How to Create SSO Login Links with Redirect
SSO login links with redirect let you send users directly to a specific page on our platform, ensuring they first log in using their designated authentication method (Auth0 SAML, Auth0 OIDC, or username/password).
For how to create Redirect Links for OpenAthens refer to the OpenAthens documentation.
Engineering background: This guide covers the steps to construct the link. For an explanation of why the
__sso_redirectcookie mechanism works and how it survives the Auth0 OIDC round-trip, see Deep Linking with Enterprise Connections (SAML / OIDC).
Domain Selection
When onboarding new clients with a SAML connection, they receive an SSO URL/Link. The domain used in this URL determines which platform users land on after login:
www.statista.com- Default domain for the international platformde.statista.com- Use this domain when users should land on the German platform
Examples:
- International platform:
https://www.statista.com/sso/login?connection=<connection-id> - German platform:
https://de.statista.com/sso/login?connection=<connection-id>
Steps to Create an SSO Login Link with Redirect
-
Identify the Customer's Login Method
- Auth0 SAML: Use the customer's SAML connection ID.
- Auth0 OIDC: Use the customer's OIDC connection ID.
- Username/Password: No connection ID required.
-
Choose the Target Page
- Decide which page the user should be redirected to after login (e.g.
/outlook/ecommerce-outlook).
- Decide which page the user should be redirected to after login (e.g.
-
Construct the SSO Login Link with Redirect
Important:
The value of the__sso_redirectparameter must be URL-encoded to ensure special characters are handled correctly.
For example,/outlook/ecommerce-outlookbecomes%2Foutlook%2Fecommerce-outlook.-
Auth0 SAML Example:
https://www.statista.com/sso/login?connection=<customer-saml-connection-id>&__sso_redirect=<url-encoded-target-page>Example:
https://www.statista.com/sso/login?connection=acme-saml&__sso_redirect=%2Foutlook%2Fecommerce-outlook
-
Auth0 OIDC Example:
https://www.statista.com/sso/login?connection=<customer-oidc-connection-id>&__sso_redirect=<url-encoded-target-page>
-
Username/Password Example:
https://www.statista.com/sso/login?__sso_redirect=<url-encoded-target-page>
-
-
Share the Link
- Provide the constructed link to your users. When they click it, they will be prompted to log in via the specified connection and then redirected to the chosen page.
Notes
- The
connectionparameter must match the customer's assigned connection ID. - The
__sso_redirectparameter should be a valid path on the platform. - The value of the
__sso_redirectparameter must be URL-encoded. - If you are unsure about the connection ID, contact customer support.