Configureer de minimale TLS-versie voor een Event Grid-onderwerp of -domein

Azure Event Grid Basic-resources kunnen een minimale versie van Transport Layer Security (TLS) vereisen voor inkomende clientverbindingen. De ondersteunde resourcetypen zijn aangepaste onderwerpen, domeinen en partnernaamruimtes. Als een client een protocolversie onder het geconfigureerde minimum gebruikt, accepteert Event Grid het verzoek niet.

De API-versie 2026-06-15-preview voegt het volgende minimale TLS-gedrag toe voor deze Event Grid Basic-bronnen:

  • De standaard minimale TLS-versie is TLS 1.2.
  • TLS 1.0 en TLS 1.1 worden afgewezen.
  • TLS 1.2 wordt ondersteund.
  • TLS 1.3 kan worden geselecteerd als de minimale TLS-versie.

TLS 1.3 is een opt-in minimumversie. Bestaande bronnen zijn niet automatisch geconfigureerd om TLS 1.3 te vereisen, en TLS 1.3 is niet de standaard. Om TLS 1.3 te vereisen, configureer je de resource expliciet door gebruik te maken van de API-versie 2026-06-15-preview. Dit API-versiespecifieke gedrag stelt de standaard- of ondersteunde eigenschapswaarden voor eerdere API-versies niet vast.

API-versie Standaard minimaal TLS TLS 1.0 en TLS 1.1 TLS 1.2 TLS 1.3 als minimum
2026-06-15-preview TLS 1.2 Afgewezen Supported Ondersteund als opt-in instelling

Important

Voordat je TLS 1.3 als minimale TLS-versie configureert, controleer je of elke client en service die verbinding maakt met de Event Grid-resource TLS 1.3 ondersteunt. Clients die TLS 1.3 niet ondersteunen, kunnen niet communiceren met een resource die TLS 1.3 vereist.

De minimale TLS-instelling op resourceniveau geldt voor inkomende clientverbindingen. Een Web Hook-eventabonnement heeft een aparte instelling voor uitgaande gebeurtenislevering. Voor meer informatie over resource-level enforcement, zie Een minimale TLS-versie afdwingen voor aanvragen voor Event Grid Basic-resources.

Configureer de minimale TLS-versie voor een topic of domein in het Azure-portaal

Je kunt de minimale TLS-versie specificeren bij het aanmaken van een Event Grid-onderwerp of een domein in het Azure-portaal op het tabblad Beveiliging. De volgende screenshots zijn voor een Event Grid-onderwerp. De gebruikersinterface voor het configureren van deze eigenschap voor een domein is vergelijkbaar.

Screenshot van het tabblad Onderwerpbeveiliging aanmaken met de minimale TLS-versie ingesteld op versie 1.3.

Je kunt ook de minimale TLS-versie voor een bestaand onderwerp opgeven op de configuratiepagina . De minimale TLS-versielijst bevat TLS 1.3.

Screenshot van een bestaande Event Grid topic configuratiepagina met de lijst van minimale TLS-versies die versies 1.0 tot en met 1.3 toont.

Vereis TLS 1.3 voor een topic met behulp van een Resource Manager-sjabloon

Om TLS 1.3 voor een aangepaste topic te vereisen, gebruik je de API-versie 2026-06-15-preview en stel je de eigenschap minimumTlsVersionAllowed in op 1.3. Het volgende voorbeeld is voor een aangepast onderwerp. Het geldt niet voor Event Grid-namespaces.

In de volgende stappen wordt beschreven hoe u een sjabloon maakt in Azure Portal.

  1. Selecteer in de Azure-portal Een resource maken.

  2. Voer custom deployment in in Search the Marketplace en druk vervolgens op Enter.

  3. Selecteer Aangepaste implementatie (implementeren met aangepaste sjablonen) (preview), selecteer Aanmaken en selecteer vervolgens Je eigen sjabloon bouwen in de editor.

  4. In de template-editor plakt u de volgende JSON om een onderwerp te maken dat TLS 1.3 vereist. Vervang de standaardwaarde van de topic_name parameter door je onderwerpnaam.

    {
        "$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. Sla de sjabloon op.

  6. Specificeer de deploymentwaarden en selecteer vervolgens Review + create om de template te deployen.

Note

Nadat je de minimale TLS-versie voor een Event Grid-onderwerp of domein hebt bijgewerkt, kan het tot 30 seconden duren voordat de wijziging volledig is doorgevoerd.

Stel de minimale TLS-versie in voor een Web Hook event-abonnement

De minimale TLS-instelling voor een Web Hook event-abonnement regelt de uitgaande levering van Event Grid naar de webhook. Het staat los van de minimale TLS-instelling voor inkomende verbindingen naar een topic, domein of partnernaamruimte.

Wanneer je een Web Hook event-abonnement aanmaakt, kun je het zo instellen dat het dezelfde minimale TLS-versie gebruikt als het topic of expliciet de minimale versie specificeren.

Screenshot waarop de pagina wordt getoond om de minimale TLS-versie in te stellen bij het aanmaken van een eventabonnement op een Event Grid-onderwerp.

Voor een bestaand Web Hook-eventabonnement gaat u naar de pagina Event Subscription en werkt u de TLS-instelling bij op het tabblad Additional Features . Standaard gebruikt het evenementenabonnement dezelfde minimale TLS-versie als het onderwerp.

Volgende stap

Zie Een minimale TLS-versie afdwingen voor aanvragen naar Event Grid Basic-resources voor meer informatie.