关于企业数据域的更改
创建企业时,为企业选择“数据域”,这是企业 URL 中使用的字符串。 例如,如果选择 octo-enterprise 为 slug,则企业 URL GitHub.com 将为 https://github.com/enterprises/octo-enterprise。
如果公司通过信用卡或PayPal付费 GitHub Enterprise Cloud ,则可以更改企业设置中的污点。 更改 slug 时, GitHub 不会从旧 URL 设置任何重定向。 旧的企业数据域将立即可供另一个客户使用。
注意
如果通过发票支付 GitHub Enterprise Cloud 费用,或者企业使用 Enterprise Managed Users,则必须联系 GitHub 的销售团队 以更改企业污点。 对于托管 GHE.com的企业,目前不支持改变企业污点。
更改企业数据域时的注意事项
在更改企业的数据域之前,请确保已考虑企业配置、自动化或流程中可能依赖于旧企业数据域的任何部分。 为了最大程度减少中断,应在更改数据域之前或之后立即解决这些问题。
系统的某些部分可能会因更改数据域而受到影响,但包括但不限于以下几点。
SAML 单一登录 (SSO)
如果在企业级别启用了 SAML 单一登录 (SSO),则需要重新配置标识提供者 (IdP) 中的设置才能使用新的企业数据域。 更改数据域时,将不会撤销现有的 IdP 会话,但在更新 IdP 设置之前,成员将无法使用 SSO 访问企业中的资源。 如果在组织级别启用了 SAML 或 SCIM,则更改数据域不会影响 SSO。 有关详细信息,请参阅“为企业配置 SAML 单点登录”。
在更改数据域之前,为了确保即使在 SSO 不起作用时,你也有权访问企业,我们建议下载企业恢复代码。 有关详细信息,请参阅“下载企业帐户的单一登录恢复代码”。
API 端点
许多用于管理企业的 GitHub API 终结点都将企业 slug 用作参数。 如果在自动化中使用这些终结点,则需要更新 API 调用以使用新的数据域。 使用旧数据域的 API 调用将立即停止工作。 企业 ID(在许多情况下可用作数据域的替代方法)不受数据域更改的影响。
OpenID Connect 与 GitHub Actions 工作流
如果您在 GitHub Actions 工作流中使用 OpenID Connect(OIDC),并且已将云提供商配置为仅接受来自包含您的企业标识符的唯一 URL 的令牌,则需要更新云提供商中的设置。 为了防止工作流失败,最可靠的选项是将提供程序配置为在更改数据域之前接受来自旧数据域和新数据域的令牌。 有关详细信息,请参阅“OpenID Connect”。
GitHub Connect
如果您的企业通过 GitHub Enterprise Server 连接到一个或多个 GitHub Connect 实例,更改 slug 后,您需要先禁用再重新启用 GitHub Connect 以重置连接。 有关详细信息,请参阅文档中的 GitHub Enterprise Server。
更改企业数据域
注意
更改企业短名称之前,请确保你已了解潜在后果。 有关详细信息,请参阅更改企业标识符时的注意事项。
-
导航到您的企业。 例如,从 GitHub.com 上的 公司 页面。
-
在页面顶部,单击“ 设置”。
-
在页面底部的“危险区域”部分中,单击“更改企业 URL 数据域”。
-
在“更改企业 URL 数据域”对话框中,按照说明操作,然后单击“更改企业数据域 URL”。