Skip to main content

更改企业的 URL

如果你要更改访问企业的 URL,可以更改企业数据域。

谁可以使用此功能?

Enterprise owners can change the URL for the enterprise.

关于企业数据域的更改

创建企业时,为企业选择“数据域”,这是企业 URL 中使用的字符串。 例如,如果选择 octo-enterprise 作为数据域,则企业的 URL 将为 https://github.com/enterprises/octo-enterprise

如果你的公司按信用卡或 PayPal 支付 GitHub Enterprise Cloud 的费用,则可以更改企业设置中的数据域。 更改数据域时,GitHub 不会从旧 URL 设置任何重定向。 旧的企业数据域将立即可供另一个客户使用。

注意: 如果你通过发票支付 GitHub Enterprise Cloud 的费用,或者企业使用 Enterprise Managed Users,则必须联系 GitHub 的销售团队 来更改企业数据域。

更改企业数据域时的注意事项

在更改企业的数据域之前,请确保已考虑企业配置、自动化或流程中可能依赖于旧企业数据域的任何部分。 为了最大程度减少中断,应在更改数据域之前或之后立即解决这些问题。

系统的某些部分可能会因更改数据域而受到影响,但包括但不限于以下几点。

SAML 单一登录 (SSO)

如果在企业级别启用了 SAML 单一登录 (SSO),则需要重新配置标识提供者 (IdP) 中的设置才能使用新的企业数据域。 更改数据域时,将不会撤销现有的 IdP 会话,但在更新 IdP 设置之前,成员将无法使用 SSO 访问企业中的资源。 如果在组织级别启用了 SAML 或 SCIM,则更改数据域不会影响 SSO。 有关详细信息,请参阅“为企业配置 SAML 单点登录”。

在更改数据域之前,为了确保即使在 SSO 不起作用时,你也有权访问企业,我们建议下载企业恢复代码。 有关详细信息,请参阅“下载企业帐户的单一登录恢复代码”。

API 终结点

许多用于管理企业的 GitHub API 终结点将企业数据域作为参数。 如果在自动化中使用这些终结点,则需要更新 API 调用以使用新的数据域。 使用旧数据域的 API 调用将立即停止工作。 企业 ID(在许多情况下可用作数据域的替代方法)不受数据域更改的影响。

包含 GitHub Actions 工作流的 OpenID Connect

如果在 GitHub Actions 工作流中使用 OpenID Connect (OIDC),并且已将云提供商配置为仅接受来自于包含企业数据域的唯一 URL 中的令牌,则需要更新云提供商中的设置。 为了防止工作流失败,最可靠的选项是将提供程序配置为在更改数据域之前接受来自旧数据域和新数据域的令牌。 有关详细信息,请参阅“关于使用 OpenID Connect 进行安全强化”。

GitHub Connect

如果企业通过 GitHub Connect 链接到一个或多个 GitHub Enterprise Server 实例,则在更改数据域后,你需要通过禁用然后重新启用 GitHub Connect 来重置连接。 有关详细信息,请参阅 GitHub Enterprise Server 文档中的“管理 GitHub Connect”。

更改企业数据域

注意: 在更改企业的数据域之前,请确保已了解潜在后果。 有关详细信息,请参阅“更改企业数据域时的注意事项”。

  1. 在 GitHub.com 的右上角,单击你的个人资料照片,然后单击“你的企业”。

  2. 在企业列表中,单击您想要查看的企业。

  3. 在企业帐户边栏中,单击“设置”。

  4. 在页面底部的“危险区域”部分中,单击“更改企业 URL 数据域”。

  5. 在“更改企业 URL 数据域”对话框中,按照说明操作,然后单击“更改企业数据域 URL”。