Configurar o acesso seguro ao GitHub

Acesse https://github.com e confira o domínio na barra de endereço.

• Já tem conta? Clique em Sign in (Entrar). Não é necessário criar outra.
• Ainda não tem? Clique em Sign up (Criar conta) e siga o cadastro com um e-mail ao qual você tenha acesso. Use uma senha longa e exclusiva, de preferência gerada por um gerenciador de senhas.

Depois de entrar, abra o menu da sua foto de perfil → Settings (Configurações) → Emails (E-mails).

Se aparecer Unverified (Não verificado), clique em Resend verification email (Reenviar e-mail de verificação). Abra a mensagem do GitHub na sua caixa de entrada e siga a confirmação indicada. Se necessário, confira o spam.

Volte a Emails e confira se a pendência de verificação foi resolvida. Se o e-mail já estiver verificado, não repita o processo.

Na sua conta, siga este caminho:

1. Abra o menu da foto de perfil.
2. Clique em Settings (Configurações).
3. No menu lateral, procure a seção Access (Acesso).
4. Abra Password and authentication (Senha e autenticação).

Essa página reúne os controles de senha e autenticação da conta. Já a verificação do e-mail fica em Emails.

A autenticação de dois fatores (2FA) acrescenta uma verificação à senha. Com um aplicativo autenticador, você usa um código temporário gerado no celular para confirmar o acesso quando solicitado.

Nas configurações de segurança do GitHub, localize a seção de autenticação de dois fatores.

Se estiver desativada, siga a ativação na próxima tela. Se já estiver ativa, não desative nem reinicie a configuração: confira se você ainda tem acesso ao segundo fator cadastrado e aos códigos de recuperação.

1. No GitHub, inicie a ativação dos dois fatores e escolha o aplicativo autenticador.
2. Abra um aplicativo autenticador confiável no celular. Se precisar instalar um, use a loja oficial do aparelho.
3. No aplicativo, adicione uma conta e leia o QR code exibido pelo GitHub.
4. Digite o código temporário gerado pelo aplicativo somente no campo de confirmação do GitHub, em github.com. Avance e aguarde a validação.

Ler o QR code não basta: o GitHub precisa aceitar o código para confirmar o segundo fator.

Eles permitem recuperar o acesso se você perder o autenticador. Quando o GitHub os apresentar, guarde-os em um gerenciador de senhas confiável ou impressos em local protegido.

Escolha um local que você consiga acessar mesmo sem o celular do autenticador. Não deixe a única cópia nesse aparelho nem em arquivos do projeto.

Público: qualquer pessoa pode consultar o conteúdo e o histórico publicados.

Privado: a consulta fica restrita ao proprietário e às pessoas ou entidades autorizadas.

Um repositório público pode ser consultado por qualquer visitante. Isso não dá permissão para alterar o repositório. A permissão de escrita é separada da visibilidade, tanto em projetos públicos quanto privados.

Estar conectado ao GitHub pelo navegador não configura automaticamente a autenticação do Git no computador. A sessão do site e a autenticação usada pelo Git são separadas.

HTTPS é uma forma de conectar o Git ao GitHub com os dados protegidos por criptografia durante a transmissão. Essa proteção não substitui a autenticação quando uma operação exige identificar sua conta.

A senha usada para entrar no site do GitHub não é aceita como senha para operações Git por HTTPS.

O Git Credential Manager (GCM) é o intermediário que cuida das credenciais de acesso usadas pelo Git.

Com o GCM configurado, você autoriza o acesso em um fluxo pelo navegador. Após essa autorização, o gerenciador obtém as credenciais necessárias e as fornece ao Git.

Abra o Git Bash no Windows ou o Terminal no macOS/Linux. Execute os comandos separadamente. O primeiro verifica o Git; o segundo verifica o Git Credential Manager.

Se o segundo comando mostrar uma versão, não reinstale o GCM.

Se ele não for reconhecido:

• Windows: confira primeiro o Git for Windows, que normalmente já inclui o GCM. Atualize ou execute novamente o instalador oficial, mantendo o componente Git Credential Manager selecionado, antes de considerar uma instalação separada.
• macOS: use o instalador oficial do GCM ou o método com Homebrew indicado na documentação, caso já use essa ferramenta.
• Linux: escolha na documentação um método compatível com sua distribuição e arquitetura; não presuma que instalar o Git também instalou o GCM.

A versão confirma que o GCM pode ser executado. Agora confira se o Git está configurado para chamá-lo como auxiliar de credenciais. Faça esta consulta fora de uma pasta de projeto; ela não altera configurações.

Se o GCM está disponível e a consulta anterior não encontrou auxiliares, execute o comando abaixo. Ele configura a integração no seu usuário; não autoriza sua conta no GitHub.

O GCM gerencia a autenticação e fornece credenciais ao Git. O cofre, também chamado de backend de armazenamento, é onde essas credenciais ficam guardadas.

• Windows — wincred: Gerenciador de Credenciais do Windows.
• macOS — keychain: Chaves do macOS.
• Linux — secretservice: um cofre compatível com Secret Service, disponível na sessão. Não presuma que ele já esteja instalado e configurado.

No Windows, mantenha o Git Bash usado no passo anterior; não abra o PowerShell. No macOS e no Linux, mantenha também o terminal atual. Continue nesse terminal e nessa pasta até a autorização do próximo passo.

Execute as duas consultas. Elas não solicitam nem recuperam tokens.

• Windows: abra o Gerenciador de Credenciais → Credenciais do Windows e confirme que está acessível.
• macOS: abra Acesso às Chaves e confira se o chaveiro de login está disponível e desbloqueado.
• Linux com Secret Service: confirme um serviço compatível, como GNOME Keyring, disponível na mesma sessão gráfica. No GNOME, use Senhas e Chaves (Seahorse) para conferir um chaveiro de senhas desbloqueado.

Não revele senhas nem copie entradas. Ainda não precisa existir uma credencial do GitHub.

Com Secret Service disponível e o cofre desbloqueado, selecione-o. Este comando não instala o serviço nem suas dependências.

Com o GCM integrado e o cofre seguro conferido, execute o comando abaixo no terminal. Ele inicia o login no GitHub, sem precisar criar, publicar ou clonar um repositório.

Se houver escolha de método, selecione a opção de entrar pelo navegador.

1. Antes de informar qualquer segredo, confira o protocolo HTTPS e o domínio exato github.com na página de autenticação.
2. Informe senha e segundo fator somente nessa página legítima, se solicitados.
3. Na página de autorização, confira novamente o domínio, a conta selecionada e o aplicativo Git Credential Manager. Só então aprove.

Após a confirmação no navegador, aguarde o comando terminar sem erro no terminal. Fechar a aba não basta. Em seguida, liste as contas reconhecidas pelo GCM:

Seu nome de usuário esperado deve aparecer na lista.

No gerenciador do cofre configurado, confira a presença da entrada do GitHub correspondente à conta. Veja apenas sua identificação; não revele nem copie o valor da credencial.

Se houver erro, a conta não aparecer ou você não conseguir confirmar o armazenamento, pare e consulte as instruções oficiais do GCM para seu sistema.

Você reuniu os critérios para escolher a visibilidade e preparar a autenticação HTTPS sem expor credenciais. Lembre-se: autenticar a conta não concede novas permissões de leitura ou escrita em repositórios.