Menu
Amazon Cognito
Developer Guide (Version Last Updated: 07/28/2016)

Specifying Attribute Mapping for Your User Pool

Note

The Attribute mapping tab appears only when you're editing an existing user pool.

On the Attribute mapping tab, you can map identity provider (IdP) attributes or assertions to user pool attributes. For more information, see Specifying Identity Provider Attribute Mappings for Your User Pool.

Note

Currently, only the Facebook id, Google sub, and Login with Amazon user_id attributes can be mapped to the Amazon Cognito user pools username attribute.

Note

The attribute in the user pool must be large enough to fit the values of the mapped identity provider attributes, or an error occurs when users sign in. Custom attributes should be set to the maximum 2048 character size if mapped to identity provider tokens.

You must create mappings for any attributes that are required for your user pool.

To specify a social identity provider attribute mapping for your user pool

  1. Choose the Facebook, Google, or Amazon tab.

  2. For each attribute you need to map, perform the following steps:

    1. Choose the Capture check box.

    2. In the User pool attribute field, choose the user pool attribute to map the social identity provider attribute to from the drop-down list.

    3. If you need more attributes, choose Add Facebook attribute (or Add Google attribute or Add Amazon attribute) and perform the following steps:

      1. In the Facebook attribute (or Google attribute or Amazon attribute) field, enter the name of the attribute to be mapped.

      2. For User pool attribute, choose the user pool attribute you want to map to the social identity provider attribute to from the drop-down list.

    4. Choose Save changes.

To specify a SAML provider attribute mapping for your user pool

  1. Choose the SAML tab.

  2. For each attribute you need to map, perform the following steps:

    1. Choose Add SAML attribute.

    2. In the SAML attribute field, enter the name of the SAML attribute to be mapped.

    3. For User pool attribute, choose the user pool attribute you want to map to the SAML attribute from the drop-down list.

    4. Choose Save changes.