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:
- Add the identity provider in the Aiven Console .
- Configure SAML on your IdP.
- Finalize the setup in the Aiven Console using information from your IdP.
- Link your users to the identity provider.
Step 1. Add the IdP in the Aiven Console
- In the organization, click Admin.
- Click Identity providers.
- Click Add identity provider.
- Select an IdP and enter a name.
- 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. If you saved your IdP as a draft, you can open the settings by clicking the name of the IdP.
-
Enter the IDP URL and Entity Id details.
Aiven Auth0 Azure AD FusionAuth Google JumpCloud Okta OneLogin IdP URL Identity Provider Login URL
Login URL
Login URL
SSO URL
IDP URL
Identity Provider Single Sign-On URL
SAML 2.0 Endpoint (HTTP)
Entity ID Issuer URN
Azure AD Identifier
Entity ID
Entity ID
IdP Entity ID
Identity Provider Issuer
Issuer URL
-
Paste the certificate from the IdP into the Certificate field.
-
Optional: Paste or upload a JSON file with configuration details for your IdP.
-
Click Next.
-
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.
-
Optional: Select a user group to add all users who sign up with this IdP to.
-
Limited availabilty To enable user provisioning with Okta, click the toggle.
- Copy the Base URL and Access token.
- Add the URL and token to your Okta app integration.
-
Click Finish to complete the setup.
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.
Step 4. Link your users to the identity provider
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:
- On the Identity providers page, click the name of the IdP.
- 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.
- 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.
The process for users to link their Aiven user account with the IdP varies for new and existing users.
-
For existing users that are already logged in to the Aiven Console
- Click Link profile to go to your IdP's authentication page.
- Log in to the IdP to link the accounts. You can use the IdP for all future logins.
-
For existing users that are not logged into the Aiven Console
- Click Login.
- Log in to the Aiven Console. You are redirected to your IdP's authentication page.
- Log in to the IdP to link the accounts. You can use the IdP for all future logins.
-
For new users without an Aiven user account
- Click Sign up. You are redirected to your IdP's authentication page.
- Log in to the IdP.
- Complete the sign up process in the Aiven Console. The IdP is automatically linked to your Aiven user account 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.