Impor uma versão mínima de TLS para pedidos aos recursos básicos do Event Grid

A comunicação entre um cliente e um recurso do Azure Event Grid é encriptada através do Transport Layer Security (TLS). Para informações sobre TLS, consulte Transport Layer Security.

Para tópicos personalizados Event Grid Basic, domínios e namespaces de parceiros, pode configurar a versão mínima TLS aceite para pedidos de cliente recebidos. A configuração mínima de TLS 1.2 exige que os clientes usem o TLS 1.2 ou uma versão mais recente do protocolo que o serviço suporte. Um mínimo configurado de TLS 1.3 exige que os clientes utilizem TLS 1.3. O Event Grid não aceita pedidos que utilizem uma versão do protocolo abaixo do mínimo configurado.

A versão 2026-06-15-preview da API define a versão mínima TLS para TLS 1.2 e rejeita TLS 1.0 e TLS 1.1. Com esta versão da API, pode configurar explicitamente o TLS 1.3 como mínimo. O TLS 1.3 não é o padrão, e os recursos existentes não estão automaticamente configurados para exigir TLS 1.3. Este comportamento é específico da versão 2026-06-15-preview da API e não estabelece o comportamento das versões anteriores da API.

O suporte e negociação de protocolos no endpoint de serviço são diferentes da aplicação mínima do TLS ao nível dos recursos. Um endpoint pode negociar um protocolo que o serviço suporta, e o Event Grid avalia então o pedido com base na versão mínima de TLS configurada no recurso.

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.

Permissões para tópicos e domínios

Para definir a propriedade minimumTlsVersionAllowed para um tópico ou domínio da Grade de Eventos, deve ter permissão para criar e gerir o recurso. Os papéis de controlo de acesso baseado em papéis do Azure (Azure RBAC) que fornecem estas permissões incluem a ação Microsoft.EventGrid/topics/write ou Microsoft.EventGrid/domains/write. As funções incorporadas com estas ações incluem:

As atribuições de funções devem ser definidas para o tópico ou domínio da Grelha de Eventos, ou para um nível superior, para permitir que o utilizador configure a sua versão mínima de TLS. Para obter mais informações sobre o escopo da função, consulte Entender o escopo do RBAC do Azure.

Restringa estas atribuições de funções a utilizadores que necessitem da capacidade de criar um tópico ou domínio do Event Grid ou de atualizar as suas propriedades. Utilize o princípio do privilégio mínimo para que os utilizadores tenham apenas as permissões de que necessitam. Para obter mais informações, consulte Práticas recomendadas para o Azure RBAC.

Note

As funções clássicas de administrador de subscrição Administrador de Serviços e Coadministrador incluem o equivalente à função de Proprietário do Azure Resource Manager. O papel de Proprietário inclui todas as ações, pelo que um utilizador com uma destas funções administrativas pode também criar e gerir tópicos ou domínios do Event Grid. Para obter mais informações, consulte Funções do Azure, Funções do Microsoft Entra e funções clássicas de administrador de assinatura.

Considerações de rede

Quando um cliente envia um pedido para um tópico ou domínio do Event Grid, estabelece primeiro uma ligação ao endpoint. O Event Grid verifica a definição mínima de TLS do recurso quando processa o pedido. Se o pedido usar uma versão do protocolo abaixo do mínimo configurado, o Event Grid rejeita o pedido.

Considere o seguinte comportamento:

  • Um rastreio de rede pode mostrar o estabelecimento bem-sucedido da ligação TCP e a negociação TLS antes de a Event Grid rejeitar um pedido que utilize uma versão do protocolo abaixo do mínimo configurado.
  • A varredura de endpoint identifica os protocolos que o endpoint de serviço pode negociar. Não identifica a versão mínima do TLS configurada num tópico, domínio ou espaço de nomes de parceiro individual.

A entrega por Webhook é separada

Uma subscrição de evento do Web Hook tem uma definição mínima separada de TLS para a entrega de eventos de saída do Event Grid para o webhook. A configuração ao nível do recurso descrita neste artigo controla os pedidos de entrada e não define o protocolo que o Event Grid utiliza para entregar eventos a um webhook.

Próximo passo

Para configurar a definição, veja Configurar a versão mínima TLS para um tópico ou domínio do Event Grid.

  • Última atualização a