Configure a versão mínima do TLS para um tópico ou domínio do Event Grid

Os recursos básicos do Azure Event Grid podem exigir uma versão mínima do Transport Layer Security (TLS) para ligações de cliente de entrada. Os tipos de recursos suportados são tópicos personalizados, domínios e namespaces de parceiros. Se um cliente usar uma versão do protocolo abaixo do mínimo configurado, o Event Grid não aceita a solicitação.

A versão 2026-06-15-preview da API adiciona o seguinte comportamento mínimo TLS para estes recursos Event Grid Basic:

  • A versão mínima padrão de TLS é TLS 1.2.
  • O TLS 1.0 e o TLS 1.1 são rejeitados.
  • O TLS 1.2 é suportado.
  • O TLS 1.3 pode ser selecionado como a versão mínima do TLS.

TLS 1.3 é uma versão mínima opcional. Os recursos existentes não estão automaticamente configurados para exigir TLS 1.3, e TLS 1.3 não é o padrão. Para exigir o TLS 1.3, configure explicitamente o recurso usando a versão 2026-06-15-previewda API . Este comportamento específico da versão da API não estabelece os valores de propriedade padrão ou suportados para versões anteriores da API.

Versão da API TLS mínimo predefinido TLS 1.0 e TLS 1.1 TLS 1,2 TLS 1.3 no mínimo
2026-06-15-preview TLS 1,2 Rejeitado Supported Suportado como configuração opt-in

Importante

Antes de configurar o TLS 1.3 como a versão mínima do TLS, verifique se todos os clientes e serviços que se ligam ao recurso do Event Grid suportam o TLS 1.3. Os clientes que não suportam TLS 1.3 não conseguem comunicar com um recurso que exija TLS 1.3.

A definição TLS mínima ao nível de recurso aplica-se às ligações de cliente de entrada. Uma subscrição de evento Web Hook tem uma configuração separada para a entrega de eventos de saída. Para mais informações sobre aplicação ao nível dos recursos, consulte Impor uma versão mínima de TLS para pedidos a recursos Basic do Event Grid.

Configure a versão mínima TLS para um tópico ou domínio no portal do Azure

Pode especificar a versão mínima de TLS ao criar um tópico do Event Grid ou um domínio no portal Azure, no separador Segurança. As capturas de ecrã seguintes são para um tópico do Event Grid. A interface do utilizador para configurar esta propriedade para um domínio é semelhante.

Captura de ecrã do separador Segurança do Tópico em Criar Tópico com a versão mínima de TLS definida para a versão 1.3.

Também pode especificar a versão mínima TLS para um tópico existente na página de Configuração . A lista mínima de versões TLS inclui TLS 1.3.

Captura de ecrã de uma página existente de configuração do tópico do Event Grid com a lista de versões TLS Mínimas a mostrar as versões 1.0 a 1.3.

Exija o TLS 1.3 para um tópico usando um modelo do Resource Manager

Para exigir o TLS 1.3 para um tópico personalizado, use a versão 2026-06-15-preview da API e defina a minimumTlsVersionAllowed propriedade para 1.3. O exemplo seguinte é para um tema personalizado. Não se aplica aos namespaces do Event Grid.

As etapas a seguir descrevem como criar um modelo no portal do Azure.

  1. No portal Azure, selecione Criar um recurso.

  2. Em Pesquisar no Marketplace, introduza deployment personalizado e depois pressione Enter.

  3. Selecione Implementação personalizada (implementar com modelos personalizados) (pré-visualização), selecione Criar e, em seguida, selecione Criar o seu próprio modelo no editor.

  4. No editor de templates, cole o JSON seguinte para criar um tópico que exija TLS 1.3. Substitua o valor padrão do topic_name parâmetro pelo nome do seu tópico.

    {
    "$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"
            }
        }
    ]
}

  5. Guarde o modelo.

  6. Especifique os valores de implementação e depois selecione Revisar + criar para implementar o modelo.

Note

Depois de atualizar a versão mínima do TLS para um tópico ou domínio da Grade de Eventos, pode demorar até 30 segundos para que a alteração se propague totalmente.

Configurar a versão mínima de TLS para uma subscrição de evento Web Hook

A definição mínima de TLS para uma subscrição de evento Web Hook controla a entrega de saída do Event Grid para o webhook. É separado da configuração mínima de TLS para ligações de entrada a um tópico, domínio ou namespace de parceiros.

Quando cria uma subscrição de evento Web Hook, pode configurá-la para usar a mesma versão mínima TLS do tópico ou especificar explicitamente a versão mínima.

Captura de ecrã que mostra a página para definir a versão mínima TLS ao criar uma subscrição de evento para um tópico do Event Grid.

Para uma subscrição de evento Web Hook existente, vá à página de Subscrição do Evento e atualize a definição TLS no separador Funcionalidades Adicionais . Por defeito, a subscrição do evento usa a mesma versão mínima TLS do tema.

Próximo passo

Para mais informações, consulte Impor uma versão mínima do TLS para pedidos aos recursos do Event Grid Basic.

  • Última atualização a