Konfigurieren Sie die minimale TLS-Version für ein Event Grid-Thema oder eine Domäne

Azure Event Grid Basic-Ressourcen können für eingehende Client-Verbindungen eine Mindestversion von Transport Layer Security (TLS) benötigen. Die unterstützten Ressourcentypen sind benutzerdefinierte Themen, Domains und Partnernamensräume. Wenn ein Client eine Protokollversion unterhalb der konfigurierten Mindestversion verwendet, akzeptiert Event Grid die Anfrage nicht.

Die API-Version 2026-06-15-preview fügt folgendes Mindest-TLS-Verhalten für diese Event Grid Basic-Ressourcen hinzu:

  • Die Standard-Mindest-TLS-Version ist TLS 1.2.
  • TLS 1.0 und TLS 1.1 werden abgelehnt.
  • TLS 1.2 wird unterstützt.
  • TLS 1.3 kann als minimale TLS-Version ausgewählt werden.

TLS 1.3 ist die Mindestversion, wenn diese Option aktiviert ist. Bestehende Ressourcen sind nicht automatisch so konfiguriert, dass TLS 1.3 erforderlich ist, und TLS 1.3 ist nicht der Standard. Um TLS 1.3 zu erzwingen, konfigurieren Sie die Ressource explizit mit API-Version 2026-06-15-preview. Dieses API-versionsspezifische Verhalten legt die Standard- oder unterstützten Eigenschaftswerte für frühere API-Versionen nicht fest.

API-Version Standardmäßiges Mindest-TLS TLS 1.0 und TLS 1.1 TLS 1.2 Mindestens TLS 1.3
2026-06-15-preview TLS 1.2 Rejected Supported Als Opt-in-Einstellung unterstützt

Important

Bevor Sie TLS 1.3 als minimale TLS-Version konfigurieren, überprüfen Sie, ob jeder Client und Dienst, der sich mit der Event Grid-Ressource verbindet, TLS 1.3 unterstützt. Clients, die TLS 1.3 nicht unterstützen, können nicht mit einer Ressource kommunizieren, die TLS 1.3 benötigt.

Die minimale TLS-Einstellung auf Ressourcenebene gilt für eingehende Client-Verbindungen. Ein Web-Hook-Event-Abonnement hat eine separate Einstellung für die Auslieferung ausgehender Ereignisse. Weitere Informationen zur Durchsetzung auf Ressourcenebene finden Sie unter Erzwingen einer TLS-Mindestversion für Anforderungen an Event Grid Basic-Ressourcen.

Konfigurieren Sie die minimale TLS-Version für ein Topic oder eine Domain im Azure-Portal

Sie können die minimale TLS-Version angeben, wenn Sie ein Event Grid-Thema oder eine Domäne im Azure-Portal auf der Registerkarte Sicherheit erstellen. Die folgenden Screenshots beziehen sich auf ein Event Grid-Thema. Die Benutzeroberfläche zur Konfiguration dieser Eigenschaft für eine Domäne ist ähnlich.

Screenshot des Reiters „Themensicherheit erstellen“ mit der Mindest-TLS-Version auf Version 1.3 gesetzt.

Du kannst auch die minimale TLS-Version für ein bestehendes Thema auf der Konfigurationsseite angeben. Die Mindest-TLS-Versionsliste enthält TLS 1.3.

Screenshot einer bestehenden Event-Grid-Themen-Konfigurationsseite mit der Liste der Mindest-TLS-Versionen, die die Versionen 1.0 bis 1.3 zeigt.

TLS 1.3 für ein Topic mit einer Resource Manager-Vorlage erforderlich machen

Um TLS 1.3 für ein benutzerdefiniertes Topic zu erzwingen, verwenden Sie die API-Version 2026-06-15-preview und setzen Sie die minimumTlsVersionAllowed Eigenschaft auf 1.3. Das folgende Beispiel bezieht sich auf ein individuelles Thema. Es gilt nicht für Event Grid-Namensräume.

Die folgenden Schritte beschreiben, wie eine Vorlage im Azure-Portal erstellt wird.

  1. Klicken Sie im Azure-Portal auf Ressource erstellen.

  2. Geben Sie in Search the Marketplacebenutzerdefinierte Bereitstellung ein und drücken Sie dann Enter.

  3. Wählen Sie Benutzerdefinierte Bereitstellung (mit benutzerdefinierten Vorlagen bereitstellen) (Vorschau), wählen Sie Erstellen und dann Eigene Vorlage im Editor erstellen.

  4. Im Vorlageneditor fügen Sie das folgende JSON ein, um ein Topic zu erstellen, das TLS 1.3 benötigt. Ersetze den Standardwert des Parameters topic_name durch deinen Themennamen.

    {
    "$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. Speichern Sie die Vorlage.

  6. Gib die Bereitstellungswerte an und wähle dann Review + erstellen, um die Vorlage zu deployen.

Note

Nachdem du die minimale TLS-Version für ein Event Grid-Thema oder eine Domain aktualisiert hast, kann es bis zu 30 Sekunden dauern, bis die Änderung vollständig wirksam ist.

Konfigurieren Sie die minimale TLS-Version für ein Web-Hook-Event-Abonnement

Die Mindest-TLS-Einstellung für ein Web-Hook-Event-Abonnement steuert die ausgehende Auslieferung vom Event Grid zum Webhook. Es ist getrennt von der Mindest-TLS-Einstellung für eingehende Verbindungen zu einem Topic, einer Domain oder einem Partner-Namespace.

Wenn du ein Web-Hook-Event-Abonnement erstellst, kannst du es so konfigurieren, dass es dieselbe minimale TLS-Version wie das Topic verwendet oder dass du explizit die Mindestversion angibst.

Screenshot, der die Seite zeigt, um die minimale TLS-Version beim Erstellen eines Event-Abonnements für ein Event Grid-Thema einzustellen.

Für ein bestehendes Web-Hook-Event-Abonnement gehen Sie zur Seite Event Subscription und aktualisieren Sie die TLS-Einstellung im Reiter Additional Features . Standardmäßig verwendet das Event-Abonnement dieselbe minimale TLS-Version wie das Topic.

Nächster Schritt

Weitere Informationen finden Sie unter Erzwingen einer Mindestversion von TLS für Anforderungen an Event Grid Basic-Ressourcen.

  • Zuletzt aktualisiert um