trailingSlash: always está configurado y el inicio de sesión con passkey responde Not authenticated

Un fallo de inicio de sesión que reprodujimos en local: por qué una sola barra final de más basta para que el inicio de sesión con passkey falle en el primer paso, y cómo dos comandos curl te dicen si te afecta.

¿Por qué nos importa una barra?

En nuestro propio sitio, después de cada compilación se ejecuta un script que comprueba que cada enlace interno termine con una barra final. No es manía. Una dirección sin la barra recibe primero una redirección 308 del servidor, y las herramientas para webmasters del buscador registran cada una de esas redirecciones como «Página con redirección» y nos las van avisando una por una.

Así que, cuando leímos un informe de la comunidad que decía que alguien no podía iniciar sesión con passkey en su sitio EmDash, y que delante del sitio había justo algo que añade una barra a las direcciones, nuestra primera reacción no fue de compasión, sino de mala conciencia: esa configuración podríamos haberla añadido nosotros mismos sin pensarlo.

Así que creamos un sitio nuevo con la plantilla de blog (EmDash 1.4.0, adaptador Node, SQLite) y lo reprodujimos.

Cuando falla el inicio de sesión, ¿qué paso falla realmente?

El primer paso del inicio de sesión con passkey es que la página le pide al servidor un «desafío» (challenge). La solicitud va a /_emdash/api/auth/passkey/options. El navegador muestra el aviso de huella dactilar o llave de seguridad solo después de que este paso tiene éxito.

No podemos hacer que un script pulse un sensor de huellas, así que probamos solo este paso, con curl, con y sin la barra final:

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 primera devuelve 200, con un desafío y un rpId. La segunda solo difiere en una barra y devuelve:

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

/_emdash/api/auth/mode y /_emdash/api/health se comportan igual: 200 sin la barra, 401 con ella.

Conviene anotar un pequeño desvío. Al principio solicitamos passkey/options con un GET como haría un navegador y obtuvimos una página HTML 404 completa, y casi concluimos que el endpoint no existía. Solo acepta POST.

¿Por qué 401 y no 404?

Leímos el código fuente del middleware de autenticación de EmDash. Contiene una lista de endpoints a los que se puede acceder sin iniciar sesión, escrita de dos formas: las entradas que terminan en / se comparan como prefijos, y todas las demás deben coincidir exactamente. passkey/options, passkey/verify, auth/mode y health están todos en el grupo de coincidencia exacta.

Si se añade una barra, la dirección deja de ser igual a cualquier entrada de la lista. El middleware la trata entonces como un endpoint corriente que exige haber iniciado sesión. Y tú envías esta solicitud justamente porque intentas iniciar sesión.

La conclusión suena a acertijo, pero es así: el primer paso del inicio de sesión se considera uno para el que hay que haber iniciado sesión antes.

¿Y si de verdad configuré trailingSlash como always?

Eso también lo probamos. En astro.config.mjs añadimos:

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

Luego probamos el mismo endpoint:

Dirección solicitadaResultado
/_emdash/api/auth/passkey/options404
/_emdash/api/auth/passkey/options/401 NOT_AUTHENTICATED

Ningún lado funciona. No capturamos qué forma de dirección envía realmente la página de administración, así que no podemos decir en qué lado cae, pero caiga donde caiga, no se puede iniciar sesión.

¿Qué hago ahora?

Primero, vuelve a dejar trailingSlash en su valor por defecto (si no lo escribes, es ignore). Probamos con el valor por defecto: las páginas se abren con o sin la barra y los endpoints de inicio de sesión funcionan.

Segundo, si la barra la añade tu proxy o puerta de enlace, deja pasar sin reescribir las rutas que empiezan por /_emdash/. No lo hemos probado en un proxy real. Se deduce del principio de arriba, así que compruébalo tú mismo.

Tercero, sobre las versiones. Probamos la 1.4.0. La corrección correspondiente se ha fusionado en la rama principal en la comunidad, pero cuando hicimos las pruebas la última versión publicada seguía siendo la 1.4.0 y no la incluía. Así que, cuando actualices más adelante, no lo des por hecho: vuelve a ejecutar los dos comandos curl de arriba. Son diez segundos.

¿Por qué el inicio de sesión con enlace mágico sigue funcionando?

Aquel informe mencionaba que el inicio de sesión con enlace mágico seguía funcionando. Viendo la lista, no sorprende: auth/magic-link/ es una entrada que termina en barra, así que se compara como prefijo, y una barra final de más no le afecta. Es una deducción nuestra a partir de la lista. No la verificamos por separado.

¿Cómo sé si me afecta?

Dos cosas, y deben cumplirse las dos:

  1. El inicio de sesión con passkey responde Not authenticated, mientras que el inicio de sesión con enlace mágico funciona.
  2. En la prueba curl de arriba, la dirección con barra devuelve 401 y la de sin barra devuelve 200.

Si en el segundo punto ambas devuelven 200, tienes otro problema, y este artículo no te ayudará.