Pourquoi une barre oblique nous préoccupe-t-elle ?
Sur notre propre site, un script s’exécute après chaque build pour vérifier que chaque lien interne se termine par une barre oblique finale. Ce n’est pas de la maniaquerie. Une adresse sans barre oblique reçoit d’abord une redirection 308 du serveur, et les outils pour webmasters du moteur de recherche enregistrent chacune de ces redirections comme « Page avec redirection » et nous les signalent une à une.
Alors, quand nous avons lu un signalement de la communauté disant que quelqu’un ne pouvait pas se connecter avec un passkey sur son site EmDash, et que devant ce site se trouvait justement quelque chose qui ajoute une barre oblique aux adresses, notre première réaction n’a pas été la compassion, mais la mauvaise conscience : ce réglage, nous aurions très bien pu l’ajouter nous-mêmes sans y penser.
Nous avons donc créé un nouveau site avec le modèle de blog (EmDash 1.4.0, adaptateur Node, SQLite) et nous l’avons reproduit.
Quand la connexion échoue, quelle étape échoue réellement ?
La première étape de la connexion par passkey est que la page demande au serveur un « défi » (challenge). La requête va vers /_emdash/api/auth/passkey/options. Le navigateur n’affiche l’invite d’empreinte digitale ou de clé de sécurité qu’après la réussite de cette étape.
Nous ne pouvons pas faire appuyer un script sur un capteur d’empreintes, nous n’avons donc testé que cette étape, avec curl, avec et sans la barre oblique 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 '{}'
La première renvoie 200, avec un défi et un rpId. La seconde ne diffère que d’une barre oblique et renvoie :
{"success":false,"error":{"code":"NOT_AUTHENTICATED","message":"Not authenticated"}}
/_emdash/api/auth/mode et /_emdash/api/health se comportent de la même façon : 200 sans la barre oblique, 401 avec.
Un petit détour mérite d’être noté. Nous avions d’abord appelé passkey/options avec un GET comme le ferait un navigateur, et nous avons obtenu une page HTML 404 complète, au point de presque conclure que le point d’accès n’existait pas. Il n’accepte que POST.
Pourquoi 401 et non 404 ?
Nous avons lu le code source du middleware d’authentification d’EmDash. Il contient une liste de points d’accès joignables sans connexion, écrite sous deux formes : les entrées qui se terminent par / sont comparées comme préfixes, toutes les autres doivent correspondre exactement. passkey/options, passkey/verify, auth/mode et health figurent tous dans le groupe de correspondance exacte.
Si l’on ajoute une barre oblique, l’adresse n’est plus égale à aucune entrée de la liste. Le middleware la traite alors comme un point d’accès ordinaire, qui exige d’être connecté. Or vous envoyez cette requête justement parce que vous essayez de vous connecter.
La conclusion ressemble à une devinette, mais c’est bien ainsi : la première étape de la connexion est jugée exiger d’être déjà connecté.
Et si j’ai vraiment défini trailingSlash sur always ?
Nous l’avons essayé aussi. Dans astro.config.mjs, nous avons ajouté :
export default defineConfig({
trailingSlash: "always",
// ...
});
Puis nous avons testé le même point d’accès :
| Adresse demandée | Résultat |
|---|---|
/_emdash/api/auth/passkey/options | 404 |
/_emdash/api/auth/passkey/options/ | 401 NOT_AUTHENTICATED |
Aucun des deux côtés ne fonctionne. Nous n’avons pas capturé la forme d’adresse que la page d’administration envoie réellement, nous ne pouvons donc pas dire de quel côté elle tombe, mais de quel côté que ce soit, la connexion est impossible.
Que faire maintenant ?
Premièrement, remettez trailingSlash à sa valeur par défaut (sans rien écrire, c’est ignore). Nous avons testé avec la valeur par défaut : les pages s’ouvrent avec ou sans la barre oblique, et les points d’accès de connexion fonctionnent.
Deuxièmement, si la barre oblique est ajoutée par votre proxy ou votre passerelle, laissez passer sans les réécrire les chemins qui commencent par /_emdash/. Nous ne l’avons pas essayé sur un vrai proxy. Cela découle du principe ci-dessus, merci de le vérifier vous-même.
Troisièmement, à propos des versions. Nous avons testé la 1.4.0. Le correctif correspondant a été fusionné dans la branche principale côté communauté, mais au moment de nos tests, la dernière version publiée était toujours la 1.4.0 et ne l’incluait pas. Donc, quand vous mettrez à jour plus tard, ne le tenez pas pour acquis : relancez les deux commandes curl ci-dessus. Cela prend dix secondes.
Pourquoi la connexion par lien magique fonctionne-t-elle quand même ?
Ce signalement mentionnait que la connexion par lien magique avait continué à fonctionner. D’après la liste, cela n’a rien d’étonnant : auth/magic-link/ est une entrée qui se termine par une barre oblique, elle est donc comparée comme préfixe, et une barre oblique finale supplémentaire ne l’affecte pas. C’est une déduction que nous avons tirée de la liste. Nous ne l’avons pas vérifiée séparément.
Comment savoir si je suis concerné ?
Deux conditions, qui doivent être réunies :
- La connexion par passkey répond
Not authenticated, alors que la connexion par lien magique fonctionne. - Dans le test curl ci-dessus, l’adresse avec barre oblique renvoie
401et celle sans renvoie200.
Si, au second point, les deux renvoient 200, vous avez un autre problème, et cet article ne vous aidera pas.