# Informar ao Git sobre a chave de assinatura

Para assinar commits localmente, você precisa informar ao Git que há uma chave GPG, SSH ou X.509 que deseja usar.

## Informar ao Git sobre a chave GPG

<div class="ghd-tool mac">

Se você estiver usando uma chave GPG que corresponde à sua identidade do autor do submissão e ao endereço de e-mail verificado associado à sua conta em GitHub.com, você poderá começar a assinar commits e tags.

> \[!NOTE]
> Se você não tiver uma chave GPG que corresponda à identidade do committer, precisará associar um e-mail a uma chave existente. Para saber mais, confira [Associar um e-mail à chave GPG](/pt/authentication/managing-commit-signature-verification/associating-an-email-with-your-gpg-key).

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

1. Abra <span class="platform-mac">Terminal</span><span class="platform-linux">Terminal</span><span class="platform-windows">Git Bash</span>.

2. Se você tiver configurado anteriormente o Git para usar um formato de chave diferente ao assinar com o `--gpg-sign`, desmarque essa configuração para que o formato padrão de `openpgp` seja usado.

   ```shell
   git config --global --unset gpg.format
   ```

3. Use o comando `gpg --list-secret-keys --keyid-format=long` para listar a forma longa das chaves GPG para as quais você tem uma chave pública e privada. Uma chave privada é necessária para assinar commits ou tags.

   ```shell copy
   gpg --list-secret-keys --keyid-format=long
   ```

   > \[!NOTE]
   > Algumas instalações de GPG no Linux podem exigir o uso de `gpg2 --list-keys --keyid-format LONG` para ver uma lista das chaves existentes. Nesse caso, você também precisará configurar o Git para usar `gpg2` executando `git config --global gpg.program gpg2`.

4. Da lista de chaves GPG, copie a forma longa do ID da chave GPG que você gostaria de usar. Neste exemplo, a ID da chave GPG é `3AA5C34371567BD2`:

   ```shell copy
   $ gpg --list-secret-keys --keyid-format=long
   /Users/hubot/.gnupg/secring.gpg
   ------------------------------------
   sec   4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10]
   uid                          Hubot <hubot@example.com>
   ssb   4096R/4BB6D45482678BE3 2016-03-10
   ```

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

   ```shell
   git config --global user.signingkey 3AA5C34371567BD2
   ```

   Como alternativa, você pode usar uma subchave. Neste exemplo, a ID da subchave GPG é `4BB6D45482678BE3`:

   ```shell
   git config --global user.signingkey 4BB6D45482678BE3
   ```

   Se você usar várias chaves e subchaves, anexe um ponto de exclamação `!` à chave para informar ao git que esta é sua chave preferida. Às vezes, pode ser necessário escapar o ponto de exclamação com uma barra invertida: `\!`.

6. Opcionalmente, para configurar o Git a fim de assinar todos os commits e rótulos por padrão, insira o seguinte comando:

   ```shell
   git config --global commit.gpgsign true
   git config --global tag.gpgSign true
   ```

   Para saber mais, confira [Assinar commits](/pt/authentication/managing-commit-signature-verification/signing-commits).

7. Se você não estiver usando o pacote GPG, execute o seguinte comando no shell do `zsh` para adicionar a chave GPG ao arquivo `.zshrc`, se houver, ou o arquivo `.zprofile`:

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

   Como alternativa, se você usar o shell do `bash`, execute este comando:

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

