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.

Esta versão do GitHub Enterprise foi descontinuada em 2023-03-15. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Sobre a autenticação no GitHub

Você pode acessar com segurança os recursos da sua conta efetuando a autenticação no GitHub Enterprise Server e usando credenciais diferentes dependendo de onde você efetua a autenticação.

Sobre autenticação no GitHub

Para manter sua conta segura, você precisa se autenticar antes de acessar alguns recursos do GitHub Enterprise Server. Ao efetuar a autenticação em GitHub Enterprise Server, você fornece ou confirma credenciais que são exclusivas que provam quem você declara ser.

Você pode acessar seus recursos em GitHub Enterprise Server de várias formas: no navegador, por meio do GitHub Desktop ou outro aplicativo da área de trabalho, com a API ou por meio da linha de comando. Cada forma de acessar o GitHub Enterprise Server é compatível com diferentes modos de autenticação.

  • Seu IdP (provedor de identidade)
  • O nome de usuário e a senha com autenticação de dois fatores
  • Personal access token
  • Chave SSH

Efetuar a autenticação no seu navegador

Você pode efetuar a autenticação no GitHub Enterprise Server no seu navegador de diferentes formas.

  • Somente nome de usuário e senha
    • Você criará uma senha ao criar sua conta no GitHub Enterprise Server. Recomendamos que você use um gerenciador de senhas para gerar uma senha aleatória e única. Para mais informações, confira "Criar uma senha forte".
  • 2FA (autenticação de dois fatores) (recomendado)
    • Se você habilitar a 2FA, depois de inserir com êxito seu nome de usuário e senha, também solicitaremos que você forneça um código gerado por um aplicativo TOTP (Senhas Avulsas por Tempo Limitado) em seu dispositivo móvel. Para obter mais informações, confira "Acessar o GitHub usando a autenticação de dois fatores".
    • Além da autenticação com um aplicativo TOTP, você tem a opção de adicionar um método alternativo de autenticação com uma chave de segurança usando WebAuthn. Para obter mais informações, confira "Configurar a autenticação de dois fatores".
  • Autenticação externa
    • O administrador do site pode configurar o sua instância do GitHub Enterprise Server para usar uma autenticação externa em vez de um nome de usuário e uma senha. Para mais informações, confira "Sobre a autenticação para sua empresa".

Efetuar a autenticação com GitHub Desktop

Você pode efetuar a autenticação com o GitHub Desktop usando seu navegador. Para obter mais informações, confira "Autenticar para o GitHub no GitHub Desktop".

Efetuar a autenticação com a API

Você pode efetuar a autenticação com a API de diferentes formas. Para obter mais informações, confira "Autenticação na API REST".

Autenticação na API com um personal access token

Caso você deseje usar a API REST do GitHub para uso pessoal, crie um personal access token. Para obter mais informações sobre como criar um personal access token, confira "Criando um token de acesso pessoal".

Autenticação na API com um aplicativo

Se você quiser usar a API em nome de uma organização ou de outro usuário, a GitHub recomenda que você use um GitHub App. Para obter mais informações, confira "About authentication with a GitHub App".

Você também pode criar um token OAuth com um OAuth App para acessar a API REST. No entanto, o GitHub recomenda que você use um GitHub App. Os GitHub Apps permitem mais controle sobre o acesso e a permissão que o aplicativo tem.

Autenticação na API em um fluxo de trabalho do GitHub Actions

Se você quiser usar a API em um fluxo de trabalho de GitHub Actions, a GitHub recomenda que você se autentique com o GITHUB_TOKEN interno, em vez de criar um token. Você pode conceder permissões à GITHUB_TOKEN com a chave permissions. Para obter mais informações, confira "Autenticação automática de token".

Efetuando a autenticação com a linha de comando

Você pode acessar repositórios no GitHub Enterprise Server pela linha de comando de duas maneiras, HTTPS e SSH. Ambos têm uma maneira diferente de efetuar a autenticação. O método de autenticação é determinado com base na escolha de uma URL remota de HTTPS ou SSH quando você clonar o repositório. Para obter mais informações sobre as formas de acesso, confira "Sobre repositórios remote".

HTTPS

Você pode trabalhar com todos os repositórios no GitHub Enterprise Server por meio de HTTPS, mesmo que você esteja atrás de um firewall ou proxy.

Se você fizer a autenticação com a GitHub CLI, poderá fazer a autenticação com um personal access token ou por meio do navegador da Web. Para obter mais informações sobre como se autenticar com a GitHub CLI, confira gh auth login.

Se você fizer a autenticação sem a GitHub CLI, precisará fazer a autenticação com um personal access token. Quando o Git solicitar sua senha, insira seu personal access token. Como alternativa, você pode usar um auxiliar de credencial como o Gerenciador de Credenciais do Git. A autenticação baseada em senha do Git foi removida para dar lugar a métodos de autenticação mais seguros. Para obter mais informações, veja "Criando um token de acesso pessoal". Sempre que você usar o Git para se autenticar no GitHub Enterprise Server, precisará inserir suas credenciais para se autenticar no GitHub Enterprise Server, a menos que você armazene em cache com um auxiliar de credencial.

SSH

Você pode trabalhar com todos os repositórios no GitHub Enterprise Server por meio de SSH, embora os firewalls e proxys possam se recusar a permitir conexões de SSH.

Se você efetuar a autenticação com GitHub CLI, a CLI encontrará chaves públicas SSH no seu computador e solicitará que você selecione uma para upload. Se a GitHub CLI não encontrar uma chave pública SSH para o upload, ela poderá gerar um novo par de chaves pública/privada SSH e carregar a chave pública na sua conta do sua instância do GitHub Enterprise Server. Em seguida, você poderá fazer a autenticação com um personal access token ou por meio do navegador da Web. Para obter mais informações sobre como se autenticar com a GitHub CLI, confira gh auth login.

Se você fizer a autenticação sem a GitHub CLI, precisará gerar um par de chaves pública/privada SSH no computador local e adicionar a chave pública à sua conta do sua instância do GitHub Enterprise Server. Para obter mais informações, confira "Gerando uma nova chave SSH e adicionando-a ao agente SSH". Sempre que você usar o Git para se autenticar no GitHub Enterprise Server, precisará inserir sua frase secreta de chave SSH, a menos que tenha armazenado a chave.

Formatos de token de GitHub

GitHub emite tokens que começam com um prefixo para indicar o tipo do token.

Tipo de tokenPrefixoMais informações
Personal access tokenghp_"Criando um token de acesso pessoal"
token de acesso OAuthgho_"Autorizando Aplicativos OAuth"
Token de acesso de usuário para um GitHub Appghu_"Autenticação com um aplicativo GitHub em nome de um usuário"
Token de acesso de instalação para um GitHub Appghs_"Como autenticar como uma instalação de Aplicativo GitHub"
Atualizar token para um GitHub Appghr_"Atualizar tokens de acesso do usuário"