Skip to main content

Habilitar o bypass delegado para proteção de push

Você pode usar o bypass delegado para sua organização ou repositório para controlar quem pode enviar commits por push que contêm segredos identificados pela secret scanning.

Quem pode usar esse recurso?

Proprietários de repositórios, proprietários de organizações, gerentes de segurança e usuários com a função de administrador

Sobre a habilitação do bypass delegado para proteção por push

O bypass delegado para proteção de push permite que você:

  • Defina os colaboradores que podem ignorar a proteção por push.
  • Adiciona um processo de aprovação para outros colaboradores.

O bypass delegado se aplica a arquivos criados, editados e carregados no GitHub.

Para saber mais, confira Sobre o bypass delegado para proteção contra push.

Ao habilitar esse recurso, você criará uma lista de bypass de funções e equipes que podem gerenciar solicitações para ignorar a proteção por push. Se você ainda não tiver equipes ou funções apropriadas para usar, crie equipes adicionais antes de começar.

Como alternativa, você pode conceder a membros específicos da organização a capacidade de examinar e gerenciar solicitações de bypass usando permissões refinadas, o que lhe dá um controle mais refinado sobre quais indivíduos e equipes podem aprovar e negar solicitações de bypass. Para obter mais informações, consulte Como usar permissões refinadas para controlar quem pode examinar e gerenciar solicitações de bypass.

Configurar bypass delegado para um repositório

Observação

Se o proprietário de uma organização configurar o bypass delegado no nível da organização, as configurações no nível do repositório serão desabilitadas.

  1. Em GitHub, acesse a página principal do repositório.

  2. 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.

    Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja-escuro.

  3. Na seção "Security" da barra lateral, clique em Advanced Security.

  4. Em "Secret Protection", verifique se a proteção de push está habilitada para o repositório.

  5. Em "Push protection", à direita de "Who can bypass push protection for secret scanning", selecione o menu suspenso e clique em Funções ou equipes específicas.

  6. Em "Bypass list", clique em Add role or team.

    Observação

    Quando você adiciona funções ou equipes à "lista de bypasses", esses usuários receberão a capacidade de ignorar a proteção por push e também poderão revisar e gerenciar as solicitações de todos os outros colaboradores para ignorar a proteção por push.

    Não é possível adicionar equipes secretas à lista de bypass.

  7. Na caixa de diálogo, selecione as funções e equipes que deseja adicionar à lista de bypass e clique em Adicionar selecionados.

Configurar o bypass delegado para uma organização

Você deve configurar o bypass delegado para sua organização usando uma configuração de segurança personalizada. Em seguida, você pode aplicar a configuração de segurança a todos os repositórios (ou alguns selecionados) em sua organização.

  1. Crie uma nova configuração de segurança personalizada ou edite uma existente. Confira Criando uma configuração de segurança personalizada.

  2. Ao definir a configuração de segurança personalizada, em "Secret scanning", verifique se "Push protection" está definido como Enabled.

  3. Em "Push protection", à direita de "Bypass privileges", selecione o menu suspenso e clique em Specific actors.

    Observação

    Quando você atribui privilégios de bypass a atores selecionados, esses membros da organização recebem a capacidade de ignorar a proteção por push e também revisam e gerenciam as solicitações de todos os outros colaboradores para ignorar a proteção por push.

    Não é possível adicionar equipes secretas à lista de bypass.

  4. Clique no menu suspenso "Selecionar agentes" e selecione as funções e equipes às quais deseja atribuir privilégios de bypass.

    Dica

    Além de atribuir privilégios de bypass a funções e equipes, você também pode conceder a membros individuais da organização a capacidade de examinar e gerenciar solicitações de bypass usando permissões refinadas. Consulte Como usar permissões refinadas para controlar quem pode examinar e gerenciar as solicitações de bypass.

  5. Clique em Salvar configuração.

  6. Aplique a configuração de segurança a todos os repositórios (ou a repositórios selecionados) da sua organização. Confira Aplicando uma configuração de segurança personalizada.

Para saber mais sobre configurações de segurança, consulte Sobre a habilitação de recursos de segurança em escala.

Como usar permissões refinadas para controlar quem pode examinar e gerenciar as solicitações de bypass

Você pode conceder a indivíduos ou equipes específicos na organização a capacidade de examinar e gerenciar as solicitações de bypass usando permissões refinadas.

  1. Verifique se o bypass delegado está habilitado para a organização. Para obter mais informações, siga as etapas 1 a 3 em Como configurar o bypass delegado para sua organização e verificar se você salvou e aplicou a configuração de segurança aos repositórios selecionados.
  2. Crie (ou edite) uma função de organização personalizada. Para obter mais informações sobre como criar e editar funções personalizadas, confira Gerenciando as funções de organização personalizadas.
  3. Ao escolher quais permissões adicionar à função personalizada, selecione a permissão "Examinar e gerenciar solicitações de bypass da secret scanning".
  4. Atribua a função personalizada a membros ou equipes individuais na sua organização. Para obter mais informações sobre a atribuição de funções personalizadas, confira Usando funções de organização.