When SSO is not used, the Cognito userpool itself is leveraged as the identity provider. The Cognito Userpool in question is the one which was created by the Local Measure Engage CloudFormation template.
Instructions
The following summarizes the high-level process which needs to be followed:
- Navigate to the relevant Cognito Userpool
- Create users
- Specify the identity provider
The steps below will guide you through the detailed process.
Step 1: Navigate to the relevant Cognito Userpool
Log into the AWS account in which the Local Measure Engage CloudFormation stack has been created. Navigate to the Cognito service (ensure that you are in the correct region) and open the UserPool which was created when the Local Measure Engage CloudFormation stack has been created.
Step 2: Create users
On the 'Users' tab, click 'Create User'.
Enter a username and email address. It is recommended to specify the user's (agent's) email address as their username. This ensures that it will match the user's Amazon Connect username, thereby making it easier for the user to remember their details.
Mark the email address as verified and specify a temporary password. The user will be required to change this password the first time they log into Engage. It is not required to specify a phone number.
Repeat this step for all agents who will require the ability to log into Local Measure Engage.
Step 3: Specify the identity provider
Switch to the 'App Integration' tab.
Scroll to the bottom and click into the app-client.
On the resulting screen, scroll down to the 'Hosted UI' section and click the 'Edit' button.
On the resulting screen, scroll down to the 'Identity providers' section and select 'Cognito user pool' from the dropdown list. This tells Cognito to use the userpool, with the manually created users, as the identity provider.
Click 'Save changes' at the bottom of the screen.
[.callout-primary--check]Congratulations, you have successfully configured Cognito.[.callout-primary--check]