Skip to main content

Vencimento e revogação de token

Seus tokens podem expirar e também podem ser revogados por você, por aplicativos que você autorizou e pelo próprio GitHub.

Quando um token vencer ou for revogado, ele não poderá mais ser usado para autenticar solicitações do Git e da API. Não é possível restaurar um token vencido ou revogado, você ou o aplicativo deverá criar um novo token.

Este artigo explica os possíveis motivos pelos quais seu GitHub token pode ser revogado ou expirar.

Observação

Quando um personal access token, um token OAuth app ou um token GitHub App expira ou é revogado, você poderá ver a ação oauth_authorization.destroy no seu registro de segurança. Para saber mais, confira Revisar seus logs de segurança.

Token revogado após atingir sua data de validade

Ao criar um personal access token, recomendamos que você defina uma expiração para o token. Ao alcançar a data de vencimento do seu token, este será automaticamente revogado. Para saber mais, confira Gerenciar seus tokens de acesso pessoal.

Token revogado pelo usuário

Você pode revogar a autorização de um GitHub App ou OAuth app nas configurações da sua conta, o que revogará todos os tokens associados ao aplicativo. Para saber mais, confira Revisão e revogação da autorização de aplicativos GitHub e Revisar aplicações OAuth autorizadas.

Depois que uma autorização for revogada, todos os tokens associados à autorização também serão revogados. Para reautorizar um aplicativo, siga as instruções do aplicativo ou site de terceiros para conectar sua conta GitHub novamente.

Token revogado pelo OAuth app

O proprietário de OAuth app pode revogar a autorização de uma conta para seu aplicativo; isso também revogará todos os tokens associados a essa autorização. Para obter mais informações sobre como revogar as autorizações de seu OAuth app, consulte Pontos de extremidade da API REST para autorizações de OAuth.

OAuth app os proprietários também podem revogar tokens individuais associados a uma autorização. Para obter mais informações sobre como revogar tokens individuais para o seu OAuth app, consulte Pontos de extremidade da API REST para autorizações de OAuth.

Token revogado devido ao excesso de tokens para um OAuth app com o mesmo escopo

Há um limite de dez tokens emitidos por combinação de usuário/aplicativo/escopo e um limite de taxa de dez tokens criados por hora. Se um aplicativo criar mais de dez tokens para o mesmo usuário e os mesmos escopos, os tokens mais antigos com a mesma combinação de usuário/aplicativo/escopo serão revogados. No entanto, atingir o limite da taxa horária não revogará seu token mais antigo. Em vez disso, ele acionará um aviso de reautorização no navegador, solicitando que o usuário verifique novamente as permissões que está concedendo ao seu aplicativo. Esse prompt tem o objetivo de interromper qualquer possível loop infinito em que o aplicativo esteja preso, já que há pouca ou nenhuma razão para um aplicativo solicitar dez tokens do usuário em uma hora.

O token de usuário expirou devido à GitHub App configuração

Os tokens de acesso do usuário criados por um GitHub App expirarão após oito horas por padrão e, em seguida, deverão ser regenerados usando o token de atualização incluído. GitHub Apps Opcionalmente, os proprietários podem configurar esses tokens para nunca expirarem, mas isso não é recomendado devido às implicações de segurança. Para obter mais informações sobre como configurar os GitHub Apptokens de acesso do usuário, consulte Ativando recursos opcionais para aplicativos GitHub.