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

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

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

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

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

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

注意： 对于 Visual Studio 订阅者，请参阅“关于包含 GitHub Enterprise 的 Visual Studio 订阅”。

一人占用一个 GitHub Enterprise 许可证，具体取决于特定条件。如果用户尚未接受加入企业的邀请，该用户仍会使用许可证。有关企业中使用许可证的人员的详细信息，请参阅“关于每用户定价”。

对于使用单个席位而不管使用多少部署的每个用户，你必须在 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 上的用户帐户的电子邮件地址进行匹配。如果贵企业在 GitHub.com 上使用或任何企业组织使用 SAML 身份验证或 SCIM 预配，我们首先会检查链接的 SAML 或 SCIM 标识，以查看该标识是否包含以下属性之一。我们会尝试将这些属性的值与每个 GitHub Enterprise Server 用户的主电子邮件地址进行比对。

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

如果没有匹配项，或者 SAML 身份验证或 SCIM 预配未使用，我们会尝试将 GitHub Enterprise Server 上的主电子邮件地址与 GitHub.com 上用户帐户的已验证电子邮件地址进行比对。有关 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_profile	GHEC 上的用户配置文件页的 URL
github_com_user	用户是否在 GHEC 上拥有帐户
github_com_member_roles	对于 GHEC 上用户所属的每个组织，组织名称和用户在该组织中的角色（`Owner` 或 `Member`）由冒号分隔组织由逗号分隔
github_com_enterprise_role	可以是：`Owner`、`Member`、`Outside collaborator`（对于对 GitHub.com 具有个人帐户的企业）或者 `Repository collaborator`（对于对 GitHub.com 使用托管用户帐户的企业）
github_com_verified_domain_emails	与用户的 GHEC 帐户关联且与企业的已验证域匹配的所有电子邮件地址
github_com_saml_name_id	SAML 用户名
github_com_orgs_with_pending_invites	用户 GHEC 帐户加入企业内组织的所有待定邀请
github_com_advanced_security_license_user	用户是否在 GHEC 上使用 GitHub Advanced Security 许可证
license_type	可以是下述之一：`Visual Studio subscription` 或 `Enterprise`
enterprise_server_user	用户是否在 GHES 上至少有一个帐户
enterprise_server_primary_emails	与用户的每个 GHES 帐户关联的主电子邮件地址
enterprise_server_user_ids	对于用户的每个 GHES 帐户，帐户的用户 ID
enterprise_server_advanced_security_user_ids	用户使用 GitHub Advanced Security 的 GHES 实例（仅当使用 GHES 版本 3.12 或更高版本且已启用许可证同步时存在）
total_user_accounts	此人在 GHEC 和 GHES 上拥有的帐户总数
visual_studio_subscription_user	用户是否为 Visual Studio 订阅者
visual_studio_subscription_email	与用户的 VSS 关联的电子邮件地址
visual_studio_license_status	Visual Studio 许可证是否已与 GitHub 用户匹配

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)。可以是以下选项之一：`True` 或 `False`。
许可证	GitHub Enterprise Server 许可证的哈希。
公钥	GitHub Enterprise Server 许可证的公钥部分。
服务器 ID	为 GitHub Enterprise Server 实例生成的 UUID。
版本	GitHub Enterprise Server 实例的版本。

已使用的许可证疑难解答

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

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

注意：为简化故障排除，建议使用与你在 GitHub.com 上的企业帐户相关联的已验证的域。有关详细信息，请参阅“验证或批准您企业的域”。
识别出使用多个席位的用户后，请确保同一电子邮件地址与该用户的所有帐户相关联。有关哪些电子邮件地址必须匹配的详细信息，请参阅“关于已使用的许可证的计算”。
如果电子邮件地址最近进行了更新或验证以解决不匹配问题，请查看上次许可证同步作业的时间戳。如果作业自更正后尚未运行，请手动触发新作业。有关详细信息，请参阅“在 GitHub Enterprise Server 和 GitHub Enterprise Cloud 之间同步许可证使用情况”。

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