Skip to main content

Vencimiento y revocación de tokens

Sus tokens pueden caducar y también pueden ser revocados por usted, por las aplicaciones que ha autorizado y por GitHub.

Cuando un token ha expirado o se ha revocado, ya no se puede usar para autenticar solicitudes de Git y de API. No es posible restablecer un token revocado o vencido, ya seas tú o la aplicación necesitarán crear un token nuevo.

En este artículo se explican las posibles razones por las que tu token GitHub podría revocarse o caducar.

Nota:

Cuando un token personal access token, OAuth app o GitHub App expira o se revoca, es posible que vea la acción oauth_authorization.destroy en el registro de seguridad. Para más información, consulta Revisar tu registro de seguridad.

El token se revocó después de llegar a su fecha de vencimiento

Al crear un personal access token, se recomienda establecer una expiración para el token. Al alcanzar la fecha de vencimiento de tu token, este se revocará automáticamente. Para más información, consulta Administración de tokens de acceso personal.

El usuario revocó el token

Puede revocar la autorización de una GitHub App o OAuth app desde la configuración de su cuenta, lo que revocará todos los tokens asociados a la aplicación. Para más información, consulta Revisión y revocación de autorización de aplicaciones de GitHub y Revisión de las aplicaciones autorizadas de OAuth.

Una vez que se revoca una autorización, cualquier token asociado con la autorización también se revocará. Para volver a autorizar una aplicación, siga las instrucciones de la aplicación o sitio web de terceros para volver a conectar su cuenta en GitHub.

OAuth app revocó el token

El propietario de un OAuth app puede revocar la autorización de una cuenta para su aplicación, lo que también revocará los tokens asociados a dicha autorización. Para obtener más información sobre la revocación de las autorizaciones de sus OAuth app, consulte Puntos de conexión de la API de REST para las autorizaciones de OAuth.

OAuth app los propietarios también pueden revocar tokens individuales asociados a una autorización. Para obtener más información sobre cómo revocar tokens individuales para OAuth app, consulte Puntos de conexión de la API de REST para las autorizaciones de OAuth.

Se revocó el token debido a un exceso de tokens para un OAuth app con el mismo ámbito

Hay un límite de diez tokens que se emiten por combinación de usuario/aplicación/ámbito y un límite de frecuencia de diez tokens creados por hora. Si una aplicación crea más de diez tokens para el mismo usuario y los mismos alcances, se revocarán los tokens más antiguos con la misma combinación de usuario/aplicación/alcance. Sin embargo, alcanzar el límite de volumen por hora no revocará el token más antiguo. En su lugar, desencadenará una solicitud de nueva autorización en el explorador, y se pedirá al usuario que compruebe los permisos que concede a la aplicación. Este mensaje está pensado interrumpir cualquier bucle infinito posible en el que la aplicación está atrapada, ya que hay pocos o ningún motivo para que una aplicación solicite diez tokens al usuario en un plazo de una hora.

El token de usuario ha expirado debido a la GitHub App configuración

Los tokens de acceso de usuario creados por un GitHub App expirarán después de ocho horas de forma predeterminada y, a continuación, se deben volver a generar mediante el token de actualización incluido. Los propietarios de GitHub Apps pueden configurar estos tokens para que nunca expiren en su lugar, pero esto no se recomienda debido a las implicaciones de seguridad. Para obtener más información sobre la configuración de los tokens de acceso de usuario de GitHub App, consulte Activación de características opcionales para aplicaciones de GitHub.