LightUp 第三方 API 契約已定案・端點已上線 v1.0.0 · 707394544381

撤權語意

承諾

撤權在下一個請求生效。

因為 Gateway 每個請求都向身分服務查一次當前授權,沒有跨請求的 allow-cache,所以撤權不需要等 token 過期。

事件 生效起點
tenant 對 app 的 grant 撤回 下一個請求
service account 停用/epoch+1 下一個請求
client 停用 下一個請求
使用者 session 撤銷 下一個請求
方案降級 下一個請求

對外不承諾任何秒數,也沒有 SLA。 本文件承諾的只有「下一個請求生效」這件事本身:因為每個請求都問一次授權,所以撤權寫入之後的下一個請求就會被拒。平台內部量過的數字是觀測值,不是對外承諾,也不會寫進這份文件——任何看到的秒數都不是 SLA。

Token 自身過期

profile TTL
self(使用者本人) 15 分
workload(service account) 15 分

TTL 是上限,不是撤權機制。不要拿「反正 15 分鐘就過期」當作撤權已經生效的理由——撤權比它早,而且與它無關。

登出、revoke 與 introspect 的分工

撤權不只有「平台那邊拿掉授權」一種形狀。三件事不要混在一起(細節與狀態見 使用者流程):

你做的事 範圍
POST /oauth2/revoke(RFC 7009) 只撤你這個 client 的 refresh token family。不結束使用者的登入、不送 back-channel logout、其他 app 不受影響
GET|POST /oauth2/logout(RP-Initiated Logout) 結束使用者那顆登入 session,並對這顆 session 上所有第三方 app 送 back-channel logout
POST /oauth2/introspect(RFC 7662) 不改變任何狀態,只問「這張 token 現在還有不有效」。即時讀取、無快取,對使用者 token 是判斷有效性的權威來源

你這端要做什麼

平台收不回的東西

平台無法收回第三方已經取得的資料副本。撤權擋的是之後的請求,不是你已經寫進自己資料庫的內容。你自己那一份的保留、刪除與匯出,由你的安全與產品契約決定。

同樣地,檔案 URL、下載連結與各種快取有各自的生命週期;不要假設撤權會讓一個已經發出去的 URL 立刻失效。