Logo

Advanced topics

How to set up single sign on (SSO)

Integrating AWS IAM Identity Center (SSO) with Datazoom

This guide provides instructions for configuring single sign-on (SSO) for your Datazoom account using AWS IAM Identity Center (formerly AWS SSO) as your identity provider. The process involves creating a SAML 2.0 application in your AWS account and sharing the configuration details with Datazoom.

Prerequisites

Before you begin, please ensure you have the following:

  • Administrative access to your organization's AWS Management Console.

  • AWS IAM Identity Center enabled in your AWS account.

  • A User Pool ID and Cognito Domain URL provided by the Datazoom team. You will need these values to complete the steps below.

Access IAM Identity Center

  1. In the AWS Management Console, navigate to IAM Identity Center.

  2. Select Applications under Application assignments in the left menu.

Add a New Application

  1. Click Add Application.

  2. Choose I have an application I want to set up.

  3. Select SAML 2.0 as the application type.

  4. Click Next.

Configure Application

  1. Display name: Enter a name for the application (e.g., Datazoom SSO).

  2. Description: Provide a brief description of the application.

  3. Download the IAM Identity Center SAML metadata file. Share this file with Datazoom for their Cognito configuration.

  4. Under Application metadata, select Manually type your metadata values.

  5. Fill in the following:

Frame 85.png

Add Attribute Mappings

  1. Configure the attribute mappings to map IAM Identity Center attributes to Cognito user attributes. Example:

User attribute in the application

AWS IAM Identity Center attribute

Subject

${user:subject}

email

${user:email}

Save and Assign Users

  1. Save the application configuration.

  2. Assign users or groups to the application in IAM Identity Center to grant access.