Skip to main content

此版本的 GitHub Enterprise 将停止服务 2022-09-28. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

GitHub Enterprise 许可证使用情况疑难解答

你可以通过审核许可证报告来排查企业的许可证使用情况问题。

Who can use this feature

Enterprise owners can review license usage for GitHub Enterprise.

关于意外的许可证使用情况

如果企业使用的许可证数量出现异常,你可以查看已使用的许可证报告以审核整个企业部署和订阅中的许可证使用情况。 有关详细信息,请参阅“查看 GitHub Enterprise 的许可证使用情况”和“查看企业帐户的订阅和使用情况”。

如果发现错误,可以尝试执行故障排除步骤。

出于隐私原因,除非使用 Enterprise Managed Users,否则企业所有者无法直接访问用户帐户的详细信息。

关于已使用的许可证的计算

GitHub 会对以下每个人员计费:使用 GitHub Enterprise Server 的部署;为 GitHub Enterprise Cloud 上的其中一个组织的成员;为 Visual Studio subscriber。 有关企业中使用许可证的人员的详细信息,请参阅“关于每用户定价”。

对于使用单个席位而不管使用多少部署的每个用户,你必须在 GitHub Enterprise Server 和 GitHub Enterprise Cloud 之间同步许可证使用情况。 有关详细信息,请参阅“同步 GitHub Enterprise Server 和 GitHub Enterprise Cloud 之间的许可证使用情况”。

同步许可证使用情况后,GitHub 会按电子邮件地址将 GitHub Enterprise Server 上的用户帐户与 GitHub Enterprise Cloud 上的用户帐户进行匹配。

首先,我们先检查 GitHub Enterprise Server 上每个用户的主电子邮件地址。 然后尝试将该地址与 GitHub Enterprise Cloud 上的用户帐户的电子邮件地址进行匹配。 如果企业使用 SAML SSO,我们首先检查电子邮件地址的以下 SAML 属性。

  • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
  • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
  • username
  • NameID
  • emails

如果在这些属性中找不到与 GitHub Enterprise Server 上的主电子邮件地址匹配的电子邮件地址,或如果企业不使用 SAML SSO,则我们将在 GitHub Enterprise Cloud 上检查该用户的每个已验证的电子邮件地址。 有关 GitHub.com 上的电子邮件地址验证的详细信息,请参阅 GitHub Enterprise Cloud 文档中的“验证电子邮件地址”。

已使用的许可证文件中的字段

GitHub.com 许可证使用情况报告和 GitHub Enterprise Server 导出的许可证使用情况文件包含各种字段,可帮助你排查企业的许可证使用情况的问题。

GitHub.com 许可证使用情况报告(CSV 文件)

企业的许可证使用情况报告是一个 CSV 文件,其中包含有关企业成员的以下信息。 某些字段特定于 GitHub Enterprise Cloud (GHEC) 部署、GitHub Enterprise Server (GHES) 通连环境或带有 GitHub Enterprise 的 Visual Studio 订阅 (VSS)。

字段说明
github_com_login用户的 GHEC 帐户的用户名
github_com_name用户的 GHEC 帐户的显示名称
github_com_profileGHEC 上的用户配置文件页的 URL
github_com_user用户是否在 GHEC 上拥有帐户
github_com_member_roles对于 GHEC 上用户所属的每个组织,组织名称和用户在该组织中的角色(OwnerMember)由冒号分隔

组织由逗号分隔
github_com_enterprise_role可以是下述之一:OwnerMemberOutside collaborator
github_com_verified_domain_emails与用户的 GHEC 帐户关联且与企业的已验证域匹配的所有电子邮件地址
github_com_saml_name_idSAML 用户名
github_com_orgs_with_pending_invites用户 GHEC 帐户加入企业内组织的所有待定邀请
license_type可以是下述之一:Visual Studio subscriptionEnterprise
enterprise_server_user用户是否在 GHES 上至少有一个帐户
enterprise_server_primary_emails与用户的每个 GHES 帐户关联的主电子邮件地址
enterprise_server_user_ids对于用户的每个 GHES 帐户,帐户的用户 ID
total_user_accounts此人在 GHEC 和 GHES 上拥有的帐户总数
visual_studio_subscription_user用户是否为 Visual Studio subscriber
visual_studio_subscription_email与用户的 VSS 关联的电子邮件地址
visual_studio_license_statusVisual Studio 许可证是否已与 GitHub 用户匹配

尚未成为企业中至少一个组织的成员的 Visual Studio subscriber将包含在此报告中,为待定邀请状态,并且将缺少“名称”或“个人资料链接”字段的值。

GitHub Enterprise Server 导出的许可证使用情况(JSON 文件)

GitHub Enterprise Server 许可证使用情况是一个 JSON 文件,通常是在 GitHub Enterprise Server 和 GitHub Enterprise Cloud 部署之间执行手动用户许可证同步时会用到。 此文件包含特定于 GitHub Enterprise Server 环境的以下信息。

字段说明
功能在 GitHub Enterprise Server 实例上启用的 GitHub Connect 功能,以及启用的日期和时间。
主机名GitHub Enterprise Server 实例的主机名。
仅 HTTP是否在 GitHub Enterprise Server 实例上启用并配置了传输层安全性 (TLS)。 可以是以下选项之一:TrueFalse
许可证GitHub Enterprise Server 许可证的哈希。
公钥GitHub Enterprise Server 许可证的公钥部分。
服务器 ID为 GitHub Enterprise Server 实例生成的 UUID。
版本GitHub Enterprise Server 实例的版本。

已使用的许可证疑难解答

要确保每个用户只使用单个席位进行不同的部署和订阅,请尝试以下故障排除步骤。

  1. 为帮助识别使用多个席位的用户,如果你的企业对 GitHub Enterprise Cloud 使用已验证的域,请查看企业成员的电子邮件地址不是来自与他们 GitHub.com 帐户关联的已验证域的企业成员列表。 通常,这些是错误使用了多个许可的席位的用户。 有关详细信息,请参阅“查看电子邮件地址不是来自已验证的域的成员”。

    注意:为简化故障排除,建议使用与你在 GitHub.com 上的企业帐户相关联的已验证的域。 有关详细信息,请参阅“验证或批准企业的域”。

  2. 识别出使用多个席位的用户后,请确保同一电子邮件地址与该用户的所有帐户相关联。 有关哪些电子邮件地址必须匹配的详细信息,请参阅“关于已使用的许可证的计算”。

  3. 如果电子邮件地址最近进行了更新或验证以解决不匹配问题,请查看上次许可证同步作业的时间戳。 如果作业自更正后尚未运行,请手动触发新作业。 有关详细信息,请参阅“在 GitHub Enterprise Server 和 GitHub Enterprise Cloud 之间同步许可证使用情况”。

如果在看完上述故障排除信息后仍对已使用的许可证有任何问题,可以通过 GitHub 支持门户联系 GitHub 支持。