Authentifizierung mit einem GitHub Access Token

Fehlermeldung: Could not authenticate against github.com

Wenn du Probleme bei der Installation oder Aktualisierung von Contao hast und dir wird die folgende Fehlermeldung angezeigt:

Could not authenticate against github.com

Dann erfährst du in dieser Anleitung was zu tun ist.

Was ist der Hintergrund für diese Fehlermeldung?

Bei der Installation und beim Update von Contao bzw. von Erweiterungen werden Anfragen an GitHub gestellt. GitHub begrenzt diese Anfragen für einen Server (für eine IP-Adresse) auf 60 Anfragen pro Stunde. Dieses Limit gilt, wenn keine Authentifizierung vorhanden ist.

Mehr zu den "rate limits" findest du auch hier bei GitHub.

Ein Github Access Token - die Lösung für das Problem

Mit einem sogenannten Github Access Token kannst du das Problem umgehen, denn mit einer gültigen Authentifizierung sind bis zu 5000 Anfragen pro Stunde möglich.

Um einen Github Access Token zu erstellen, benötigst du einen kostenlosen Github Account.

Gehe dazu auf die Website https://github.com, trage einen Nutzernamen (frei wählbar), deine Mailadresse und ein Passwort ein und klicke den Button "Sign up for GitHub".

Du musst danach:

1. eine "Aufgabe" lösen, damit verifiziert wird, dass du ein Mensch bist und

2. auf den Button Next: Select a plan klicken.

Im folgenden Screen wählst du die kostenfreie Variante mit Choose Free.

Im nächsten Bildschirm musst du nichts auswählen und nur unten den Button Complete setup bestätigen.

Zum Schluss musst du nur noch deine E-Mail-Adresse verifizieren.

Dazu hast du eine Mail an die angegebene Mailadresse erhalten. Klicke auf den Link in der Mail. Danach ist dein Konto bei GitHub erstellt. Du erhältst darüber noch eine Bestätigungsmail von GitHub.

Solltest du keine Verifizierungsmail erhalten haben, prüfe deinen Spam-Ordner oder du kannst hier noch einmal eine Mail anfordern.

GitHub Access Token erstellen

Nach dem du ein Github Account erstellt hast, solltest du bei Github angemeldet sein.

Falls du nicht angemeldet bist, melde dich über https://github.com/login mit deinem Benutzernamen bzw. deiner Mailadresse und deinem Passwort an.

Klicke oben rechts auf deinen Nutzer.

Wähle Settings

Wähle Developer Settings

Wähle Personal access tokens

Generiere einen Personal access token in dem du auf Generate new token klickst

Vergib für den Token einen Namen deiner Wahl, wähle repo und generiere den Token über Generate Token

Kopiere den Token und speichere dir diesen am besten auf deinem lokalen Rechner kurz zwischen.

Hinweis: Der Token wird nur einmal angezeigt!

Datei auth.json erstellen und auf dem Server ablegen

Damit der Contao Manager nun den Token verwenden kann, musst du eine spezielle Datei erstellen und auf dem Server ablegen.

Generiere dir eine Datei mit dem Namen auth.json und füge folgenden Inhalt ein:

Dein-generierter-Token ersetzt du mit dem kopierten GitHub Access Token aus dem Zwischenspeicher.

Lade die so erzeuge Datei per FTP auf deinen Server in den Ordner /contao-manager/.

Danach kannst du den Contao Manager neu starten. Der Fehler sollte jetzt nicht mehr angezeigt werden.