trailingSlash: always ist gesetzt, und der Passkey-Login meldet Not authenticated

Ein Login-Fehler, den wir lokal nachgestellt haben: warum ein einziger zusätzlicher Schrägstrich am Ende den Passkey-Login schon im ersten Schritt scheitern lässt, und wie zwei curl-Befehle zeigen, ob du betroffen bist.

Warum kümmert uns ein Schrägstrich?

Auf unserer eigenen Website läuft nach jedem Build ein Skript, das prüft, ob jeder interne Link mit einem Schrägstrich am Ende endet. Das ist keine Pedanterie. Eine Adresse ohne Schrägstrich bekommt zuerst eine 308-Weiterleitung vom Server, und die Webmaster-Tools der Suchmaschine verbuchen jede dieser Weiterleitungen als „Seite mit Weiterleitung“ und melden sie uns einzeln.

Als wir also einen Bericht aus der Community lasen, jemand könne sich auf seiner EmDash-Website nicht mit einem Passkey anmelden, und vor der Website hänge zufällig etwas, das Adressen einen Schrägstrich anhängt, war unsere erste Reaktion kein Mitgefühl, sondern ein schlechtes Gewissen: Diese Einstellung hätten wir selbst auch nebenbei gesetzt.

Also haben wir eine neue Website mit dem Blog-Template aufgesetzt (EmDash 1.4.0, Node-Adapter, SQLite) und den Fehler nachgestellt.

Wenn der Login scheitert: Welcher Schritt scheitert eigentlich?

Der erste Schritt beim Passkey-Login ist, dass die Seite beim Server eine „Challenge“ anfordert. Die Anfrage geht an /_emdash/api/auth/passkey/options. Der Browser zeigt die Abfrage für Fingerabdruck oder Sicherheitsschlüssel erst, nachdem dieser Schritt gelungen ist.

Wir können ein Skript keinen Fingerabdrucksensor drücken lassen, also haben wir nur diesen Schritt getestet, mit curl, einmal mit und einmal ohne Schrägstrich am Ende:

curl -i -X POST http://localhost:4400/_emdash/api/auth/passkey/options \
  -H 'X-EmDash-Request: 1' -H 'Content-Type: application/json' -d '{}'

curl -i -X POST http://localhost:4400/_emdash/api/auth/passkey/options/ \
  -H 'X-EmDash-Request: 1' -H 'Content-Type: application/json' -d '{}'

Der erste liefert 200, mit einer Challenge und einer rpId. Der zweite unterscheidet sich nur durch einen Schrägstrich und liefert:

{"success":false,"error":{"code":"NOT_AUTHENTICATED","message":"Not authenticated"}}

/_emdash/api/auth/mode und /_emdash/api/health verhalten sich genauso: 200 ohne Schrägstrich, 401 mit.

Eine kleine Episode am Rande: Wir haben passkey/options zuerst mit einem browserartigen GET aufgerufen und eine komplette HTML-404-Seite zurückbekommen, und hätten fast geschlossen, der Endpunkt existiere nicht. Er akzeptiert nur POST.

Warum 401 und nicht 404?

Wir haben den Quellcode der Auth-Middleware von EmDash gelesen. Darin steht eine Liste von Endpunkten, die auch ohne Login erreichbar sind, in zwei Schreibweisen: Einträge, die auf / enden, werden als Präfix verglichen, alle anderen müssen exakt übereinstimmen. passkey/options, passkey/verify, auth/mode und health stehen alle in der Gruppe mit exaktem Vergleich.

Kommt ein Schrägstrich dazu, entspricht die Adresse keinem Eintrag der Liste mehr. Die Middleware behandelt sie dann wie einen gewöhnlichen Endpunkt, für den man angemeldet sein muss. Und du schickst diese Anfrage ja gerade deshalb, weil du dich anmelden willst.

Die Schlussfolgerung klingt wie ein Rätsel, ist aber so: Der erste Schritt der Anmeldung gilt als einer, für den man schon angemeldet sein muss.

Und wenn ich trailingSlash tatsächlich auf always gesetzt habe?

Auch das haben wir ausprobiert. In astro.config.mjs haben wir ergänzt:

export default defineConfig({
  trailingSlash: "always",
  // ...
});

Dann haben wir denselben Endpunkt getestet:

Angefragte AdresseErgebnis
/_emdash/api/auth/passkey/options404
/_emdash/api/auth/passkey/options/401 NOT_AUTHENTICATED

Keine der beiden Seiten funktioniert. Wir haben nicht mitgeschnitten, welche Form der Adresse die Admin-Seite tatsächlich sendet, können also nicht sagen, auf welcher Seite sie landet. Auf welcher auch immer: Die Anmeldung gelingt nicht.

Was tun?

Erstens: Setze trailingSlash auf den Standardwert zurück (ohne Angabe gilt ignore). Wir haben mit dem Standardwert getestet: Seiten öffnen sich mit und ohne Schrägstrich, und die Login-Endpunkte funktionieren.

Zweitens: Wenn der Schrägstrich von deinem Proxy oder Gateway angehängt wird, lass Pfade, die mit /_emdash/ beginnen, ohne Umschreiben durch. Das haben wir auf einem echten Proxy nicht ausprobiert. Es folgt aus dem Prinzip oben, bitte prüfe es selbst.

Drittens: zu den Versionen. Wir haben 1.4.0 getestet. Die entsprechende Korrektur ist in der Community in den Hauptzweig eingeflossen, aber als wir getestet haben, war die neueste Version noch 1.4.0 und enthielt sie nicht. Wenn du später aktualisierst, nimm es also nicht als gegeben hin: Führe die beiden curl-Befehle von oben noch einmal aus. Das dauert zehn Sekunden.

In dem Bericht stand, der Magic-Link-Login habe weiter funktioniert. Nach der Liste überrascht das nicht: auth/magic-link/ ist ein Eintrag, der auf einen Schrägstrich endet, wird also als Präfix verglichen, und ein weiterer Schrägstrich am Ende ändert daran nichts. Das ist unser Schluss aus der Liste. Wir haben es nicht gesondert überprüft.

Woran erkenne ich, ob ich betroffen bin?

Zwei Dinge, und beide müssen zutreffen:

  1. Der Passkey-Login meldet Not authenticated, während der Magic-Link-Login funktioniert.
  2. Im curl-Test oben liefert die Adresse mit Schrägstrich 401 und die ohne 200.

Wenn im zweiten Punkt beide 200 liefern, hast du ein anderes Problem, und dieser Artikel hilft dir nicht weiter.