Wie behebe ich den Fehler "Authentication failed" bei der Anmeldung in GitHub Desktop?
- Überblick über die Ursache
- Überprüfung der Zugangsdaten
- Persönliches Zugriffstoken (PAT) erstellen
- Zwei-Faktor-Authentifizierung (2FA) und Token-Nutzung
- Gespeicherte Anmeldedaten in GitHub Desktop und System löschen
- GitHub Desktop aktualisieren
- Netzwerk und Proxy-Einstellungen prüfen
- SSH-Authentifizierung als Alternative
- Zusammenfassung
Überblick über die Ursache
Der Fehler "Authentication failed" tritt häufig auf, wenn GitHub Desktop die Zugangsdaten für den GitHub-Account nicht korrekt verifizieren kann. Dies kann verschiedene Gründe haben, beispielsweise falsche Eingabe von Benutzernamen oder Passwort, abgelaufene oder falsche Zugangstoken, Probleme mit der Zwei-Faktor-Authentifizierung (2FA) oder Konfigurationsprobleme in den gespeicherten Zugangsdaten.
Überprüfung der Zugangsdaten
Stellen Sie sicher, dass Sie Ihre korrekten GitHub-Zugangsdaten verwenden. Da GitHub seit einigen Jahren keine Passwort-Authentifizierung für Git-Operationen mehr erlaubt, sondern stattdessen persönliche Zugriffstoken (Personal Access Tokens, PAT), müssen Sie überprüfen, ob Sie bei GitHub Desktop mit einem PAT statt eines Passworts angemeldet sind. Wenn Sie sich mit Benutzername und Passwort versuchen anzumelden, wird die Authentifizierung fehlschlagen.
Persönliches Zugriffstoken (PAT) erstellen
Falls Sie noch kein persönliches Zugriffstoken besitzen oder Ihr Token abgelaufen ist, müssen Sie ein neues erzeugen. Melden Sie sich dazu auf GitHub im Bereich der Token-Einstellungen an und erstellen Sie ein neues Token. Achten Sie darauf, die notwendigen Berechtigungen (Scopes) zu setzen, die GitHub Desktop benötigt, etwa für Repo-Zugriff und ggf. Workflow oder Gist, je nach Ihrem Anwendungsfall.
Zwei-Faktor-Authentifizierung (2FA) und Token-Nutzung
Wenn Sie für Ihren GitHub-Account die Zwei-Faktor-Authentifizierung aktiviert haben, ist es zwingend notwendig, ein persönliches Zugriffstoken anstelle eines Passworts zu verwenden, da das normale Passwort in der Kommandozeile nicht akzeptiert wird. Nach der Erstellung des Tokens verwenden Sie dieses als Passwort beim Anmelden. Geben Sie als Benutzername Ihren GitHub-Benutzernamen an.
Gespeicherte Anmeldedaten in GitHub Desktop und System löschen
Manchmal sind auf Ihrem Rechner gespeicherte Zugangsdaten fehlerhaft oder veraltet, was die Wiederholungen von Authentifizierungsfehlern verursacht. Bei Windows können Sie mit dem Programm "Anmeldeinformationsverwaltung" (Credential Manager) die gespeicherten GitHub-bezogenen Einträge entfernen. Bei macOS kontrollieren und löschen Sie entsprechende Einträge im Schlüsselbund (Keychain Access). Nachdem die alten Anmeldedaten entfernt wurden, startet GitHub Desktop meist mit einer neuen Abfrage der Benutzerdaten und fordert Sie zur erneuten Eingabe des Tokens auf.
GitHub Desktop aktualisieren
Vergewissern Sie sich, dass Sie die neueste Version von GitHub Desktop verwenden. Ältere Versionen könnten Probleme mit aktuellen Sicherheitsmechanismen wie OAuth oder 2FA haben. Eine Aktualisierung löst oft unerwartete Authentifizierungsprobleme.
Netzwerk und Proxy-Einstellungen prüfen
Falls Sie hinter einem Proxy oder einer speziellen Firewall arbeiten, kann dies die Verbindung zu den GitHub-Servern beeinträchtigen und zur Fehlermeldung führen. Prüfen Sie Ihre Netzwerkeinstellungen bzw. stellen Sie sicher, dass GitHub Desktop durch Ihre Firewall oder Ihren Proxy kommunizieren darf. Gegebenenfalls definieren Sie Umgebungsvariablen oder passen die Proxy-Einstellungen innerhalb von GitHub Desktop an.
SSH-Authentifizierung als Alternative
Als Alternative zur HTTP-Authentifizierung mit Token können Sie auch ein SSH-Schlüsselpaar einrichten und GitHub Desktop so konfigurieren, dass es SSH verwendet. Dabei müssen Sie Ihren öffentlichen SSH-Schlüssel in Ihrem GitHub-Account hinterlegen. Die SSH-Verbindung ist oftmals stabiler und benötigt keine wiederholte Eingabe von Zugangsdaten.
Zusammenfassung
Der Fehler "Authentication failed" in GitHub Desktop entsteht meistens durch falsche oder veraltete Anmeldedaten, fehlende oder abgelaufene Tokens, oder Probleme mit der 2FA. Wichtig ist, ein aktives persönliches Zugriffstoken mit den richtigen Berechtigungen zu erstellen und dieses als Passwort in GitHub Desktop zu verwenden, vor allem wenn 2FA aktiv ist. Entfernen Sie veraltete Zugangsdaten aus dem System, aktualisieren Sie GitHub Desktop auf die neueste Version und prüfen Sie Ihre Netzwerkeinstellungen. Bei anhaltenden Problemen kann die Umstellung auf SSH eine stabile Alternative bieten.