Skip to main content

将团队与身份提供程序组同步

可以将团队与受支持的标识提供者 (IdP) 组同步 GitHub ,以便自动添加和删除团队成员。

谁可以使用此功能?

Organization owners can synchronize a GitHub team with an IdP group.

注意

如果企业使用 Enterprise Managed Users,则不需要使用团队同步。 而是可以通过在设置企业时创建的 SCIM 配置来管理团队成员身份。 有关详细信息,请参阅“使用标识提供者组管理团队成员身份”。

关于团队同步

如果为组织或企业帐户启用了团队同步,则可以将 GitHub 团队与 IdP 组同步。 执行此作时,IdP 组的成员身份更改会自动反映在 GitHub 上,从而减少了手动更新和自定义脚本的需求。 有关详细信息,请参阅 管理组织中的团队同步管理企业中组织的团队同步

最多可以将五个 IdP 组连接到一个 GitHub 团队。 可以将 IdP 组分配给多个 GitHub 团队。

团队同步不支持具有 5000 多个成员的 IdP 组。

团队 GitHub 连接到 IdP 组后,IdP 管理员必须通过标识提供者更改团队成员身份。 您无法在 GitHub 上或通过 API 管理团队成员资格。

如果你的组织由企业帐户拥有,则对企业帐户启用团队同步将覆盖组织级的团队同步设置。 有关详细信息,请参阅“管理企业中组织的团队同步”。

团队同步不是用户预配服务,在大多数情况下不会邀请非成员加入组织。 这意味着只有当用户已经是组织成员时,才会成功地将其添加到团队中。 但是,你可以选择允许团队同步来重新邀请以前是组织成员而后来被删除的用户。 有关详细信息,请参阅 管理组织中的团队同步管理企业中组织的团队同步

通过您的 IdP 进行的所有团队成员变更都会在 GitHub 的审核日志中显示为由团队同步机器人所做的更改。 团队同步将至少每小时一次从您的 IdP 获取组信息,并将 IdP 组成员资格的任何更改同步到 GitHub 中。 将团队连接到 IdP 组可能会删除一些团队成员。 有关详细信息,请参阅同步团队成员的要求

父团队无法与 IdP 组同步。 如果要连接到 IdP 组的团队是父团队,我们建议您创建一个新团队或删除使团队成为父团队的嵌套关系。 有关详细信息,请参阅“关于组织团队”、“创建组织团队”和“在贵公司的组织层次结构中移动一个团队”。

若要管理任何 GitHub 团队(包括与 IdP 组关联的团队)的存储库访问权限,您必须通过 GitHub 进行更改。 有关详细信息,请参阅 关于组织团队管理团队对组织存储库的访问

还可以管理团队与 API 的同步。 有关详细信息,请参阅 用于团队同步的 REST API 终结点

同步工作团队成员的要求

将团队关联到 IdP 组后,团队同步仅会在以下情况下将 IdP 组的每个成员添加到 GitHub 上对应的团队中:

  • 如果不允许团队同步邀请非成员加入组织,则此人已是组织 GitHub成员。
  • 该人员已使用其个人帐户 GitHub 登录,并通过 SAML 单一登录至少一次向组织或企业帐户进行身份验证。
  • 此人的 SSO 身份是 IdP 组的成员。

不符合这些条件的现有团队或组成员将自动从团队 GitHub 中删除,并失去对存储库的访问权限。 撤销用户的关联身份,也会将该用户从映射到 IdP 组的任何团队中移除。 有关详细信息,请参阅 查看和管理成员通过 SAML 对组织的访问权限查看和管理用户对企业的 SAML 访问

删除后的团队成员在使用 SSO 向组织或企业帐户进行身份验证后可以自动添加回团队,并移动到已连接的 IdP 组。

为避免无意中删除团队成员,建议在组织或企业帐户中强制实施 SAML SSO,创建新团队以同步成员资格数据,并在同步现有团队之前检查 IdP 组成员资格。 有关详细信息,请参阅 为您的组织强制执行 SAML 单点登录为企业配置 SAML 单点登录

先决条件

要将 GitHub 上的团队连接到 IdP 组,必须确保该团队已存在于组织中。 即使已配置 SCIM 预配,在 IdP 中创建组也不会自动在 GitHub 上创建团队。

在将 GitHub 团队与 IdP 组关联之前,组织或企业所有者必须为你的组织或企业账户启用团队同步。 有关详细信息,请参阅 管理组织中的团队同步管理企业中组织的团队同步

为避免无意中删除团队成员,请访问 IdP 的管理门户,并确认每个当前团队成员也位于要连接到此团队的 IdP 组中。 如果您没有身份提供程序的这一访问权限,在可以联系 IdP 管理员。

您必须使用 SAML SSO 进行身份验证。 有关详细信息,请参阅“使用单一登录进行身份验证”。

将 IdP 组连接到团队

将 IdP 组连接到 GitHub 团队时,组中的所有用户将自动添加到团队。

  1. 在 GitHub 的右上角,单击个人资料图片,然后单击“ Your organizations”****。

  2. 单击您的组织名称。

  3. 在组织名称下,单击“ Teams”****。

    组织的水平导航栏的屏幕截图。 标有人员图标和“团队”的选项卡以深橙色框出。

  4. 单击团队的名称。

  5. 在团队页面顶部,单击“ Settings”****。

    团队页标题的屏幕截图。 标有齿轮图标和“设置”的选项卡用深橙色标出。

  6. 在“标识提供者组”下,选择“选择组”下拉菜单并单击最多 5 个标识提供者组。

  7. 单击“保存更改”。

断开 IdP 组与团队的连接

  1. 在 GitHub 的右上角,单击个人资料图片,然后单击“ Your organizations”****。

  2. 单击您的组织名称。

  3. 在组织名称下,单击“ Teams”****。

    组织的水平导航栏的屏幕截图。 标有人员图标和“团队”的选项卡以深橙色框出。

  4. 单击团队的名称。

  5. 在团队页面顶部,单击“ Settings”****。

    团队页标题的屏幕截图。 标有齿轮图标和“设置”的选项卡用深橙色标出。

  6. 在“身份提供程序组”下,找到您要断开连接的 IdP 组,然后单击其右侧的

  7. 单击“保存更改”。