O que são logs de auditoria?
Observação
Webhooks podem ser uma boa alternativa ao log de auditoria ou à pesquisa de API para determinados casos de uso. Os webhooks são uma maneira de o GitHub notificar seu servidor quando houver eventos específicos para um repositório, organização ou empresa. Em comparação com a API ou com a pesquisa de log de auditoria, os webhooks podem ser mais eficientes se você quiser apenas conhecer e, possivelmente, registrar quando determinados eventos ocorrerem em sua empresa, organização ou repositório. Confira Documentação de Webhooks.
O log de auditoria lista os eventos disparados por atividades que afetam sua empresa nos últimos 180 dias. O log de auditoria mantém os eventos do Git por sete dias.
Por padrão, são exibidos apenas os eventos dos últimos três meses. Para ver eventos mais antigos, você deve especificar um intervalo de datas com o parâmetro created. Confira Noções básicas de sintaxe de pesquisa.
O nome de cada entrada do log de auditoria é composto por uma categoria de eventos, seguida de um tipo de operação. Por exemplo, a entrada repo.create refere-se à operação create na categoria repo.
Cada entrada do log de auditoria mostra informações aplicáveis sobre um evento, como:
- A empresa ou organização em que uma ação foi executada em
- O usuário (ator) que executou a ação
- O usuário afetado pela ação
- Em qual repositório uma ação foi executada
- A ação que foi executada
- Em que país a ação foi executada
- A data e a hora em que a ação ocorreu
- A identidade SSO do SAML e SCIM do usuário (ator) que executou a ação
- Para ações fora da UI da Web, como o usuário (ator) se autenticou
- Opcionalmente, o endereço IP de origem para o usuário (ator) que executou a ação
Além de exibir seus logs do auditoria, você pode monitorar a atividade na sua empresa de outras maneiras, como gerenciar webhooks globais. Para saber mais, confira Como explorar a atividade do usuário na sua empresa. Você também pode usar o log de auditoria e outras ferramentas a fim de monitorar as ações executadas em resposta a alertas de segurança. Para saber mais, confira Alertas de segurança de auditoria.
Como usar logs de auditoria
Como proprietário do site, você pode interagir com os dados de log de auditoria para sua empresa de várias maneiras:
- Veja o log de auditoria da sua empresa. Para saber mais, confira Como acessar o log de auditoria da sua empresa.
- Você pode pesquisar no log de auditoria eventos específicos e exportar dados de log de auditoria. Para obter mais informações, consulte Como fazer pesquisas no log de auditoria para sua empresa e Como exportar a atividade do log de auditoria da sua empresa.
- Você pode identificar todos os eventos que foram executados por um token de acesso específico. Para obter mais informações, consulte Identificar eventos de log de auditoria executados por um token de acesso.
- Você pode ver o endereço IP associado aos eventos no log de auditoria. Para saber mais, confira Exibir endereços IP no log de auditoria da sua empresa.
- Você pode transmitir dados de eventos de auditoria e do Git de GitHub para um sistema externo de gerenciamento de dados. Para saber mais, confira Como transmitir o log de auditoria para sua empresa.
- Use a API de Log de auditoria para ver as ações executadas na sua empresa. Para saber mais, confira Como usar a API do log de auditoria para sua empresa.
Para ver a lista completa das ações do log de auditoria que podem ser exibidas no log de auditoria da empresa, confira Auditar eventos de log para sua empresa.