Viewing your GitHub Advanced Security usage

About licenses for GitHub Advanced Security

Cada licença de GitHub Advanced Security especifica um número máximo de contas, ou estações, que podem usar essas funcionalidades. Periodicamente você deve verificar que sua utilização está dentro da sua capacidade de licença. 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. No canto superior direito do GitHub.com, clique na foto do seu perfil e em Suas empresas.

2. Na lista de empresas, clique na empresa que você deseja visualizar.

3. Na barra lateral da conta corporativa, clique em Configurações.

4. Na barra lateral esquerda, clique em Licenciamento do Enterprise.

   The "GitHub Advanced Security" section shows details of the current usage. 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."

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

6. Optionally, click the name of an organization where you are an owner to display the security and analysis settings for the organization.

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. 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. No canto superior direito do GitHub.com, clique na foto do seu perfil e clique em Suas organizações.

2. Ao lado da organização, clique em Configurações.

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

4. Underneath "GitHub Advanced Security," click CSV report next to "Committers."

At the enterprise-level

1. No canto superior direito do GitHub.com, clique na foto do seu perfil e em Suas empresas.

2. Na lista de empresas, clique na empresa que você deseja visualizar.

3. Na barra lateral da conta corporativa, clique em Configurações.

4. Na barra lateral esquerda, clique em Licenciamento do Enterprise.

5. Under "GitHub Advanced Security," click CSV report next to "Committers."

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.