Configuring SCIM provisioning for Enterprise Managed Users

You can configure your identity provider to provision new users and manage their membership in your enterprise and teams.

To manage users in your enterprise with your identity provider, your enterprise must be enabled for Enterprise Managed Users, which are available with GitHub Enterprise Cloud. 更多信息请参阅“关于 Enterprise Managed Users”。

About provisioning for Enterprise Managed Users

You can configure provisioning for Enterprise Managed Users to create, manage, and deactivate user accounts for your enterprise members. When you configure provisioning for Enterprise Managed Users, users assigned to the GitHub Enterprise Managed User application in your identity provider are provisioned as new user accounts on GitHub via SCIM, and the users are added to your enterprise.

When you update information associated with a user's identity on your IdP, your IdP will update the user's account on GitHub.com. When you unassign the user from the GitHub Enterprise Managed User application or deactivate a user's account on your IdP, your IdP will communicate with GitHub to invalidate any SAML sessions and disable the member's account. The disabled account's information is maintained and their username is changed to a hash of their original username with the short code appended. If you reassign a user to the GitHub Enterprise Managed User application or reactivate their account on your IdP, the managed user account on GitHub will be reactivated and username restored.

Groups in your IdP can be used to manage team membership within your enterprise's organizations, allowing you to configure repository access and permissions through your IdP. For more information, see "Managing team memberships with identity provider groups."

基本要求

Before you can configure provisioning for Enterprise Managed Users, you must configure SAML single-sign on. For more information, see "Configuring SAML single sign-on for Enterprise Managed Users."

创建个人访问令牌

To configure provisioning for your enterprise with managed users, you need a personal access token with the admin:enterprise scope that belongs to the setup user.

Warning: If the token expires or a provisioned user creates the token, SCIM provisioning may unexpectedly stop working. Make sure that you create the token while signed in as the setup user and that the token expiration is set to "No expiration".

  1. Sign into GitHub.com as the setup user for your new enterprise with the username @SHORT-CODE_admin.
  2. 在任何页面的右上角,单击您的个人资料照片,然后单击 Settings(设置)用户栏中的 Settings 图标
  3. 在左侧边栏中,单击 Developer settings开发者设置
  4. 在左侧边栏中,单击 Personal access tokens(个人访问令牌)个人访问令牌
  5. 单击 Generate new token(生成新令牌)生成新令牌按钮
  6. Under Note, give your token a descriptive name. Screenshot showing the token's name
  7. Select the Expiration drop-down menu, then click No expiration. Screenshot showing token expiration set to no expiration
  8. Select the admin:enterprise scope. Screenshot showing the admin:enterprise scope
  9. 单击 Generate token(生成令牌)生成令牌按钮
  10. To copy the token to your clipboard, click the . 新建的令牌
  11. To save the token for use later, store the new token securely in a password manager.

Configuring provisioning for Enterprise Managed Users

After creating your personal access token and storing it securely, you can configure provisioning on your identity provider.

To configure Azure Active Directory to provision users for your enterprise with managed users, see Tutorial: Configure GitHub Enterprise Managed User for automatic user provisioning in the Azure AD documentation.

To configure Okta to provision users for your enterprise with managed users, see "Configuring SCIM provisioning for Enterprise Managed Users with Okta."

此文档对您有帮助吗?

隐私政策

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或者, 了解如何参与。