Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Como transmitir o log de auditoria para sua empresa

Você pode transmitir dados de auditoria e eventos do Git de GitHub para um sistema externo de gerenciamento de dados.

Quem pode usar esse recurso

Enterprise owners can configure audit log streaming.

Observação: o straming de log de auditoria está em versão beta no momento para GitHub Enterprise Server e está sujeito a alterações.

Sobre a transmissão do log de auditoria

Para ajudar a proteger sua propriedade intelectual e manter a conformidade para sua organização, você pode usar o streaming para manter cópias dos dados do log de auditoria e monitore: * O acesso às configurações da organização ou do repositório

  • As alterações nas permissões
  • Os usuários adicionados ou removidos em uma organização, um repositório ou uma equipe
  • Os usuários promovidos para administradores
  • Alterações nas permissões de um GitHub App

Os benefícios do streaming de dados de auditoria incluem:

  • Exploração de dados. Você pode examinar eventos transmitidos usando sua ferramenta preferida para consultar grandes quantidades de dados. O streaming contém eventos de auditoria e do Git em toda a conta corporativa.
  • Retenção de dados. Você pode manter os logs de auditoria e os dados de eventos do Git exportados o tempo necessário.

Os proprietários empresariais podem configurar ou excluir um fluxo a qualquer momento. O streaming exporta os dados de auditoria e de eventos do Git para todas as organizações da sua empresa.

Observação: todos os logs de auditoria são transmitidos no formato JSON.

Configurando a transmissão do log de auditoria

Você configurou o fluxo do log de auditoria em GitHub Enterprise Server seguindo as instruções do seu provedor.

Configurando a transmissão para o Amazon S3

Para transmitir os logs de auditoria para o ponto de extremidade do Amazon S3, você deve ter um bucket e chaves de acesso. Para obter mais informações, confira Como criar, configurar e trabalhar com buckets do Amazon S3 na documentação da AWS. Certifique-se de bloquear o acesso público ao bucket para proteger as suas informações de log de auditoria.

Para configurar a tarnsmissão do de log de auditoria de GitHub você vai precisar:

  • O nome do seu bucket do Amazon S3
  • Seu ID de acesso ao AWS
  • Sua chave de segredo para o AWS

Para obter informações sobre como criar ou acessar a ID da chave de acesso e a chave secreta, confira Noções básicas e obtenção das suas credenciais da AWS na documentação da AWS.

  1. No canto superior à direita de GitHub Enterprise Server, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub Enterprise Server 1. Na barra lateral da conta corporativa, clique em Configurações. Guia Configurações na barra lateral das contas corporativas 1. Em " Configurações", clique em Log de auditoria. Guia Log de auditoria na barra lateral da conta corporativa

  2. Em "Log de auditoria", clique em Streaming de log. 1. Selecione a lista suspensa Configurar fluxo e clique em Amazon S3.

    Escolha o Amazon S3 no menu suspenso

  3. Defina as configurações de fluxo.

    • Em "Bucket", digite o nome do bucket de destino da transmissão. Por exemplo, auditlog-streaming-test.
    • Em "ID da Chave de Acesso", digite a ID da chave de acesso. Por exemplo, ABCAIOSFODNN7EXAMPLE1.
    • Em "Chave Secreta", digite a chave secreta. Por exemplo, aBcJalrXUtnWXYZ/A1MDENG/zPxRfiCYEXAMPLEKEY.
  4. Para verificar se o GitHub pode se conectar ao ponto de extremidade do Amazon S3 e fazer gravações nele, clique em Verificar ponto de extremidade.

    Verificar o ponto de extremidade 1. Depois de verificar com êxito o ponto de extremidade, clique em Salvar.

Configurando a transmissão para o Azure Blob Storage

Antes de configurar uma transmissão em GitHub, você deve primeiro ter criado uma conta de armazenamento e um contêiner no Microsoft Azure. Para obter detalhes, confira a documentação da Microsoft: "Introdução ao Armazenamento de Blobs do Azure".

Para configurar a transmissão em GitHub, você precisa da URL de um token SAS.

No portal do Microsoft Azure:

  1. Na Página Inicial, clique em Contas do Armazenamento.

  2. Clique no nome da conta de armazenamento que deseja usar e clique em Contêineres.

    O link dos contêineres no Azure

  3. Clique no nome do contêiner que você deseja usar.

  4. Clique em Tokens de acesso compartilhado.

    O link do token de acesso compartilhado no Azure

  5. No menu suspenso Permissões, altere as permissões para permitir apenas Create e Write.

    Menu suspenso de permissões

  6. Defina uma data de validade que esteja em conformidade com sua política de rotação de segredo.

  7. Clique em Gerar token SAS e URL.

  8. Copie o valor do campo URL SAS de Blob exibido. Você usará este URL em GitHub.

