{"meta":{"title":"Definir padrões personalizados para a verificação de segredo","intro":"Proteja seus tipos de segredo exclusivos definindo padrões personalizados com expressões regulares.","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/how-tos","title":"How-tos"},{"href":"/pt/code-security/how-tos/secure-your-secrets","title":"Proteja seus segredos"},{"href":"/pt/code-security/how-tos/secure-your-secrets/customize-leak-detection","title":"Personalizar a detecção de vazamento"},{"href":"/pt/code-security/how-tos/secure-your-secrets/customize-leak-detection/define-custom-patterns","title":"Definir padrões personalizados"}],"documentType":"article"},"body":"# Definir padrões personalizados para a verificação de segredo\n\nProteja seus tipos de segredo exclusivos definindo padrões personalizados com expressões regulares.\n\n## Definindo um padrão personalizado com Copilot\n\nVocê pode usar a IA para gerar expressões regulares com base em uma descrição de texto do tipo de padrão que deseja detectar, incluindo cadeias de caracteres de exemplo opcionais que devem ser detectadas. Consulte [Gerando expressões regulares para padrões personalizados com IA](/pt/code-security/how-tos/secure-your-secrets/customize-leak-detection/generating-regular-expressions-for-custom-patterns-with-ai).\n\n## Definindo um padrão personalizado para um repositório\n\nAntes de definir um padrão personalizado, você deve garantir que Secret Protection ele esteja habilitado em seu repositório. Para obter mais informações, consulte [Habilitar a varredura de segredos para seu repositório](/pt/code-security/how-tos/secure-your-secrets/detect-secret-leaks/enable-secret-scanning).\n\n1. Em GitHub, acesse a página principal do repositório.\n\n2. No nome do repositório, clique em ** Settings**. Caso não consiga ver a guia \"Configurações\", selecione o menu suspenso **** , clique em **Configurações**.\n\n \n\n3. Na seção \"Segurança e qualidade\" da barra lateral, clique em **Advanced Security**.\n\n4. Em \"Secret Protection\", à direita de \"Padrões personalizados\", clique em **Novo padrão**.\n\n5. Insira as informações para o novo padrão personalizado. Você deve fornecer, pelo menos, o nome para o seu padrão e a expressão regular para definir o formato do seu padrão secreto.\n\n 1. No campo \"Nome do padrão\", digite um nome para o padrão.\n 2. No campo \"Formato secreto\", digite uma expressão regular para o formato do seu padrão secreto.\n 3. Você pode clicar em **Mais opções ** para especificar outro conteúdo ao redor ou critérios adicionais de correspondência para o formato do segredo. Confira [Referência de padrões personalizados](/pt/code-security/reference/secret-security/custom-patterns#syntax-for-manually-defining-custom-patterns).\n 4. Forneça um exemplo de cadeia de caracteres de teste para verificar se a sua configuração está correspondendo aos padrões esperados.\n\n \n\n6. Quando estiver pronto para testar seu novo padrão personalizado, a fim de identificar correspondências no repositório sem criar alertas, clique em **Salvar e executar uma simulação**.\n\n7. Quando o teste terminar, você verá uma amostra de resultados (até 1.000). Revise os resultados e identifique quaisquer resultados falso-positivos.\n \n\n8. Edite o novo padrão personalizado para corrigir problemas com os resultados e testar suas alterações e clique em **Salvar e executar uma simulação**.\n\n9. Quando estiver satisfeito com o novo padrão personalizado, clique em **Publicar padrão**.\n\n10. Opcionalmente, para habilitar a proteção push para seu padrão personalizado, clique em **Habilitar**. Para obter mais informações, consulte [Proteção por Notificações Push](/pt/code-security/concepts/secret-security/push-protection).\n\n > \\[!NOTE]\n > O botão \"Enable\" não estará disponível até que a simulação seja bem-sucedida e você publique o padrão.\n\nDepois que o padrão for criado, secret scanning verifica todos segredos em todo o histórico do Git em todos os branches presentes no repositório GitHub. para obter mais informações sobre como exibir alertas de escaneamento de segredos, consulte [Gerenciar alertas de verificação de segredo](/pt/code-security/how-tos/manage-security-alerts/manage-secret-scanning-alerts).\n\n## Definindo um padrão personalizado para uma organização\n\nAntes de definir um padrão personalizado, você deve garantir que habilite secret scanning em os repositórios que deseja verificar em sua organização. Você pode usar security configurations para habilitar secret scanning em todos os repositórios em sua organização. Para obter mais informações, consulte [Habilitando recursos de segurança em escala](/pt/code-security/concepts/security-at-scale/organization-security).\n\n1. No canto superior direito de GitHub, clique na foto de perfil e clique em ** Your organizations**.\n\n2. Selecione uma organização clicando nela.\n\n3. No nome da organização, clique em ** Settings**. Caso não consiga ver a guia \"Configurações\", selecione o menu suspenso **** , clique em **Configurações**.\n\n \n\n4. Na seção \"Segurança\" da barra lateral, selecione o **Advanced Security** menu suspenso e clique no **Global settings**.\n\n5. Em \"Padrões personalizados\", clique em **Novo padrão**.\n\n6. Insira as informações para o novo padrão personalizado. Você deve fornecer, pelo menos, o nome para o seu padrão e a expressão regular para definir o formato do seu padrão secreto.\n\n 1. No campo \"Nome do padrão\", digite um nome para o padrão.\n 2. No campo \"Formato secreto\", digite uma expressão regular para o formato do seu padrão secreto.\n 3. Você pode clicar em **Mais opções ** para especificar outro conteúdo ao redor ou critérios adicionais de correspondência para o formato do segredo. Confira [Referência de padrões personalizados](/pt/code-security/reference/secret-security/custom-patterns#syntax-for-manually-defining-custom-patterns).\n 4. Forneça um exemplo de cadeia de caracteres de teste para verificar se a sua configuração está correspondendo aos padrões esperados.\n\n \n\n7. Se estiver pronto para testar seu novo padrão personalizado e quiser identificar correspondências em repositórios específicos sem criar alertas, clique em **Salvar e executar uma simulação**.\n\n8. Selecione os repositórios em que deseja realizar a simulação.\n * Para executar a simulação em toda a organização, selecione **Todos os repositórios na organização**.\n * Para especificar os repositórios nos quais você deseja realizar a simulação, selecione **Repositórios selecionados**, pesquise e selecione até dez repositórios.\n\n9. Quando tudo estiver pronto para testar seu novo padrão personalizado, clique em **Executar**.\n\n10. Quando o teste terminar, você verá uma amostra de resultados (até 1.000). Revise os resultados e identifique quaisquer resultados falso-positivos.\n \n\n11. Edite o novo padrão personalizado para corrigir problemas com os resultados e testar suas alterações e clique em **Salvar e executar uma simulação**.\n\n12. Quando estiver satisfeito com o novo padrão personalizado, clique em **Publicar padrão**.\n\n13. Opcionalmente, para habilitar a proteção push para seu padrão personalizado, clique em **Habilitar**. Para obter mais informações, consulte [Proteção por Notificações Push](/pt/code-security/concepts/secret-security/push-protection#customization).\n\n > \\[!NOTE]\n >\n > * A opção para ativar a proteção por push é visível apenas para padrões publicados.\n > * A proteção de push para padrões personalizados será aplicada somente a repositórios em sua organização que tenham o secret scanning como uma proteção de push habilitada.\n > * Habilitar a proteção de push para padrões personalizados comumente encontrados pode ser prejudicial para os colaboradores.\n\nDepois que seu padrão é criado, secret scanning verifica se há segredos em repositórios em sua organização, incluindo todo o histórico do Git em todas ramificações. Os proprietários da organização e administradores do repositório receberão um alerta sobre todos os segredos encontrados e poderão revisar o alerta no repositório onde o segredo for encontrado. Para obter mais informações sobre como exibir alertas de escaneamento de segredos, consulte [Gerenciar alertas de verificação de segredo](/pt/code-security/how-tos/manage-security-alerts/manage-secret-scanning-alerts).\n\n## Definir um padrão personalizado para uma conta corporativa\n\n> \\[!NOTE]\n>\n> * No nível da empresa, somente o criador de um padrão personalizado pode editar o padrão e usá-lo em uma simulação.\n> * Você só pode executar uma simulação em repositórios aos quais você tem acesso de administração. Se um proprietário da empresa quiser acesso para executar execuções de teste em qualquer repositório de uma organização, ele deverá receber a função de proprietário da organização. Para saber mais, confira [Gerenciando sua função em uma organização pertencente à sua empresa](/pt/enterprise-cloud@latest/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-your-role-in-an-organization-owned-by-your-enterprise).\n\n1. Navegue até sua empresa. Por exemplo, na página [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\\&ref_type=engagement\\&ref_style=text) em GitHub.com.\n\n2. Na parte superior da página, clique ** em Políticas**.\n\n3. Em \"Policies\", clique em **Advanced Security Code security**.\n\n4. Em \"Advanced Security Code security\", clique **em Recursos de segurança**.\n\n5. Em \"Padrões personalizados de verificação de segredo\", clique em **Novo padrão**.\n\n6. Insira as informações para o novo padrão personalizado. Você deve fornecer, pelo menos, o nome para o seu padrão e a expressão regular para definir o formato do seu padrão secreto.\n\n 1. No campo \"Nome do padrão\", digite um nome para o padrão.\n 2. No campo \"Formato secreto\", digite uma expressão regular para o formato do seu padrão secreto.\n 3. Você pode clicar em **Mais opções ** para especificar outro conteúdo ao redor ou critérios adicionais de correspondência para o formato do segredo. Confira [Referência de padrões personalizados](/pt/code-security/reference/secret-security/custom-patterns#syntax-for-manually-defining-custom-patterns).\n 4. Forneça um exemplo de cadeia de caracteres de teste para verificar se a sua configuração está correspondendo aos padrões esperados.\n\n \n\n7. Quando estiver pronto para testar o novo padrão personalizado, clique em **Salvar e executar uma simulação** para identificar correspondências na empresa sem criar alertas.\n\n8. Pesquise e selecione até 10 repositórios em que você deseja executar a simulação.\n\n9. Quando tudo estiver pronto para testar seu novo padrão personalizado, clique em **Executar**.\n\n10. Quando o teste terminar, você verá uma amostra de resultados (até 1.000). Revise os resultados e identifique quaisquer resultados falso-positivos.\n \n\n11. Edite o novo padrão personalizado para corrigir problemas com os resultados e testar suas alterações e clique em **Salvar e executar uma simulação**.\n\n12. Quando estiver satisfeito com o novo padrão personalizado, clique em **Publicar padrão**.\n\n13. Opcionalmente, para habilitar a proteção push para seu padrão personalizado, clique em **Habilitar**. Para obter mais informações, consulte [Proteção por Notificações Push](/pt/code-security/concepts/secret-security/push-protection).\n > \\[!NOTE]\n >\n > * Para habilitar a proteção de push para padrões personalizados, é necessário habilitar o secret scanning como proteção de push no nível empresarial.\n > * Habilitar a proteção de push para padrões personalizados comumente encontrados pode ser prejudicial para os colaboradores.\n\nDepois que seu padrão é criado, secret scanning verifica se há segredos em repositórios em suas organizações com GitHub Secret Protection habilitado, incluindo todo o histórico do Git em todas as ramificações. Os proprietários da organização e administradores do repositório receberão um alerta sobre todos os segredos encontrados e poderão revisar o alerta no repositório onde o segredo for encontrado. Para obter mais informações sobre como exibir alertas de escaneamento de segredos, consulte [Gerenciar alertas de verificação de segredo](/pt/code-security/how-tos/manage-security-alerts/manage-secret-scanning-alerts)."}