Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Acessar o GitHub usando a autenticação de dois fatores

Com a 2FA habilitada, será solicitado que você forneça seu código de autenticação de 2FA, bem como sua senha, ao iniciar a sessão no GitHub Enterprise Server.

Com a autenticação de dois fatores habilitada, você deverá fornecer um código de autenticação ao acessar GitHub Enterprise Server por meio do seu navegador. Se você acessar GitHub Enterprise Server usando outros métodos, como, por exemplo, a API ou a linha de comando, você deverá usar uma forma alternativa de autenticação. Para obter mais informações, confira "Sobre a autenticação no GitHub".

Fornecer um código 2FA ao entrar no site

Depois de entrar no GitHub Enterprise Server usando sua senha, você precisará fornecer um código de autenticação de do seu aplicativo TOTP.

GitHub Enterprise Server só pedirá que você forneça seu código de autenticação 2FA novamente se você tiver se desconectado, se estiver usando um novo dispositivo, se estiver executando uma ação confidencial ou se sua sessão expirar. Para obter mais informações sobre a 2FA para ações confidenciais, confira "Modo sudo".

Gerar um código por meio de um aplicativo TOTP

Se você optar por configurar a autenticação de dois fatores usando um aplicativo TOTP no smartphone, será possível gerar um código de autenticação para o GitHub Enterprise Server a qualquer momento. Na maioria das vezes, apenas iniciar o aplicativo gera um novo código. Você deve consultar a documentação do seu aplicativo para obter instruções específicas.

Se você excluir seu aplicativo autenticador após configurar a autenticação de dois fatores, precisará fornecer seu código de recuperação para obter acesso à sua conta. Muitos aplicativos TOTP dão suporte ao backup seguro de seus códigos de autenticação na nuvem e podem ser restaurados se você perder o acesso ao seu dispositivo. Para obter mais informações, confira "Como recuperar sua conta se você perder suas credenciais de autenticação de dois fatores"

Usar a autenticação de dois fatores com a linha de comando

Depois de habilitar a 2FA, você não usará mais sua senha para acessar GitHub Enterprise Server na linha de comando. Em vez disso, use o Gerenciador de Credenciais do Git, um personal access token ou uma chave SSH.

Autenticação na linha de comando usando o Git Credential Manager

O Git Credential Manager é um auxiliar de credencial do git seguro que é executado em Windows, macOS e Linux. Para obter mais informações sobre auxiliares de credenciais do Git, confira Evitar repetições no livro Pro Git.

As instruções de instalação variam de acordo com o sistema operacional do computador. Para obter mais informações, confira Baixar e instalar no repositório GitCredentialManager/git-credential-manager.

Autenticar na linha de comando usando HTTPS

Você precisará criar um personal access token para usá-lo como senha na autenticação no GitHub Enterprise Server na linha de comando usando URLs HTTPS.

Quando precisar fornecer um nome de usuário e uma senha na linha de comando, use seu nome de usuário do GitHub Enterprise Server e o personal access token. O prompt da linha de comando não especificará que você deve inserir seu personal access token quando solicitar sua senha.

Para obter mais informações, confira "Como criar um personal access token".

Autenticar na linha de comando usando SSH

Habilitar a 2FA não altera como você faz a autenticação no GitHub Enterprise Server na linha de comando usando URLs SSH. Para obter mais informações sobre como configurar e usar uma chave SSH, confira "Como se conectar ao GitHub com o SSH".

Usar a autenticação de dois fatores para acessar um repositório usando o Subversion

Observação: o suporte ao Subversion será removido do GitHub em 8 de janeiro de 2024. Uma versão futura do GitHub Enterprise Server após 8 de janeiro de 2024 também removerá o suporte ao Subversion. Para ler mais sobre isso, consulte o blog do GitHub.

Quando você acessa um repositório por meio do Subversion, é preciso fornecer um personal access token em vez de inserir sua senha. Para obter mais informações, confira "Como criar um personal access token".

Solução de problemas

Em caso de perda de acesso às suas credenciais de autenticação de dois fatores, você poderá usar seus códigos de recuperação ou outro método de recuperação (se houver um configurado) para obter acesso novamente à sua conta. Para obter mais informações, confira "Como recuperar sua conta se você perder suas credenciais de 2FA".

Se a autenticação falhar várias vezes, talvez seja conveniente sincronizar o relógio do seu telefone com o provedor móvel. Muitas vezes, isso envolve verificar a opção "Set automatically" (Definir automaticamente) no relógio do seu telefone, em vez de fornecer seu próprio fuso horário.

Leitura adicional