教程：为 GitHub 配置自动用户预配
本教程旨在展示自动预配 GitHub Enterprise Cloud 组织成员身份时需要在 GitHub 和 Microsoft Entra ID 中执行的步骤。
注意
Microsoft Entra 预配集成依赖于可供 GitHub Enterprise Cloud 客户在 GitHub Enterprise 计费计划中使用的 GitHub SCIM API。
先决条件
在本教程中概述的方案假定您已具有以下各项：
- 一个 Microsoft Entra 租户
- 一家在 GitHub 企业云（需要 GitHub Enterprise 计费计划）中创建的 GitHub 组织
- GitHub 中具有组织的管理员权限的用户帐户
- 为 GitHub Enterprise Cloud 组织配置的 SAML
- 请确保已为组织提供 OAuth 访问权限，如此处所述
- 仅在组织级别启用 SSO 时，才支持单个组织的 SCIM 预配
注意
此集成也可以通过 Microsoft Entra 美国政府云环境使用。 你可以在“Microsoft Entra 美国政府云应用程序库”中找到此应用程序，并以公有云相同的方式对其进行配置。
将用户分配到 GitHub
Microsoft Entra ID 使用名为“分配”的概念来确定哪些用户应收到对所选应用的访问权限。 在自动用户帐户预配的上下文中，只同步已“分配”到 Microsoft Entra ID 中的应用程序的用户和组。
在配置和启用预配服务之前，需要确定 Microsoft Entra ID 中哪些用户和/或组表示需要访问 GitHub 组织的用户。 确定后，可以按照此处的说明分配这些用户：
有关详细信息，请参阅向企业应用分配用户或组。
将用户分配到 GitHub 的重要提示
建议将单个 Microsoft Entra 用户分配到 GitHub 以测试预配配置。 其他用户和/或组可以稍后分配。
如果将用户分配到 GitHub，必须在分配对话框中选择“用户”角色或其他特定于应用程序的有效角色（如果有）。 “默认访问权限”角色不可用于预配，将跳过这些用户。
为 GitHub 配置用户预配
本部分会指导你将 Microsoft Entra ID 连接到 GitHub 的 SCIM 预配 API，来自动预配 GitHub 组织成员身份。 此集成利用 OAuth 应用，可根据 AMicrosoft Entra ID 中的用户和组分配自动添加、管理和移除成员对 GitHub Enterprise Cloud 组织的访问权限。 当通过 SCIM 将用户预配到 GitHub 组织时，将向用户的电子邮件地址发送电子邮件邀请。
在 Microsoft Entra ID 中配置 GitHub 的自动用户帐户预配
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到“标识”>“应用程序”>“企业应用程序”。
如果已为 GitHub 配置单一登录，请使用搜索字段搜索 GitHub 实例。
选择 GitHub 实例，并选择“预配”选项卡。
将“预配模式”设置为“自动”。
在 Azure 门户中，输入“租户 URL”字段并单击“测试连接”，确保 Microsoft Entra ID 可以连接到 GitHub 组织。 如果连接失败，请确保 GitHub 帐户具有管理员权限，且输入的“租户 URL”正确无误，然后再次尝试“授权”步骤（可以按规则：
https://api.github.com/scim/v2/organizations/<Organization_name>来编写“租户 URL”，可在 GitHub 帐户：“设置”>“组织”下找到你的组织）。
在“管理员凭据”部分下，单击“授权”。 此操作将在新的浏览器窗口中打开“GitHub 授权”对话框。 请注意，需要确保已获得批准可以进行访问授权。 按照此处的说明进行操作。
在新窗口中，使用管理员帐户登录到 GitHub。 在显示的授权对话框中，选择要启用预配的 GitHub 组织，然后选择“授权”。 完成后，返回到 Azure 门户完成预配配置。
在“通知电子邮件”字段中输入应接收预配错误通知的个人或组的电子邮件地址，并选中复选框“发生故障时发送电子邮件通知”。
单击“保存” 。
在“映射”部分下，选择“将 Microsoft Entra 用户同步到 GitHub”。
在“属性映射”部分，查看从 Microsoft Entra ID 同步到 GitHub 的用户属性。 选为“匹配”属性的特性用于匹配 GitHub 中的用户帐户以执行更新操作。 请勿为“预配”部分中的其他默认属性启用“匹配优先级”设置，因为可能会发生错误。 选择“保存”，提交所有更改。
若要为 GitHub 启用 Microsoft Entra 预配服务，请在“设置”部分将“预配状态”更改为“开”。
单击“保存” 。
此操作会对“用户和组”部分中分配到 GitHub 的任何用户和/或组启动初始同步。 初始同步执行的时间比后续同步长，只要服务正在运行，大约每隔 40 分钟就会进行一次同步。 可以使用“同步详细信息”部分监视进度并跟踪指向预配活动日志的链接，这些日志描述了预配服务执行的所有操作。
要详细了解如何读取 Microsoft Entra 预配日志，请参阅有关自动用户帐户预配的报告。