Add SAML identity providers
You can give your organization users access to Aiven through identity providers (IdPs) that support SAML.
The following are general steps for setting up single sign-on with an IdP. Setup instructions are also available for these specific providers:
For all IdPs, Aiven recommends following security best practices.
Step 1: Add the IdP in the Aiven Console
- In the organization, click Admin.
- Click Identity providers.
- Click Add identity provider.
- Select an identity provider 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.
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 from your identity provider.
-
Enter the Entity ID from your identity provider.
-
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.
-
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.
-
-
Optional: Select a user group to add all users who sign up with this IdP to.
-
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: Optional: Link your users to the identity provider
You can manually link Aiven organization user accounts using the following URLs.
You don't need to manually link organization users who have an email address that matches a verified domain linked to one of your identity providers.
-
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 an 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 the account link URL.
- 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 the account link URL.
- 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 the signup URL.
- Select the identity provider on the signup page. 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.