8. Opcionalmente, para solicitar que você insira um PIN ou uma senha quando necessário, instale `pinentry-mac`. Por exemplo, usando o [Homebrew](https://brew.sh/):

   ```shell
   brew install pinentry-mac
   echo "pinentry-program $(which pinentry-mac)" >> ~/.gnupg/gpg-agent.conf
   killall gpg-agent
   ```

</div>

<div class="ghd-tool windows">

Se você estiver usando uma chave GPG que corresponde à sua identidade do autor do submissão e ao endereço de e-mail verificado associado à sua conta em GitHub.com, você poderá começar a assinar commits e tags.

> \[!NOTE]
> Se você não tiver uma chave GPG que corresponda à identidade do committer, precisará associar um e-mail a uma chave existente. Para saber mais, confira [Associar um e-mail à chave GPG](/pt/authentication/managing-commit-signature-verification/associating-an-email-with-your-gpg-key).

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

1. Abra <span class="platform-mac">Terminal</span><span class="platform-linux">Terminal</span><span class="platform-windows">Git Bash</span>.
2. Se você tiver configurado anteriormente o Git para usar um formato de chave diferente ao assinar com o `--gpg-sign`, desmarque essa configuração para que o formato padrão de `openpgp` seja usado.

   ```shell
   git config --global --unset gpg.format
   ```
3. Use o comando `gpg --list-secret-keys --keyid-format=long` para listar a forma longa das chaves GPG para as quais você tem uma chave pública e privada. Uma chave privada é necessária para assinar commits ou tags.

   ```shell copy
   gpg --list-secret-keys --keyid-format=long
   ```

   > \[!NOTE]
   > Algumas instalações de GPG no Linux podem exigir o uso de `gpg2 --list-keys --keyid-format LONG` para ver uma lista das chaves existentes. Nesse caso, você também precisará configurar o Git para usar `gpg2` executando `git config --global gpg.program gpg2`.
4. Da lista de chaves GPG, copie a forma longa do ID da chave GPG que você gostaria de usar. Neste exemplo, a ID da chave GPG é `3AA5C34371567BD2`:

   ```shell copy
   $ gpg --list-secret-keys --keyid-format=long
   /Users/hubot/.gnupg/secring.gpg
   ------------------------------------
   sec   4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10]
   uid                          Hubot <hubot@example.com>
   ssb   4096R/4BB6D45482678BE3 2016-03-10
   ```
5. Para definir a sua chave de assinatura GPG principal no Git, cole o texto abaixo, substituindo o ID da chave GPG principal que você gostaria de usar. Neste exemplo, a ID da chave GPG é `3AA5C34371567BD2`:

   ```shell
   git config --global user.signingkey 3AA5C34371567BD2
   ```

   Como alternativa, você pode usar uma subchave. Neste exemplo, a ID da subchave GPG é `4BB6D45482678BE3`:

   ```shell
   git config --global user.signingkey 4BB6D45482678BE3
   ```

   Se você usar várias chaves e subchaves, anexe um ponto de exclamação `!` à chave para informar ao git que esta é sua chave preferida. Às vezes, pode ser necessário escapar o ponto de exclamação com uma barra invertida: `\!`.
6. Opcionalmente, para configurar o Git a fim de assinar todos os commits e rótulos por padrão, insira o seguinte comando:

   ```shell
   git config --global commit.gpgsign true
   git config --global tag.gpgSign true
   ```

   Para saber mais, confira [Assinar commits](/pt/authentication/managing-commit-signature-verification/signing-commits).

</div>

<div class="ghd-tool linux">

Se você estiver usando uma chave GPG que corresponde à sua identidade do autor do submissão e ao endereço de e-mail verificado associado à sua conta em GitHub.com, você poderá começar a assinar commits e tags.

> \[!NOTE]
> Se você não tiver uma chave GPG que corresponda à identidade do committer, precisará associar um e-mail a uma chave existente. Para saber mais, confira [Associar um e-mail à chave GPG](/pt/authentication/managing-commit-signature-verification/associating-an-email-with-your-gpg-key).

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

1. Abra <span class="platform-mac">Terminal</span><span class="platform-linux">Terminal</span><span class="platform-windows">Git Bash</span>.
2. Se você tiver configurado anteriormente o Git para usar um formato de chave diferente ao assinar com o `--gpg-sign`, desmarque essa configuração para que o formato padrão de `openpgp` seja usado.

   ```shell
   git config --global --unset gpg.format
   ```
3. Use o comando `gpg --list-secret-keys --keyid-format=long` para listar a forma longa das chaves GPG para as quais você tem uma chave pública e privada. Uma chave privada é necessária para assinar commits ou tags.

   ```shell copy
   gpg --list-secret-keys --keyid-format=long
   ```

   > \[!NOTE]
   > Algumas instalações de GPG no Linux podem exigir o uso de `gpg2 --list-keys --keyid-format LONG` para ver uma lista das chaves existentes. Nesse caso, você também precisará configurar o Git para usar `gpg2` executando `git config --global gpg.program gpg2`.
4. Da lista de chaves GPG, copie a forma longa do ID da chave GPG que você gostaria de usar. Neste exemplo, a ID da chave GPG é `3AA5C34371567BD2`:

   ```shell copy
   $ gpg --list-secret-keys --keyid-format=long
   /Users/hubot/.gnupg/secring.gpg
   ------------------------------------
   sec   4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10]
   uid                          Hubot <hubot@example.com>
   ssb   4096R/4BB6D45482678BE3 2016-03-10
   ```
5. Para definir a sua chave de assinatura GPG principal no Git, cole o texto abaixo, substituindo o ID da chave GPG principal que você gostaria de usar. Neste exemplo, a ID da chave GPG é `3AA5C34371567BD2`:

   ```shell
   git config --global user.signingkey 3AA5C34371567BD2
   ```

   Como alternativa, você pode usar uma subchave. Neste exemplo, a ID da subchave GPG é `4BB6D45482678BE3`:

   ```shell
   git config --global user.signingkey 4BB6D45482678BE3
   ```

   Se você usar várias chaves e subchaves, anexe um ponto de exclamação `!` à chave para informar ao git que esta é sua chave preferida. Às vezes, pode ser necessário escapar o ponto de exclamação com uma barra invertida: `\!`.
6. Opcionalmente, para configurar o Git a fim de assinar todos os commits e rótulos por padrão, insira o seguinte comando:

   ```shell
   git config --global commit.gpgsign true
   git config --global tag.gpgSign true
   ```

   Para saber mais, confira [Assinar commits](/pt/authentication/managing-commit-signature-verification/signing-commits).
7. Para adicionar a chave GPG ao arquivo de inicialização `.bashrc`, execute o seguinte comando:

   ```bash
   [ -f ~/.bashrc ] && echo -e '\nexport GPG_TTY=$(tty)' >> ~/.bashrc
   ```

</div>

## Contando ao Git sobre sua chave SSH

Você pode usar uma chave SSH existente para assinar commits e tags ou gerar uma nova especificamente para assinatura. Para saber mais, confira [Gerando uma nova chave SSH e adicionando-a ao agente SSH](/pt/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent).

> \[!NOTE]
> A verificação de assinatura SSH está disponível no Git 2.34 ou posterior. Para atualizar sua versão do Git, acesse o site do [Git](https://git-scm.com/downloads).

1. Abra <span class="platform-mac">Terminal</span><span class="platform-linux">Terminal</span><span class="platform-windows">Git Bash</span>.
2. Configure o Git para usar SSH para assinar confirmações e marcas:

   ```bash
   git config --global gpg.format ssh
   ```
3. Para definir a chave de assinatura SSH no Git, cole o texto abaixo, substituindo **/PATH/TO/.SSH/KEY.PUB** pela chave pública que deseja usar.

   ```bash
   git config --global user.signingkey /PATH/TO/.SSH/KEY.PUB
   ```

<div class="ghd-tool windows">

## Contando ao Git sobre sua chave X.509

Use o [smimesign](https://github.com/github/smimesign) para assinar confirmações e marcas usando o S/MIME.

> \[!NOTE]
> A verificação de assinatura S/MIME está disponível no Git 2.19 ou posterior. Para atualizar sua versão do Git, acesse o site do [Git](https://git-scm.com/downloads).

1. Instale o [smimesign](https://github.com/github/smimesign#installation).

2. Abra <span class="platform-mac">Terminal</span><span class="platform-linux">Terminal</span><span class="platform-windows">Git Bash</span>.

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:

     ```shell
     git config --global gpg.x509.program smimesign
     git config --global gpg.format x509
     ```

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

     ```shell
     cd PATH-TO-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:

     ```shell
     git config --global gpg.program smimesign
     ```

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

     ```shell
     cd  PATH-TO-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. Se você não estiver usando uma chave X.509 que corresponda à identidade do autor do commit, liste as chaves X.509 para as quais você tem um certificado e uma chave privada usando o comando `smimesign --list-keys`.

   ```shell
   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, a ID do certificado é `0ff455a2708394633e4bb2f88002e3cd80cbd76f`:

   ```shell
   $ 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:

     ```shell
     git config --global user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f
     ```

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

     ```shell
     cd  PATH-TO-REPOSITORY
     git config --local user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f
     ```

</div>

<div class="ghd-tool mac">

## Contando ao Git sobre sua chave X.509

Use o [smimesign](https://github.com/github/smimesign) para assinar confirmações e marcas usando o S/MIME.

> \[!NOTE]
> A verificação de assinatura S/MIME está disponível no Git 2.19 ou posterior. Para atualizar sua versão do Git, acesse o site do [Git](https://git-scm.com/downloads).

1. Instale o [smimesign](https://github.com/github/smimesign#installation).

2. Abra <span class="platform-mac">Terminal</span><span class="platform-linux">Terminal</span><span class="platform-windows">Git Bash</span>.

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:

     ```shell
     git config --global gpg.x509.program smimesign
     git config --global gpg.format x509
     ```

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

     ```shell
     cd PATH-TO-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:

     ```shell
     git config --global gpg.program smimesign
     ```

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

     ```shell
     cd  PATH-TO-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. Se você não estiver usando uma chave X.509 que corresponda à identidade do autor do commit, liste as chaves X.509 para as quais você tem um certificado e uma chave privada usando o comando `smimesign --list-keys`.

   ```shell
   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, a ID do certificado é `0ff455a2708394633e4bb2f88002e3cd80cbd76f`:

   ```shell
   $ 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:

     ```shell
     git config --global user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f
     ```

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

     ```shell
     cd  PATH-TO-REPOSITORY
     git config --local user.signingkey 0ff455a2708394633e4bb2f88002e3cd80cbd76f
     ```

</div>

## Leitura adicional

* [Adicionando uma nova chave SSH à sua conta de GitHub](/pt/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account).
* [Assinar commits](/pt/authentication/managing-commit-signature-verification/signing-commits)
* [Assinar tags](/pt/authentication/managing-commit-signature-verification/signing-tags)