我們為什麼會在意一個斜線?
我們自己的網站,建置完會跑一個腳本,檢查每個內部連結是不是都帶結尾斜線。這不是潔癖。不帶斜線的網址會先被伺服器 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/options | 404 |
/_emdash/api/auth/passkey/options/ | 401 NOT_AUTHENTICATED |
兩邊都走不通。我們沒有去抓管理頁面實際會發出哪一種網址,所以不確定頁面會落在哪一邊,但無論落在哪邊,都登入不了。
現在該怎麼辦?
第一,先把 trailingSlash 改回預設值(不寫就是 ignore)。我們在預設值下測過:頁面帶不帶斜線都能開啟,登入介面也正常。
第二,如果斜線是你前面的代理或閘道加的,讓它對 /_emdash/ 開頭的路徑放行,不要改寫。這一條我們沒有在真實的代理上試過,是按上面的原理推出來的,請你自己驗證。
第三,關於版本。 我們測的是 1.4.0。社群裡對應的修復已經合併進了主幹,但我們測試的時候,最新的發行版仍然是 1.4.0,沒有帶上它。所以以後你升級了,不要想當然,把上面那兩條 curl 再跑一遍,十秒鐘的事。
為什麼魔法連結登入還是好的?
那份回報裡提到,魔法連結登入一直正常。照著名單看,這不奇怪:auth/magic-link/ 是以斜線結尾的項目,走的是前綴比對,後面多一個斜線,並不影響它。這是我們根據名單做的推斷,沒有單獨去驗證。
怎麼判斷自己是不是中招?
兩件事,同時滿足才是:
- 通行金鑰登入時回報
Not authenticated,魔法連結登入卻正常。 - 上面那條帶斜線的 curl 回傳
401,不帶斜線的回傳200。
如果第二條裡兩個都是 200,那你遇到的是別的問題,這篇文章幫不上忙。