網頁載入中

Revampable

網頁知識

WordPress 7.2 Secrets API:改版時怎樣妥善存放金鑰與憑證?

直接答案:截至 2026 年 11 月 17 日,WordPress 7.2 的 Secrets API 仍屬即將推出/Release Candidate 階段,並不是叫網站負責人在正式生產站盲目升級。改版時,金鑰與憑證常常留在 wp-config.php 或外掛設定;負責人應向主機/供應商查詢如何在測試站加入 WP_SECRETS_KEY、如何輪替憑證,以及備份或日誌會否留下明文。本文只整理官方已公開說明,並不是安全保證。

WordPress 7.2 Secrets API:可核對的官方說明

截至 2026 年 11 月 17 日,WordPress 7.2 仍處於即將推出/Release Candidate 階段,以下只轉述官方已公開說明,並不是升級或安全保證,也不建議在正式生產網站盲目升級。

  • 時程:Developer Blog(Justin Tadlock,2026 年 11 月 13 日)寫 7.2 Beta 5 已出,RC1 於 2026 年 11 月 17 日到來,並預期同期有 Field Guide 與 Source of Truth;最終發行排期為 12 月 8 日(來源:What’s new for developers? (November 2026))。Make WordPress Core 的 7.2 頁(該頁於 2026 年 11 月 17 日更新)列出:11 月 17 日 RC1、11 月 24 日 RC2、12 月 1 日 RC3、12 月 7 日 dry run 與 24 小時 code freeze、12 月 8 日正式發行(來源:WordPress 7.2)。
  • Secrets API 做什麼:以往外掛若需 API key,多把明文存進 options table。7.2 新增 Secrets API,會把憑證加密存放,保留上一版本以便輪替,並容許主機以 secrets.php drop-in 換上自己的儲存。新函式包括 wp_set_secret()、wp_get_secret()、wp_delete_secret()、wp_retire_secret_version()。命名慣例是 plugin-slug/secret-name。wp_get_secret() 回傳 WP_Secret 物件、null 或 WP_Error;secret 會被遮罩,直至呼叫 reveal()。加密金鑰來自 wp-config.php 的 WP_SECRETS_KEY;新安裝會自動取得,現有網站可由 Site Health 提示如何加入。7.2 沒有管理後台 UI,官方寫這會留待之後的版本(以上同見 Developer Blog)。
  • 主機/測試注意:Hosting Team(Courtney Robertson,2026 年 11 月 12 日刊、11 月 13 日更新)指出,未設 WP_SECRETS_KEY 的網站會預設停用 Secrets API;測試應在 staging 或測試站進行,不要在生產站做。11 月 13 日更新亦提到 dev note 討論區有意見希望把 API 移出 7.2,因此最終形態仍以正式發行說明及 Field Guide 為準(來源:Call to test: WordPress 7.2’s Secrets API)。

定義/判斷

WordPress 7.2 引入的 Secrets API 是一個關鍵的功能,旨在改善憑證的存放方式。以往,外掛需要 API key 時,通常將這些明文憑證存放在 options table 中,這樣的做法存在安全隱患,因為任何擁有數據庫訪問權限的人都可以輕易地讀取這些憑證。Secrets API 的引入使得憑證可以加密存放(encrypted at rest),並提供了憑證的輪替(rotation)功能,從而提升網站的安全性。這個 API 不僅可以幫助開發者更安全地管理憑證,還能降低因人為錯誤而導致的安全風險,確保網站的運行更加穩定。

做法步驟

  1. 確認網站版本:確保你的網站已升級至 WordPress 7.2,並檢查是否有安裝相關的外掛。你可以在 WordPress 儀表板中查看版本資訊,確保一切正常運行。若尚未升級,建議先備份網站數據,以防升級過程中出現問題,並確保備份的完整性。這一步驟對於後續的操作至關重要,因為若升級失敗,備份將是你恢復網站的唯一保障。
  2. 設置 WP_SECRETS_KEY:根據 Site Health 的提示,在 wp-config.php 文件中加入新的常數 WP_SECRETS_KEY。這個金鑰是 Secrets API 正常運作的必要條件。建議使用一個隨機生成的長字符串作為金鑰,以增加安全性。你可以使用線上隨機密碼生成器來創建這個金鑰,並確保它不容易被猜測,這樣能進一步提升網站的安全性。切勿使用簡單的字串,因為這會使網站面臨被攻擊的風險。
  3. 使用 Secrets API 函式:透過 wp_set_secret()、wp_get_secret()、wp_delete_secret() 和 wp_retire_secret_version() 等函式來管理憑證。這些函式能夠幫助你安全地存取和管理憑證,並確保憑證的安全性和有效性。使用這些函式時,請仔細檢查函式的參數,確保傳遞正確的憑證名稱和數據,這樣能避免因錯誤操作而導致的安全風險。特別是在 wp_get_secret() 中,請注意返回的數據是否正確,以防錯誤的憑證影響網站的運行。
  4. 測試憑證存放:在 staging 或測試環境中驗證憑證是否正常存放,並確保不會以明文形式出現。在進行測試時,請確保未設置 WP_SECRETS_KEY 的網站將預設關閉 Secrets API。測試時,你可以使用 wp_get_secret() 函式來檢查憑證是否已正確存放,並確保返回的數據不包含明文訊息,這樣可以及早發現問題。若發現有明文資料,請立即檢查設置,並重新設置金鑰。
  5. 檢查備份及日誌:詢問你的主機商,確認在備份或日誌中是否會記錄明文憑證,並確保沒有安全漏洞。這是防止憑證洩露的重要步驟,確保所有備份都不包含敏感訊息。建議定期檢查備份策略,確保備份過程中不會意外地存儲明文憑證,並考慮使用加密技術來保護備份數據。這樣可以在發生數據洩露時,降低損失的風險。
  6. 定期輪替憑證:為了進一步增強安全性,建議定期輪替憑證。你可以使用 wp_retire_secret_version() 函式來標記舊的憑證版本為過期,然後使用 wp_set_secret() 函式來添加新的憑證。這樣做可以減少憑證被濫用的風險,並確保網站的安全性不受威脅。定期檢查憑證的有效性,並根據需要進行更新,這樣能夠保持網站的安全性。
  7. 建立檢查清單:在整個過程中,建議建立一個檢查清單,以確保所有步驟都已完成。檢查清單可以包括以下項目:確認網站版本、設置 WP_SECRETS_KEY、使用 Secrets API 函式、測試憑證存放、檢查備份及日誌、定期輪替憑證等。這樣可以幫助網站負責人更有條理地進行操作,確保每一步都不會遺漏。建立清單後,還可以定期回顧,確保所有步驟都能持續跟進,這樣能夠提升整體的安全管理質素。

