Managing team memberships with identity provider groups

About team management with Enterprise Managed Users

With Enterprise Managed Users, you can manage team membership within your enterprise through your IdP. When you connect a team in one of your enterprise's organizations to an IdP group, changes to membership from the IdP group are reflected in your enterprise automatically, reducing the need for manual updates and custom scripts.

When a change to an IdP group or a new team connection results in a managed user joining a team in an organization they were not already a member of, the managed user will automatically be added to the organization. Organization owners can also manage organization membership manually. When you disconnect a group from a team, users who became members of the organization via team membership are removed from the organization if they are not assigned membership in the organization by any other means.

You can connect a team in your enterprise to one IdP group. You can assign the same IdP group to multiple teams in your enterprise.

If you are connecting an existing team to an IdP group, you must first remove any members that were added manually. After you connect a team in your enterprise to an IdP group, your IdP administrator must make team membership changes through the identity provider. You cannot manage team membership on GitHub.com.

When group membership changes on your IdP, your IdP sends a SCIM request with the changes to GitHub.com according to the schedule determined by your IdP, so change may not be immediate. Any requests that change team or organization membership will register in the audit log as changes made by the account used to configure user provisioning.

Teams connected to IdP groups cannot be parents of other teams nor a child of another team. If the team you want to connect to an IdP group is a parent or child team, we recommend creating a new team or removing the nested relationships that make your team a parent team.

To manage repository access for any team in your enterprise, including teams connected to an IdP group, you must make changes on GitHub.com. For more information, see "Managing team access to an organization repository".

Creating a new team connected to an IdP group

Any member of an organization can create a new team and connect the team to an IdP group.

1. In the top right corner of GitHub, click your profile photo, then click Your organizations.

2. Click the name of your organization.

3. Under your organization name, click Teams.

   

4. On the right side of the Teams tab, click New team.

5. Under "Create new team", type the name for your new team.

6. Optionally, in the "Description" field, type a description of the team.

7. To connect a team, select the "Identity Provider Groups" drop-down menu and click the team you want to connect.

8. Decide whether the team will be visible or secret.

9. Click Create team.

Managing the connection between an existing team and an IdP group

Organization owners and team maintainers can manage the existing connection between an IdP group and a team.

1. In the top right corner of GitHub, click your profile photo, then click Your profile.

2. In the top right corner of GitHub, click your profile photo, then click Your organizations.

3. Under your organization name, click Teams.

   

4. On the Teams tab, click the name of the team.

5. At the top of the team page, click Settings.

6. Optionally, under "Identity Provider Group", to the right of the IdP group you want to disconnect, click .

7. To connect an IdP group, under "Identity Provider Group", select the drop-down menu, and click an identity provider group from the list.

8. Click Save changes.

Viewing IdP groups and connected teams

You can review a list of IdP groups, any teams connected to an IdP group, and see the membership of each IdP group on GitHub. You must edit the membership for a group on your IdP.

1. In the top-right corner of GitHub, click your profile photo, then click Your enterprises.

2. In the list of enterprises, click the enterprise you want to view.

3. Under your business account's name, click Identity provider.

4. Under "Identity Provider (IdP) Groups", review the list of IdP groups.