Configurare la versione minima di TLS per un namespace di Event Hubs

Gli spazi di nomi Hub eventi di Azure permettono ai client di inviare e ricevere dati con TLS 1.2 e versioni successive. Per applicare misure di sicurezza più rigorose, è possibile configurare lo spazio dei nomi di Hub eventi in modo da richiedere che i client inviino e ricevano i dati con una versione più recente di TLS. Se uno spazio di nomi di un Event Hub richiede una versione minima di TLS, allora qualsiasi richiesta fatta con una versione precedente fallisce. Per informazioni concettuali su questa caratteristica, vedi Imporre una versione minima richiesta di Transport Layer Security (TLS) per le richieste a uno spazio dei nomi di Event Hubs.

È possibile configurare la versione minima di TLS usando il portale di Azure o un modello di Azure Resource Manager (ARM).

Specificare la versione minima di TLS nel portale di Azure

Puoi specificare la versione minima TLS quando crei uno spazio di nomi Event Hub nel portale Azure nella scheda Avanzato.

Screenshot che mostra la pagina per impostare la versione minima di TLS durante la creazione di uno spazio dei nomi.

È anche possibile specificare la versione minima di TLS per uno spazio dei nomi esistente nella pagina Configurazione.

Screenshot che mostra la pagina per impostare la versione minima di TLS per uno spazio dei nomi esistente.

TLS 1.3 è disponibile come versione minima TLS nel portale Azure.

Screenshot che mostra le versioni TLS 1.0, 1.1, 1.2 e 1.3 nella lista delle versioni TLS minime.

Creare un modello per configurare la versione minima di TLS

Per configurare la versione minima TLS per uno spazio di nomi Event Hub con un template, crea un template con la MinimumTlsVersion proprietà impostata su 1.2 o 1.3. Quando crei uno spazio di nomi Event Hub con un template Azure Resource Manager, la MinimumTlsVersion proprietà viene impostata di default su 1.2, a meno che tu non la imposti esplicitamente a un'altra versione.

Note

Gli spazi dei nomi creati con un valore api-version precedente a 2022-01-01-preview avranno 1.0 come valore per MinimumTlsVersion. Questo comportamento era l'impostazione predefinita precedente ed è ancora disponibile per compatibilità con le versioni precedenti.

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

  1. Nel portale di Azure scegliere Crea una risorsa.

  2. In Cerca nel Marketplace digitare distribuzione personalizzata e quindi premere INVIO.

  3. Scegliere Distribuzione personalizzata (distribuzione tramite modelli personalizzati) (anteprima), scegliere Crea e quindi Crea un modello personalizzato nell'editor.

  4. Nell'editor di template, incolla il seguente JSON per creare un nuovo namespace e configurare la versione minima TLS. Ricordare di sostituire i segnaposto tra parentesi angolari con valori personalizzati.

    {
        "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
        "contentVersion": "1.0.0.0",
        "parameters": {
            "eventHubNamespaceName": {
                "type": "string",
                "defaultValue": "[concat(uniqueString(subscription().subscriptionId), 'tls')]",
                "metadata": {
                    "description": "Name of the Event Hubs namespace"
                }
            },
            "location": {
                "type": "string",
                "defaultValue": "westeurope",
                "metadata": {
                    "description": "Location for all resources."
                }
            },
            "minimumTlsVersion": {
                "type": "string",
                "defaultValue": "1.2",
                "allowedValues": [
                    "1.2",
                    "1.3"
                ],
                "metadata": {
                    "description": "Minimum TLS version"
                }
            }
        },
        "resources": [{
            "type": "Microsoft.EventHub/namespaces",
            "apiVersion": "2024-01-01",
            "name": "[parameters('eventHubNamespaceName')]",
            "location": "[parameters('location')]",
            "sku": {
                "name": "Standard"
            },
            "properties": {
                "minimumTlsVersion": "[parameters('minimumTlsVersion')]"
            },
            "tags": {}
        }]
    }
    
  5. Scegliere Salva per salvare il modello.

  6. Imposta il minimumTlsVersion parametro su 1.3 per richiedere TLS 1.3.

  7. Specificare il parametro del gruppo di risorse, quindi scegliere il pulsante Rivedi e crea per distribuire il modello e creare un account di archiviazione con la proprietà MinimumTlsVersion configurata.

