How does single sign-on work on PixelGlass?
Your app's server signs a JWT with HS256 and the secret from Settings › Audience › Single sign-on. The site checks it and signs the reader in as that member.
What does the token carry?
Your user's id in your app, their address, an optional name, your site's host, and a new random id. It works once, for five minutes at most.
Which member does a token sign in?
The member with your app's id. If none has it, the member with that address. If neither exists, PixelGlass makes a confirmed member on no newsletter.
Does a sign-in add the reader to my newsletter?
No. A member made by single sign-on joins no newsletter, because a sign-in is not consent to email.
What happens when I make a new secret?
The new secret is shown once, and the old one works for one more day, so your app can change over.
Who can turn on single sign-on?
The owner alone, because the secret signs anyone in as any reader.