trailingSlash: always è impostato e l'accesso con passkey risponde Not authenticated

Un guasto di accesso riprodotto in locale: perché una sola barra finale in più basta a far fallire l'accesso con passkey già al primo passaggio, e come due comandi curl dicono se sei coinvolto.

Perché ci preoccupiamo di una barra?

Sul nostro sito, dopo ogni build, gira uno script che controlla che ogni link interno termini con una barra finale. Non è pignoleria. Un indirizzo senza barra riceve prima un reindirizzamento 308 dal server, e gli strumenti per i webmaster del motore di ricerca registrano ognuno di questi reindirizzamenti come «Pagina con reindirizzamento» e ce li segnalano uno per uno.

Così, quando abbiamo letto una segnalazione della community secondo cui qualcuno non riusciva ad accedere con una passkey sul suo sito EmDash, e davanti al sito c’era per caso qualcosa che aggiunge una barra agli indirizzi, la nostra prima reazione non è stata la compassione, ma il senso di colpa: quell’impostazione potremmo aggiungerla anche noi, senza pensarci.

Abbiamo quindi creato un nuovo sito con il template del blog (EmDash 1.4.0, adattatore Node, SQLite) e l’abbiamo riprodotto.

Quando l’accesso fallisce, quale passaggio fallisce davvero?

Il primo passaggio dell’accesso con passkey è che la pagina chiede al server una «sfida» (challenge). La richiesta va a /_emdash/api/auth/passkey/options. Il browser mostra la richiesta di impronta digitale o chiave di sicurezza solo dopo che questo passaggio è riuscito.

Non possiamo far premere a uno script un sensore di impronte, quindi abbiamo testato solo questo passaggio, con curl, con e senza la barra finale:

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 '{}'

Il primo restituisce 200, con una sfida e un rpId. Il secondo differisce di una sola barra e restituisce:

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

/_emdash/api/auth/mode e /_emdash/api/health si comportano allo stesso modo: 200 senza la barra, 401 con la barra.

Vale la pena annotare un piccolo episodio. Inizialmente avevamo chiamato passkey/options con un GET come farebbe un browser e avevamo ottenuto un’intera pagina HTML 404, tanto che abbiamo quasi concluso che l’endpoint non esistesse. Accetta solo POST.

Perché 401 e non 404?

Abbiamo letto il codice sorgente del middleware di autenticazione di EmDash. Contiene un elenco di endpoint raggiungibili senza accedere, scritto in due forme: le voci che terminano con / vengono confrontate come prefissi, tutte le altre devono corrispondere esattamente. passkey/options, passkey/verify, auth/mode e health stanno tutti nel gruppo a corrispondenza esatta.

Se si aggiunge una barra, l’indirizzo non è più uguale ad alcuna voce dell’elenco. Il middleware lo tratta allora come un normale endpoint che richiede di aver effettuato l’accesso. E tu stai inviando proprio questa richiesta perché cerchi di accedere.

La conclusione suona come un indovinello, ma è così: il primo passaggio dell’accesso viene giudicato come uno che richiede di aver già effettuato l’accesso.

E se ho davvero impostato trailingSlash su always?

Abbiamo provato anche questo. In astro.config.mjs abbiamo aggiunto:

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

Poi abbiamo testato lo stesso endpoint:

Indirizzo richiestoRisultato
/_emdash/api/auth/passkey/options404
/_emdash/api/auth/passkey/options/401 NOT_AUTHENTICATED

Nessuno dei due lati funziona. Non abbiamo catturato quale forma di indirizzo invii davvero la pagina di amministrazione, quindi non possiamo dire su quale lato finisca, ma su qualunque lato sia, non si riesce ad accedere.

Cosa fare adesso?

Primo, riporta trailingSlash al valore predefinito (se non lo scrivi è ignore). Abbiamo testato con il valore predefinito: le pagine si aprono con o senza la barra e gli endpoint di accesso funzionano.

Secondo, se la barra la aggiunge il tuo proxy o gateway, lascia passare senza riscriverli i percorsi che iniziano con /_emdash/. Non l’abbiamo provato su un proxy reale. Deriva dal principio descritto sopra, quindi verificalo tu.

Terzo, riguardo alle versioni. Abbiamo testato la 1.4.0. La correzione corrispondente è stata unita al ramo principale nella community, ma quando abbiamo fatto i test l’ultima versione rilasciata era ancora la 1.4.0 e non la includeva. Quindi, quando aggiornerai in seguito, non darlo per scontato: esegui di nuovo i due comandi curl qui sopra. Ci vogliono dieci secondi.

Quella segnalazione diceva che l’accesso con link magico aveva continuato a funzionare. Guardando l’elenco, non sorprende: auth/magic-link/ è una voce che termina con una barra, quindi viene confrontata come prefisso, e una barra finale in più non la influenza. È una deduzione che abbiamo tratto dall’elenco. Non l’abbiamo verificata separatamente.

Come capire se sono coinvolto?

Due cose, che devono valere entrambe:

  1. L’accesso con passkey risponde Not authenticated, mentre l’accesso con link magico funziona.
  2. Nel test curl qui sopra, l’indirizzo con la barra restituisce 401 e quello senza restituisce 200.

Se nel secondo punto entrambi restituiscono 200, hai un altro problema e questo articolo non ti aiuterà.