Saltar al contenido

fatal: could not read Username for github.com: Solución

Última actualización:

fatal: could not read Username for 'https://github.com' significa que git intentó obtener algo a través de HTTPS, le pidió credenciales y no tenía ninguna que proporcionar. En un flujo de trabajo no hay terminal donde escribirlas, así que git se rinde. El desencadenante habitual es un repositorio privado: un submódulo privado, un paquete privado instalado desde una URL de git o un segundo repositorio que se clona. El GITHUB_TOKEN integrado solo cubre el repositorio en el que se ejecuta el flujo de trabajo.

El mensaje exacto

fatal: could not read Username for 'https://github.com': No such device or address
fatal: could not read Username for 'https://github.com': terminal prompts disabled

Ambas formas significan lo mismo. Un mensaje relacionado para remotos SSH es Permission denied (publickey).

Solución 1: clonar un segundo repositorio privado con un token

steps:
  - uses: actions/checkout@v4
  - uses: actions/checkout@v4
    with:
      repository: my-org/private-lib
      path: private-lib
      token: ${{ secrets.CROSS_REPO_TOKEN }}

CROSS_REPO_TOKEN debe ser un token de acceso personal de grano fino o un token de instalación de GitHub App con permiso de lectura en Contents para ese único repositorio. Cree un token para el conjunto más pequeño de repositorios que necesite.

Solución 2: submódulos privados

- uses: actions/checkout@v4
  with:
    submodules: recursive
    token: ${{ secrets.CROSS_REPO_TOKEN }}

El token que pase también se usa para las descargas de los submódulos. Si el archivo .gitmodules usa URL SSH, cámbielas a HTTPS o use una clave SSH (consulte la página de publickey).

Solución 3: dependencias instaladas desde URL de git

npm install, pip install git+https://..., go get y las dependencias git de Cargo ejecutan git por su cuenta. Indique a git que use el token para cada URL HTTPS de GitHub antes del paso de instalación:

- name: Let git use a token for private GitHub dependencies
  run: git config --global url."https://x-access-token:${GH_TOKEN}@github.com/".insteadOf "https://github.com/"
  env:
    GH_TOKEN: ${{ secrets.CROSS_REPO_TOKEN }}
- run: npm ci

En Go, establezca también GOPRIVATE=github.com/my-org/* para que el proxy de Go no consulte los módulos privados. En los runners alojados, la máquina es nueva, así que esta configuración desaparece al terminar el trabajo. En un runner autohospedado que se reutiliza, use git config --local o elimínela después para que el token no quede guardado en disco.

Solución 4: el token está configurado pero no tiene acceso

Si ya pasa un token, compruebe que no haya caducado, que se creó para la organización correcta y que el SSO de la organización está autorizado para él, si la organización lo exige. Un token con el alcance adecuado pero sin acceso al repositorio concreto provoca errores de la misma familia, a veces como Repository not found.

Solución 5: el nombre del repositorio es incorrecto

Una errata en repository: produce un fallo que parece un problema de autenticación, porque GitHub no revela si existe un repositorio privado.

Cómo prevenirlo

  1. Use un token de GitHub App o un token de grano fino limitado a los repositorios que necesite el flujo de trabajo.
  2. Centralice el acceso entre repositorios en un único secreto documentado y configure un recordatorio de caducidad.
  3. Prefiera HTTPS con un token en CI frente a SSH, salvo que tenga configurada una clave de despliegue.
  4. Evite las dependencias git privadas cuando un registro de paquetes sea suficiente.
  5. No imprima nunca el token. Los secretos se ocultan en los registros, pero una URL que lo incluya en una línea de depuración puede filtrarse de otras formas.

Preguntas frecuentes

¿Por qué mi GITHUB_TOKEN no funciona para otro repositorio?

El GITHUB_TOKEN está limitado al repositorio que ejecuta el flujo de trabajo. Para acceder a cualquier otro repositorio privado se necesita un token diferente.

¿Este error significa que mi token es incorrecto?

Significa que no se proporcionó ninguna credencial para esa URL. Si se usara un token incorrecto, normalmente vería un 403 o Authentication failed.

¿Necesito un token de acceso personal?

No necesariamente. Para los equipos es mejor un token de instalación de GitHub App, porque no está vinculado a la cuenta de una persona.

¿Ocurre en repositorios públicos?

No al clonarlos. Puede aparecer si la URL apunta a un repositorio que se renombró, se hizo privado o se eliminó.