# Armazenando suas credenciais de GitHub em cache no Git

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

> \[!TIP]
> Se você clonar repositórios do GitHub usando SSH, poderá efetuar a autenticação 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/enterprise-server@3.22/authentication/connecting-to-github-with-ssh).

## GitHub CLI

O GitHub CLI armazenará automaticamente suas credenciais do Git para você escolher `HTTPS` como protocolo preferido para operações Git e responder "sim" ao prompt que perguntará se você gostaria de efetuar a autenticação no Git com a suas credenciais do GitHub.

1. Instale GitHub CLI no 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ê deseja se autenticar no Git com suas credenciais do GitHub, insira `Y`.

Para obter mais informações sobre como se autenticar com a GitHub CLI, confira [`gh auth login`](https://cli.github.com/manual/gh_auth_login).

## Gerenciador de credenciais do Git

[Git Credential Manager](https://github.com/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 nem armazenar manualmente um personal access token](/pt/enterprise-server@3.22/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens), pois o GCM gerencia a autenticação em seu nome, incluindo a 2FA (autenticação de dois fatores).

<div class="ghd-tool mac">

1. Instale o Git usando o [Homebrew](https://brew.sh/):

   ```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 deve primeiro autorizar um OAuth app. Se sua conta ou organização exigir [autenticação de dois fatores](/pt/enterprise-server@3.22/authentication/securing-your-account-with-two-factor-authentication-2fa), você também precisará concluir o desafio de 2FA.

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](https://github.com/git-for-windows/git/releases/latest) de sua [página de versões](https://github.com/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 deve primeiro autorizar um OAuth app. Se sua conta ou organização exigir [autenticação de dois fatores](/pt/enterprise-server@3.22/authentication/securing-your-account-with-two-factor-authentication-2fa), você também precisará concluir o desafio de 2FA.

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](https://github.com/git-for-windows/git/releases/latest).

> \[!WARNING]
> Se você tiver armazenado 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 Control Panel em Contas de Usuário > Gerenciador de Credenciais. Procure a entrada do 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](https://github.com/git-ecosystem/git-credential-manager/blob/release/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](https://aka.ms/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 deve primeiro autorizar um OAuth app. Se sua conta ou organização exigir [autenticação de dois fatores](/pt/enterprise-server@3.22/authentication/securing-your-account-with-two-factor-authentication-2fa), você também precisará concluir o desafio de 2FA.

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](https://git-scm.com/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](https://github.com/GitCredentialManager/git-credential-manager).