Informar ao Git sobre a chave de assinatura

Informar ao Git sobre a chave GPG

Se você estiver usando uma chave GPG que corresponda à identidade do committer (autor do commit) e ao endereço de e-mail associado à conta do GitHub Enterprise Server, você poderá começar a assinar commits e tags.

Se você tiver várias chaves GPG, precisará informar ao Git qual deve ser usada.

1. Abra TerminalTerminalGit Bash.

2. Use the gpg --list-secret-keys --keyid-format=long command to list the long form of the GPG keys for which you have both a public and private key. Uma chave privada é necessária para assinar commits ou tags.

   $ gpg --list-secret-keys --keyid-format=long

   Nota: Algumas instalações GPG no Linux podem exigir que você use gpg2 --list-keys --keyid-format LONG para visualizar uma lista de suas chaves existentes. Neste caso você também precisará configurar o Git para usar gpg2 executando git config --global gpg.program gpg2.

3. From the list of GPG keys, copy the long form of the GPG key ID you'd like to use. Neste exemplo, o ID da chave GPG é 3AA5C34371567BD2:

   $ gpg --list-secret-keys --keyid-format=long
   /Users/hubot/.gnupg/secring.gpg
   ------------------------------------
   sec   4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10]
   uid                          Hubot 
   ssb   4096R/42B317FD4BA89E7A 2016-03-10

4. Para definir a sua chave de assinatura GPG no Git, cole o texto abaixo, substituindo o ID da chave GPG que você gostaria de usar. Neste exemplo, o ID da chave GPG é 3AA5C34371567BD2:

   $ git config --global user.signingkey 3AA5C34371567BD2

5. Se você não estiver usando o pacote GPG, execute o comando a seguir no shell do zsh para adicionar a chave GPG ao seu arquivo .zshrc, se ele existir, ou seu arquivo .zprofile:

   $ if [ -r ~/.zshrc ]; then echo 'export GPG_TTY=$(tty)' >> ~/.zshrc; \
     else echo 'export GPG_TTY=$(tty)' >> ~/.zprofile; fi

   Como alternativa, se você usar o shall de bash, execute este comando:

   $ if [ -r ~/.bash_profile ]; then echo 'export GPG_TTY=$(tty)' >> ~/.bash_profile; \
     else echo 'export GPG_TTY=$(tty)' >> ~/.profile; fi

Contando ao Git sobre sua chave X.509

Você pode usar smimesign para assinar commits e tags usando S/MIME em vez de GPG.

1. Instale smimesign.
2. Abra TerminalTerminalGit Bash.
3. Configure o Git para usar o S/MIME para assinar commits e tags. No Git 2.19 ou posterior, use os comandos git config gpg.x509.program e git config gpg.format:

• Para usar o S/MIME para assinar todos os repositórios:

  $ git config --global gpg.x509.program smimesign
  $ git config --global gpg.format x509

• Para usar o S/MIME para assinar um único repositório:

  $ cd /path/to/my/repository
  $ git config --local gpg.x509.program smimesign
  $ git config --local gpg.format x509

  No Git 2.18 ou anterior, use o comando git config gpg.program:
• Para usar o S/MIME para assinar todos os repositórios:

  $ git config --global gpg.program smimesign

• Para usar o S/MIME para assinar um único repositório:

  $ cd /path/to/my/repository
  $ git config --local gpg.program smimesign

  Se você estiver usando uma chave X.509 que corresponde à sua identidade do committer, poderá começar a assinar commits e tags.

4. If you're not using an X.509 key that matches your committer identity, list X.509 keys for which you have both a certificate and private key using the smimesign --list-keys command.

   $ smimesign --list-keys

5. Da lista de chaves X.509, copie o ID de certificado da chave X.509 que gostaria de usar. Neste exemplo, o ID do certificado é 0ff455a2708394633e4bb2f88002e3cd80cbd76f:

   $ smimesign --list-keys
                ID: 0ff455a2708394633e4bb2f88002e3cd80cbd76f
               S/N: a2dfa7e8c9c4d1616f1009c988bb70f
         Algorithm: SHA256-RSA
          Validity: 2017-11-22 00:00:00 +0000 UTC - 2020-11-22 12:00:00 +0000 UTC
            Issuer: CN=DigiCert SHA2 Assured ID CA,OU=www.digicert.com,O=DigiCert Inc,C=US
           Subject: CN=Octocat,O=GitHub\, Inc.,L=San Francisco,ST=California,C=US
            Emails: octocat@github.com

6. Para definir sua chave de autenticação X.509 no Git, cole o texto abaixo, substituindo o certificado que você copiou anteriormente.

• Para usar sua chave X.509 para assinar para todos os repositórios:

  $ git config --global user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f

• Para usar sua chave X.509 para assinar um único repositório:

  $ cd /path/to/my/repository
  $ git config --local user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f