14. August 2021
JWT Authentication mit Nuxt
In diesem Artikel zeige ich Ihnen, wie Sie JWT-Authentifizierungstoken und Aktualisierungstoken in Nuxt handhaben können. Wir werden in diesem Tutorial nicht das offizielle nuxt/auth-Paket verwenden, da die aktuelle Version zum Zeitpunkt der Erstellung dieses Artikels noch nicht sehr stabil ist und noch nicht vollständig dokumentiert und getestet wurde.

Notwendige Abhängigkeiten installieren
Zunächst einmal müssen wir einige Abhängigkeiten installieren, die für die Verarbeitung der Tokens und Cookies zur Speicherung der Schlüssel erforderlich sind.
Die Pakete cookie-universal-nuxt und vuex-persistedstate sind für das Setzen und Aktualisieren der Cookies zuständig, die wir zur Speicherung der Zugriffs- und Aktualisierungstoken der API verwenden. @nuxtjs/axios wird verwendet, um API-Aufrufe mit den Token durchzuführen und/oder die Token abzurufen.
Speichern der Tokens
Um autorisierte API-Aufrufe durchzuführen, müssen wir die Zugriffs- und Aktualisierungstoken irgendwo speichern. Dazu nutzen wir den Vuex-Store innerhalb von Nuxt und verwenden das Paket vuex-persistedstate, um die Schlüssel beim Neuladen der Seite mithilfe von Cookies zu speichern.
Hier richten wir das Plugin vuex-persistedstate so ein, dass es unsere Cookie-Bibliothek zur Speicherung der Tokens in unserer Anwendung nutzt. In paths legen wir fest, dass nur unsere Tokens im Cookie gespeichert werden sollen, um die Größenbeschränkung für Cookies nicht zu überschreiten. Das Cookie in unserem Beispiel ist 14 Tage lang gültig.
Vergiss nicht, das Plugin zu deiner Datei nuxt.config.js hinzuzufügen:
Vuex Store
Nachdem wir nun unser Persistenz-Plugin für den Vuex-Store konfiguriert haben, müssen wir auch unsere Mutationen und Aktionen schreiben, um die Aufgaben im Zusammenhang mit den Tokens zu bewältigen. Dazu erstellen wir im store Verzeichnis von Nuxt eine Datei namens auth.js.
In dieser Datei haben wir einige Aktionen zur Bearbeitung unserer Token-Anfragen definiert.
loginist dafür zuständig, beide Token von der API abzurufen, indem die Anmeldedaten des Benutzers über eine POST-Anfrage übermittelt werden.registerfunktioniert mehr oder weniger genauso wie „login“, mit dem Unterschied, dass mit den angegebenen Anmeldedaten ein neuer Benutzer angelegt wird.getUserist der API-Aufruf, der für das Abrufen der Benutzerinformationen zuständig ist, nachdem die Tokens empfangen wurden.refreshaktualisiert unser Zugriffstoken, indem es das Aktualisierungstoken an die API übermittelt. Als Antwort erhalten wir ein neues Zugriffstoken.
Authentifizierte Requests
Nachdem wir unsere Tokens nun gespeichert und dauerhaft abgelegt haben, ist es an der Zeit, authentifizierte Anfragen an die API zu stellen. Axios verfügt über eine integrierte Funktion namens „Interceptors“, die wir nutzen werden, um unsere API-Aufrufe dynamisch mit dem gespeicherten Token zu authentifizieren.
Nun prüft Axios bei jeder Anfrage, ob der Benutzer über ein Zugriffstoken verfügt, und sendet die Daten des „Authorization“-Headers automatisch an dieses Zugriffstoken.
Vergiss auch hier nicht, das Axios-Plugin zu deiner nuxt.config.js hinzuzufügen:
Token aktualisieren
Nun ist alles eingerichtet und wir könnten das Tutorial an dieser Stelle beenden, aber was passiert, wenn das Token abgelaufen oder ungültig ist?
Wenn Zugriffstoken ablaufen oder ungültig werden, die Anwendung aber weiterhin auf eine geschützte Ressource zugreifen muss, steht die Anwendung vor dem Problem, ein neues Zugriffstoken zu erhalten, ohne den Nutzer dazu zu zwingen, erneut eine Berechtigung zu erteilen. Um dieses Problem zu lösen, wurde mit OAuth 2.0 ein Artefakt namens „Refresh-Token“ eingeführt. Ein Refresh-Token ermöglicht es einer Anwendung, ein neues Zugriffstoken zu erhalten, ohne den Nutzer dazu aufzufordern.
— Token-Aktualisierung verstehen via Auth0
Um dies zu bewerkstelligen, können wir unseren Axios-Interceptor so anpassen, dass er den zurückgegebenen API-Fehler verarbeitet und automatisch versucht, unser Zugriffstoken zu aktualisieren, bevor die Anfrage erneut versucht wird. Dazu ändern wir unsere Plugin-Datei axios.js:
Hier haben wir den onError Handler hinzugefügt, um auf tokenbezogene Fehlercodes der API zu reagieren, zu versuchen, das Zugriffstoken mithilfe unseres Aktualisierungstokens zu aktualisieren, und die fehlgeschlagene Anfrage erneut auszuführen. Wenn das Token nicht aktualisiert werden konnte oder ein Fehler aufgetreten ist, melden wir den Benutzer aus der Anwendung ab.
Aktualisierung von Tokens auf Serverseite
Da unser Zugriffstoken nicht lange gültig sein sollte, können wir davon ausgehen, dass unser Zugriffstoken abgelaufen ist, wenn der Benutzer die Seite neu lädt oder sich zum ersten Mal wieder mit dem Server verbindet. Durch die Verwendung des nuxtServerInit Hooks in unserem Store können wir automatisch versuchen, das Zugriffstoken zu aktualisieren. Dazu aktualisieren wir unseren Store wie folgt:
Mit dieser aktualisierten Aktion versucht unser Server nun, das Zugriffstoken bei jeder Serveranfrage automatisch zu aktualisieren.
Zusammenfassung
Nun verfügen wir über eine voll funktionsfähige und weitgehend automatisierte Lösung für den Umgang mit JWT in Nuxt. Unsere Token werden in einem Cookie gespeichert und stehen für client- und serverseitige Anfragen zur Verfügung.



