Skip to main content

Exibindo e filtrando alertas da varredura de segredos

Saiba como encontrar e filtrar verificação de segredo alertas para seu repositório.

Quem pode usar esse recurso?

People with admin access to a repository can view verificação de segredo alerts for the repository.

A Secret scanning estará disponível para os repositórios pertencentes a uma organização no GitHub Enterprise Server se a sua empresa tiver uma licença do GitHub Advanced Security. Para obter mais informações, confira "Sobre alertas secretos de verificação" e "Sobre a Segurança Avançada do GitHub".

Sobre a página de alertas do secret scanning

Quando você habilita a secret scanning para um repositório ou envia commits por push a um repositório com a secret scanning habilitada, o GitHub verifica o conteúdo em busca de segredos que correspondam aos padrões definidos pelos provedores de serviço e aos padrões personalizados definidos na empresa, na organização ou no repositório.

Quando a secret scanning detectar um segredo, o GitHub gerará um alerta. GitHub exibe um alerta na guia Segurança do repositório.

Para ajudar você a fazer a triagem de alertas com mais eficiência, o GitHub separa os alertas em duas listas:

  • Alertas de alta confiança.
  • Outros alertas.

Captura de tela da exibição de alertas do secret scanning. O botão para alternar entre os alertas de "Alta confiança" e "Outros" está realçado com um contorno laranja.

Lista de alertas de alta confiança

A lista de alertas de "alta confiança" exibe alertas relacionados a padrões compatíveis e padrões personalizados especificados. Essa lista é sempre o modo de exibição padrão da página de alertas.

Lista de outros alertas

A lista de "outros" alertas exibe alertas relacionados a padrões que não são de provedor (como chaves privadas). Esses tipos de alertas possuem uma taxa maior de falsos positivos.

Além disso, os alertas que se enquadram nessa categoria:

  • São limitados em quantidade a cinco mil alertas por repositório (isso inclui alertas abertos e fechados).
  • Não são mostrados nas exibições de resumo na visão geral de segurança, apenas na exibição "Secret scanning".
  • Têm somente os cinco primeiros locais detectados exibidos no GitHub para padrões que não são de provedor.

Para que o GitHub verifique padrões que não são de provedor, você deve habilitar o recurso para seu repositório ou sua organização. Para obter mais informações, confira "Habilitar a verificação de segredos que não são de provedor".

Exibindo alertas

Os alertas para secret scanning são exibidos na guia Segurança do repositório.

  1. No sua instância do GitHub Enterprise Server, navegue até a página principal do repositório.
  2. Abaixo do nome do repositório, clique em Segurança. Caso não consiga ver a guia "Segurança", selecione o menu suspenso e clique em Segurança.
    Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Segurança" é realçada por um contorno laranja escuro.
  3. Na barra lateral esquerda, em "Alertas de vulnerabilidades", clique em Secret scanning .
  4. Opcionalmente, alterne para "Outro" para ver os alertas para padrões que não são de provedor.
  5. Em "Secret scanning", clique no alerta que você deseja exibir.

Filtragem de alertas

Você pode aplicar vários filtros à lista de alertas para ajudar a encontrar os alertas de maior interesse. Você pode usar os menus suspensos acima da lista de alertas ou inserir os qualificadores listados na tabela na barra de pesquisa.

QualificadorDescrição
is:openExibe alertas abertos.
is:closedExibe alertas fechados.
validity:activeExibe alertas para segredos reconhecidamente ativos. Para obter mais informações sobre os status de validade, consulte "Avaliando alertas da verificação de segredos".
validity:inactiveExibe alertas para segredos que não estão mais ativos.
validity:unknownExibe alertas para segredos nos quais o status de validade é desconhecido.
secret-type:SECRET-NAMEExibe alertas para um tipo específico de segredo, por exemplo, secret-type:github_personal_access_token. Para obter uma lista dos tipos de segredo compatíveis, confira "Padrões de varredura de segredos com suporte".
provider:PROVIDER-NAMEExibe alertas para um provedor específico, por exemplo, provider:github. Para obter uma lista de parceiros compatíveis, confira "Padrões de varredura de segredos com suporte".
confidence:highExibe alertas para segredos de alta confiança, relacionados a segredos compatíveis e padrões personalizados. Para obter uma lista dos padrões de alta confiança compatíveis, confira "Padrões de varredura de segredos com suporte".
confidence:otherExibe alertas para padrões que não são de provedor, como chaves privadas. Para obter uma lista de padrões que não são de provedores compatíveis, confira "Padrões de varredura de segredos com suporte".

Próximas etapas