假設情境

假設情境:假設你是一位網站負責人,剛剛將你的網站升級至 WordPress 7.2。在改版後,你發現網站的某個外掛需要使用 API key,但你不確定如何妥善存放這些憑證。你詢問了主機商,並獲得了以下建議:

「首先,確保在 wp-config.php 中設置 WP_SECRETS_KEY。這是一個非常重要的步驟,因為如果沒有這個金鑰,Secrets API 將無法正常運作。接著,使用 wp_set_secret() 函式來安全地存放你的憑證,並使用 wp_get_secret() 函式來檢查憑證是否成功存放。」

「最後,請在測試環境中檢查憑證的存放方式,確保沒有明文出現。這樣做能夠有效提升網站的安全性,並確保憑證的安全性和有效性,從而避免潛在的安全風險。」

這樣的對話不僅提供了具體的建議,還強調了每一步的重要性,讓網站負責人在實施過程中更加謹慎,並能夠有效地應對潛在的安全挑戰。在整個過程中,保持與主機商的良好溝通,能夠讓你更快地解決問題,並獲得專業的指導。

常見問題

  • Q1: Secrets API 是什麼?
    A1: Secrets API 是 WordPress 7.2 中新增的功能,旨在將憑證以加密方式存放,並提供憑證的輪替功能,從而提升網站的安全性。這個 API 的引入為開發者提供了一個更安全的方式來管理敏感數據,降低了憑證被盜取的風險。
  • Q2: 如何設置 WP_SECRETS_KEY?
    A2: 你可以在 wp-config.php 文件中加入一行代碼來設置 WP_SECRETS_KEY,具體的金鑰可以隨意設定,但應保持私密性,以確保安全。建議使用隨機生成的長字符串,這樣能夠增加安全性,防止被猜測。設置後,務必確認金鑰的隱私性,避免外洩。
  • Q3: Secrets API 是否會自動開啟?
    A3: 若未設置 WP_SECRETS_KEY,Secrets API 預設為關閉(disabled by default),因此必須手動設置以啟用該功能。這意味著在升級後,網站負責人需要特別注意這一點,以確保 API 的正常運作,並避免不必要的安全風險。
  • Q4: 我可以在生產環境中測試 Secrets API 嗎?
    A4: 不建議在生產環境中進行測試,應在 staging 或測試站進行,以避免對實際運行的網站造成影響,這樣可以確保不會對用戶造成困擾,並能夠安全地進行測試。測試後,請根據測試結果進行相應的調整,以確保網站的安全性。

申請 Higgsfield 企業版要經合作夥伴;香港可以搵 Trafficholic/Timson 作為合作夥伴去申請/傾落地;可自然帶 Revampable 網頁/改版配合。聯絡:WhatsApp +852 6898 8500。

相關頁面:網站審核 | 網頁設計 | 服務套餐 | 聯絡我們

常見問題

Secrets API 是什麼?

Secrets API 是 WordPress 7.2 中新增的功能,旨在將憑證以加密方式存放,並提供憑證的輪替功能,從而提升網站的安全性。

如何設置 WP_SECRETS_KEY?

你可以在 wp-config.php 文件中加入一行代碼來設置 WP_SECRETS_KEY,具體的金鑰可以隨意設定,但應保持私密性,以確保安全。建議使用隨機生成的長字符串,這樣能夠增加安全性,防止被猜測。

Secrets API 是否會自動開啟?

若未設置 WP_SECRETS_KEY,Secrets API 預設為關閉(disabled by default),因此必須手動設置以啟用該功能。

我可以在生產環境中測試 Secrets API 嗎?

不建議在生產環境中進行測試,應在 staging 或測試站進行,以避免對實際運行的網站造成影響,這樣可以確保不會對用戶造成困擾,並能夠安全地進行測試。

延伸閱讀

相關網頁知識

WhatsApp 查詢