網站設了 trailingSlash: always,通行金鑰登入卻回報 Not authenticated

一次在本機重現出來的登入故障:為什麼多一個結尾斜線,就能讓通行金鑰登入在第一步失敗,以及兩條 curl 就能判斷你是否中招。

我們為什麼會在意一個斜線?

我們自己的網站,建置完會跑一個腳本,檢查每個內部連結是不是都帶結尾斜線。這不是潔癖。不帶斜線的網址會先被伺服器 308 轉址一次,搜尋引擎的站長工具把這些轉址統統記成「有重新導向的網頁」,一條一條地報給我們看。

所以當我們讀到一份社群回報,說有人的 EmDash 網站登入不了通行金鑰,而網站前面剛好有一層會替網址補斜線的東西,我們的第一反應不是同情,是心虛:這種設定,我們自己也會順手加上。

於是我們新建了一個部落格範本站(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 '{}'

第一條回傳 200,裡面是一份挑戰和 rpId。第二條只多了一個斜線,回傳:

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

/_emdash/api/auth/mode 和 /_emdash/api/health 也一樣:不帶斜線 200,帶斜線 401。

順帶記一個小插曲。我們一開始是用瀏覽器式的 GET 去存取 passkey/options 的,得到的是一整頁 404 的 HTML,差點以為介面不存在。它只接受 POST。

為什麼是 401,而不是 404?

我們去翻了 EmDash 認證中介層的原始碼。裡面有一份「不用登入也能存取」的介面名單,分兩種寫法:以 / 結尾的項目按前綴比對,其餘的按整串精確比對。passkey/options、passkey/verify、auth/mode、health 都寫在精確比對裡。

網址多出一個斜線,就不再等於名單裡的任何一條。中介層於是把它當成一個普通的、需要登入的介面來處理。而你此刻正是為了登入才發的這個請求。

結論有點繞口,但就是這樣:登入的第一步,被判定為需要先登入。

如果我就是把 trailingSlash 設成了 always 呢?

我們也試了這個。在 astro.config.mjs 裡加上:

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

再測同一個介面:

請求網址結果
/_emdash/api/auth/passkey/options404
/_emdash/api/auth/passkey/options/401 NOT_AUTHENTICATED

兩邊都走不通。我們沒有去抓管理頁面實際會發出哪一種網址,所以不確定頁面會落在哪一邊,但無論落在哪邊,都登入不了。

現在該怎麼辦?

第一,先把 trailingSlash 改回預設值(不寫就是 ignore)。我們在預設值下測過:頁面帶不帶斜線都能開啟,登入介面也正常。

第二,如果斜線是你前面的代理或閘道加的,讓它對 /_emdash/ 開頭的路徑放行,不要改寫。這一條我們沒有在真實的代理上試過,是按上面的原理推出來的,請你自己驗證。

第三,關於版本。 我們測的是 1.4.0。社群裡對應的修復已經合併進了主幹,但我們測試的時候,最新的發行版仍然是 1.4.0,沒有帶上它。所以以後你升級了,不要想當然,把上面那兩條 curl 再跑一遍,十秒鐘的事。

為什麼魔法連結登入還是好的?

那份回報裡提到,魔法連結登入一直正常。照著名單看,這不奇怪:auth/magic-link/ 是以斜線結尾的項目,走的是前綴比對,後面多一個斜線,並不影響它。這是我們根據名單做的推斷,沒有單獨去驗證。

怎麼判斷自己是不是中招?

兩件事,同時滿足才是:

  1. 通行金鑰登入時回報 Not authenticated,魔法連結登入卻正常。
  2. 上面那條帶斜線的 curl 回傳 401,不帶斜線的回傳 200。

如果第二條裡兩個都是 200,那你遇到的是別的問題,這篇文章幫不上忙。