Kräv en minsta TLS-version för förfrågningar till Event Grid Basic-resurser

Kommunikationen mellan en klient och en Azure Event Grid-resurs krypteras med hjälp av Transport Layer Security (TLS). För information om TLS, se Transport Layer Security.

För Event Grid Basic anpassade ämnen, domäner och partnernamnrymder kan du konfigurera den minsta TLS-versionen som accepteras för inkommande klientförfrågningar. Ett konfigurerat minimum av TLS 1.2 kräver att klienter använder TLS 1.2 eller en nyare protokollversion som tjänsten stödjer. Ett konfigurerat minimum av TLS 1.3 kräver att klienter använder TLS 1.3. Event Grid accepterar inte förfrågningar som använder en protokollversion under det konfigurerade minimumet.

API-versionen 2026-06-15-preview sätter minimiversionen TLS till TLS 1.2 som standard och avvisar TLS 1.0 och TLS 1.1. Med denna API-version kan du uttryckligen konfigurera TLS 1.3 som minimum. TLS 1.3 är inte standard, och befintliga resurser är inte automatiskt konfigurerade för att kräva TLS 1.3. Detta beteende är specifikt för API-versionen 2026-06-15-preview och fastställer inte beteendet för tidigare API-versioner.

Protokollstöd och förhandling vid tjänstslutpunkten skiljer sig från minimal framtvingande av TLS på resursnivå. En endpoint kan förhandla om ett protokoll som tjänsten stödjer, och Event Grid utvärderar sedan förfrågan mot resursens konfigurerade minimum TLS-version.

Important

Innan du konfigurerar TLS 1.3 som minsta TLS-version, kontrollera att varje klient och tjänst som ansluter till Event Grid-resursen stödjer TLS 1.3. Klienter som inte stödjer TLS 1.3 kan inte kommunicera med en resurs som kräver TLS 1.3.

Behörigheter för ämnen och domäner

För att sätta egenskapen minimumTlsVersionAllowed för ett Event Grid-ämne eller domän måste du ha behörighet att skapa och hantera resursen. roller för Azure-rollbaserad åtkomstkontroll (Azure RBAC) som tillhandahåller dessa behörigheter inkluderar åtgärden Microsoft.EventGrid/topics/write eller Microsoft.EventGrid/domains/write. Inbyggda roller med dessa åtgärder inkluderar:

Rolltilldelningar måste ha omfång till Event Grid-ämnet eller domänen, eller till en högre nivå, för att tillåta användaren att konfigurera sin minsta TLS-version. Mer information om rollomfånget finns i Förstå omfattningen för Azure RBAC.

Begränsa dessa rolltilldelningar till användare som behöver möjlighet att skapa ett Event Grid-ämne eller domän eller uppdatera dess egenskaper. Använd principen om minsta privilegium så att användarna bara har de behörigheter de behöver. Mer information finns i Metodtips för Azure RBAC.

Note

De klassiska prenumerationsadministratörsrollerna Tjänstadministratör och medadministratör innehåller motsvarigheten till rollen Azure Resource Manager-ägare. Ägarrollen inkluderar alla åtgärder, så en användare med en av dessa administrativa roller kan också skapa och hantera Event Grid-avsnitt eller domäner. Mer information finns i Azure-roller , Microsoft Entra-roller och klassiska prenumerationsadministratörsroller.

Nätverksöverväganden

När en klient skickar en förfrågan till ett Event Grid topic eller en domän, upprättar den först en anslutning till slutpunkten. Event Grid kontrollerar resursens minsta TLS-inställning när den behandlar förfrågan. Om förfrågan använder en protokollversion under det konfigurerade minimum, avvisar Event Grid förfrågan.

Tänk på följande:

  • En nätverksspårning kan visa framgångsrik TCP-anslutningsetablering och TLS-förhandling innan Event Grid avvisar en begäran som använder en protokollversion under det konfigurerade minimumet.
  • Slutpunktsskanning identifierar vilka protokoll som tjänstslutpunkten kan förhandla om. Den identifierar inte den lägsta TLS-versionen som konfigurerats för ett enskilt ämne, en domän eller ett partnernamnområde.

Webhook-leverans är separat

En Web Hook eventprenumeration har en separat minimiinställning för TLS för utgående händelseleverans från Event Grid till webhook. Resursnivåinställningen som beskrivs i denna artikel styr inkommande förfrågningar och definierar inte protokollet som Event Grid använder för att leverera händelser till en webhook.

Nästa steg

För att konfigurera inställningen, se Konfigurera minsta TLS-version för ett Event Grid-ämne eller domän.