使用 Okta 为企业配置身份验证和预配

Note: GitHub AE single sign-on (SSO) support for Okta is currently in beta.

关于 SAML 和 SCIM 与 Octa

您可以使用 Okta 作为 GitHub AE 的身份提供程序 (IdP)，这允许您的 Okta 用户使用其 Okta 凭据登录到 GitHub AE。

要使用 Okta 作为 GitHub AE 的 IdP，您可以将 GitHub AE 应用程序添加到 Okta，将 Okta 配置为您在 GitHub AE 中的 IdP，然后为 Okta 用户和组预配访问权限。

以下预配功能可用于分配给 GitHub AE 应用程序的所有 Okta 用户。

功能	描述
推送新用户	在 Okta 中创建新用户时，该用户将添加到 GitHub AE。
推送用户停用	当您在 Okta 中停用用户时，将从您在 GitHub AE 上的企业暂停该用户。
推送个人资料更新	当您在 Okta 中更新用户的个人资料时，它将更新您在 GitHub AE 上的企业中该用户成员身份的元数据。
重新激活用户	当您在 Okta 中重新激活用户时，它将在 GitHub AE 上取消暂停企业中的用户。

In the Okta Dashboard, expand the Applications menu, then click Applications.
单击 Browse App Catalog（浏览应用程序目录）
在搜索字段中，键入“GitHub AE”，然后单击结果中的 GitHub AE。
单击 Add（添加）。
对于“基本 URL”，请键入您在 GitHub AE 上的企业的 URL。
单击 Done（完成）。

要为 GitHub AE 启用单点登录 (SSO)，必须配置 GitHub AE 使用 Okta 提供的登录 URL、颁发者 URL 和公共证书。您可以在“GitHub AE”应用程序中找到这些详细信息。

In the Okta Dashboard, expand the Applications menu, then click Applications.
Click on the GitHub AE app.
单击 Sign On（登录）。
单击 View Setup Instructions（查看设置说明）。
记下“登录 URL”、“颁发者”和“公共证书”详细信息。
使用详细信息为您在 GitHub AE 上的企业启用 SAML SSO。更多信息请参阅“配置企业的 SAML 单点登录”。

注意：要从 GitHub AE 测试 SAML 配置，必须将 Okta 用户帐户分配给 GitHub AE 应用程序。

Okta 中的“GitHub AE”应用程序使用 GitHub AE API 与 SCIM 和 SSO 的企业进行交互。此过程说明如何通过使用 GitHub AE 的个人访问令牌配置 Okta 来启用和测试对 API 的访问。

在 GitHub AE 中，生成具有 admin:enterprise 范围的个人访问令牌。更多信息请参阅“创建个人访问令牌”。
In the Okta Dashboard, expand the Applications menu, then click Applications.
Click on the GitHub AE app.
单击 Provisioning（配置）。
单击 Configure API Integration（配置 API 集成）。
选择 Enable API integration（启用 API 集成）。
对于“"API Token（API 令牌）”，键入之前生成的 GitHub AE 个人访问令牌。
单击 Test API Credentials（测试 API 凭据）。

注意： 如果看到 Error authenticating: No results for users returned（身份验证错误：未返回用户结果），请确认已为 GitHub AE 启用 SSO。更多信息请参阅“为 GitHub AE 启用 SAML SSO”。

此过程演示如何为 Okta 预配配置 SCIM 设置。这些设置定义了在自动将 Okta 用户帐户设置为 GitHub AE 时将使用哪些功能。

In the Okta Dashboard, expand the Applications menu, then click Applications.
Click on the GitHub AE app.
单击 Provisioning（配置）。
在“Settings（设置）”下，单击 To App（到应用程序）。
在“Provisioning to App（配置到 App）”的右侧，单击 Edit（编辑）。
在“Create Users（创建用户）”的右侧，选择 Enable（启用）。
在“Update User Attributes（更新用户属性）”的右侧，选择 Enable（启用）。
在“Deactivate Users（停用用户）”的右侧，选择 Enable（启用）。
单击 Save（保存）。

您可以为单个 Okta 用户或整个组预配对 GitHub AE 的访问权限。

在 Okta 用户可以使用其凭据登录到 GitHub AE 之前，您必须将用户分配到 Okta 中的“GitHub AE”应用程序。

In the Okta Dashboard, expand the Applications menu, then click Applications.
Click on the GitHub AE app.
单击 Assignments（分配）。
选择 Assign（分配）下拉菜单，然后单击 Assign to People（分配给人员）。
在所需用户帐户的右侧，单击 Assign（分配）。
在“Role（角色）”右侧，单击用户的角色，然后单击 Save and go back（保存并返回）。
单击 Done（完成）。