Nova exigência do Git de autenticação por token, o que é e o que devo fazer?
5 min5 minutos de leitura
5 min5 minutos de leitura
Ultimamente, você se deparou com essa mensagem ao fazer alguns comandos no Git?
Autor(a)
Camila Fernanda Alves
Sou Engenheira de Software com experiência em Backend e Cibersegurança e graduada em Engenharia Biomédica. Atualmente atuo no Bradesco como Software Engineer, desenvolvendo soluções escaláveis e seguras para canais digitais. Já atuei como instrutora, criando conteúdos e apoiando estudantes em trilhas de tecnologia. No tempo livre, sou apaixonada pelos jogos da Nintendo e às vezes, alguns jogos FPS.
Inscreva-se em nossa Newsletter
Fique por dentro de conteúdos, insights e oportunidades do universo tech. Receba novidades e lançamentos direto no seu e-mail.
Logon failed, use ctrl+c to cancel basic credential prompt.
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
fatal: unable to access ‘<repositório Git>’: The request URL returned error: 403
Isso ocorreu, porque o GitHub anunciou uma nova exigência de autenticação baseada em token para o Git. A partir do dia 13 de Agosto de 2021, a senha da conta do GitHub passou a não ser aceita mais para autenticar operações no Git.
Essa mudança se deve por motivos de segurança, pois os tokens oferecem alguns benefícios, como ter a possibilidade de salvar as informações do usuário no token e não no servidor, bem como o fato de ser configurado para ter as permissões que você quiser e ter um período de expiração.
Ou seja, ele para de funcionar após determinado tempo, como se fosse uma senha única e descartável.
Assim, caso outra pessoa tenha acesso ao seu token, ela estará restrita apenas às permissões que você configurou para o mesmo. Assim você não irá correr o risco de perder sua conta do GitHub, podendo descartar o token perdido e gerar outro novamente.
Mas então, o que é preciso fazer para continuar usando as operações Git?
O GitHub recomenda começar a utilizar um token de acesso pessoal, mas caso queira, pode optar por utilizar uma chave SSH.
Dessa forma, segue um passo a passo de como gerar seu token pessoal:
Na página principal, selecione seu usuário no canto superior direito e clique na opção Settings:
Na página que irá abrir, clique na opção Developer settings, 18ª opção da lista à esquerda.
Selecione a opção Personal access tokens, 3ª opção da lista à esquerda.
Clique na opção Generate new token.
Confirme com sua senha do GitHub.
Dê um nome para seu token e defina seu tempo de expiração.
Marque as permissões que você deseja conceder ao token. Detalhe, para usar seu token para acessar repositórios, selecione a opção repo.
Por fim, ao selecionar todas as opções escolhidas, clique em Generate token ao final da tela.
Prontinho, irá aparecer um código para que você possa copiar e colar no Gerenciador de Credenciais da sua máquina. Esse processo irá depender do seu sistema operacional.
Como editar credenciais no Windows
Depois que você gerar o token, copie ele e acesse o Painel de Controle. Você pode encontrar digitando na barra de busca.
Em seguida, acesse Contas de Usuário:
Clique em Gerenciar Credenciais do Windows:
Procure na seção de Credenciais Genéricas o github.com, selecione-o e coloque para editar;
Copie o token gerado na primeira etapa e cole na caixa de texto da Senha.
Caso você não encontre o github.com, você pode selecionar a opção Adicionar uma credencial genérica
E preencher nos campos:
Endereço de rede ou na Internet: https://github.com/
Nome de usuário: seu nome de usuário do GitHub
Senha: seu token pessoal gerado anteriormente
Prontinho, depois você pode realizar operações Git novamente sem requisições de login até a data de expiração do token gerado.
Como editar credencial Git no Linux
No Linux, este processo pode ser feito somente no terminal. Ao abrir um repositório Git nele e fazer comandos como git pull, git push ou git clone, o Git irá fazer uma requisição de usuário e senha, caso você colocar a sua senha do GitHub, como era feito anteriormente, irá receber a mensagem citada no início:
Dessa forma, basta você realizar o comando novamente e no lugar da senha, colar o seu token gerado:
Assim, o comando irá ser realizado com sucesso:
Porém, apesar de estar funcionando, não é viável ter que colar o token toda vez que for fazer esses comandos, certo? Para isso, basta escrever o seguinte comando para que a última senha utilizada fique salva:
git config--global credential.helper cache
Assim, no próximo comando feito, o Git irá solicitar autenticação novamente, porém nos seguintes comandos, o Git não irá pedir seu usuário e senha novamente:
E por fim, caso você queira tirar o token das configurações, basta fazer:
git config --global--unset credential.helper
Assim, você terá os pedidos de requisições novamente:
Como editar credenciais no MacOS
Para setar o token no Mac, é semelhante ao processo do Windows. Acesse Keychain access, para encontrar você pode clicar no ícone da lupa no canto direito da barra de menu:
Em seguida, procure por github.com, clique em internet password, edite e cole o token pessoal gerado.
Caso queira retirar ele, no terminal digite:
git credential-osxkeychain erase
Conclusão
Em suma, essa mudança de utilização de tokens para autenticação é bastante interessante, pois ele pode lhe oferecer um controle maior e mais segurança.
Você pode fazer todo esse processo citado acima quantas vezes achar necessário, bem como configurar as permissões e o tempo de expiração de cada token gerado da maneira de achar melhor.
Em casos de falhas em segurança, por exemplo, a pessoa estará limitada às permissões dadas ao token e sua conta GitHub continua salva.
Além disso, caso isso ocorra, apague seu token indo no GitHub, em seguida em Settings, Developer settings e Personal access tokens, mesmo passo a passo para gerar o token, porém clique em Delete:
Assim, você estará seguro novamente.
Caso você tenha curiosidade e queira entender um pouquinho mais sobre o token e outros tipos de autenticação, temos esse artigo que você possa se interessar:
