Help centre/Widget and identity
Sign customers in with single sign-on
Your app signs a short token saying who somebody is, and HeedPost starts their session. No SAML, no metadata.
Set it up
- Turn it on in Settings › Sign-in and privacyUnder Single sign-on. You get a signing secret.
- Sign a token on your serverA JWT signed with HS256, carrying
sub,email,iatandexp. Make it when someone clicks through. - Send them inTo
/auth/sso?token=…on your workspace, or give the same token to the widget. - Require it, if you wantEmailed links and Google then stop working, and people are sent to a start URL in your app.
Everything rests on the secret. Keep it on your server. Rotating it takes effect at once, and every token signed with the old one stops working.
The details
The claims, the two-minute window, what each error means, and code in Python and Node are in the single sign-on guide.
Related
Did this answer it?