Sobre a autenticação no GitHub

Sobre autenticação no GitHub

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

Você pode acessar seus recursos em GitHub AE 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 AE é compatível com diferentes modos de autenticação.

• Seu IdP (provedor de identidade)
• Personal access token
• Chave SSH

Efetuar a autenticação no seu navegador

Você pode se autenticar no GitHub AE no navegador usando o IdP. Para obter mais informações, confira "Sobre a autenticação com logon único de SAML".

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 "Managing your personal access tokens".

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 "Sobre a autenticação com um 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 AE 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 AE 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. Para obter mais informações, veja "Managing your personal access tokens". Sempre que você usar o Git para se autenticar no GitHub AE, precisará inserir suas credenciais para se autenticar no GitHub AE, a menos que você armazene em cache com um auxiliar de credencial.

SSH

Você pode trabalhar com todos os repositórios no GitHub AE 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 GitHub AE. 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 GitHub AE. 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 AE, 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 token	Prefixo	Mais informações
Personal access token	ghp_	"Managing your personal access tokens"
token de acesso OAuth	gho_	"Autorizando Aplicativos OAuth"
Token de acesso de usuário para um GitHub App	ghu_	"Autenticação com um aplicativo GitHub em nome de um usuário"
Token de acesso de instalação para um GitHub App	ghs_	"Como autenticar como uma instalação de Aplicativo GitHub"
Atualizar token para um GitHub App	ghr_	"Atualizar tokens de acesso do usuário"