Há várias maneiras de acessar e reter dados de log de auditoria para sua empresa:
- Interface da Web: exibir a atividade recente nas configurações da empresa. Consulte Exibir o log de auditoria da empresa por meio da interface da Web.
- Exportações JSON/CSV: baixe um arquivo de atividade de log de auditoria. Consulte Como exportar a atividade do log de auditoria da sua empresa.
- Ponto de extremidade da API REST: consultar eventos de log de auditoria programaticamente. Consulte Como usar a API do log de auditoria para sua empresa.
- Streaming para um sistema externo: entregue eventos continuamente a um sistema que os respondentes de incidentes podem acessar e consultar. Consulte Como transmitir o log de auditoria para sua empresa.
Cada método expõe um subconjunto diferente dos dados do log de auditoria. Para obter a lista completa de eventos, consulte Auditar eventos de log para sua empresa.
Dados de log de auditoria disponíveis pelo método de acesso
| Dados disponíveis | Interface web | Exportar JSON/CSV | endpoint da API REST | Streaming para um sistema externo |
|---|---|---|---|---|
| Intervalo de eventos da Web | 180 dias | 180 dias | 180 dias | Determinado pela política de retenção do sistema externo |
| Eventos de solicitação de API | (Se habilitado) | |||
| Eventos do Git | (somente JSON). O log de auditoria mantém os eventos do Git por sete dias. | . O log de auditoria mantém os eventos do Git por sete dias. | ||
| Respostas de logon único (organização e empresa) | ||||
| Execuções de fluxo de trabalho criadas e concluídas | ||||
| Trabalhos de fluxo de trabalho iniciados, incluindo os segredos fornecidos para cada trabalho | ||||
| Executores auto-hospedados online e offline |
Para empresas que usam Enterprise Managed Users, o log de auditoria da empresa também inclui eventos dos usuários. Para obter uma lista desses eventos de usuário, consulte Eventos do log de segurança.
Para reter eventos git além de sua disponibilidade no log de auditoria, salve-os no armazenamento externo antes que eles expirem. Configure o streaming de log de auditoria com antecedência para coletar eventos continuamente.
As exportações de eventos do Git não incluem eventos iniciados por meio da interface da Web ou das APIs REST ou GraphQL. Por exemplo, quando alguém mescla uma solicitação de pull na interface da Web, o push resultante para o branch base está ausente da exportação.
api.request os eventos estão disponíveis somente em logs de auditoria corporativa transmitidos e somente quando a opção de transmitir eventos de solicitação de API tiver sido habilitada. Para obter mais informações, consulte Como transmitir o log de auditoria para sua empresa.
Importante
O streaming de log de auditoria inclui apenas a atividade a partir do momento em que você a habilita. Habilitá-lo durante um incidente não recuperará a atividade anterior.
Preparando-se para uma resposta a incidentes
Habilite o streaming de log de auditoria empresarial, o streaming de eventos de solicitação de API e a divulgação do endereço IP de origem para se preparar para a resposta a incidentes. Sem os três recursos habilitados, os respondentes terão lacunas críticas de visibilidade ao investigar incidentes que afetam sua empresa ou suas organizações. Defina um período de retenção apropriado para os logs transmitidos e verifique se os respondentes de incidentes podem acessá-los.
Para obter instruções de instalação, consulte Como transmitir o log de auditoria para sua empresa, Habilitando o streaming de log de auditoria de solicitações de API e Exibir endereços IP no log de auditoria da sua empresa.
Durante um incidente de segurança, Suporte do GitHub pode responder perguntas sobre recursos e dados disponíveis, mas não investiga em seu nome nem preserva logs para sua investigação. Para obter mais informações, consulte Entender como GitHub Suporte pode ajudar durante um incidente de segurança.
Exibindo o log de auditoria da empresa por meio da interface da Web
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.
- Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
- Na parte superior da página, clique em Configurações.
- Em "Configurações", clique em Audit log.