Skip to content

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_redirect cookie 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 platform
  • de.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>
  1. 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.
  2. Choose the Target Page

    • Decide which page the user should be redirected to after login (e.g. /outlook/ecommerce-outlook).
  3. Construct the SSO Login Link with Redirect

    Important:
    The value of the __sso_redirect parameter must be URL-encoded to ensure special characters are handled correctly.
    For example, /outlook/ecommerce-outlook becomes %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>
      
  4. 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 connection parameter must match the customer's assigned connection ID.
  • The __sso_redirect parameter should be a valid path on the platform.
  • The value of the __sso_redirect parameter must be URL-encoded.
  • If you are unsure about the connection ID, contact customer support.