No GitHub : 1. No canto superior à direita de GitHub Enterprise Server, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub Enterprise Server 1. Na barra lateral da conta corporativa, clique em Configurações. Guia Configurações na barra lateral das contas corporativas 1. Em " Configurações", clique em Log de auditoria. Guia Log de auditoria na barra lateral da conta corporativa

  1. Em "Log de auditoria", clique em Streaming de log.

  2. Clique em Configurar fluxo e selecione Armazenamento de Blobs do Azure.

    Escolha o Azure Blob Storage a partir do menu suspenso

  3. Na página de configuração, insira a URL do SAS do blob que você copiou no Azure. O campo Contêiner é preenchido automaticamente com base na URL.

    Insira as configurações de transmissão

  4. Clique em Verificar ponto de extremidade para verificar se o GitHub pode se conectar ao ponto de extremidade do Armazenamento de Blobs do Azure e fazer gravações nele.

    Verificar o ponto de extremidade

  5. Depois de verificar com êxito o ponto de extremidade, clique em Salvar.

Configurando a transmissão para os Centros de Evento do Azure

Antes de configurar uma transmissão em GitHub, primeiro você deve ter o namespace do centro de um evento no Microsoft Azure. Em seguida, você deve criar uma instância do centro de um evento dentro do namespace. Você precisará das informações da instância do centro desse evento ao configurar a transmissão. Para obter detalhes, confira a documentação da Microsoft: "Guia de Início Rápido: Criar um hub de eventos usando o portal do Azure".

Você precisa de duas informações sobre seu centro de eventos: o nome da sua instância e a sequência de caracteres de conexão.

No portal do Microsoft Azure:

  1. Pesquise "Centros de Evento".

    Caixa de pesquisa do portal Azure

  2. Selecione a opção Hubs de Eventos. Os nomes dos centros de eventos serão listados.

    Uma lista de centros de eventos

  3. Faça uma observação do nome do centro do evento para o qual você deseja transmitir.

  4. Clique no centro de eventos necessário. Em seguida, no menu à esquerda, selecione Políticas de Acesso Compartilhado.

  5. Selecione uma política de acesso compartilhada na lista de políticas ou crie uma nova política.

    Uma lista de políticas de acesso compartilhadas

  6. Clique no botão à direita do campo Chave primária da cadeia de conexão para copiar a cadeia de conexão.

    A string de conexão do centro do evento

No GitHub : 1. No canto superior à direita de GitHub Enterprise Server, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub Enterprise Server 1. Na barra lateral da conta corporativa, clique em Configurações. Guia Configurações na barra lateral das contas corporativas 1. Em " Configurações", clique em Log de auditoria. Guia Log de auditoria na barra lateral da conta corporativa

  1. Em "Log de auditoria", clique em Streaming de log.

  2. Clique em Configurar fluxo e selecione Hubs de Eventos do Azure.

    Selecione Centro de Eventos do Azure no menu suspenso

  3. Na página de configuração, insira:

    • O nome da instância do Centro de Eventos do Azure.
    • A cadeia de conexão.

    Insira as configurações de transmissão

  4. Clique em Verificar ponto de extremidade para verificar se o GitHub pode se conectar ao ponto de extremidade do Hub de Eventos do Azure e fazer gravações nele.

    Verificar o ponto de extremidade

  5. Depois de verificar com êxito o ponto de extremidade, clique em Salvar.

Configurando a transmissão para o Google Cloud Storage

