開發者API 金鑰與驗證

最小權限,而不是一把萬用權杖。

一把無所不能的 API 金鑰,一旦外洩就是災難。CMSHub 的機器憑證明確帶有依集合設定的動作權限——查閱、建立、更新或刪除——整合只會持有真正需要的權限,金鑰即使外洩,影響範圍也小且可預知。

01 / 機器憑證

限定範圍的 API 金鑰,而非主金鑰

依工作區建立、輪替與撤銷 API 金鑰,每把金鑰只限用於特定集合與特定動作——與你對待任何正式環境憑證的最小權限原則相同。

依集合、依動作限定範圍

只在整合實際觸及的集合上,精確授予查閱、建立、更新或刪除權限——沒有任何隱含權限。

建立、輪替、撤銷

在工作區中管理金鑰的生命週期——定期輪替,或在外洩時立即撤銷。

預設拒絕

金鑰若未被明確授予某個集合的權限,就無法存取它——不會隱性退回更寬鬆的權限。

02 / 使用者工作階段

強化的憑證,可撤銷的工作階段

使用者登入採用以 Argon2id 衍生的憑證——一種現代、高記憶體成本的雜湊演算法——伺服器端工作階段以 JWT 封裝,可立即撤銷,而不只是等它過期。

以 Argon2id 衍生的憑證

密碼以 Argon2id 雜湊,能抵禦 GPU 與 ASIC 加速的破解攻擊。

可撤銷的工作階段

伺服器端工作階段代表遭盜用的工作階段可以立即撤銷,不必等權杖過期。

可稽核的驗證事件

登入、工作階段撤銷與金鑰異動都會留下紀錄,讓你能回答誰在何時存取了什麼。

建立限定範圍的金鑰

核發只限一個集合的 API 金鑰。

開啟工作區,建立權限恰好符合整合需求的金鑰。