Skip to main content

Add Auth0 as an identity provider

Use Auth0 to give your organization users single sign-on (SSO) access to Aiven.

Step 1: Add the IdP in the Aiven Console​

  1. In the organization, click Admin.
  2. Click Identity providers.
  3. Click Add identity provider.
  4. Select an identity provider and enter a name.
  5. Select a verified domain to link this IdP to. Users see linked IdPs on the login page.

On the Configuration step are two parameters that you use to set up the SAML authentication in your IdP:

  • Metadata URL
  • ACS URL

Step 2: Configure SAML on Auth0​

  1. Log in to your Auth0 account.

  2. Select Applications.

  3. Click Create Application.

  4. Enter an application name.

  5. Choose Regular Web Applications and click Create.

  6. After your application is created, go to the Addons tab.

  7. Enable the SAML 2 WEB APP option.

  8. Click the SAML 2 WEB APP option. The Settings tab opens.

  9. Set the Application Callback URL to the ACS URL from the Aiven Console.

  10. In the Settings section for the Application Callback URL, remove the existing configuration and add the following field mapping configuration:

    {
      "email": "email",
      "first_name": "first_name",
      "identity": "email",
      "last_name": "last_name",
      "mapUnknownClaimsAsIs": true
    }

  11. Click Enable and Save.

  12. On the Usage tab, make a note of the Identity Provider Login URL, Issuer URN, and Identity Provider Certificate. These are needed for the SAML configuration in Aiven Console.

Step 3: Finish the configuration in Aiven​

Go back to the Aiven Console to complete setting up the IdP. If you saved your IdP as a draft, you can open the settings by clicking the name of the IdP.

  1. In the IDP URL field, enter the Auth0 Identity Provider Login URL.
  2. In the Entity ID field, enter the Auth0 Issuer URN.

  1. Paste the certificate from the IdP into the Certificate field.

  2. Optional: Paste or upload a JSON file with configuration details for your IdP.

  3. Click Next.

  4. Configure the security options for this IdP and click Next.

    • Require authentication context: This lets the IdP enforce stricter security measures to help prevent unauthorized access, such as requiring multi-factor authentication.

    • Require assertion to be signed: The IdP checks for a digital signature. This security measure ensures the integrity and authenticity of the assertions by verifying that they were issued by a trusted party and have not been tampered with.

    • Sign authorization request sent to IdP: A digital signature is added to the request to verify its authenticity and integrity.

    • Extend active sessions: This resets the session duration every time the token is used.

    • Enable group syncing: This syncs the group membership from your IdP to the Aiven Platform.

      note
      • The Aiven Platform doesn't create groups with this feature. It only syncs the group membership between the groups in your IdP and the groups you create in Aiven. For user group provisioning, use SCIM.
      • User group membership automatically syncs when a user logs in.
      • The IdP is the single source of truth. If a group in the IdP doesn't exist in Aiven, it will be ignored. Likewise, if a user is added to a group in Aiven Console but not in the IdP, they will be removed from the Aiven group when the group membership syncs.

  5. Optional: Select a user group to add all users who sign up with this IdP to.

  6. Click Finish to complete the setup.

note

If you set up a SAML authentication method before and are now switching to a new IdP, existing users need to log in with the new account link URL to finish the setup.