About team synchronization
If team sync is enabled for your organization or enterprise account, you can synchronize a GitHub team with an IdP group. When you do this, membership changes to the IdP group are reflected on GitHub automatically, reducing the need for manual updates and custom scripts.
You can assign an IdP group to multiple GitHub teams.
Once a GitHub team is connected to an IdP group, your IdP administrator must make team membership changes through the identity provider. You cannot manage team membership on GitHub.
Parent teams cannot synchronize with IdP groups. If the team you want to connect to an IdP group is a parent team, we recommend creating a new team or removing the nested relationships that make your team a parent team. For more information, see About teams, Creating a team, and Moving a team in your organization’s hierarchy.
To manage repository access for any GitHub team, including teams connected to an IdP group, you must make changes with GitHub. For more information, see About teams and Managing team access to an organization repository.
Prerequisites
To connect a team on GitHub to an IdP group, the team must already exist in your organization. Even if you have configured SCIM provisioning, creating a group in your IdP does not automatically create a team on GitHub.
You must configure user provisioning with SCIM for your GitHub Enterprise Server instance. For more information, see Configuring user provisioning with SCIM on GitHub Enterprise Server.
Note
This is an outdated, private beta version of SCIM for GitHub Enterprise Server. Customers must upgrade to 3.14 or newer and use the SCIM beta in order for their SCIM feedback or bug reports to be considered.
Warning
The beta is exclusively for testing and feedback, and no support is available. GitHub recommends testing with a staging instance. For more information, see Setting up a staging instance.
Connecting an IdP group to a team
When you connect an IdP group to a GitHub team, all users in the group are automatically added to the team.
-
In the upper-right corner of GitHub, select your profile photo, then click Your organizations**.
-
Click the name of your organization.
-
Under your organization name, click Teams.
-
Click the name of the team.
-
At the top of the team page, click Settings.
-
Click Save changes.
Disconnecting an IdP group from a team
-
In the upper-right corner of GitHub, select your profile photo, then click Your organizations**.
-
Click the name of your organization.
-
Under your organization name, click Teams.
-
Click the name of the team.
-
At the top of the team page, click Settings.
-
Click Save changes.