Set up SAML with JumpCloud#

This article explains how to set up SAML with JumpCloud for an organization in Aiven. For more information on SAML and instructions for other identity providers, see the Set up SAML authentication article.

Prerequisite steps in Aiven Console#

  1. In the organization, click Admin.

  2. Select Authentication.

  3. Click Add authentication method.

  4. Enter a name and select SAML. You can also select the teams that users will be added to when they sign up or log in through this authentication method.

You are shown two parameters needed to set up the SAML authentication in JumpCloud:

  • Metadata URL

  • ACS URL

Configure SAML on JumpCloud#

  1. In the JumpCloud admin console, go to SSO.

  2. Select Custom SAML App.

  3. Set the IdP Entity ID.

  4. Set the Audience URI (SP Entity ID) to the Metadata URL from the Aiven Console.

  5. Set the ACS URL to the one from the Aiven Console.

  6. Set the Default RelayState to the homepage of the Aiven Console, https://console.aiven.io.

  7. Add an entry in Attribute statements with Service Provider Attribute Name of email and JumpCloud Attribute Name of email.

  8. Set the Login URL to the ACS URL from the Aiven Console.

  9. In User Groups, assign the application to your user groups.

  10. Click Activate.

  11. Download the certificate.

Finish the configuration in Aiven#

Go back to the Authentication page in Aiven Console to enable the SAML authentication method:

  1. Select the name of the JumpCloud method that you created.

  2. In the SAML configuration section, click Edit.

  3. Toggle on IdP login.

  4. Add the configuration settings from JumpCloud:

  • Set the SAML IDP URL to the IDP URL from JumpCloud.

  • Set the SAML Entity ID to the IdP Entity ID from JumpCloud .

  • Paste the certificate from JumpCloud into the SAML Certificate field.

  1. Click Edit method to save your changes.

  2. Toggle on Enable authentication method at the top of the page.

You can use the Signup URL to invite new users, or the Account link URL for those that already have an Aiven user account.

Troubleshooting#

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