Skip to main content

Add identity providers

You can give your organization users access to Aiven through an identity provider (IdP).

To set up single sign-on through an IdP for your organization:

  1. Add the identity provider in the Aiven Console .
  2. Configure SAML on your IdP.
  3. Finalize the setup in the Aiven Console using information from your IdP.
  4. Link your users to the identity provider.

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 IdP 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 your IdP

Use the metadata URL and ACS URL from the Aiven Console to configure a new application in your IdP. Setup instructions are available for these specific providers:

If your provider isn't listed, contact the support team at support@aiven.io for help with the configuration.

Step 3. Finish the configuration in Aiven

Go back to the Aiven Console to complete setting up the IdP:

  1. Enter the IDP URL and Entity Id details.

    AivenAuth0Azure ADFusionAuthGoogleJumpCloudOktaOneLogin
    IdP URLIdentity Provider Login URLLogin URLLogin URLSSO URLIDP URLIdentity Provider Single Sign-On URLSAML 2.0 Endpoint (HTTP)
    Entity IDIssuer URNAzure AD IdentifierEntity IDEntity IDIdP Entity IDIdentity Provider IssuerIssuer URL
  2. Paste the certificate from the IdP into the Certificate field.

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

  4. Click Next.

  5. Configure the security options for this IdP:

    • 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 will check 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.
  6. Click Next and complete the setup.

If you saved your IdP as a draft, you can open the settings by clicking the name of the IdP.

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.

Your organization users should automatically be able to use the identity provider to sign up and log in to Aiven. You can also handle this manually using URLs:

  1. On the Identity providers page, click the name of the IdP.
  2. In the Overview section there are two URLs:
    • Signup URL: Users that don't have an Aiven user account can use this to create a new Aiven user linked to this IdP.
    • User account link URL: Users that already have an Aiven user account can link their existing Aiven user with this IdP.
  3. Send the appropriate URL to your organization users. If you set up a different IdP 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.

When a user clicks on the link, they will be redirected to a page to link their Aiven user account with the IdP:

  • For existing users that are already logged into the Aiven Console
    1. Click Link profile. You are redirected to your IdP's authentication page.
    2. Once logged in to the provider, you will be redirected back to the Aiven Console and the IdP is linked to your profile. You can use the IdP for all future logins.
  • For existing users that are not logged into the Aiven Console
    1. Click Login.
    2. On the login page of the Aiven Console, log in as usual. You are redirected to your IdP's authentication page.
    3. Once logged in to the provider, you are redirected back to the Aiven Console and the IdP is linked to your profile. You can use the IdP for all future logins.
  • For new users without an Aiven user account
    1. Click Sign up. You are redirected to your IdP's authentication page.
    2. Once logged in to the provider, you are redirected back to the Aiven sign up page.
    3. Complete the sign up process. The IdP is linked to your profile and you can use it for all future logins.

Troubleshooting

If you have issues, you can use the SAML Tracer browser extension to check the process step by step.