Acerca de la autenticación en GitHub

Acerca de la autenticación en GitHub

A fin de proteger la cuenta, debe autenticarse para poder acceder a determinados recursos en GitHub Enterprise Server. Cuando te autenticas en GitHub Enterprise Server, proporcionas o confirmas las credenciales que son específicas para ti y así compruebas de que eres exactamente quien estás declarando ser.

Puedes acceder a tus recursos en GitHub Enterprise Server de muchas maneras: en el buscador, a través de GitHub Desktop o de alguna otra aplicación de escritorio, con la API o a través de la línea de comandos. Cada forma de acceder a GitHub Enterprise Server es compatible con diferentes modalidades de autenticación.

• Tu proveedor de identidades (IdP)
• Nombre de usuario y contraseña con autenticación en dos fases
• Personal access token
• Llave SSH

Autenticarte en tu buscador

Puedes autenticarte en GitHub Enterprise Server desde el explorador de diversas formas.

• Solo nombre de usuario y contraseña
  • Crearás una contraseña cuando crees tu cuenta en GitHub Enterprise Server. Te recomendamos que utilices un administrador de contraseñas para generar una contraseña aleatoria y única. Para más información, consulta "Crear una contraseña segura".
• Autenticación en dos fases(2FA) (recomendada)
  • Si habilitas la autenticación en dos fases, después de escribir correctamente el nombre de usuario y la contraseña, también te pediremos que proporciones un código generado por una aplicación de contraseñas de un solo uso y duración definida (TOTP) en el dispositivo móvil. Para obtener más información, consulta "Acceder a GitHub utilizando la autenticación de dos factores".
  • Además de la autenticación con una aplicación TOTP, opcionalmente puedes agregar un método alternativo de autenticación con una clave de seguridad mediante WebAuthn. Para obtener más información, consulta "Configurar la autenticación de dos factores".
• Autenticación externa
  • El administrador del sitio puede configurar tu instancia de GitHub Enterprise Server para usar la autenticación externa en lugar de un nombre de usuario y una contraseña. Para obtener más información, consulta "Acerca de la autenticación para tu empresa".

Autenticarte con GitHub Desktop

Puedes autenticarte con GitHub Desktop utilizando tu buscador. Para obtener más información, vea «Autenticación en GitHub en GitHub Desktop».

Autenticarte con la API

Puedes autenticarte con la API de varias formas. Para obtener más información, vea «Autenticación en la API REST».

Autenticación en la API con un personal access token

Si quieres usar la API REST de GitHub para uso personal, puedes crear un personal access token. Para obtener más información sobre cómo crear un personal access token, consulta "Managing your personal access tokens".

Autenticación en la API con una aplicación

Si deseas usar la API en nombre de una organización u otro usuario, GitHub recomienda usar un GitHub App. Para obtener más información, vea «About authentication with a GitHub App».

También puedes crear un token de OAuth con una OAuth App para acceder a la API REST. Pero en GitHub se recomienda usar una GitHub App en su lugar. Las GitHub App permiten un mayor control sobre el acceso y el permiso que tiene la aplicación.

Autenticación en la API en un flujo de trabajo de GitHub Actions

Si deseas usar la API en un flujo de trabajo de GitHub Actions, GitHub recomienda autenticarse con el GITHUB_TOKEN integrado en lugar de crear un token. Puedes conceder permisos a GITHUB_TOKEN con la clave permissions. Para obtener más información, vea «Autenticación automática de tokens».

Autenticarte con la línea de comandos

Puedes acceder a los repositorios en GitHub Enterprise Server desde la línea de comandos en dos formas, HTTPS y SSH, y ambas tienen una forma diferente para autenticarte. El método para autenticarte se determina con base en si escoges una URL remota de HTTPS o SSH cuando clonas el repositorio. Para obtener más información sobre de qué forma obtener acceso, consulta "Acerca de los repositorios remotos".

HTTPS

Puedes trabajar con todos los repositorios en GitHub Enterprise Server a través de HTTPS, aún si estás detrás de un cortafuegos o de un proxy.

Si te autenticas con GitHub CLI, puedes autenticarte con un personal access token o a través del explorador web. Para obtener más información sobre la autenticación con GitHub CLI, consulta gh auth login.

Si te autenticas sin GitHub CLI, debes autenticarte con un personal access token. Cuando Git le solicite la contraseña, escriba los datos personal access token. También puedes usar un asistente de credenciales como el Administrador de credenciales de Git. La autenticación basada en contraseña para Git se quitó en favor de métodos de autenticación más seguros. Para más información, consulta "Managing your personal access tokens". Cada vez que uses Git para autenticarte con GitHub Enterprise Server, se te pedirá que escribas las credenciales para autenticarte con GitHub Enterprise Server, a menos que las almacene en caché con un asistente de credenciales.

SSH

Puedes trabajar con todos los repositorios de GitHub Enterprise Server a través de SSH, aunque los cortafuegos y proxies podrían rehusarse a permitir conexiones SSH.

Si te autenticas con elGitHub CLI, este encontrará llaves SSH públicas en tu máquina y te pedirá seleccionar una para cargar. Si GitHub CLI no encuentra una clave pública SSH para cargar, puede generar un par de claves SSH pública/privada y cargar la clave pública en tu cuenta de tu instancia de GitHub Enterprise Server. A continuación, podrás autenticarte con un personal access token o a través del explorador web. Para obtener más información sobre la autenticación con GitHub CLI, consulta gh auth login.

Si te autenticas sin GitHub CLI, necesitarás generar un par de claves pública/privada en tu máquina local y agregar la clave pública a tu cuenta de tu instancia de GitHub Enterprise Server. Para obtener más información, vea «Generación de una nueva clave SSH y adición al agente SSH». Cada vez que use Git para autenticarse con GitHub Enterprise Server, se le pedirá que escriba la frase de contraseña de la clave SSH, a menos que haya almacenado la clave.

Formatos de los tokens de GitHub

GitHub emite tokens que inician con un prefijo para indicar el tipo de los mismos.

Tipo de token	Prefijo	Más información
Personal access token	ghp_	"Managing your personal access tokens"
Token de acceso OAuth	gho_	"Autorización de aplicaciones de OAuth"
Token de acceso de usuario para una GitHub App	ghu_	"Autenticación con una aplicación de GitHub en nombre de un usuario"
Token de acceso de instalación para una GitHub App	ghs_	"Autenticación como una instalación de una aplicación de GitHub"
Actualizar un token para una GitHub App	ghr_	"Actualización de tokens de acceso de usuario"