Aqua supports SAML 2.0 login. To enable SAML, support will request several pieces of information from you. We will then enable SAML for a single user within your account so that no one loses access, allow you to test the configuration end-to-end, and then enable it for all of your users.

Step 1: Create a SAML Application

To begin enabling SAML, you must first create a new application for the Aqua in your SAML provider. This differs by the provider, but most providers will require the following information:

Application Callback URL
Allowed Callback URLs
Audience (aka Entity/Issuer ID)urn:amazon:cognito:sp:us-east-1_voZ9dTvpW
Required AssertionsEmailAddress
Identity Claim
Required Attributes
{User's email address}

Signin / Signout URL 

Some providers have some custom options and settings you may need to configure differently. Please see the following guides for:
- JumpCloud
- Active Directory

After you have created your SAML application, you will need to provide your application information to Aqua support. This can either be in the form of an exported XML metadata file, or a link to an XML metadata endpoint. You can validate your XML file using an online SAML XML validator.

Step 3: Initiating the SAML Setup

Once you have collected the above information and configured your application, please contact Aqua support and provide the following information:

  1. Your XML file or XML metadata endpoint
  2. The domains you'd like to allow to authenticate with your account. Aqua can support an unlimited number of domains.
  3. Whether you would like to enforce SAML login for all users in your account (if yes, existing usernames/passwords will no longer work and SAML will be enforced for all new and existing users).
  4. Whether you would like to enable just-in-time provisioning of user accounts (if yes, new users will be added to the "Default" groups).
  5. Which user (email address) you'd like to use to test the configuration before enabling it globally.

Step 4: Test the SAML setup

Once support confirms receipt of the above, we will enable SAML for your account, but only apply it to the user you specify. This is done to prevent incorrect SAML configurations from locking out all other users in your account.

Support will then ask you to confirm the workflow by testing a SAML sign-in. If everything succeeds, we will then enable it for all other users.

Step 5: Next Steps

  1. Aqua supports several advanced SAML features you may wish to enable.
  2. Share the new SAML sign-in link with your users: 

Step 6: Optional

  1. Customize session timeout