Skip to main content

Add Google as an identity provider

Use Google 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 Google

  1. Log in to Google Admin console.

  2. Go to Menu > Apps > Web and mobile apps.

  3. Click Add App > Add custom SAML app.

  4. On the App Details page, enter a name for the Aiven profile.

  5. Click Continue.

  6. On the Google Identity Provider details page, copy the SSO URL, Entity ID, and the Certificate. You'll use these for the SAML configuration in Aiven Console.

  7. Click Continue.

  8. On the Service Provider Details page, set the following parameters:

    ParameterValue
    Entity IDMetadata URL from Aiven Console
    ACS URLACS URL from Aiven Console
    Start URL
    Name ID formatEMAIL
    App attributesemail
  9. Click Finish.

  10. Turn on your SAML app.

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 SSO URL from Google.
  2. In the Entity ID field, enter the Entity ID from Google.
  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.