{"meta":{"title":"Proteção por Notificações Push","intro":"Proteja seus segredos evitando que alcancem seu repositório com proteção por push.","product":"Qualidade de segurança e código","breadcrumbs":[{"href":"/pt/code-security","title":"Qualidade de segurança e código"},{"href":"/pt/code-security/concepts","title":"Concepts"},{"href":"/pt/code-security/concepts/secret-security","title":"Segurança secreta"},{"href":"/pt/code-security/concepts/secret-security/push-protection","title":"Proteção por Notificações Push"}],"documentType":"article"},"body":"# Proteção por Notificações Push\n\nProteja seus segredos evitando que alcancem seu repositório com proteção por push.\n\n## O que é proteção por push?\n\nA proteção por push é um secret scanning recurso projetado para impedir que credenciais codificadas, como segredos ou tokens, sejam enviadas por push para o repositório. Em vez de alertar você sobre vazamentos de credenciais após o fato, a proteção por push bloqueia pushs que contêm segredos *antes* que eles cheguem ao repositório.\n\n## Como funciona a proteção por push\n\nA proteção de push bloqueia os segredos detectados em:\n\n* Pushes da linha de comando\n* Confirmações feitas na interface do usuário do GitHub\n* Uploads de arquivo para um repositório em GitHub\n* Solicitações à API REST\n* Interações com o GitHub servidor MCP (somente repositórios públicos)\n\nQuando a proteção por push detecta um segredo em potencial durante uma tentativa de push, ela bloqueará o push e fornecerá uma mensagem detalhada explicando o motivo do bloco. Você precisará revisar o código em questão, remover todas as informações confidenciais e tentar o envio por push novamente.\n\n## Tipos de proteção por push\n\nHá dois tipos de proteção por push:\n\n* [Proteção de push para repositórios](#push-protection-for-repositories)\n* [Proteção por push para usuários](#push-protection-for-users)\n\n### Proteção de push para repositórios\n\nVocê pode habilitar a proteção por push para repositórios no nível do repositório, da organização ou da empresa. Esta forma de proteção por push:\n\n* É necessário habilitar GitHub Secret Protection\n* É desabilitado por padrão e pode ser habilitado por um administrador de repositório, proprietário da organização, gerente de segurança ou proprietário da empresa\n* Impede que pushes que contêm segredos atinjam repositórios específicos protegidos\n* Gera alertas para bypasses de proteção por push na guia ** Security and quality** do repositório, da organização e da empresa\n\n> \\[!TIP]\n> Independentemente do status de habilitação da proteção por push, as organizações nas GitHub Team e GitHub Enterprise podem executar um relatório gratuito para escanear o código em busca de segredos vazados. O relatório também mostra quantos vazamentos secretos poderiam ter sido evitados pela proteção por push. Consulte [Segurança secreta com GitHub](/pt/code-security/concepts/secret-security/secret-security-with-github#secret-risk-assessment).\n\n### Proteção por push para usuários\n\nA proteção por push para usuários só está disponível GitHub.come é específica para sua GitHub conta. Esta forma de proteção por push:\n\n* Está habilitado por padrão\n* Impede que você envie segredos por push para repositórios públicos em GitHub\n* Não gera alertas quando você ignora a proteção por push, a menos que a proteção por push também esteja habilitada no nível do repositório\n\n## Bypass de proteção por push e alertas\n\nPara proteção por push para repositórios, por padrão, qualquer pessoa com acesso de gravação ao repositório pode ignorar a proteção por push especificando um motivo de bypass. Quando um colaborador ignora um bloqueio de push, GitHub:\n\n* Cria um alerta na ** Security and quality** aba do repositório, da organização e da empresa\n* Adiciona o evento de desvio ao registro de auditoria\n* Envia um alerta de email para proprietários de conta pessoal, organização e empresas, gerentes de segurança e administradores de repositório que estão assistindo ao repositório, com um link para o segredo e o motivo pelo qual ele foi permitido\n\nEsta tabela mostra o comportamento dos alertas para cada motivo de bypass que um usuário pode especificar.\n\n| Motivo do desvio | Comportamento do alerta |\n| --------------------------------------------------------------- | ----------------------- |\n| É usado em testes | |\n| GitHub cria um alerta fechado, resolvido como \"usado em testes\" | |\n| Isso é um falso positivo | |\n| GitHub cria um alerta fechado, marcado como \"falso positivo\" | |\n| Farei a correção mais tarde | |\n| GitHub cria um alerta aberto | |\n\nSe você deseja ter um controle maior sobre quais colaboradores podem ignorar a proteção de push e quais pushes contendo segredos devem ser permitidos, você pode configurar o bypass delegado para proteção de push. Com o bypass delegado, você pode conceder aos atores:\n\n* **Privilégios de bypass**, permitindo que eles mesmos ignorem a proteção de push, além de revisar e aprovar as solicitações de bypass feitas por outros colaboradores\n* **Isenção da proteção de push**, permitindo que realizem o push de commits sem disparar a proteção de push\n\n## Benefícios da proteção por push\n\n* **Segurança preventiva:** A proteção por push atua como um mecanismo de defesa de linha de frente verificando o código em busca de segredos codificados no momento do push. Essa abordagem preventiva ajuda a evitar vazamentos de credenciais antes que eles sejam inseridos no histórico do repositório, facilitando o endereçamento e a correção de ameaças.\n* **Comentários imediatos:** os desenvolvedores recebem comentários instantâneos se um possível segredo for detectado durante uma tentativa de push. Essa notificação imediata permite uma correção rápida, reduzindo a probabilidade de exposição de informações confidenciais.\n* **Risco reduzido de vazamentos de credenciais:** Ao bloquear confirmações que contêm credenciais codificadas, a proteção por push reduz significativamente o risco de vazamentos acidentais de credenciais e expansão secreta. Isso ajuda a proteger contra possíveis violações e manter a integridade da base de código.\n* **Gerenciamento de segredos eficiente:** em vez de lidar retrospectivamente com segredos expostos, os desenvolvedores podem resolver os problemas na origem. Isso torna o gerenciamento de segredos mais eficiente e menos demorado.\n* **Funcionalidade de ignorar para flexibilidade:** para casos em que ocorrem falsos positivos ou quando certos padrões são necessários, você pode desabilitar a proteção por push para os usuários, e os usuários autorizados podem usar o recurso delegado de ignorar para desabilitar a proteção por push para repositórios.\n Além disso, você pode isentar atores confiáveis completamente da proteção de push.\n Isso fornece flexibilidade sem comprometer a segurança geral.\n* **Capacidade de detectar padrões personalizados (para repositórios em organizações):** As organizações podem definir padrões personalizados para detectar segredos exclusivos para seu ambiente. Essa personalização garante que a proteção por push possa identificar e bloquear até mesmo segredos não padrão com eficiência.\n\n## Personalização\n\nDepois de habilitar a proteção por push para repositórios, você pode personalizá-la:\n\n* Definindo padrões personalizados para bloquear pushes que contêm padrões secretos exclusivos\n* Designar colaboradores que podem ignorar a proteção por push e aprovar solicitações de bypass para outros colaboradores ou estão isentos totalmente da proteção por push\n* Configurando quais padrões de segredo são incluídos na proteção de push em nível empresarial ou organizacional"}