Zum Inhalt springen

fatal: could not read Username for github.com: Beheben

Zuletzt aktualisiert am

fatal: could not read Username for 'https://github.com' bedeutet, dass Git versucht hat, etwas über HTTPS abzurufen, nach Zugangsdaten gefragt wurde und keine zur Verfügung hatte. In einem Workflow gibt es kein Terminal, in das Sie etwas eingeben könnten, daher bricht Git ab. Der häufigste Auslöser ist ein privates Repository: ein privates Submodule, ein privates Paket, das über eine Git-URL installiert wird, oder ein zweites Repository, das Sie auschecken. Das integrierte GITHUB_TOKEN gilt nur für das Repository, in dem der Workflow läuft.

Die genaue Meldung

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

Beide Varianten haben dieselbe Ursache. Eine verwandte Meldung für SSH-Remotes lautet Permission denied (publickey).

Lösung 1: Ein zweites privates Repository mit einem Token auschecken

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 sollte ein Fine-grained Personal Access Token oder ein Installation-Token einer GitHub App mit Leseberechtigung für Contents in diesem einen Repository sein. Erstellen Sie das Token für möglichst wenige Repositories.

Lösung 2: Private Submodule

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

Das übergebene Token wird auch für das Abrufen der Submodule verwendet. Verwenden die URLs in der Datei .gitmodules SSH, stellen Sie sie auf HTTPS um oder verwenden Sie einen SSH-Schlüssel (siehe die Seite zu publickey).

Lösung 3: Abhängigkeiten, die über Git-URLs installiert werden

npm install, pip install git+https://..., go get und Cargo-Git-Abhängigkeiten führen Git selbst aus. Weisen Sie Git vor dem Installationsschritt an, für jede GitHub-HTTPS-URL das Token zu verwenden:

- 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

Setzen Sie für Go zusätzlich GOPRIVATE=github.com/my-org/*, damit der Go-Proxy nicht nach privaten Modulen gefragt wird. Bei gehosteten Runnern ist die Maschine für jeden Job neu, daher ist diese Einstellung nach dem Job verschwunden. Auf einem selbst gehosteten, wiederverwendeten Runner verwenden Sie git config --local oder entfernen die Einstellung danach, damit das Token nicht auf der Festplatte verbleibt.

Lösung 4: Das Token ist gesetzt, hat aber keinen Zugriff

Wenn Sie bereits ein Token übergeben, prüfen Sie, ob es nicht abgelaufen ist, für die richtige Organisation erstellt wurde und – falls die Organisation es verlangt – für SSO autorisiert ist. Ein Token mit dem richtigen Scope, aber ohne Zugriff auf das konkrete Repository, erzeugt ähnliche Fehler, manchmal als Repository not found.

Lösung 5: Der Repository-Name ist falsch

Ein Tippfehler in repository: führt zu einem Fehler, der wie ein Authentifizierungsproblem aussieht, da GitHub nicht verrät, ob ein privates Repository existiert.

So verhindern Sie den Fehler

  1. Verwenden Sie ein Token einer GitHub App oder ein Fine-grained Token, das auf die Repositories beschränkt ist, die der Workflow benötigt.
  2. Bündeln Sie den repositoryübergreifenden Zugriff in einem dokumentierten Secret und setzen Sie eine Erinnerung für das Ablaufdatum.
  3. Bevorzugen Sie in der CI HTTPS mit einem Token gegenüber SSH, sofern Sie keinen Deploy Key eingerichtet haben.
  4. Vermeiden Sie private Git-Abhängigkeiten, wo eine Paket-Registry ausreichen würde.
  5. Geben Sie das Token niemals aus. Secrets werden in Logs maskiert, aber eine URL mit dem Token in einer Debug-Zeile kann auf anderem Weg trotzdem offenliegen.

FAQ

Warum funktioniert mein GITHUB_TOKEN nicht für ein anderes Repository?

Das GITHUB_TOKEN ist auf das Repository beschränkt, in dem der Workflow läuft. Für den Zugriff auf andere private Repositories ist ein anderes Token nötig.

Bedeutet dieser Fehler, dass mein Token falsch ist?

Er bedeutet, dass für diese URL keine Zugangsdaten übergeben wurden. Bei einem falschen Token würden Sie in der Regel einen 403-Fehler oder Authentication failed sehen.

Brauche ich ein persönliches Access Token?

Nicht unbedingt. Für Teams ist ein Installation-Token einer GitHub App besser, da es nicht an das Konto einer einzelnen Person gebunden ist.

Tritt das auch bei öffentlichen Repositories auf?

Nicht beim Klonen. Er kann auftreten, wenn die URL auf ein Repository zeigt, das umbenannt, auf privat gestellt oder gelöscht wurde.