Skip to main content
Version: Next

ACME

用途說明#

自動提供從 Let's Encrypt 或是其它 ACMEv2 服務發佈之憑証。

欄位配置說明#

變數類型預設值說明必填
account_emailstring識別帳戶用,可在其它插件實例中重覆使用。V
api_uristringhttps://acme-v02.api.letsencrypt.orgACMEv2 API 端點。可使用 Let's Encrypt staging environment 做測試。(註一)
cert_typestringrsa憑證的型態,如使用RSA憑證則選擇 rsa 或是使用EC憑證則選擇 ecc
domainsarray of string[]創造憑證的域名列表。如要符合 example.com 底下的子域名則可寫成 *.example.com。不支援正規表示式。(註二)
renew_threshold_daysnumber14更新憑證的時間(單位為天)。
storagestringshm使用的後端儲存型態。包含 kongshmredisconsul 或是 vault
storage_configtable後端儲存相關設定。
tos_acceptedbooleanfalse如果使用 Let's Encrypt,必須把這項欄位設定為 true,代表同意 Terms of Service
note

註一:如果要直接做為產品推出,並且使用了同樣的域名,需要在測試完後手動把測試資料刪除。
註二:此欄位僅能填入域名,不代表公用名稱(Common Name)或是主題備用名稱(Subject Alternative Name)。每個域名擁有自己的憑證。

用法示例#

在全局啟用插件#

  1. 從網站左邊Menu中 外掛插件 頁面中,點選右上角的 新增外掛插件

全局啟用畫面

  1. 點選後,選擇 安全 頁籤,並啟用ACME,填寫內容參考欄位配置說明,設定成功後,任何請求(不分服務、路由、用戶)皆需經過驗證才能通過。

驗證#