为事件网格主题或域配置最低TLS版本

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 Rejected Supported 支持作为选择加入设置

Important

在配置TLS 1.3为最低TLS版本之前，先确认所有连接到事件网格资源的客户端和服务都支持TLS 1.3。 不支持 TLS 1.3 的客户端无法与需要 TLS 1.3 的资源通信。

资源级最低TLS设置适用于入站客户端连接。 Web Hook 事件订阅有一个单独的出站事件传递设置。 有关资源级强制的更多信息，请参见“ 强制执行对事件网格基本资源请求的最低TLS版本”。

在 Azure 门户中为某个主题或域配置最低 TLS 版本

你可以在 Azure 门户的安全选项卡上创建事件网格主题或域时指定最低 TLS 版本。以下截图是针对事件网格主题的。 为域配置该属性的用户界面类似。

创建主题安全标签页的截图，TLS最低版本设置为1.3版本。

你也可以在 配置 页面指定现有主题的最低TLS版本。 TLS的最低版本列表包括TLS 1.3。

现有事件网格主题配置页面的截图，包含最小TLS版本列表，显示版本为1.0到1.3。

使用资源管理器模板要求主题使用TLS 1.3

要要求自定义主题使用 TLS 1.3，请使用 API 版本2026-06-15-preview并将属性1.3设置为 minimumTlsVersionAllowed 。 以下示例适用于自定义主题内容。 它不适用于事件网格命名空间。

以下步骤介绍如何在 Azure 门户中创建模板。

  1. 在 Azure 门户中，选择“ 创建资源”。

  2. 在“搜索市场”中，输入自定义部署，然后按回车。

  3. 选择 自定义部署（使用自定义模板部署）（预览），选择 创建，然后 在编辑器中选择构建您自己的模板。

  4. 在模板编辑器中，粘贴以下 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": "chinanorth2",
            "properties": {
                "minimumTlsVersionAllowed": "1.3"
            }
        }
    ]
}

  5. 保存模板。

  6. 指定部署值，然后选择 “审查 + 创建” 来部署模板。

Note

在你更新事件网格主题或域的最低TLS版本后，变更完全传播可能需要长达30秒。

为 Web Hook 事件订阅配置最低 TLS 版本

Web Hook 事件订阅的最低 TLS 设置控制从 Event Grid 向 webhook 的出站传输。 它与针对主题、域或合作伙伴命名空间的入站连接的最低TLS设置是分开的。

创建 Web Hook 事件订阅时，你可以配置它使用与主题相同的最低 TLS 版本，或明确指定最低版本。

截图显示创建事件订阅时设置最低TLS版本的页面。

对于已有的Web Hook事件订阅，请前往 事件订阅 页面，在 附加功能 标签页更新TLS设置。默认情况下，事件订阅使用的最低TLS版本与主题相同。

后续步骤

欲了解更多信息，请参见 对事件网格基础资源的请求强制执行最低TLS版本。

  • 上次更新时间为