trailingSlash: always を設定したら、パスキーのログインが Not authenticated になった

ローカルで再現したログイン障害です。末尾のスラッシュが 1 つ増えるだけで、なぜパスキーのログインが最初のステップで失敗するのか。そして、2 本の curl で自分が該当するかどうかを判断する方法。

なぜスラッシュ 1 つが気になるのか?

私たちのサイトでは、ビルドのあとに、すべての内部リンクが末尾スラッシュ付きになっているかを調べるスクリプトを走らせています。几帳面すぎるわけではありません。スラッシュのない URL は、まずサーバーから 308 リダイレクトを受けます。検索エンジンのウェブマスターツールはそのリダイレクトを「リダイレクトを含むページ」としてすべて記録し、1 件ずつ報告してくるのです。

そのため、EmDash のサイトでパスキーのログインができないというコミュニティの報告を読み、しかもサイトの前段に URL へスラッシュを補う仕組みがあったと知ったとき、最初に浮かんだのは同情ではなく後ろめたさでした。この設定は、私たちも何気なく入れてしまいそうだからです。

そこで、新しくブログテンプレートのサイト(EmDash 1.4.0、Node アダプター、SQLite)を作り、再現してみました。

ログインに失敗するとき、実際にはどのステップが失敗しているのか?

パスキーのログインの最初のステップは、ページがサーバーに「チャレンジ」を要求することです。リクエスト先は /_emdash/api/auth/passkey/options です。ブラウザーに指紋やセキュリティキーの確認が表示されるのは、このステップが成功したあとです。

スクリプトに指紋センサーを押させることはできないので、このステップだけを curl で、スラッシュあり・なしの両方でテストしました。

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

1 本目は 200 を返し、中にはチャレンジと rpId が入っています。2 本目はスラッシュが 1 つ多いだけですが、次のように返ります。

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

/_emdash/api/auth/mode と /_emdash/api/health も同じです。スラッシュなしは 200、ありは 401 でした。

ちょっとした寄り道も書いておきます。最初は passkey/options にブラウザーと同じ GET でアクセスしたところ、HTML の 404 ページがまるごと返ってきて、エンドポイントが存在しないのかと思いかけました。このエンドポイントは POST しか受け付けません。

なぜ 404 ではなく 401 なのか?

EmDash の認証ミドルウェアのソースを読みました。中には「ログインしなくてもアクセスできるエンドポイント」の一覧があり、書き方は 2 種類です。/ で終わる項目は前方一致、それ以外は文字列全体の完全一致で照合されます。passkey/options、passkey/verify、auth/mode、health はすべて完全一致のほうに書かれています。

URL にスラッシュが 1 つ増えると、一覧のどの項目とも等しくなくなります。するとミドルウェアは、それをログインが必要な通常のエンドポイントとして扱います。そしてあなたが今このリクエストを送っているのは、まさにログインするためです。

結論は謎かけのようですが、事実はこうです。ログインの最初のステップが、先にログインしていることを求められるのです。

本当に trailingSlash を always にしてしまっていたら?

これも試しました。astro.config.mjs に次を加えます。

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

そのうえで同じエンドポイントをテストします。

リクエスト先結果
/_emdash/api/auth/passkey/options404
/_emdash/api/auth/passkey/options/401 NOT_AUTHENTICATED

どちらの側も通りません。管理画面が実際にどちらの形の URL を送るかは調べていないので、どちら側に落ちるかは断言できませんが、どちらであってもログインはできません。

では、どうすればいいのか?

まず、trailingSlash を既定値に戻してください(書かなければ ignore です)。既定値で試したところ、ページはスラッシュの有無にかかわらず開け、ログイン用のエンドポイントも正常でした。

次に、スラッシュを付けているのが前段のプロキシやゲートウェイなら、/_emdash/ で始まるパスは書き換えずに通すようにしてください。これは実際のプロキシでは試していません。上の仕組みから導いたものなので、ご自身で確認してください。

最後にバージョンについて。 私たちが試したのは 1.4.0 です。コミュニティでは対応する修正がメインブランチにマージされていますが、私たちがテストした時点で最新のリリースはまだ 1.4.0 で、それは含まれていませんでした。ですから、のちにアップグレードしたときは思い込まずに、上の 2 本の curl をもう一度実行してください。10 秒で済みます。

なぜマジックリンクのログインは使えたのか?

その報告には、マジックリンクのログインはずっと正常だったとありました。一覧を見るかぎり、不思議ではありません。auth/magic-link/ はスラッシュで終わる項目で、前方一致で照合されるため、末尾にスラッシュが増えても影響しないのです。これは一覧からの私たちの推測で、単独では検証していません。

自分が該当するかどうかの見分け方

次の 2 つが同時に成り立つ場合です。

  1. パスキーのログインでは Not authenticated になるのに、マジックリンクのログインは正常。
  2. 上の curl で、スラッシュありは 401、なしは 200 を返す。

2 つ目で両方とも 200 なら、別の問題です。この記事はお役に立てません。