觀點 · 資訊分享

Cloudflare Access 機器密鑰換新有緩衝了:寬限期 1 小時到 30 天,還能一鍵暫停

Cloudflare Access 的服務權杖在 8 月 25 到 26 日連出三項更新:換密鑰可設寬限期、可暫時停用而不刪除、新密鑰改用 cfast_ 開頭的可掃描格式,舊密鑰不用重換。

發布
2026-08-26
篇幅
約 5 分鐘 · 2,093 字
結構
7 節 + 3 題常見問題
標籤
#Cloudflare#Cloudflare Access#服務權杖#密鑰管理
Cloudflare Access 機器密鑰換新有緩衝了:寬限期 1 小時到 30 天,還能一鍵暫停

一句話看懂:Cloudflare Access 的「服務權杖」(給程式與機器用的通行證)在 8 月 25 到 26 日一口氣出了三項更新:換密鑰可以設寬限期、能暫時停用、新密鑰的格式也更容易被掃描工具抓到。

Access 服務權杖三項更新資訊圖卡:機器用的登入密鑰:換得更平滑、停得更快,新格式也更好掃描

先用白話講:服務權杖是什麼?

Cloudflare Access 像是大樓的門禁:想進入受保護的網站或 API,要先證明身分。人可以用帳號登入,但程式與機器沒辦法按「用 Google 登入」,所以 Access 發給它們一組專用的通行證,這就是服務權杖(service token)。

這組通行證有兩個部分:公開的 ID 和不能外洩的密鑰(Client Secret)。就像飯店房卡:卡號大家看得到,但卡本身要收好。

發生什麼事

Cloudflare 更新日誌在兩天內出了三篇,都跟服務權杖有關:

  • 8 月 25 日:換密鑰可以設寬限期。管理員換密鑰時,可以選擇讓新舊兩把密鑰同時有效一段時間,好讓你慢慢更新各個服務,不會因為換密鑰而突然斷線。主控台提供 1 小時到 30 天;也可以選擇立刻撤銷舊密鑰。
  • 8 月 25 日:可以暫時停用權杖。不用刪除權杖,就能把它「關掉」:停用的權杖無法通過驗證,但設定都還在,之後可以再打開。官方的用途舉例是:懷疑密鑰外洩時先隔離,或暫停某個自動化服務。
  • 8 月 26 日:新密鑰格式可被掃描。從 8 月 26 日起新建立的密鑰,格式是 cfast_ 開頭,後面接 40 個英數字,最後再加 8 個字元的檢查碼。這樣的固定前綴與檢查碼,能讓機密掃描工具更容易認出,誤判也比較少。

這三項怎麼搭配?

情境 可以怎麼做
例行換密鑰 設寬限期,先換新密鑰,慢慢更新服務,期限到了舊密鑰自動作廢
懷疑密鑰外洩 先暫停權杖;官方說,停用也會同時中止正在寬限期內的舊密鑰
不確定密鑰有沒有被誤傳到程式碼庫 新格式讓掃描工具更容易發現,搭配 GitHub 之類的機密掃描更有效

給開發者的技術細節

  • 驗證用的標頭沒有變,仍是 CF-Access-Client-Id 與 CF-Access-Client-Secret;新舊格式的密鑰都用同一個 Client ID
  • 舊密鑰不用重換:官方明說既有的服務權杖密鑰繼續有效,不需要輪替
  • 透過 API 換密鑰時,Cloudflare 官方文件寫的是呼叫「Rotate a service token」端點,用 previous_client_secret_expires_at 帶入 RFC 3339 格式的到期時間,就能自訂輪替排程
  • 需要設定的步驟請看官方文件的「Rotate service token secrets」與「Turn a service token on or off」
# 範例:在 CI 裡用服務權杖呼叫受 Access 保護的服務(值請放環境變數,不要寫進程式碼)
curl -H "CF-Access-Client-Id: $CF_ACCESS_ID" -H "CF-Access-Client-Secret: $CF_ACCESS_SECRET" https://app.example.com

我的看法

這三項更新單看都很小,湊在一起卻是一套完整的密鑰管理流程:能換、能停、能被掃到。

自架服務的人最容易忽略的就是機器密鑰,因為它們一設好就多半放著不管。我會建議:把「定期換密鑰」排進行事曆,換的時候用寬限期,不要為了省事選立刻撤銷,不然一台忘記更新的排程就會讓整條流程失敗;一旦發現密鑰貼在不該貼的地方,第一步先停用,再慢慢查。

另外,新格式只對「新建立的密鑰」有效,舊密鑰不會自動變成可掃描的樣子。如果你想提高掃描效果,可以趁換密鑰時順便升級。

名詞小辭典

  • 服務權杖(Service token):給程式與機器使用的身分憑證,用來通過 Cloudflare Access 的保護。
  • Client Secret:服務權杖裡不能外洩的那一半,等於這張通行證的密碼。
  • 輪替(Rotation):定期換掉密鑰,降低萬一外洩造成的傷害。
  • 機密掃描:自動檢查程式碼與紀錄裡有沒有誤放密碼或金鑰的工具。

資料來源

常見問題

我現有的服務權杖要重換嗎?
不用。官方說既有的服務權杖密鑰繼續有效,不需要輪替;只有 8 月 26 日起新建立的密鑰才會使用新格式。
寬限期可以設多久?
主控台提供 1 小時到 30 天的選項,也可以選擇立刻撤銷舊密鑰;用 API 時可以帶 RFC 3339 格式的到期時間,自訂輪替排程。
停用權杖跟刪除權杖有什麼不同?
停用後權杖無法通過驗證,但設定仍保留,之後能再打開;刪除則是整個移除。官方建議在疑似密鑰外洩,或要暫停自動化服務時使用停用。
LINE