{"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"manage-team-mapping","__idx":0},"children":["Manage team mapping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you have set up ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs-legacy/teams"},"children":["teams"]}," in your organization, you can map teams to the relevant IdPs so that organization administrators (people with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Owner"]}," role) can automatically map the people in their organization to different teams based on some of their attributes (claims)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-team-mapping","__idx":1},"children":["Add team mapping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section describes how to map a team to your identity provider using mapping rules."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Log in to ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"https://app.redocly.com/"},"children":["Workflows"]},", and select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Org Settings"]}," tab."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To add a team mapping rule, select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage team mapping"]}," option for your identity provider."," ",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/manage-team-mapping-c9bceaa3adb23d56.png","alt":"Manage team mapping"},"children":[]}," ","The ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Team mapping"]}," page displays."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the Team mapping page, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Mapping Rule"]},". The Create team mapping rule displays."," ",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/create-team-mapping-rule-012ab2278d64b8df.png","alt":"Manage team mapping"},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter the following information for the mapping:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Claim path"]},": Specify the claim path associated with the person. This can be a string or a URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Match condition"]},": Select the match condition from the dropdown. For a list of what the mapping conditions mean, refer to the ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"#how-to-map-conditions"},"children":["Mapping conditions"]}," table."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Claim value"]},": Enter the value of the claim for the claim path."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Assigned team"]},": Select the team you want to assign the person to."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]}," to add the mapping rule for the selected identity provider."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-to-map-conditions","__idx":2},"children":["How to map conditions"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Condition"},"children":["Condition"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"How would you use it?"},"children":["How would you use it?"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Map to selected team only if the claim path contains a part of the specified claim value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claim path: email"]}," contains ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manager"]},", then people with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}," claim that have ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manager"]}," in the email address will be added to the selected team."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Default"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mapped to this team by default"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All users are added to the selected team by default."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Equals"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Map to selected team only if the claim path matches the specified claim value exactly"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claim path: role"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isAdmin"]},", people who have this exact ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["role"]}," in the claim will be added to the selected team."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Exists In"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Map to selected team only if the claim path exists in the specified claim value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claim path: role"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isMaintain"]},", people who have ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isMaintain"]}," as part of their claim, they will be added to the selected team."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Does Not Contain"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Map to selected team only if the claim path does not contain the specified claim value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set as an exclusion. If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claim path: email"]}," contains ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["developer"]},", then people with any ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}," claim other than ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["developer"]}," in the email address will be added to the selected team."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Does Not Equal"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Map to selected team only if the claim path does not match the specified claim value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set as an exclusion. If the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claim path: role"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isAdmin"]},", people with any ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["role"]}," other than ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isAdmin"]}," in the claim will be added to the selected team."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Mapping rules are exclusive"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While you can add multiple mapping rules for teams, you can only add one mapping rule of a kind per identity provider. For example, if you have added a mapping rule with condition ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["default"]}," with one team, you cannot use the same condition ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["default"]}," with any other team for that identity provider."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"update-team-mapping-rule","__idx":3},"children":["Update team mapping rule"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can update an existing team mapping rule from the team mapping page."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the Identity providers page, select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage team mapping"]}," option for the identity provider you want to update."," ",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/manage-team-mapping-c9bceaa3adb23d56.png","alt":"Manage team mapping"},"children":[]}," ","The Team mapping page displays."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the Team mapping page, select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Update team mapping rule"]}," icon for the rule you want to update."," ","The ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Update team mapping"]}," dialog displays."," ",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/update-team-mapping-rule-6bb8417b66570177.png","alt":"Update team mapping rule"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the match condition you want to update, and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Update"]}," to save your changes."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"remove-a-team-mapping-rule","__idx":4},"children":["Remove a team mapping rule"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can remove an existing team mapping rule from the team mapping page."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the Identity providers page, select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage team mapping"]}," option for the identity provider you want to remove a team mapping rule."," ",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/manage-team-mapping-c9bceaa3adb23d56.png","alt":"Manage team mapping"},"children":[]}," ","The Team mapping page displays."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the Team mapping page, select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Remove team mapping rule"]}," icon for the rule you want to remove,."," ","The ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Remove team mapping"]}," dialog displays."," ",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/remove-team-mapping-rule-eaba3f80f639bc33.png","alt":"Delete team"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Remove"]}," to remove this team mapping rule for the identity provider configuration."]}]}]},"frontmatter":{"excludeFromSearch":true},"tagList":["admonition"],"title":"Manage team mapping","lastModified":"2025-05-28T16:01:32.000Z"}