Note

Dopo aver aggiornato la versione minima TLS per il namespace degli Event Hubs, potrebbero volerci fino a 30 secondi prima che la modifica venga completamente propagata.

Configurare la versione minima TLS richiede la versione API 2022-01-01-preview o successiva del provider di risorse Hub eventi di Azure.

Controllare la versione minima di TLS richiesta per uno spazio dei nomi

Per verificare la versione minima richiesta di TLS per il namespace del tuo Event Hubs, puoi consultare l'API di Azure Resource Manager. Avrai bisogno di un token Bearer per consultare l'API, che potrai recuperare usando l'app ARMClient eseguendo i seguenti comandi.

.\ARMClient.exe login
.\ARMClient.exe token <your-subscription-id>

Dopo aver ottenuto il bearer token, è possibile usare lo script seguente in combinazione con un client REST per eseguire query sull'API.

@token = Bearer <Token received from ARMClient>
@subscription = <your-subscription-id>
@resourceGroup = <your-resource-group-name>
@namespaceName = <your-namespace-name>

###
GET https://management.azure.com/subscriptions/{{subscription}}/resourceGroups/{{resourceGroup}}/providers/Microsoft.EventHub/namespaces/{{namespaceName}}?api-version=2022-01-01-preview
content-type: application/json
Authorization: {{token}}

La risposta dovrebbe essere simile alla seguente, con il valore minimumTlsVersion impostato tra le proprietà.

{
  "sku": {
    "name": "Premium",
    "tier": "Premium",
    "capacity": 1
  },
  "id": "/subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.EventHub/namespaces/<your-namespace-name>",
  "name": "<your-namespace-name>",
  "type": "Microsoft.EventHub/Namespaces",
  "location": "West Europe",
  "properties": {
    "minimumTlsVersion": "1.2",
    "publicNetworkAccess": "Enabled",
    "disableLocalAuth": false,
    "zoneRedundant": true,
    "isAutoInflateEnabled": false,
    "maximumThroughputUnits": 0,
    "kafkaEnabled": true,
    "provisioningState": "Succeeded",
    "status": "Active"
  }
}

Testare la versione minima di TLS in un client

Per testare che la versione minima richiesta di TLS per uno spazio di nomi di un Event Hub vieti le chiamate effettuate con una versione più vecchia, puoi configurare un client per usare una versione più vecchia di TLS. Per altre informazioni sulla configurazione di un client per l'uso di una versione specifica di TLS, vedere Configurare Transport Layer Security (TLS) per un'applicazione client.

Quando un client accede a uno spazio di nomi Event Hub utilizzando una versione TLS che non soddisfa la versione TLS minima configurata per il namespace, Hub eventi di Azure restituisce il codice di errore 401 (Non autorizzato) e un messaggio che indica che la versione TLS utilizzata non è consentita per effettuare richieste contro questo namespace Event Hub.

Note

A causa di limitazioni nella libreria confluente, gli errori provenienti da una versione TLS non valida non verranno visualizzati durante la connessione tramite il protocollo Kafka. Verrà invece visualizzata un'eccezione generale.

Note

Quando configuri una versione minima TLS per uno spazio di nomi Event Hubs, quella versione minima viene applicata al livello applicativo. Gli strumenti che tentano di determinare il supporto TLS al livello protocollo possono restituire versioni TLS oltre alla versione minima richiesta quando eseguiti direttamente sull'endpoint dello spazio di nomi degli Event Hubs.

Passaggi successivi

Per altre informazioni, consulta gli articoli seguenti.