Para configurar a transmissão para o Google Cloud Storage, você deve criar uma conta de serviço no Google Cloud com as credenciais e permissões apropriadas e, em seguida, configurar a transmissão do log de auditoria em GitHub Enterprise Server usando as credenciais da conta de serviço para autenticação.

  1. Crie uma conta de serviço para o Google Cloud. Você não precisa definir os controles de acesso ou as funções do IAM para a conta de serviço. Para obter mais informações, confira Como criar e gerenciar contas de serviço na documentação do Google Cloud.

  2. Crie uma chave JSON para a conta do serviço, e armazene a chave com segurança. Para obter mais informações, confira Como criar e gerenciar chaves de conta de serviço na documentação do Google Cloud.

  3. Se você ainda não criou um nucket, crie-o. Para obter mais informações, confira Como criar buckets de armazenamento na documentação do Google Cloud.

  4. Dê à conta de serviço a função do Storage Object Creator para o bucket. Para obter mais informações, confira Como usar permissões de IAM de Nuvem na documentação do Google Cloud.

  5. No canto superior à direita de GitHub Enterprise Server, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub Enterprise Server 1. Na barra lateral da conta corporativa, clique em Configurações. Guia Configurações na barra lateral das contas corporativas 1. Em " Configurações", clique em Log de auditoria. Guia Log de auditoria na barra lateral da conta corporativa

  6. Em "Log de auditoria", clique em Streaming de log.

  7. Selecione o menu suspenso Configurar fluxo e clique em Google Cloud Storage.

    Captura de tela do menu suspenso "Configurar fluxo"

  8. Em "Bucket", digite o nome do seu bucket do Google Cloud Storage.

    Captura de tela do campo de texto "Bucket"

  9. Em "Credenciais do JSON ", cole todo o conteúdo do arquivo para a chave do JSON da sua conta de serviço.

    Captura de tela do campo de texto "Credenciais JSON"

  10. Para verificar se o GitHub pode se conectar ao bucket do Google Cloud Storage e fazer gravações nele, clique em Verificar ponto de extremidade.

    Captura de tela do botão "Verificar ponto de extremidade"

  11. Depois de verificar com êxito o ponto de extremidade, clique em Salvar.

Configurando a transmissão para o Splunk

Para transmitir os logs de auditoria para o Coletor de Eventos HTTP (HEC) do Splunk, você deverá garantir que o ponto de extremidade esteja configurado para aceitar conexões HTTPS. Para obter mais informações, confira Configurar e usar o Coletor de Eventos HTTP no Splunk Web na documentação do Splunk.

  1. No canto superior à direita de GitHub Enterprise Server, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub Enterprise Server 1. Na barra lateral da conta corporativa, clique em Configurações. Guia Configurações na barra lateral das contas corporativas 1. Em " Configurações", clique em Log de auditoria. Guia Log de auditoria na barra lateral da conta corporativa

  2. Em "Log de auditoria", clique em Streaming de log.

  3. Clique em Configurar fluxo e selecione Splunk.

    Escolha Splunk no menu suspenso

  4. Na página de configuração, insira:

    • O domínio para o qual o aplicativo deseja que você transmita está hospedado.

      Se você estiver usando o Splunk Cloud, Domain deverá ser http-inputs-<host>, em que host é o domínio que você usa no Splunk Cloud. Por exemplo: http-inputs-mycompany.splunkcloud.com.

    • A porta sobre a qual o aplicativo aceita dados.

      Se você estiver usando o Splunk Cloud, Port deverá ser 443, se você não tiver alterado a configuração da porta. Se você estiver usando a versão de avaliação gratuita do Splunk Cloud, Port deverá ser 8088.

    • Um token que GitHub pode usar para efetuar a autenticação no aplicativo de terceiros.

    Insira as configurações de transmissão

  5. Mantenha a caixa de seleção Habilitar verificação SSL marcada.

    Os logs de auditoria são sempre transmitidos como dados criptografados. No entanto, com esta opção selecionada, GitHub verifica o certificado SSL da sua instância do Splunk ao realizar os eventos. A verificação SSL ajuda a garantir que os eventos sejam entregues no ponto de extremidade da sua URL de forma segura. Você pode limpar a seleção desta opção, mas recomendamos que saia da verificação SSL habilitada.

  6. Clique em Verificar ponto de extremidade para verificar se o GitHub pode se conectar ao ponto de extremidade do Splunk e fazer gravações nele. Verificar o ponto de extremidade 1. Depois de verificar com êxito o ponto de extremidade, clique em Salvar.

Excluindo a transmissão do log de auditoria

  1. No canto superior à direita de GitHub Enterprise Server, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub Enterprise Server 1. Na barra lateral da conta corporativa, clique em Configurações. Guia Configurações na barra lateral das contas corporativas 1. Em " Configurações", clique em Log de auditoria. Guia Log de auditoria na barra lateral da conta corporativa

  2. Em "Log de auditoria", clique em Streaming de log.

  3. Clique em Excluir fluxo.

    Excluir a transmissão

  4. Uma mensagem de confirmação é exibida. Clique em Excluir fluxo para confirmar.