Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Configurar a assinatura de commit da Web

Você pode habilitar a assinatura automática de commits feitos na interface da Web do GitHub Enterprise Server.

Quem pode usar esse recurso

Site administrators can configure web commit signing for your GitHub Enterprise Server instance.

Sobre a assinatura de commit da Web

Se você habilitar a assinatura de commit da Web, o GitHub Enterprise Server usará automaticamente o GPG para assinar os commits que os usuários fizerem na interface da Web do your GitHub Enterprise Server instance. Os commits assinados por GitHub Enterprise Server terão um status verificado. Para obter mais informações, confira "Sobre a verificação de assinatura de commit".

Você pode habilitar a assinatura de commit da Web, alternar a chave privada usada para a assinatura de commit da Web e desabilitar a assinatura de commit da Web.

Habilitar a assinatura de commit da Web

  1. No shell administrativo, crie uma chave PGP. Anote o endereço de email e a ID da chave.

    Shell
    gpg --full-generate-key --pinentry-mode=loopback
    • Use o tipo de chave padrão e pelo menos 4096 bits sem expiração.
    • Use web-flow como o nome de usuário. Se o web-flow não estiver disponível ou não puder ser utilizado, use qualquer novo nome de usuário exclusivo. Use esse nome de usuário nas etapas a seguir deste artigo.
    • Se você tiver um endereço de email sem resposta definido em Management Console, use esse endereço de email. Caso contrário, use qualquer endereço de email, como web-flow@my-company.com. O endereço de email não precisa ser válido.
  • A chave PGP não pode ser protegida por uma frase secreta. 1. Defina a chave como uma variável de ambiente para GitHub Enterprise Server, substituindo <YOUR-KEY-ID> pela ID da chave GPG.

    Shell
    ghe-config "secrets.gpgverify.web-signing-key" "$(gpg --export-secret-keys -a <YOUR-KEY-ID> | awk '{printf "%s\\n", $0}')"
    ``` 1. Atualize as configurações para o serviço de assinatura de commit de GitHub Enterprise Server.
    
    ```bash{:copy}
    sudo consul-template -once -template /etc/consul-templates/etc/nomad-jobs/gpgverify/gpgverify.hcl.ctmpl:/etc/nomad-jobs/gpgverify/gpgverify.hcl
    
    nomad job run /etc/nomad-jobs/gpgverify/gpgverify.hcl
  1. Habilite a assinatura de commit da Web.

    Shell
    ghe-config app.github.web-commit-signing-enabled true
  2. Aplique a configuração e aguarde a conclusão da execução da configuração.

    Shell
    ghe-config-apply
  3. Crie um usuário no your GitHub Enterprise Server instance por meio da autenticação integrada ou da autenticação externa. Para obter mais informações, confira "Sobre a autenticação em sua empresa".

    • O nome de usuário do usuário precisa ser o mesmo usado quando a chave PGP foi criada na etapa 1 acima, por exemplo, web-flow.
    • O endereço de email do usuário precisa ser o mesmo endereço que você usou ao criar a chave PGP. 1. Execute o comando a seguir, substituindo KEY-ID por sua ID de chave PGP.
    Shell
    gpg --armor --export KEY-ID
  4. Copie a chave PGP, começando com -----BEGIN PGP PUBLIC KEY BLOCK----- e terminando com -----END PGP PUBLIC KEY BLOCK-----.

  5. Entre em GitHub Enterprise Server como o usuário criado para assinatura de confirmação da Web, por exemplo, web-flow.

  6. Adicione a chave PGP pública ao perfil do usuário. Para saber mais, confira "Como adicionar uma chave GPG a uma conta do GitHub".

    Observação: não remova outras chaves públicas da lista de chaves GPG. Se uma chave pública for excluída, todas as confirmações assinadas com a chave privada correspondente não serão mais marcadas como verificadas.

    1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

    Captura de tela do ícone de foguete para acesso às configurações de administração do site

  7. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

    Captura de tela do link "Administração do site" 1. Na barra lateral à esquerda, clique em Management Console . Guia Management Console na barra lateral esquerda

  8. Na parte superior da página, clique em Configurações. Guia Configurações

  9. Na barra lateral esquerda, clique em Email. Guia Email

  10. Em "Endereço de email sem resposta", digite o mesmo endereço de email usado ao criar a chave PGP.

    Observação: o campo "Endereço de email sem resposta" só será exibido se você tiver habilitado o email no your GitHub Enterprise Server instance. Para obter mais informações, confira "Como configurar o email para notificações".

    1. Na barra lateral esquerda, clique em **Salvar configurações**.

    Captura de tela do botão Salvar configurações no Management Console

    Observação: se você salvar as configurações no Management Console, isso reiniciará os serviços do sistema, o que poderá resultar em tempo de inatividade visível pelo usuário.

  11. Aguarde a conclusão da execução de suas configurações.

    Configurar a instância

Girar a chave privada usada para assinatura de commit da Web

  1. No shell administrativo, crie uma chave PGP. Anote o endereço de email e a ID da chave.

    Shell
    gpg --full-generate-key --pinentry-mode=loopback
    • Use o tipo de chave padrão e pelo menos 4096 bits sem expiração.
    • Use o nome de usuário do usuário de assinatura de commit da Web, por exemplo, web-flow.
    • Use o endereço de email sem resposta definido no Management Console, que deve ser igual ao endereço de email do usuário de assinatura de commit da Web, por exemplo, web-flow.
  • A chave PGP não pode ser protegida por uma frase secreta. 1. Defina a chave como uma variável de ambiente para GitHub Enterprise Server, substituindo <YOUR-KEY-ID> pela ID da chave GPG.

    Shell
    ghe-config "secrets.gpgverify.web-signing-key" "$(gpg --export-secret-keys -a <YOUR-KEY-ID> | awk '{printf "%s\\n", $0}')"
    ``` 1. Atualize as configurações para o serviço de assinatura de commit de GitHub Enterprise Server.
    
    ```bash{:copy}
    sudo consul-template -once -template /etc/consul-templates/etc/nomad-jobs/gpgverify/gpgverify.hcl.ctmpl:/etc/nomad-jobs/gpgverify/gpgverify.hcl
    
    nomad job run /etc/nomad-jobs/gpgverify/gpgverify.hcl
    ``` 1. Execute o comando a seguir, substituindo KEY-ID por sua ID de chave PGP.
    
    ```bash{:copy}
    gpg --armor --export KEY-ID
  1. Copie a chave PGP, começando com -----BEGIN PGP PUBLIC KEY BLOCK----- e terminando com -----END PGP PUBLIC KEY BLOCK-----.

  2. Entre em GitHub Enterprise Server como o usuário criado para assinatura de confirmação da Web, por exemplo, web-flow.

  3. Adicione a chave PGP pública ao perfil do usuário. Para saber mais, confira "Como adicionar uma chave GPG a uma conta do GitHub".

    Observação: não remova outras chaves públicas da lista de chaves GPG. Se uma chave pública for excluída, todas as confirmações assinadas com a chave privada correspondente não serão mais marcadas como verificadas.

Desabilitar a assinatura de commit da Web

Você pode desabilitar a assinatura de commit da Web no your GitHub Enterprise Server instance.

  1. No shell administrativo, execute o comando a seguir.

    Shell
    ghe-config app.github.web-commit-signing-enabled false
  2. Aplicar a configuração.

    Shell
    ghe-config-apply