Contao, Composer und der GitHub Access Token
- 4.4
- 4.9
- 4.13
- 5.3
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.
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.
Ein Github Account erstellen
Hinweis
Falls du bereits einen GitHub Account hast, lies gleich weiter unter Github Access Token erstellen.
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:
- eine "Aufgabe" lösen, damit verifiziert wird, dass du ein Mensch bist und
-
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:
auth.json
{
"github-oauth": {
"github.com": "Dein-generierter-Token"
}
}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.
Tipp
Du kannst deinen erzeugten GitHub Access Token bzw. die Datei auth.json in allen deinen Installationen verwenden. Achte allerdings darauf, dass du diesen Token nicht öffentlich zugänglich machst.
Über den Autor
Christian Feneberg ist der Gründer der Contao-Academy und erstellt seit 2010 Websites mit Contao. Außerdem ist er im Team von trakked.io. und regelmäßig auf YouTube in der Contao Show zu sehen. Neben Contao begeistert er sich für Online-Marketing, Unternehmertum und Persönlichkeitsentwicklung.
2 Kommentare
Herr Rilke |
genial,
vielen dank - das hat mir sehr geholfen & ne menge zeit gespart!
Danke für dein Feedback. Es freut uns, wenn wir helfen können.
PongoPeter |
Die Methode müsste doch auch funktionieren, wenn man durch das Token eine Erweiterung aus einem privaten Repository installieren will, analog zur Console "composer config --global --auth github-oauth.github.com TOKEN" oder?
Tut aber nicht.
Also falsch angenommen?
Falsch machen, kann man ja nicht viel (auth.json in /contao-manager erstellen und das Token, das in der Console funktioniert, dort einfügen... gerade so fehlerfrei hinbekommen <g>)
Hallo Peter, bei einem privaten Repository versuche es bitte mal ohne die Composer-Cloud.
Dazu im Contao Manager auf das Zahnrad-Symbol > Systemprüfung und dann Serverkonfiguration > ändern. Dort dann den Haken bei Die Composer Resolver Cloud verwenden entfernen.
Einen Kommentar schreiben