適用於: ✔️ Front Door 進階版
Important
Azure Front Door 中的 Mutual TLS 目前處於預覽階段。 請參閱Microsoft Azure 預覽的補充使用條款,以了解適用於 Azure 測試版、預覽版或其他尚未正式發布的功能的法律條款。
互惠TLS(mTLS)認證,或稱用戶端驗證,確保客戶端與伺服器之間的流量在雙向間都是安全且可信的。 透過使用 mutual TLS,你可以設定 Azure Front Door 透過提供有效的客戶端憑證來驗證客戶端身份。 互惠TLS認證適用於需要安全識別和管理客戶端以鎖定資源的情境,例如企業對企業(B2B)應用、物聯網(IoT)應用、銀行應用程式、VPN、企業網路等。
你可以搭配 Azure Front Door 支援的其他授權和認證方式,使用 mutual TLS。
Note
Azure Front Door Premium 支援互惠 TLS。
互惠 TLS 驗證模式
停用 mTLS:不需要客戶端憑證和驗證。 這個選項是預設值。
啟用 mTLS:
客戶端證書必備並驗證: 客戶端證書是必須的。 Azure Front Door 會做完整的驗證,包括檢查客戶端憑證的存在、有效性,以及是否被撤銷、根憑證鏈和 SAN/CN 清單。 Azure Front Door 會將帶有標頭
X-Azure-ClientCertificate的請求轉發到來源。 當啟用 mTLS 時,這個選項是預設情境。客戶端證書必須但未驗證: 客戶端證書是必須的。 Azure Front Door 不會執行其他驗證。 Azure Front Door 會丟棄不包含憑證的請求。 原廠必須進行所有驗證。 預設情況下,Azure Front Door 會透過標頭將憑證傳遞到後端。
-
客戶端憑證驗證(如有): 客戶端證書不是必須的。 Azure Front Door 在有客戶端憑證存在時會進行完整驗證,並透過
X-Azure-ClientCertificate標頭將客戶端憑證轉發給來源。 如果客戶端沒有提供客戶端憑證,Azure Front Door 會將請求轉交給來源進行進一步驗證。
-
客戶端憑證驗證(如有): 客戶端證書不是必須的。 Azure Front Door 在有客戶端憑證存在時會進行完整驗證,並透過
mTLS 直通至起始點: 客戶端證書不是必須的。 Azure Front Door 不會執行任何驗證。 原廠必須進行所有驗證。
用戶端驗證
當你設定 Azure Front Door 來驗證客戶端憑證時,它會檢查以下資訊:
目前日期小於證書
Not After日期。目前日期大於或等於證書
Not Before日期。憑證擴展金鑰使用資訊不存在,或者即使存在,也包含客戶端認證的 OID。
證明證書的有效性與完整性,證明其格式未被更改。
檢查憑證鏈,如果客戶端憑證是由指定網域的受信任發行者發出,憑證的 CN(憑證名稱)會形成一條不中斷的鏈。
您也可以設定可選的驗證功能,例如:
驗證客戶端憑證的 SAN/CN 擴充,是否符合上傳到 Azure Front Door 的允許 SAN 清單。 Azure Front Door 自訂網域主機名稱必須明確包含在此清單中,才能被視為有效進行互惠 TLS 驗證。 SAN 會先被驗證,如果沒有匹配或 SAN 是空的,則會驗證 CN。 如果 SAN 或 CN 中的某個符合 Azure Front Door 上設定的允許 SAN 清單,驗證就會成功。
可透過 OCSP(線上憑證狀態協定)檢查客戶端憑證的撤銷狀態。
Note
Azure Front Door 允許網域清單中不支援萬用碼網域。 如果客戶端憑證的 SAN/CN 有通配碼網域,且 Azure Front Door 允許清單中某一層子網域符合,驗證就會成功。
憑證撤銷檢查
Azure Front Door 支援憑證撤銷狀態的驗證。 預設是啟用的。 在驗證過程中,Azure Front Door 會利用其 Authority Information Access (AIA) 擴充功能中定義的 OCSP 回應器查詢客戶端所提供的憑證。 如果客戶端憑證被撤銷,Azure Front Door 會回覆客戶端一個 HTTP 403 狀態碼及原因。 如果憑證有效,Azure Front Door 會繼續處理這個請求。
mTLS 支援公開與私有憑證嗎?
Azure Front Door 目前支援由知名公開憑證機構及私人設立的憑證機構所簽發的憑證。
知名憑證機構頒發的CA證書: 受信任憑證儲存通常包含中間憑證與根憑證,這些憑證能在幾乎不需額外設定的情況下,實現可信連線。
由組織已建立的憑證機構核發的 CA 證書: 你的組織通常私下發放這些證書,其他機構不信任它們。 您必須將中間憑證和根憑證匯入受信任憑證儲存,讓客戶建立鏈信任。
然而,Azure Front Door 會對用戶端憑證進行擴展金鑰使用(EKU)檢查,以確保憑證是為用戶端認證而設。 由於產業變革,公共憑證授權機構(CA)很快停止發行具備所需EKU的用戶端認證憑證。
轉用私有 CA,這些憑證可以持續以正確的 EKU 發出憑證,用於 Azure Front Door 的 mTLS 場景。 此轉換確保客戶端身份不中斷且安全。
在前門網域實施 mTLS 前的重要設計考量
在新網域和新端點啟用 mTLS,以避免不必要的停機。
啟用 mTLS 後,無法在路由或規則引擎中啟用快取,且無法在快取中啟用。 此限制防止將快取內容回傳給未認證的用戶端。
mTLS 在功能上是域上的。 不過,為了確保惡意使用者無法繞過 mTLS 來存取你的來源,Azure Front Door 端點上有一個 mTLS 控制。 在自訂網域啟用 mTLS 之前,先在該自訂網域所關聯的 Azure Front Door 端點啟用 mTLS。 所有帶有 mTLS 的網域只能與此類端點下的路由關聯。 你不能將擁有混合互認證狀態的網域關聯到同一個端點。
當 Front Door 端點啟用 mTLS,你無法將Azure Front Door端點域與路由關聯。 反過來,你需要先將端點域與端點下的所有路由解除關聯,才能啟用端點的 mTLS。
如果你在現有的 Azure Front Door 網域上開啟 mTLS,會有停機時間,因為你需要做以下變更。 啟用新的自訂網域 mTLS。
建立一個啟用 mTLS 的新端點,或使用任何啟用 mTLS 的現有 Azure Front Door 端點。
將自訂網域與未啟用 mTLS 的現有路由及端點解除關聯。
然後將自訂網域重新關聯到端點。
一旦在網域上啟用了互認證,關閉它也會造成停機。
將自訂網域與現有啟用 mTLS 的終端下的所有路由解除關聯。
在網域上關閉 mTLS。
將網域重新關聯到未啟用 mTLS 的另一個端點。
在你的起始地址新增存取控制,以驗證請求是否來自有效的前門。 如需詳細資訊,請參閱保護 Azure Front Door 來源的流量。
CA 憑證管理:透過 Azure Key Vault 上傳根目錄及最多三個中間文件(PEM,25 <KB)。 沒有自動旋轉,但雙重 CA 支援能讓無縫轉帳。
Azure Front Door 會對用戶端憑證進行擴展金鑰使用(EKU)檢查,以確保憑證是用於用戶端驗證,這是重要的安全措施。 然而,由於產業變動,公共憑證授權中心(CA)將很快停止發行具備所需 EKU 的客戶端認證憑證。 轉用私有憑證管理中心,這些憑證可以持續在 Azure Front Door 上以正確的 EKU 發行,確保用戶端認證不中斷且安全。
客戶正逐漸遠離 OCSP。 在 Front Door 憑證撤銷檢查時,Azure Front Door 目前只檢查 OCSP。
如果用戶端發送帶有以下標頭的請求,Azure Front Door 會丟棄標頭並將請求轉發給來源。
X-Azure-ClientCertEndDateX-Azure-ClientCertFingerprintX-Azure-ClientCertIssuerX-Azure-ClientCertSerialX-Azure-ClientCertStartDateX-Azure-ClientCertSubjectX-Azure-ClientCertVerifyX-Azure-ClientCertificate
解決方案會暴露哪些指標和對數欄位?
解法揭示了以下指標:
mTLS 請求數量。
mTLS 申請失敗。
mTLS 錯誤請求,依錯誤類型、SNI 主機名稱及 TLS 協定細分。
配置配額上限
客戶端 CA 憑證鏈可包含根節點及最多三個中間節點。
CA 證書必須採用 PEM 編碼且大小不超過 25 KB。
不支援自動旋轉。
你可以附加兩張加州憑證,以便在到期或撤銷時無縫轉帳。 Azure Front Door 在執行時會使用有效的 CA 憑證來驗證。
設定步驟
欲了解更多限制,請參閱 重要的設計考量 章節。 建議在新的端點和網域啟用 mTLS。
登入 Azure 入口網站,搜尋你的 Front Door 個人檔案。
在 安全性中,選擇 Mutual TLS CA 憑證。 如果你過去上傳過 mTLS 憑證鏈,你會看到清單。
選取 [+ 新增]。 你會看到你能存取的 金鑰保存庫 和 Secret 物件。 選擇你想用作 mTLS 握手公鑰部分的那些。
在 設定中,選擇 前門管理員。 你可以看到端點的清單。
選擇 + 新增端點,並勾選 強制互惠 TLS。
Note
當啟用
.z01.azurefd.net時,你無法將 Azure Front Door 預設網域(例如 )作為該端點路由的網域。 在建立路由前,請進入下一步驟,先建立啟用 mTLS 的自訂網域。在設定底下,選取網域。 你會看到現有自訂網域的清單。
選取 [+ 新增]。
在 新增網域 頁面,設定你的網域,然後往下滑到 進階設定 ,選擇 啟用互惠 TLS ,以設定該網域的互惠 TLS。
選擇 新增 以建立網域。
互惠TLS模式:從四種選項中選擇
- 客戶端憑證必須並已驗證
- 需要客戶端憑證但未驗證
- 客戶端憑證驗證(如有)
- mTLS 直通至起始點
當 Azure Front Door 設定時,選擇 CA 憑證以驗證客戶憑證。
啟用憑證撤銷檢查。
加入 SAN/CN 清單來比對。 Azure Front Door 自訂網域主機名稱必須明確包含在此清單中,才能被視為有效進行互惠 TLS 驗證。
成功建立網域後,前往先前建立的端點,在 Front Door Manager 下,新增路由,將該網域與正確的來源群組關聯。
確認 mTLS 是否如預期運作。 你可以透過將本地主機 IP 綁定到 Azure Front Door 的其中一個 IP 來檢查這個條件。
驗證成功後,將 DNS 中的自訂網域 CNMAE 記錄更新為指向 Azure Front Door 端點。
限制後端/來源存取,只接受來自 Azure Front Door 的流量,這樣就能防止直接存取 Origin 來繞過 mTLS。 如需詳細資訊,請參閱保護 Azure Front Door 來源的流量。
若要編輯網域上的現有 mTLS 設定,請在 網域頁面 選擇網域名稱。 「 編輯網域 」頁面會顯示目前的 mTLS 設定。
Note
在自訂網域上停用 mTLS 可能會導致停機,因為你需要先將自訂網域與路由和端點解除關聯,然後在該網域上停用 mTLS。 減輕停機時間的一種方法是,在 Azure Front Door 進行變更時,將流量路由回原始端。
Unexpected 403 (Forbidden) from Azure Front Door for mTLS request
如需更多診斷資訊,請將帶有請求的標頭X-Azure-DebugInfo:1傳給 Azure Front Door。 回應時,Front Door 回傳除錯標頭 X-Azure-Externalerror,並附上一個暗示錯誤可能的值。 下表列出錯誤值及其意義。
| 錯誤 | Description |
|---|---|
| ClientCert已過期 | 提交驗證的客戶憑證已過期。 |
| ClientCertSelfSigned | 用戶端憑證為自簽,發行者與葉子憑證相同。 |
| ClientCertIssuerNotFound(客戶認證發行人未被發現) | 找不到客戶憑證的發行者。 |
| ClientCertTooLongChain | 客戶端憑證鏈包含超過五個憑證,包括葉子憑證。 |
| ClientCertIncorrectPurpose | 憑證並非用於 EKU 的客戶端認證。 |
| ClientCertRootCAUntrusted | 憑證的根憑證授權中心不被信任。 |
| ClientCertIssuerSubjectMismatch | 該證書被拒絕是因為主體名稱與發卡人名稱不符。 |
| ClientCertCNSANMismatch | CN SAN 的客戶憑證清單與 Azure 入口設定 mTLS 時指定的允許 FQDN 不符。 |
| ClientCertMissing | 客戶端憑證不會顯示給 Azure Front Door。 |
| ClientCertRevoked | 客戶證書或發行者證書會被撤銷。 |
| ClientHeaderTooLong | 客戶端發送了太長的請求標頭。 |
| ClientCertInvalid | 通用客戶端憑證錯誤。 |