---
title: "exSsoSamlMapping"
canonical: "https://help.agiloft.com/space/HELP/127729703/exSsoSamlMapping"
format: markdown
---
In order to create or update user records on successful SAML logins, you need to map SAML attributes from your IdP to fields in Agiloft CLM. Follow the steps below to configure attribute to field mappings.

> 📝 User data, like First Name, Last Name, and Email, defined directly in the People table or its subtables can be added or changed based on SAML attributes. User records and field values don't have to pre-exist in the system.
> 📝 
> 📝 Group and team values can also be assigned from attributes. However, groups and teams aren't defined in the People table. They're linked fields to the privileged Groups and Teams tables, which can't be updated via SAML. When Agiloft CLM reads group or team attributes, it looks for an exact match in the corresponding table. If there isn't a match, the user gets an error and can't log in. If you want to set groups or teams from attributes, you must add those groups or teams to Agiloft CLM first, or users won't be able to log in with SAML.

1. Go to **Setup > Access > Configure SAML 2.0 Profiles** and edit the profile for this IdP.
2. Go to the User Group Mapping tab.
3. Choose the method for group assignment:
  - If you want to assign all SAML users to an existing Agiloft CLM group, select "Choose a Group existing in Agiloft as the default Group for the user" and choose the group from the drop-down list.
  - If you want to assign users to existing groups in Agiloft CLM based on a SAML attribute, select "Map the group(s) from this SAML Attribute" and enter the attribute to use.

> 📝 Any group values you send have to exactly match a Group Name in the Groups table before users in those groups can log in with SAML.

4. Next, define what to do on subsequent logins:
  - If you want to update a user's group details every time the user logs in, select "Update user's group based on the selection above."
  - If you want don't want to update groups once they're set, select "Do not update user's group membership in Agiloft."
5. Click Next to set up team mappings.
6. On the User Team Mapping tab, choose the method for team assignment:
  - If you want to assign all SAML users to existing teams in Agiloft CLM, select Set the User’s teams from Agiloft. Then select the Primary Team from the drop-down list. To assign secondary teams, select a team from the Teams list. Hold Ctrl and click to select any number of secondary teams.
  - If you want to assign users to existing teams in Agiloft CLM based on SAML attributes, select Set the User’s teams from the IdP. Then enter the attributes to use for primary and secondary team assignments.

> 📝 Any team values you send have to exactly match a Team Name in the Teams table before users in those teams can log in with SAML.

7. Next, define what to do on subsequent logins:
  - If you want to update a user's team details every time the user logs in, select "Update their Primary Team and Teams fields based on the selection above."
  - If you want don't want to update teams once they're set, select "Do not update user's Primary Team and Teams fields in Agiloft based on selection above."
8. Click Next to go to the User Field Mapping tab. The tab lists the fields from user records that can be updated with values from SAML attributes.
9. Supply the attributes for the fields you want to update in user records. Leave blank the ones you don't want to update. For more information, see [SAML Attribute Mapping](#attribute_mapping) below.

> ⚠️ The Login field is mapped on the Server Provider Details tab. Do not map Login on this tab.

10. When attribute mapping is complete, click Next.