Skip to main content

Displaying IP addresses in the audit log for your enterprise

You can display the source IP address for events in your enterprise's audit log.

Who can use this feature

Enterprise owners can display IP addresses in the audit log for an enterprise.

About display of IP addresses in the audit log

By default, GitHub Enterprise Cloud does not display the source IP address for events in your enterprise's audit log. Optionally, to ensure compliance and respond to threats, you can display the full IP address associated with the actor responsible for each event. Actors are typically users, but can also be apps or integrations.

You are responsible for meeting any legal obligations that accompany the viewing or storage of IP addresses displayed within your enterprise's audit log.

If you choose to display IP addresses, the IP addresses only appear in your enterprise's audit log. IP addresses will not appear for events in the audit logs for individual organizations owned by your enterprise. For more information about organization audit logs, see "Reviewing the audit log for your organization."

You can display IP addresses in the audit log regardless of which authentication method you use for your enterprise on GitHub.com. For more information, see "About authentication for your enterprise."

When anyone creates an account on GitHub.com, the person agrees to GitHub's collection of basic information about connections to GitHub's services, including source IP address. For more information, see "GitHub Privacy Statement."

Events that display IP addresses in the audit log

GitHub Enterprise Cloud displays an IP address in the audit log when a member of the enterprise interacts with a resource owned by your enterprise or an organization in your enterprise. For example, you will see an IP address for audited events involving an internal or private repository owned by an organization in your enterprise, or resources associated with those repositories, such as an issue, pull request, action, or project.

If members of your enterprise access GitHub.com with personal accounts that they manage, because you do not use Enterprise Managed Users, GitHub Enterprise Cloud does not display an event or IP address in the audit log for the following actions.

  • Authentication to GitHub.com
  • Interactions with a resource owned by the personal account, including a repository, gist, or project
  • Interactions with a public repository owned by an organization in your enterprise

Enabling display of IP addresses in the audit log

  1. No canto superior direito do GitHub.com, clique na foto do seu perfil e em Suas empresas. "Suas empresas" no menu suspenso na foto de perfil no GitHub Enterprise Cloud

  2. Na lista de empresas, clique na empresa que você deseja visualizar. Nome de uma empresa na lista das suas empresas

  3. Na barra lateral da conta corporativa, clique em Configurações. Guia Configurações na barra lateral das contas corporativas

  4. Em " Configurações", clique em Log de auditoria. Guia Log de auditoria na barra lateral da conta corporativa

  5. Under "Audit log", click Source IP disclosure.

    Screenshot of "Source IP disclosure" tab

  6. Under "Disclose actor IP addresses in audit logs", select Enable source IP disclosure.

    Screenshot of checkbox to enable display of IP addresses in audit logs

  7. Click Save.

After you enable the feature, you can access the audit log to view events that include IP addresses. For more information, see "Accessing the audit log for your enterprise."