# Amazon AWS

{% hint style="success" %}
Please complete the steps in the [Admin Console Configuration](https://docs.keeper.io/en/sso-connect-cloud/admin-console-configuration) section first.
{% endhint %}

<figure><img src="https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB_i6vKdtG6Z2n6zWgJ%2Fuploads%2FBnRSpTFkIyGkfz2uud2G%2FAWS.jpg?alt=media&#x26;token=94139d5b-4854-46d0-b6aa-19999c38519c" alt=""><figcaption></figcaption></figure>

### AWS SSO

Log into AWS and select on AWS Single Sign-On.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuXy1RL4M4jZYGOtSE%2Fsso-step-162b.png?alt=media\&token=17c7f3d5-d83f-46a1-bf76-50d0042c5ebd)

On the SSO Dashboard, select Configure SSO access to your cloud applications.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuY--GSpGrclS0xo3j%2Fsso-step-163b.png?alt=media\&token=fa2e2ac0-2927-4505-a5c2-e64e46444832)

On the Applications menu, select **Add a new application**.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuY0GlgFTaD94jNvIp%2Fsso-step-164b.png?alt=media\&token=b44a300d-0c6f-4242-b2eb-dd0f35595b17)

Next select **Keeper Security** and select **Add**.\*\*

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuY20FyulleeIx4oi5%2Fsso-step-165b.png?alt=media\&token=eed6206e-6eb6-4ece-9869-55786616bb55)

{% hint style="info" %}
**Keeper is working with AWS to develop an Application Connector.**
{% endhint %}

Fill in the Display name and Description (optional) in the application details section.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuY575ZDdG1Surm8rM%2Fsso-step-166b.png?alt=media\&token=5403edbb-c5c9-46e3-b0e2-fdb73c3a3a6d)

In the AWS SSO metadata section, select the download button to export the AWS SSO SAML metadata file. This file gets imported in the SSO Connect IdP Metadata section on the configuration screen.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuY6zMgj_Sv_9ziay7%2Fsso-step-167b.png?alt=media\&token=b72ae5a4-8d85-463c-96c3-95320dbe666c)

Copy this file to the Keeper SSO Connect server and upload it into the Keeper SSO Connect interface by either browsing to or dragging and dropping the file into the Configuration screen's SAML Metadata area:\\

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MFWfvDRWtPO_nevjaaS%2F-MFWiJRm6Gowf7kh-Vmv%2FGenericUPload.png?alt=media\&token=7b5f170b-8a59-4883-8a28-d39e0c04316d)

\
Next download the Keeper metadata file and upload it to the AWS Application metadata file. Navigate to the view screen of the Keeper SSO Connect Cloud™ provisioning.

![Enter View Screen](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MF6qXz87_x0Liy5MwqV%2F-MF6wuzY9HNPfwoC_vLk%2FView.png?alt=media\&token=7bd082f3-56ba-4ede-b3c6-25ff0767cc6d)

Click the "Export Metadata" button to download the config.xml file.

![Export Keeper Metadata](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MF6qXz87_x0Liy5MwqV%2F-MF6xOjnK9PJBqEBZBBp%2FDownload%20Keeper%20Metadata.png?alt=media\&token=f02b540f-2098-4e89-9992-9135e37fbbad)

\
\\

Back on the Ping Identity application configuration, select the **Select File** button and choose the **config.xml** file downloaded in the above step.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuYVRklq09uWXwdE8Y%2Fsso-step-170b.png?alt=media\&token=6f756213-66ec-40f3-acab-c7af3fa5b796)

After saving changes the **Configuration for Keeper Password Manager has been saved** success message will be displayed.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuYXS4csDoS49e8XJt%2Fsso-step-171b.png?alt=media\&token=99d2913e-b0a1-455c-b52b-9934a5b3692a)

{% hint style="info" %}
**Note: The Keeper SSL certificate cannot be larger than 2048K or the below error will be received.**
{% endhint %}

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuYZdEYEG5VI1z399u%2Fsso-step-172b.png?alt=media\&token=7f5bf29e-88e4-4077-aae4-0c7cad95f0e3)

* Either, generate a smaller SSL certificate, re-export and import the metadata file or manually set the ACS URL and Audience URL in the AWS SSO application configuration.

