Configura la versione minima di TLS per un argomento o un dominio di Event Grid

Le risorse Basic di Griglia di eventi di Azure possono richiedere una versione minima di Transport Layer Security (TLS) per le connessioni client in entrata. I tipi di risorse supportati sono argomenti personalizzati, domini e namespace partner. Se un client utilizza una versione del protocollo inferiore al minimo configurato, Event Grid non accetta la richiesta.

La versione 2026-06-15-preview API aggiunge il seguente comportamento TLS minimo per queste risorse Event Grid Basic:

  • La versione minima predefinita di TLS è TLS 1.2.
  • TLS 1.0 e TLS 1.1 sono stati rifiutati.
  • TLS 1.2 è supportato.
  • TLS 1.3 può essere selezionato come versione minima TLS.

TLS 1.3 è una versione minima facoltativa. Le risorse esistenti non sono configurate automaticamente per richiedere TLS 1.3 e TLS 1.3 non è l'impostazione predefinita. Per richiedere TLS 1.3, configura esplicitamente la risorsa usando la versione API 2026-06-15-preview. Questo comportamento specifico per la versione API non stabilisce i valori predefiniti o supportati delle proprietà per le versioni API precedenti.

Versione dell'API TLS minimo predefinito TLS 1.0 e TLS 1.1 TLS 1.2 TLS 1.3 come minimo
2026-06-15-preview TLS 1.2 Rifiutato Sostenuto Supportato come impostazione facoltativa

Importante

Prima di configurare TLS 1.3 come versione minima TLS, verifica che ogni client e servizio che si collega alla risorsa Event Grid supporti TLS 1.3. I client che non supportano TLS 1.3 non possono comunicare con una risorsa che richiede TLS 1.3.

L'impostazione TLS minima a livello di risorsa si applica alle connessioni client in entrata. Un abbonamento a un evento Web Hook ha un'impostazione separata per la consegna degli eventi in uscita. Per maggiori informazioni sull'imposizione a livello di risorsa, vedi Imporre una versione TLS minima per le richieste alle risorse di Event Grid Basic.

Configura la versione minima TLS per un argomento o un dominio nel portale Azure

Puoi specificare la versione minima TLS quando crei un argomento Event Grid o un dominio nel portale Azure nella scheda Sicurezza. Gli screenshot seguenti sono per un argomento Event Grid. L'interfaccia utente per configurare questa proprietà per un dominio è simile.

Screenshot della scheda Crea Topic Security con la versione TLS minima impostata su versione 1.3.

Puoi anche specificare la versione minima di TLS per un topic esistente nella pagina Configuration. La lista minima delle versioni TLS include TLS 1.3.

Screenshot di una pagina di configurazione esistente dell'argomento Event Grid con l'elenco delle versioni TLS minime che mostra le versioni da 1.0 a 1.3.

Richiedi TLS 1.3 per un argomento usando un template Resource Manager

Per richiedere TLS 1.3 per un argomento personalizzato, usa la versione 2026-06-15-preview API e imposta la minimumTlsVersionAllowed proprietà su 1.3. L'esempio seguente riguarda un argomento personalizzato. Non si applica agli spazi dei nomi di Event Grid.

La procedura seguente descrive come creare un modello nel portale di Azure.

  1. Nel portale di Azure selezionare Crea una risorsa.

  2. In Cerca nel Marketplace, inserisci deployment personalizzato e poi premi Invio.

  3. Seleziona Distribuzione personalizzata (distribuisci usando template personalizzati) (anteprima), seleziona Crea e poi seleziona Crea il tuo template nell'editor.

  4. Nell'editor di template, incolla il seguente JSON per creare un topic che richieda TLS 1.3. Sostituisci il valore predefinito del topic_name parametro con il nome del tuo argomento.

    {
    "$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. Scegliere Salva per salvare il modello.

  6. Specifica i valori di distribuzione, poi seleziona Rivedi + crea per distribuire il template.

Note

Dopo aver aggiornato la versione minima TLS per un argomento o dominio di Event Grid, può volerci fino a 30 secondi perché la modifica si propaghi completamente.

Configura la versione minima TLS per un abbonamento a un evento Web Hook

L'impostazione TLS minima per un abbonamento a un evento Web Hook controlla la consegna in uscita da Event Grid al webhook. È separato dall'impostazione TLS minima per le connessioni in entrata a un argomento, dominio o namespace partner.

Quando crei un abbonamento a un evento Web Hook, puoi configurarlo per usare la versione TLS minima dell'argomento o specificare esplicitamente la versione minima.

Screenshot che mostra la pagina per impostare la versione TLS minima quando si crea un abbonamento evento a un argomento Event Grid.

Per una sottoscrizione evento Web Hook esistente, vai alla pagina Sottoscrizione evento e aggiorna l'impostazione TLS nella scheda Funzionalità aggiuntive. Per impostazione predefinita, la sottoscrizione evento usa la stessa versione minima di TLS dell'argomento.

Passaggio successivo

Per maggiori informazioni, vedi Imporre una versione TLS minima per le richieste alle risorse di Event Grid Basic.

  • Ultimo aggiornamento: