# Armazenando suas credenciais de GitHub em cache no Git

Se você estiver clonando GitHub repositórios usando HTTPS, recomendamos que você use GitHub CLI ou o GCM (Git Credential Manager) para lembrar suas credenciais.

> \[!TIP]
> Se você clonar GitHub repositórios usando SSH, poderá autenticar usando uma chave SSH em vez de usar outras credenciais. Para obter informações sobre como configurar uma conexão SSH, confira [Conectando-se ao GitHub com o SSH](/pt/authentication/connecting-to-github-with-ssh).

## GitHub CLI

GitHub CLI armazenará automaticamente suas credenciais do Git para você quando você escolher `HTTPS` como seu protocolo preferencial para operações do Git e responderá "sim" ao prompt perguntando se você gostaria de autenticar no Git com suas GitHub credenciais.

1. [Instale](http://gfffh3e2b966b640040f3scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/cli/cli#installation)GitHub CLI em macOS, Windows ou Linux.
2. Na linha de comando, insira `gh auth login` e siga os prompts.
   * Quando solicitado o protocolo preferido para operações Git, selecione `HTTPS`.
   * Quando perguntado se você gostaria de autenticar no Git com suas GitHub credenciais, insira `Y`.

Para obter mais informações sobre como autenticar com GitHub CLI, consulte [`gh auth login`](http://gfffhf4b8d8d64fef492fscp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/manual/gh_auth_login).

## Gerenciador de credenciais do Git

[Git Credential Manager](http://gfffh3e2b966b640040f3scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/GitCredentialManager/git-credential-manager) (GCM) é outra maneira de armazenar suas credenciais com segurança e se conectar a GitHub via HTTPS. Com o GCM, você não precisa [criar e armazenar manualmente um personal access token](/pt/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens), pois o GCM gerencia a autenticação em seu nome, incluindo 2FA (autenticação de dois fatores).

<div class="ghd-tool mac">

1. Instale o Git usando o [Homebrew](http://gfffh460e0be0bd7e4740scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/):

   ```shell
   brew install git
   ```

2. Instale GCM usando o Homebrew:

   ```shell
   brew install --cask git-credential-manager
   ```

No macOS, você não precisa executar a `git config` porque o GCM configura automaticamente o Git para você.

Na próxima vez que você clonar uma URL HTTPS que exija autenticação, o Git solicitará que você faça logon usando uma janela do navegador. Você pode primeiro ser solicitado a autorizar um OAuth app. Se sua conta ou organização exigir [autenticação de dois fatores](/pt/authentication/securing-your-account-with-two-factor-authentication-2fa), você também precisará concluir o desafio de 2FA.

> \[!TIP]
>
> Se você é membro de uma empresa que usa Enterprise Managed Users, a visualização da sua empresa tem a barra de cabeçalho "Usuários gerenciados por NOME DA CONTA" no topo da tela. Nesse caso, você precisará desabilitar a filtragem de conta localmente no GCM para impedir que a autenticação seja solicitada sempre que uma operação remota do Git for executada. Para mais detalhes, consulte o [`git-credential-manager` repositório](http://gfffh3e2b966b640040f3scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/git-ecosystem/git-credential-manager/blob/main/docs/configuration.md#credentialgithubaccountfiltering).
>
> Para configurar o Gerenciador de Credenciais do Git, execute o seguinte comando:
>
> ```bash
> git config --global credential.gitHubAccountFiltering "false"
> ```

Após a autenticação ser concluída com sucesso, suas credenciais serão armazenadas no keychain do macOS e serão usadas toda vez que você clonar uma URL de HTTPS. O Git não exigirá que você digite suas credenciais na linha de comando novamente, a menos que você altere suas credenciais.

</div>

<div class="ghd-tool windows">

1. Instale o Git para Windows, que inclui o GCM. Para obter mais informações, consulte [Git para versões Windows](http://gfffh3e2b966b640040f3scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/git-for-windows/git/releases/latest) de sua [página de versões](http://gfffh3e2b966b640040f3scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/git-for-windows/git/releases/latest).

Recomenda-se instalar sempre a versão mais recente. No mínimo, instale a versão 2.29 ou superior, que é a primeira versão que oferece suporte ao OAuth para GitHub.

Na próxima vez que você clonar uma URL HTTPS que exija autenticação, o Git solicitará que você faça logon usando uma janela do navegador. Você pode primeiro ser solicitado a autorizar um OAuth app. Se sua conta ou organização exigir [autenticação de dois fatores](/pt/authentication/securing-your-account-with-two-factor-authentication-2fa), você também precisará concluir o desafio de 2FA.

> \[!TIP]
>
> Se você é membro de uma empresa que usa Enterprise Managed Users, a visualização da sua empresa tem a barra de cabeçalho "Usuários gerenciados por NOME DA CONTA" no topo da tela. Nesse caso, você precisará desabilitar a filtragem de conta localmente no GCM para impedir que a autenticação seja solicitada sempre que uma operação remota do Git for executada. Para mais detalhes, consulte o [`git-credential-manager` repositório](http://gfffh3e2b966b640040f3scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/git-ecosystem/git-credential-manager/blob/main/docs/configuration.md#credentialgithubaccountfiltering).
>
> Para configurar o Gerenciador de Credenciais do Git, execute o seguinte comando:
>
> ```bash
> git config --global credential.gitHubAccountFiltering "false"
> ```

Depois de autenticar com êxito, suas credenciais serão armazenadas no gerenciador de credenciais Windows e serão usadas sempre que você clonar uma URL HTTPS. O Git não exigirá que você digite suas credenciais na linha de comando novamente, a menos que você altere suas credenciais.

<br>

> \[!WARNING]
> Versões mais antigas do Git para Windows vieram com o Git Credential Manager para Windows. Este produto mais antigo não tem mais suporte e não pode se conectar a GitHub via OAuth. Recomendamos que você atualize para [a versão mais recente do Git para Windows](http://gfffh3e2b966b640040f3scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/git-for-windows/git/releases/latest).

> \[!WARNING]
> Se você tiver armazenado em cache credenciais incorretas ou desatualizadas no Gerenciador de Credenciais para Windows, o Git não acessará GitHub. Para redefinir suas credenciais armazenadas em cache para que o Git solicite que você insira suas credenciais, acesse o Gerenciador de Credenciais no Windows Painel de Controle em Contas de Usuário > Gerenciador de Credenciais. Localize a entrada GitHub e exclua-a.

</div>

<div class="ghd-tool linux">

Para Linux, instale o Git e o GCM e, em seguida, configure o Git para usar o GCM.

1. Instale o Git a partir do sistema de pacotes da sua distribuição. As instruções vão variar dependendo da versão do Linux que você executar.

2. Instale o GCM. Veja as [instruções no repositório do GCM](http://gfffh3e2b966b640040f3scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/git-ecosystem/git-credential-manager/blob/main/docs/install.md), pois elas são diferentes, de acordo com a variante do Linux executada.

3. Configurar o Git para usar o GCM. Existem vários repositórios de armazenamento que você pode escolher, então consulte a documentação do GCM (Google Cloud Messaging) para concluir sua configuração. Para obter mais informações, confira [GCM Linux](http://gfffh6b4af8a403444c64scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/gcmcore-linuxcredstores).

Na próxima vez que você clonar uma URL HTTPS que exija autenticação, o Git solicitará que você faça logon usando uma janela do navegador. Você pode primeiro ser solicitado a autorizar um OAuth app. Se sua conta ou organização exigir [autenticação de dois fatores](/pt/authentication/securing-your-account-with-two-factor-authentication-2fa), você também precisará concluir o desafio de 2FA.

> \[!TIP]
>
> Se você é membro de uma empresa que usa Enterprise Managed Users, a visualização da sua empresa tem a barra de cabeçalho "Usuários gerenciados por NOME DA CONTA" no topo da tela. Nesse caso, você precisará desabilitar a filtragem de conta localmente no GCM para impedir que a autenticação seja solicitada sempre que uma operação remota do Git for executada. Para mais detalhes, consulte o [`git-credential-manager` repositório](http://gfffh3e2b966b640040f3scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/git-ecosystem/git-credential-manager/blob/main/docs/configuration.md#credentialgithubaccountfiltering).
>
> Para configurar o Gerenciador de Credenciais do Git, execute o seguinte comando:
>
> ```bash
> git config --global credential.gitHubAccountFiltering "false"
> ```

Depois de autenticado com sucesso, as suas credenciais serão armazenadas no seu sistema e serão usadas toda vez que você clonar uma URL de HTTPS. O Git não exigirá que você digite suas credenciais na linha de comando novamente, a menos que você altere suas credenciais.

Para obter mais opções para armazenar suas credenciais no Linux, confira [Armazenamento de Credencial](http://gfffh93f3dbdd6d654213scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/book/en/v2/Git-Tools-Credential-Storage) no Pro Git.

</div>

<br>

Para obter mais informações ou relatar problemas com o GCM, veja os documentos oficiais do GCM em [Gerenciador de Credenciais do Git](http://gfffh3e2b966b640040f3scp0pu5qucnbb65kk.ffgi.yc2.bjmu.edu.cn/GitCredentialManager/git-credential-manager).