Note: Your site administrator must enable secret scanning for your GitHub Enterprise Server instance before you can use this feature. For more information, see "Configuring secret scanning for your appliance."
Observação: Secret scanning como um push de proteção estão atualmente em versão beta e sujeitos a alterações. Para solicitar acesso à versão beta, entre em contato com sua equipe de gerenciamento de contas.
About push protection for secrets
Up to now, secret scanning checks for secrets after a push and alerts users to exposed secrets. Quando você habilita a proteção por push, a secret scanning também verifica os pushes em busca de segredos de alta confiança (aqueles identificados com uma baixa taxa de falsos positivos). A Secret scanning lista todos os segredos detectados para que o autor possa revisar os segredos e removê-los ou, se necessário, permitir que esses segredos sejam enviados por push.
If a contributor bypasses a push protection block for a secret, GitHub:
- creates an alert in the "Security" tab of the repository in the state described in the table below.
- adds the bypass event to the audit log.
Esta tabela mostra o comportamento dos alertas referente a cada maneira como o usuário pode ignorar um bloco de proteção por push.
| Motivo do bypass | Comportamento do alerta |
|---|---|
| É usado em testes | O GitHub cria um alerta fechado, que é resolvido como "usado em testes" |
| Isso é um falso positivo | O GitHub cria um alerta fechado, que é resolvido como "falso positivo" |
| Farei a correção mais tarde | O GitHub cria um alerta aberto |
For information on the secrets and service providers supported for push protection, see "Secret scanning patterns."
Enabling secret scanning as a push protection
For you to use secret scanning as a push protection, the organization or repository needs to have both GitHub Advanced Security and secret scanning enabled. For more information, see "Managing security and analysis settings for your organization," "Managing security and analysis settings for your repository," and "About GitHub Advanced Security."
Organization owners, security managers, and repository administrators can enable push protection for secret scanning via the UI and API. For more information, see "Repositories" and expand the "Properties of the security_and_analysis object" section in the REST API documentation.
Enabling secret scanning as a push protection for an organization
-
On your GitHub Enterprise Server instance, navigate to the main page of the organization.
-
No nome da sua organização, clique em Configurações.
-
In the "Security" section of the sidebar, click Code security and analysis.
-
Em "Segurança e análise de código", encontre o "GitHub Advanced Security".
-
Under "Secret scanning", under "Push protection", click Enable all.
-
Optionally, click "Automatically enable for repositories added to secret scanning."
Enabling secret scanning as a push protection for a repository
-
On your GitHub Enterprise Server instance, navigate to the main page of the repository.
-
Abaixo do nome do repositório, clique em Configurações.
-
In the "Security" section of the sidebar, click Code security and analysis.
-
Em "Segurança e análise de código", encontre o "GitHub Advanced Security".
-
Em "Secret scanning", em "Proteção por push", clique em Habilitar.
Using secret scanning as a push protection from the command line
Quando você tentar efetuar push de um segredo compatível para um repositório ou uma organização com a secret scanning como uma proteção por push habilitada, o GitHub bloqueará o push. Você pode remover o segredo do branch ou seguir uma URL fornecida para permitir o push.
Up to five detected secrets will be displayed at a time on the command line. If a particular secret has already been detected in the repository and an alert already exists, GitHub will not block that secret.
Se você confirmar que um segredo é real, precisará remover o segredo do branch, de todos os commits em que ele aparece, antes de efetuar push novamente. For more information about remediating blocked secrets, see "Pushing a branch blocked by push protection."
If you confirm a secret is real and that you intend to fix it later, you should aim to remediate the secret as soon as possible. For example, you might revoke the secret and remove the secret from the repository's commit history. Real secrets that have been exposed must be revoked to avoid unauthorized access. You might consider first rotating the secret before revoking it. For more information, see "Removing sensitive data from a repository."
Observações:
- Se a configuração do Git der suporte a pushes para vários branches e não apenas para o branch atual, o push poderá ser bloqueado devido a referências adicionais e não intencionais serem enviadas por push. Para obter mais informações, confira as opções
push.defaultna documentação do Git. - Se secret scanning atingir o tempo limite após o push, GitHub ainda executará uma verificação dos seus commits para segredos após o push.
Tip: You can use secret scanning as a push protection from the web UI, as well as the command line, in GitHub Enterprise Server version 3.6 or later.
Allowing a blocked secret to be pushed
If GitHub blocks a secret that you believe is safe to push, you can allow the secret and specify the reason why it should be allowed.
Quando você permite que um segredo seja enviado por push, um alerta será criado na guia "Segurança". GitHub fecha o alerta e não envia uma notificação se você especificar que o segredo é um falso positivo ou usado apenas em testes. Se você especificar que o segredo é real e que o corrigirá mais tarde, GitHub manterá o alerta de segurança aberto e enviará notificações ao autor do commit, bem como aos administradores do repositório. Para obter mais informações, confira "Como gerenciar alertas da verificação de segredos".
- Visit the URL returned by GitHub when your push was blocked.
- Escolha a opção que melhor descreve o motivo pelo qual você deve conseguir efetuar push do segredo.
- Se o segredo for usado apenas em testes e não representar nenhuma ameaça, clique em Ele é usado em testes.
- Se a cadeia de caracteres detectada não for um segredo, clique em É um falso positivo.
- Se o segredo for real, mas você pretender corrigi-lo mais tarde, clique em Corrigirei mais tarde.
- Click Allow me to push this secret.
- Reattempt the push on the command line within three hours. If you have not pushed within three hours, you will need to repeat this process.