This version of GitHub Enterprise Server was discontinued on 2024-01-04. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise Server. For help with the upgrade, contact GitHub Enterprise support.

Viewing your GitHub Advanced Security usage

In this article

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.

Important

GitHub Advanced Security is available for enterprise accounts on GitHub Enterprise Cloud and GitHub Enterprise Server. For more information, see "GitHub’s plans."

For information about GitHub Advanced Security for Azure DevOps, see Configure GitHub Advanced Security for Azure DevOps in Microsoft Learn.

About licenses for GitHub Advanced Security

Each license for GitHub Advanced Security specifies a maximum number of licenses that can use these features. Periodically you should check that your use is within your license capacity. For more information, see "About billing for GitHub Advanced Security."

You can estimate the number of licenses your enterprise would need to purchase GitHub Advanced Security or to enable GitHub Advanced Security for additional organizations and repositories. For more information, see "Viewing committer information for GitHub Advanced Security."

Viewing GitHub Advanced Security license usage for your enterprise account

You can view the enterprise account's current license limits and usage.

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    Screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  2. In the enterprise account sidebar, click Settings.

  3. Under Settings, click License. The "GitHub Advanced Security" section shows details of the current usage. You can see the total number of licenses used, as well as a table with the number of committers and unique committers for each organization.

  4. Optionally, display the security and analysis settings for an organization.

    • Click the name of the organization.

    • 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.

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 license that is in use, including:

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

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

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

Downloading Advanced Security license usage information through the UI

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    Screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  2. In the enterprise account sidebar, click Settings.

  3. Under Settings, click License.

  4. Under "GitHub Advanced Security," in the header of the "Committers" table.

Downloading Advanced Security license usage information through the REST API

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

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.