Azure 事件方格 Basic 資源可能需要最低版本的傳輸層安全性(TLS)來處理入站用戶端連線。 支援的資源類型包括自訂主題、網域與合作夥伴命名空間。 如果客戶端使用的協定版本低於設定的最低值,事件網格就不會接受該請求。
API 版本 2026-06-15-preview 為這些事件網格 Basic 資源新增以下最低 TLS 行為:
- 預設的最低 TLS 版本是 TLS 1.2。
- TLS 1.0 和 TLS 1.1 被拒絕。
- 支援 TLS 1.2。
- TLS 1.3 可選擇為最低 TLS 版本。
TLS 1.3 是需手動啟用的最低版本。 現有資源不會自動設定成需要 TLS 1.3,而 TLS 1.3 也不是預設。 若要要求 TLS 1.3,請明確使用 API 版本 2026-06-15-preview來配置資源。 此特定 API 版本的行為並不能確定舊版 API 的預設屬性值或支援的屬性值。
| API 版本 | 預設最低 TLS | TLS 1.0 和 TLS 1.1 | TLS 1.2 | TLS 1.3 作為最低要求 |
|---|---|---|---|---|
2026-06-15-preview |
TLS 1.2 | 已拒絕 | 支援 | 支援,但須自行選擇啟用 |
Important
在將 TLS 1.3 設定為最低 TLS 版本之前,請確認每個連接到事件網格資源的客戶端和服務都支援 TLS 1.3。 不支援 TLS 1.3 的客戶端無法與需要 TLS 1.3 的資源通訊。
資源層級的最低 TLS 設定適用於入站用戶端連線。 Web Hook 事件訂閱有一個獨立的外發事件傳送設定。 欲了解更多關於資源層級強制執行的資訊,請參閱「 強制執行對事件網格基本資源請求的最低 TLS 版本」。
在 Azure 入口網站中設定主題或網域的最低 TLS 版本
你可以在 Azure 入口網站的安全性索引標籤中,建立事件網格主題或網域時指定最低 TLS 版本。以下螢幕擷取畫面是事件網格主題的。 為網域設定此屬性的使用者介面也類似。
你也可以在 設定 頁面指定現有主題的最低 TLS 版本。 TLS 的最低版本清單包含 TLS 1.3。
使用 Resource Manager 範本要求主題使用 TLS 1.3
若要要求自訂主題使用 TLS 1.3,請使用 API 版本 2026-06-15-preview,並將 minimumTlsVersionAllowed 屬性設為 1.3。 下列範例適用於自訂主題。 這不適用於事件網格命名空間。
下列步驟描述如何在 Azure 入口網站中建立範本。
在Azure入口網站中,選擇 Create a resource。
在 搜尋市集,輸入 自訂部署,然後按 Enter。
選擇 自訂部署(使用自訂範本部署)(預覽),選擇 建立,然後在 編輯器中選擇建立您自己的範本。
在範本編輯器中,貼上以下 JSON 以建立需要 TLS 1.3 的主題。 將
topic_name參數的預設值取代為您的主題名稱。{ "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "1.0.0.0", "parameters": { "topic_name": { "defaultValue": "spcustomtopic0123", "type": "String" } }, "resources": [ { "type": "Microsoft.EventGrid/topics", "apiVersion": "2026-06-15-preview", "name": "[parameters('topic_name')]", "location": "eastus", "properties": { "minimumTlsVersionAllowed": "1.3" } } ] }儲存範本。
指定部署值,然後選取 [檢閱 + 建立] 以部署範本。
Note
在你更新事件網格主題或網域的最低 TLS 版本後,變更完全傳播可能需要最多 30 秒。
設定 Web Hook 事件訂閱的最低 TLS 版本
Web Hook 事件訂閱的最低 TLS 設定控制從 Event Grid 到 webhook 的外送傳遞。 它與針對主題、網域或合作夥伴命名空間的入站連線的最低 TLS 設定是分開的。
當你建立 Web Hook 事件訂閱時,可以設定它使用與主題相同的最低 TLS 版本,或明確指定最低版本。
對於現有的 Web Hook 事件訂閱,請前往 Event Subscription 頁面,並在 附加功能 標籤中更新 TLS 設定。預設情況下,事件訂閱使用的最低 TLS 版本與主題相同。
下一步
如需詳細資訊,請參閱針對傳送至事件方格基本層資源的要求強制執行最低 TLS 版本。