Skip to main content

Viewing your GitHub Advanced Security usage

You can view usage of GitHub Advanced Security for your enterprise.

Who can use this feature

Enterprise owners can view usage for GitHub Advanced Security.

GitHub Advanced Security 可用于 GitHub Enterprise Cloud 和 GitHub Enterprise Server 上的企业帐户。GitHub Advanced Security 的一些功能也可用于 GitHub.com 上的公共存储库。 有关详细信息,请参阅“关于 GitHub 的产品”。

About licenses for GitHub Advanced Security

GitHub Advanced Security 的每个许可证都规定了可以使用这些功能的最大帐户或席位数量。 您应该定期检查您的使用是否在许可范围之内。 For more information, see "About billing for GitHub Advanced Security."

Viewing GitHub Advanced Security license usage for your enterprise account

You can check how many seats your license includes and how many of them are currently used.

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

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

  3. 在企业帐户侧边栏中,单击 “设置”。 企业帐户侧边栏中的“设置”选项卡

  4. 在左侧边栏中,单击“企业许可”。 企业帐户设置侧边栏中的“企业许可”选项卡

    The "GitHub Advanced Security" section shows details of the current usage. GitHub Advanced Security in enterprise licensing settings If you run out of seats, the section will be red and show "Limit exceeded." You should either reduce your use of GitHub Advanced Security or purchase more seats. For more information, see "About billing for GitHub Advanced Security." GitHub Advanced Security in enterprise licensing settings showing "Limit exceeded"

  5. Optionally, to see a detailed breakdown of usage per organization, in the left sidebar, click Billing. Billing tab in the enterprise account settings sidebar In the "GitHub Advanced Security" section you can see the number of committers and unique committers for each organization. GitHub Advanced Security in enterprise billing settings

  6. Optionally, click the name of an organization where you are an owner to display the security and analysis settings for the organization. Owned organization in GitHub Advanced Security section of enterprise billing settings

  7. On the "Security & analysis" settings page, scroll to the "GitHub Advanced Security repositories" section to see a detailed breakdown of usage by repository for this organization. GitHub Advanced Security repositories section For more information, see "Managing security and analysis settings for your organization."

Downloading GitHub Advanced Security license usage information

You can download a CSV file with GitHub Advanced Security license usage information at both the enterprise and organization levels. The CSV file contains information about each Advanced Security seat that is in use, including:

  • The username of the person using the seat
  • The Advanced Security-enabled repositories where commits were made
  • The organizations that people using seats belong to
  • The most recent commit dates

You can use this information for insights into how your Advanced Security licenses are being used, such as which members of your enterprise are using an Advanced Security seat or how Advanced Security licenses are being consumed across your organizations.

You can download the Advanced Security license usage CSV through the GitHub Enterprise Cloud user interface or the REST API.

Downloading Advanced Security license usage information through the UI

At the organization-level

  1. 在 GitHub.com 的右上角,单击你的个人资料照片,然后单击“你的组织”。 贵组织在配置文件菜单中

  2. 在组织旁边,单击“设置”。 设置按钮

  3. In the "Access" section of the sidebar, click Billing and plans.

  4. Underneath "GitHub Advanced Security," click next to "Committers." Download button for organization-level data

At the enterprise-level

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

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

  3. 在企业帐户侧边栏中,单击 “设置”。 企业帐户侧边栏中的“设置”选项卡

  4. 在左侧边栏中,单击“企业许可”。 企业帐户设置侧边栏中的“企业许可”选项卡

  5. Under "GitHub Advanced Security," click next to "Commiters." Download button for enterprise-level data

Downloading Advanced Security license usage information through the REST API

You can retrieve Advanced Security usage information via the billing API.

For organization-level data, use the /orgs/{org}/settings/billing/advanced-security endpoint. For more information, see "Billing" in the GitHub REST API documentation.

For enterprise-level data, use the /enterprises/{enterprise}/settings/billing/advanced-security endpoint. For more information, see "GitHub Enterprise administration" in the GitHub REST API documentation.