Versão do artigo: Enterprise Server 2.17
Acessar o GitHub usando a autenticação de dois fatores
Com a 2FA habilitada, será solicitado o seu código de autenticação 2FA, bem como sua senha, quando você entrar ou autenticar-se no GitHub Enterprise.
Neste artigo
- Fornecer um código 2FA ao entrar no site
- Usar a autenticação de dois fatores com a API
- Usar a autenticação de dois fatores com o GitHub Desktop
- Usar a autenticação de dois fatores com a linha de comando
- Usar a autenticação de dois fatores para acessar um repositório usando o Subversion
- Solução de Problemas
- Leia mais
Com a autenticação de dois fatores habilitada, você precisará fornecer um código de autenticação ao acessar o GitHub Enterprise por meio do site, usando a API ou pelo GitHub Desktop. Se você acessar o GitHub Enterprise usando outros métodos, será preciso fornecer uma segunda forma alternativa de autenticação.
Fornecer um código 2FA ao entrar no site
Depois de entrar no GitHub Enterprise usando sua senha, será solicitado que você forneça um código de autenticação de do seu app TOTP.
O GitHub Enterprise solicitará seu código de autenticação 2FA novamente apenas se você se desconectar, for usar um novo dispositivo ou a sessão expirar.
Dica: se for fornecer um código de recuperação em vez de um código de autenticação, certifique-se de não inserir o código de recuperação no campo do código de autenticação. Para obter mais informações, consulte "Recuperar sua conta se você perder as credenciais da 2FA".
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 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.
Em caso de exclusão do aplicativo móvel após configuração da autenticação de dois fatores, será preciso fornecer seu código de recuperação para obter acesso à sua conta. Para obter mais informações, consulte "Recuperar sua conta se você perder as credenciais da autenticação de dois fatores"
Usar a autenticação de dois fatores com a API
Com a 2FA habilitada, você precisará transmitir um header especial contendo seu código de autenticação 2FA. Para obter mais informações, consulte "Outros métodos de autenticação" na documentação do GitHub Developer.
Usar a autenticação de dois fatores com o GitHub Desktop
Para obter mais informações sobre como acessar o GitHub Desktop com a autenticação de dois fatores, consulte "Autenticar no GitHub" na documentação do GitHub Desktop.
Usar a autenticação de dois fatores com a linha de comando
Após habilitação da 2FA, você deverá usar um token de acesso pessoal ou uma chave SSH em vez da senha ao acessar o GitHub Enterprise na linha de comando.
Autenticar na linha de comando usando HTTPS
Após habilitação da 2FA, você deverá criar um token de acesso pessoal a ser usado como uma senha ao autenticar no GitHub Enterprise na linha de comando usando URLs HTTPS.
Ao ser solicitado a fornecer um nome de usuário e uma senha na linha de comando, use seu nome de usuário no GitHub Enterprise e o token de acesso pessoal. O prompt da linha de comando não especificará que você deve inserir seu token de acesso pessoal quando solicitar sua senha.
Para obter mais informações, consulte "Criar um token de acesso pessoal para a linha de comando".
Autenticar na linha de comando usando SSH
Habilitar a 2FA não altera como você faz a autenticação no GitHub Enterprise na linha de comando usando URLs SSH. Para obter mais informações sobre como configurar e usar uma chave SSH, consulte "Conectar-se ao GitHub com SSH".
Usar a autenticação de dois fatores para acessar um repositório usando o Subversion
Quando você acessa um repositório via Subversion, é preciso fornecer um token de acesso pessoal no lugar de digitar sua senha. Para obter mais informações, consulte "Criar um token de acesso pessoal para a linha de comando".
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, consulte "Recuperar sua conta se você perder as credenciais da 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.