Next, Ensure the Keeper application attributes that are to be mapped to AWS SSO are correct (These should be set by default. Select the Attribute mappings tab.\
\
The AWS string value to ${user:subject} and format is blank or unspecified.\
\
The Keeper Attributes are set as follows:

| Keeper Attribute | AWS SSO String Value \*\* | Format      |
| ---------------- | ------------------------- | ----------- |
| Email            | ${user:email}             | unspecified |
| First            | ${user:givenName}         | unspecified |
| Last             | ${user:familyName}        | unspecified |

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuYikx4_80RIW3vUVx%2Fsso-step-173b.png?alt=media\&token=817f851a-8a01-4237-ad0a-cf3a62010850)

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuYk4ALywkKcV93tFC%2Fsso-step-174b.png?alt=media\&token=bbeaa2b3-4939-4b0b-977e-d7d1c05066ea)

{% hint style="info" %}
**Note: If your AWS email is mapped to the AD UPN (which may not be the actual email address of your users) it can be re-mapped to the email address associated in the users AD profile.**
{% endhint %}

To make this change navigate to the **Connect Directory** on the AWS SSO page.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuYlPqetIguoO-79yb%2Fsso-step-175b.png?alt=media\&token=bef3e55c-83f2-4ea9-81f0-231acd9bd32a)

Select on the **Edit attribute mappings** button.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuYmf39cxjKQHxiN8z%2Fsso-step-176b.png?alt=media\&token=db68d01f-b252-485c-89b2-b6b4e1bc6164)

Change the AWS SSO **email** attribute from ${dir:windowsUpn} to ${dir:email} .

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuYuV1tX4mHAmLb3MH%2Fsso-step-177b.png?alt=media\&token=2c66c56c-3790-43ba-80fe-c48e24823fe1)

Select on the the **Assigned users** tab and then the **Assign users** button to select users or groups to assign the application.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuYw6qzqS1Yee5IL7a%2Fsso-step-178b.png?alt=media\&token=44b8f757-e309-4b15-a129-390d97415924)

On the Assign Users window:

* Select either Groups or Users
* Type the name of a group or user
* Select on the **Search connect directory** to initiate the search.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuYyE0d9HKEOXjD13b%2Fsso-step-179b.png?alt=media\&token=c677a255-9bbb-4422-b956-4dd16e93302c)

The results of the directory search will display under the search window.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuZ0ZzW18zaFcsv4Je%2Fsso-step-180b.png?alt=media\&token=b778d38f-908d-4f56-b3cb-5c7aebc41c9d)

Select the users/groups that are desired to have access to the application and then select the **Assign users** button.

![](https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_i6vKdtG6Z2n6zWgJ%2F-MBuXeCfNWIkZlTL7Yv2%2F-MBuZ1ejEB9FlT1JK8ll%2Fsso-step-181b.png?alt=media\&token=96db4ddb-7f82-475a-9523-4e07da295d4d)

**Note: Keeper SSO Connect expects that the SAML response is signed. Ensure that your identity provider is configured to sign SAML responses.**

Your Keeper SSO Connect setup is now complete!

#### Move existing users/initial admin to SSO authentication

Users created in the root node (top level) will need to be migrated to the sub node that the SSO integration was configured on. If users remain in the root node, they will be prompted for the master password when accessing the vault and/or admin console.

{% hint style="warning" %}
An admin can not move themselves to the SSO enabled node. It requires another admin to perform this action.
{% endhint %}

After the user is moved to the SSO enabled node, they need to log into the Keeper vault initially by selecting the "Enterprise SSO" pull down and inputting in the Enterprise Domain configured on the SSO integration. The user may get prompted to confirm by entering in the master password.

<figure><img src="https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB_i6vKdtG6Z2n6zWgJ%2Fuploads%2FfFPNzWDvSwH48ebLJOeY%2FSSO_Login.png?alt=media&#x26;token=f7bc0249-986d-427d-9746-0e7873ff7840" alt=""><figcaption><p>Initially select 'Enterprise SSO Login'</p></figcaption></figure>

Once the user has authenticated with SSO, they only need to use their email address moving forward to initiate SSO authentication.

<figure><img src="https://2503956294-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB_i6vKdtG6Z2n6zWgJ%2Fuploads%2FDrVwIHQiMQDtlxeJey0G%2Fvault_Login.PNG?alt=media&#x26;token=2e435451-c23e-41bd-91e2-8ec49a216c16" alt=""><figcaption></figcaption></figure>

They won't have to enter the Enterprise Domain. If typing in the email address and clicking Next does not route the user to the desired SSO, ensure that just-in-time provisioning is enabled in the Keeper SSO configuration and ensure that your email domain is reserved by Keeper. More information regarding routing and domain reservation [can be found here](https://docs.keeper.io/enterprise-guide/domain-reservation).
