Skip to main content

Crear un token de acceso personal

Puedes crear un token de acceso personal para utilizar en vez de una contraseña con la línea de comandos o con la API.

Notas:

  • Si utilizas el CLI de GitHub para autenticarte en GitHub a través de la línea de comandos, puedes omitir el generar un token de acceso personal y autenticarte a través del buscador web en su lugar. Para obtener más información sobre cómo autenticarte con el CLI de GitHub, consulta la sección gh auth login.
  • El Administrador de Credenciales de Git es una alternativa segura y multiplataforma a utilizar los tokens de acceso personal (PAT), la cual elimina la necesidad de administrar el alcance y el vencimiento de estos. Para obtener las instrucciones de instalación, consulta la sección Descargar e instalar en el repositorio GitCredentialManager/git-credential-manager.

Los tokens de acceso personal (PAT) son una alternativa al uso de contraseñas para la autenticación en GitHub cuando utilizas la API de GitHub o la línea de comandos.

Si quieres utilizar un PAT para acceder a los recursos que pertenecen a una organización que utiliza el SSO de SAML, debes autorizarlo. Para obtener más información, consulta las secciones "Acerca de la autenticación con el inicio de sesión único de SAML" y "Autorizar un token de acceso personal para utilizarlo con el inicio de sesión único de SAML" en la documentación de Nube de GitHub Enterprise.

Como medida de precaución en seguridad, GitHub elimina automáticamente los tokens de acceso personal que no se hayan utilizando en un año. Para proporcionar seguridad adicional, te recomendamos ampliamente que agregues una fecha de vencimiento a tus tokens de acceso personal.

Un token sin alcances asignados solo puede acceder a información pública. Para usar tu token para acceder a repositorios desde la línea de comando, selecciona repo. Para obtener más información, consulta la sección "Alcances disponibles".

Crear un token

  1. Verifica tu dirección de correo electrónico, si aún no ha sido verificada.

  2. En la esquina superior derecha de cualquier página, da clic en tu foto de perfil y después da clic en Configuración.

    Icono Settings (Parámetros) en la barra de usuario

  3. En la barra lateral izquierda, haz clic en Ajustes de desarrollador.

  4. En la barra lateral izquierda, da clic en Tokens de acceso personal. Tokens de acceso personal

  5. Haz clic en Generar un nuevo token. Generar el botón para el nuevo token

  6. Asígnale a tu token un nombre descriptivo. Token description field

  7. Para dar un vencimiento a tu token, selecciona el menú desplegable de Vencimiento y luego haz clic en uno predeterminado o utiliza el selector de calendario. Token expiration field

  8. Selecciona los alcances o permisos que deseas otorgarle a este token. Para usar tu token para acceder a repositorios desde la línea de comando, selecciona repo.

    Seleccionar los alcances del token

  9. Haz clic en Generar token. Generar un botón para el token

    Token recién creado

    Advertencia:Preserva tus tokens de la misma manera que tus contraseñas y no se las reveles a nadie. Cuando trabajes con la API, usa tokens como variables del entorno en lugar de codificarlos de forma rígida en tus programas.

  10. Para utilizar tu token o autenticarte en una organización que utilice el inicio de sesión único de SAML, autoriza el token. Para obtener más información, consulta la sección "Autorizar un token de acceso personal para utilizarse con el inicio de sesión único de SAML" en la documentación de Nube de GitHub Enterprise.

Usar un token en la línea de comando

Una vez que tengas un token, puedes ingresarlo en lugar de tu contraseña cuando realices operaciones de Git a través de HTTPS.

Por ejemplo, en la línea de comando ingresarás lo siguiente:

$ git clone https://github.com/username/repo.git
Username: your_username
Password: your_token

Los tokens de acceso personal solo se pueden usar para operaciones HTTPS Git. Si tu repositorio usa una URL SSH remota, necesitarás pasar de la URL SSH remota a HTTPS.

Si no se te solicita tu nombre de usuario y contraseña, tus credenciales pueden estar almacenadas en la caché de tu computadora. Puedes actualizar tus credenciales en la keychain para reemplazar tu contraseña anterior con el token.

En vez de ingresar tu PAT manualmente para cada operación de HTTPS de Git, puedes almacenarlo en caché con un cliente de Git. Git almacenará tus credenciales temporalmente en la memoria hasta que haya pasado un intervalo de vencimiento. También puedes almacenar el token en un archivo de texto simple que pueda leer Git antes de cada solicitud. Para obtener más información, consulta la sección " Almacenar tus credencialesde GitHub en el caché dentro de Git".

Leer más