Warum erscheint die Fehlermeldung „Authentication failed“ in der Git Client App?
- Kurzüberblick: was die Meldung bedeutet
- Falsche oder veraltete Zugangsdaten
- Fehlende oder falsch konfigurierte SSH-Schlüssel
- Zwei-Faktor-Authentifizierung und Token-Anforderung
- Konfigurationsfehler im Client
- Rechte- und Berechtigungsprobleme auf Seiten des Servers
- Netzwerk- oder Sicherheitsmittel stören die Verbindung
- Was Sie prüfen und tun können
Kurzüberblick: was die Meldung bedeutet
Die Fehlermeldung „Authentication failed“ in einer Git-Client-App bedeutet, dass der Client beim Versuch, sich gegenüber dem entfernten Git-Server (z. B. GitHub, GitLab, Bitbucket) zu authentifizieren, abgewiesen wurde. Das heißt, die übermittelten Anmeldedaten oder Authentifizierungsinformationen waren entweder falsch, ungültig, abgelaufen oder wurden gar nicht akzeptiert.
Falsche oder veraltete Zugangsdaten
Häufige Ursache ist die Verwendung eines falschen Benutzernamens oder Passworts. Bei vielen Diensten sind Passwörter mittlerweile nicht mehr für Git-Operationen zugelassen; stattdessen sind persönliche Zugriffstoken (PAT), App-Passwörter oder SSH-Schlüssel nötig. Wenn Sie weiterhin ein altes Passwort nutzen oder ein Token abgelaufen ist, schlägt die Anmeldung fehl.
Fehlende oder falsch konfigurierte SSH-Schlüssel
Wenn Ihr Client SSH zur Authentifizierung verwendet, kann „Authentication failed“ auftreten, wenn kein privater Schlüssel vorhanden ist, der öffentliche Schlüssel nicht beim Server hinterlegt ist, die Schlüsselberechtigungen falsch gesetzt sind (z. B. zu offen), oder der SSH-Agent den Schlüssel nicht lädt. Auch ein falscher Key-Algorithmus oder eine Änderung der Schlüsseldatei kann Probleme verursachen.
Zwei-Faktor-Authentifizierung und Token-Anforderung
Viele Hosting-Dienste verlangen bei aktiviertem Zwei-Faktor-Authentifizierungs (2FA) Mechanismus, dass für Git-Zugriffe anstelle des Passworts ein persönlicher Zugriffstoken oder App-spezifisches Passwort verwendet wird. Wird das herkömmliche Passwort eingegeben, lehnt der Server die Authentifizierung ab.
Konfigurationsfehler im Client
Der Git-Client kann auf falsche Anmeldeinformationen zugreifen, weil Zugangsdaten im Credential Helper, System-Schlüsselbund oder in der Konfiguration gespeichert sind und veraltet sind. Proxy- oder Netzwerk-Einstellungen im Client können ebenfalls bewirken, dass die Authentifizierungsanfrage nicht korrekt beim Server ankommt und dadurch scheitert.
Rechte- und Berechtigungsprobleme auf Seiten des Servers
Selbst bei korrekt übermittelten Anmeldeinformationen kann der Server den Zugriff verweigern, wenn das verwendete Konto nicht über ausreichende Berechtigungen für das Repository verfügt, das Repository verschoben oder gelöscht wurde, oder organisatorseigene Richtlinien (z. B. IP-Whitelist, SAML-Schutz) den Zugriff beschränken.
Netzwerk- oder Sicherheitsmittel stören die Verbindung
Firewalls, Proxies, VPNs oder Sicherheitslösungen können die Authentifizierung beeinträchtigen, etwa indem sie Header verändern, Verbindungen unterbrechen oder bestimmte Ports/Protokolle blockieren. Auch temporäre Serverprobleme beim Git-Hosting können zu vorübergehenden Authentifizierungsfehlern führen.
Was Sie prüfen und tun können
Überprüfen Sie, ob Sie das korrekte Verfahren (HTTPS mit PAT/Token oder SSH mit hinterlegtem Schlüssel) verwenden. Kontrollieren Sie gespeicherte Zugangsdaten im Credential Manager oder Schlüsselbund und löschen Sie veraltete Einträge. Stellen Sie sicher, dass SSH-Schlüssel korrekt installiert und berechtigt sind sowie der SSH-Agent läuft. Prüfen Sie, ob 2FA aktiv ist und ob Sie ein gültiges Token oder App-Passwort nutzen. Testen Sie die Verbindung mit einem einfachen Befehl (z. B. ssh -T git@provider oder git ls-remote) und lesen Sie die genaue Serverantwort. Falls nötig, konsultieren Sie die Hosting-Dokumentation oder den Administrator, um Konto- oder Berechtigungsprobleme auszuschließen.
Wenn Sie diese Punkte systematisch prüfen, lässt sich die Ursache der Meldung in den meisten Fällen schnell finden und beheben.