Skip to main content

Add Okta as an identity provider

Use Okta to give your organization users single sign-on (SSO) access to Aiven using SAML. Aiven also supports user provisioning for Okta with SCIM.

Supported features

  • Identity provider (IdP) initiated SSO
  • Service provider (SP) initiated SSO

For more information on the listed features, visit the Okta Glossary.

Prerequisite steps in Aiven Console

Add Okta as an identity provider.

Configure SAML on Okta

  1. In the Okta administrator console, go to Applications > Applications.
  2. Click Browse App Catalog.
  3. Search for and open the Aiven app.
  4. Click Add Integration and Done.
  5. On the Sign On tab, click Edit.
  6. In the Advanced Sign-on Settings set the Metadata URL and ACS URL to the URLs copied from the Aiven Console.
  7. Set the Default Relay State for the console you use:
    • For the Aiven Console:
    • For the Aiven GCP Marketplace Console:
    • For the Aiven AWS Marketplace Console:
  8. Click Save.
  9. In the SAML 2.0 section, click More details.
  10. Copy the Sign on URL, Issuer URL, and the Signing Certificate. You will use these to configure the IdP in Aiven.
  11. Go back to the Aiven Console to configure the IdP and complete the setup.

Log in with Okta

To log in to the Aiven Console using Okta:

  1. On the login page, enter your Okta email address.
  2. Click Log in and Log in with Okta.


Authentication failed

When launching the Aiven SAML application, you get the following error:

Authentication Failed
Login failed. Please contact your account administrator for more details.

Ensure IdP initiated login is enabled.

Invalid relay state

If you get the invalid relay state error, then you are attempting an IdP-initiated auth flow. This happens, for example, when you click the Aiven SAML app in Okta. Set the Default Relay State in Okta to the Aiven console that your organization uses.

The Okta password does not work

Make sure to use the Account Link URL to add the Okta IdP to your Aiven user account. You can view all authentication methods in User information > Authentication.