Configura la versión mínima de TLS para un tema o dominio de Event Grid

Los recursos básicos de Azure Event Grid pueden requerir una versión mínima de Transport Layer Security (TLS) para conexiones de cliente entrantes. Los tipos de recursos soportados son temas personalizados, dominios y espacios de nombres de socios. Si un cliente utiliza una versión de protocolo por debajo del mínimo configurado, Event Grid no acepta la solicitud.

La versión 2026-06-15-preview de la API añade el siguiente comportamiento mínimo TLS para estos recursos de Event Grid Basic:

  • La versión mínima predeterminada de TLS es TLS 1.2.
  • TLS 1.0 y TLS 1.1 son rechazados.
  • TLS 1.2 está soportado.
  • TLS 1.3 puede seleccionarse como la versión mínima de TLS.

TLS 1.3 es una versión mínima opcional. Los recursos existentes no están configurados automáticamente para requerir TLS 1.3, y TLS 1.3 no es el predeterminado. Para requerir TLS 1.3, configura explícitamente el recurso usando la versión de API 2026-06-15-preview. Este comportamiento específico de la versión de la API no establece los valores de propiedad predeterminados o soportados para versiones anteriores de la API.

Versión de API TLS mínimo por defecto TLS 1.0 y TLS 1.1 TLS 1.2 TLS 1.3 como mínimo
2026-06-15-preview TLS 1.2 Rejected Supported Se admite como configuración opcional

Importante

Antes de configurar TLS 1.3 como la versión mínima de TLS, verifica que todos los clientes y servicios que se conecten al recurso de Event Grid soporten TLS 1.3. Los clientes que no soportan TLS 1.3 no pueden comunicarse con un recurso que requiera TLS 1.3.

La configuración mínima TLS a nivel de recurso se aplica a las conexiones de cliente entrantes. Una suscripción a eventos de Web Hook tiene una configuración separada para la entrega de eventos salientes. Para obtener más información sobre la aplicación en el nivel de recurso, consulte Aplicación de una versión mínima de TLS para solicitudes a recursos básicos de Event Grid.

Configura la versión mínima de TLS para un tema o dominio en el portal de Azure

Puedes especificar la versión mínima de TLS al crear un tema de Grid de Eventos o un dominio en el portal de Azure en la pestaña Seguridad. Las siguientes capturas de pantalla son para un tema de Grid de Eventos. La interfaz de usuario para configurar esta propiedad en un dominio es similar.

Captura de pantalla de la pestaña Seguridad de Crear tema con la versión mínima de TLS establecida en Versión 1.3.

También se puede especificar la versión mínima de TLS para un tema existente en la página Configuración. La lista mínima de versiones de TLS incluye TLS 1.3.

Captura de pantalla de una página existente de configuración de temas de Event Grid con la lista de versiones mínimas TLS que muestran las versiones 1.0 a 1.3.

Requerir TLS 1.3 para un tema usando una plantilla de Resource Manager

Para requerir TLS 1.3 para un tema personalizado, usa la versión 2026-06-15-preview de la API y establece la minimumTlsVersionAllowed propiedad en 1.3. El siguiente ejemplo es para un tema personalizado. No se aplica a los espacios de nombres de Event Grid.

En los siguientes pasos se muestra cómo crear una plantilla en Azure Portal.

  1. En el portal de Azure, seleccione Crear un recurso.

  2. En Buscar en el Marketplace, introduce despliegue personalizado y luego pulsa Enter.

  3. Seleccione Implementación personalizada (implementar con plantillas personalizadas) (versión preliminar), seleccione Crear y, a continuación, seleccione Cree su propia plantilla en el editor.

  4. En el editor de plantillas, pega el siguiente JSON para crear un tópico que requiera TLS 1.3. Reemplace el valor predeterminado del parámetro topic_name por el nombre del tema.

    {
    "$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 la plantilla.

  6. Especifica los valores de despliegue y luego selecciona Revisar + crear para desplegar la plantilla.

Note

Después de actualizar la versión mínima de TLS para un tema o dominio de la Grid de Eventos, puede tardar hasta 30 segundos en propagarse completamente el cambio.

Configurar la versión mínima de TLS para una suscripción a un evento Web Hook

La configuración mínima de TLS para una suscripción a un evento de Web Hook controla la entrega saliente desde Event Grid al webhook. Es independiente del ajuste mínimo de TLS para conexiones entrantes a un tema, dominio o espacio de nombres de socio.

Cuando creas una suscripción a un evento Web Hook, puedes configurarla para que use la misma versión mínima TLS que el tema o especificar explícitamente la versión mínima.

Captura de pantalla que muestra la página para establecer la versión mínima de TLS al crear una suscripción de eventos para un tema de Event Grid.

Para una suscripción existente a un evento Web Hook, ve a la página Event Subscription y actualiza la configuración TLS en la pestaña Additional Features. Por defecto, la suscripción al evento usa la misma versión mínima TLS que el tema.

Paso siguiente

Para más información, consulte Imponer una versión mínima de TLS para solicitudes a recursos básicos de Event Grid.

  • Se actualizó por última vez el