Skip to main content

Ripple - MFA: Integration with AWS IAM Identity Center

How to integrate Ripple and Wave Pro with AWS IAM Identity Center.

Written by Yo Fukuda
Updated yesterday

Overview

This guide walks you through the steps to integrate with AWS IAM Identity Center for MFA authentication in Wave Pro.


Prerequisites

  • An IAM Identity Center instance must already be created.

  • For details, please refer to the AWS documentation.


Step 1: Log in to the AWS Console

  1. Sign in to the AWS Management Console.

  2. From the search bar, search for and navigate to Identity Center.


Step 2: Add a New Application

  1. Navigate to Application Assignments > Applications.

  2. Click Add Application.

  3. On the Select Application Type page, under Setup Preferences:

    • Select I have an application to set up

    • Select Application Type: SAML 2.0

    • Click Next


Step 3: Configure the Application

  1. Under How to start > View step-by-step instructions.

  2. Enter the following (optional):

    1. Display Name: WavePro

    2. Description: WavePro


Step 4: Configure IAM Identity Center Metadata

  1. Download the IAM Identity Center SAML metadata file.

  2. In WavePro, add the IdP settings:

    1. Go to Preferences > Identity Provider > + Add identity provider

    2. Upload the metadata file you downloaded.


Step 5: Configure Application Metadata

Enter the following values and click Submit:


Step 6: Set Attribute Mapping

In Application Attribute Mapping, configure the following attributes and click Save Changes:

User attributes of the application

Mapping to this string value or user attributes of IAMIdentitiyCenter

format

Subject

${user:subject}

persistent

${user:givenName}

Unspecified

${user:familyName}

Unspecified

${user:email}

Unspecified


Step 7: Add a User

  1. From the Identity Center menu, navigate to Users and click Add User.

  2. Fill in the user's details and click Add User:

Field

Value

Username

{Any value}

Email

{Any value}

Confirm Email Address

{Any value}

First Name

WavePro Preferences > ID under Identity Provider Settings

Last Name

[Wave ID]: wave/[Wave permission set in RBAC], user/[User permission set in RBAC], role/[Role permission set in RBAC]


Example:

waveID:wave/waverole,user/userrole,role/rolerole


Step 8: Assigning Users and Groups:

  1. Navigate to Applications > Customer Management > {Created Application Name} > Assign Users and Groups.

  2. Search for the user you created earlier, select it, and click Assign.

  3. Navigate to AWS Access Portal > Applications, and confirm that {the Created Application Name} is displayed in the application list.

  4. Click on the application.

  5. If the WavePro login screen is displayed, the setup is complete. ✅

For a basic explanation of Ripple MFA, please refer to this article.


Need More Help?

If any errors occur during the process or if you have any questions, please reach out to us:

Did this answer your question?