Vergleichsbedingungen für Regeln

Eine Regel in Azure Front Door-Regelsätzen besteht aus 0 oder mehr Vergleichsbedingungen und einer Aktion. Dieser Artikel enthält detaillierte Beschreibungen der Übereinstimmungsbedingungen, die Sie in Azure Front Door-Regelsätzen verwenden können.

Wichtig

Azure Front Door (klassisch) wird am 31. März 2027 eingestellt. Um Dienstunterbrechungen zu vermeiden, ist es wichtig, dass Sie Ihre (klassischen) Azure Front Door-Profile bis März 2027 zur Dienstebene Azure Front Door Standard oder Premium migrieren. Weitere Informationen finden Sie unter Einstellung von Azure Front Door (klassisch).

Eine Regel in (klassischen) Azure Front Door-Regelmodulen besteht aus 0 oder mehr Vergleichsbedingungen und einer Aktion. Dieser Artikel enthält detaillierte Beschreibungen der Vergleichsbedingungen, die Sie in (klassischen) Azure Front Door-Regelmodulen verwenden können.

Der erste Teil einer Regel besteht aus einer Übereinstimmungsbedingung oder aus mehreren Übereinstimmungsbedingungen. Eine Regel kann aus bis zu 10 Übereinstimmungsbedingungen bestehen. Eine Übereinstimmungsbedingung gibt bestimmte Typen von Anforderungen an, für die definierte Aktionen ausgeführt werden. Wenn Sie mehrere Übereinstimmungsbedingungen verwenden, werden die Übereinstimmungsbedingungen mit UND-Logik gruppiert. Für alle Übereinstimmungsbedingungen, die mehrere Werte unterstützen, wird OR-Logik verwendet.

Sie können eine Übereinstimmungsbedingung für Folgendes verwenden:

  • Filtern von Anforderungen, die auf einer bestimmten IP-Adresse, einem bestimmten Port, einem bestimmten Land/einer bestimmten Region basieren.
  • Filtern von Anforderungen nach Headerinformationen
  • Filtern von Anforderungen von Mobil- oder Desktopgeräten.
  • Filtern von Anforderungen nach Anforderungsdateiname und Anforderungsdateierweiterung
  • Filtern Sie Anforderungen nach Hostname, SSL-Protokoll, Anforderungs-URL, Protokoll, Pfad, Abfragezeichenfolge, POST-Argumenten und anderen Werten.
  • Filtern von Anforderungen basierend auf bestimmten IP-Adressen oder Ländern bzw. Regionen.
  • Filtern von Anforderungen nach Headerinformationen
  • Filtern von Anforderungen von Mobil- oder Desktopgeräten.
  • Filtern von Anforderungen nach Anforderungsdateiname und Anforderungsdateierweiterung
  • Filtern Sie Anforderungen nach Anforderungs-URL, Protokoll, Pfad, Abfragezeichenfolge, POST-Argumenten und anderen Werten.

Gerätetyp

Verwenden Sie die Vergleichsbedingung Gerätetyp, um Anforderungen zu identifizieren, die von einem mobilen oder einem Desktop-Gerät gestellt wurden.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber
  • Im Azure Portal: Equal, Not Equal
  • In ARM-Vorlagen: Equal; verwenden Sie die negateCondition-Eigenschaft, um Nicht Gleich anzugeben.
Wert Mobile, Desktop

Beispiel

In diesem Beispiel wird eine Übereinstimmung mit allen Anforderungen erzielt, für die als Ursprung ein mobiles Gerät erkannt wurde.

Screenshot des Portals mit der Art der Übereinstimmungsbedingung

HTTP-Version

Verwenden Sie die Vergleichsbedingung HTTP-Version, um Anforderungen zu identifizieren, die mit einer bestimmten Version des HTTP-Protokolls erstellt wurden.

Hinweis

Die Vergleichsbedingung HTTP-Version ist nur in Azure Front Door Standard/Premium verfügbar.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber
  • Im Azure Portal: Equal, Not Equal
  • In ARM-Vorlagen: Equal; verwenden Sie die negateCondition-Eigenschaft, um Nicht Gleich anzugeben.
Wert 2.0, 1.1, 1.0, 0.9

Beispiel

In diesem Beispiel wird eine Übereinstimmung mit allen Anforderungen erzielt, die mit dem HTTP 2.0-Protokoll gesendet wurden.

Screenshot des Portals mit Übereinstimmungsbedingung für die HTTP-Version.

Anforderungscookies

Verwenden Sie die Vergleichsbedingung Anforderungscookies, um Anforderungen zu identifizieren, die ein bestimmtes Cookie enthalten.

Hinweis

Die Übereinstimmungsbedingung Anforderungscookies ist nur für die Azure Front Door Standard/Premium verfügbar.

Eigenschaften

Eigenschaft Unterstützte Werte
Cookiename Ein Zeichenfolgewert, der den Namen des Cookies darstellt.
Betreiber Beliebiger Operator aus der Standardoperator-Liste.
Wert Mindestens ein Zeichenfolgenwert oder ganzzahliger Wert, der den Wert des abzugleichenden Anforderungsheaders darstellt. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.
Umwandlung der Groß-/Kleinschreibung Jede Transformation aus der Standardliste für Zeichenfolgentransformationen.

Beispiel

In diesem Beispiel wird eine Übereinstimmung mit allen Anforderungen erzielt, die ein Cookie namens deploymentStampId mit dem Wert 1 enthalten.

Screenshot des Portals mit Übereinstimmungsbedingung der Anforderungs-Cookies.

Post args

Verwenden Sie die Übereinstimmungsbedingung Post args, um Anforderungen auf Grundlage der Argumente im Text einer POST-Anforderung zu identifizieren. Eine einzelne Übereinstimmungsbedingung entspricht einem einzelnen Argument aus dem Text der POST-Anforderung. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Hinweis

Die Übereinstimmungsbedingung Post args funktioniert mit dem application/x-www-form-urlencoded-Inhaltstyp.

Eigenschaften

Eigenschaft Unterstützte Werte
Post args Ein Zeichenfolgenwert, der den Namen des POST-Arguments darstellt.
Betreiber Beliebiger Operator aus der Standardoperator-Liste.
Wert Mindestens ein Zeichenfolgenwert oder ganzzahliger Wert, der den Wert des zu abgleichenden Post-Arguments darstellt. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.
Umwandlung der Groß-/Kleinschreibung Jede Transformation aus der Standardliste für Zeichenfolgentransformationen.

Beispiel

In diesem Beispiel stimmen wir alle Post-Anforderungen ab, bei denen ein customerName-Argument im Anforderungstext bereitgestellt wird und der Wert von customerName mit dem Buchstaben J oderKbeginnt. Wir verwenden eine Falltransformation, um die Eingabewerte in Großbuchstaben zu konvertieren, sodass Werte übereinstimmen, die mit J, j, K und k beginnen.

Screenshot des Portals mit der Übereinstimmungsbedingung „post args“.

Abfragezeichenfolge

Verwenden Sie die Übereinstimmungsbedingung Abfragezeichenfolge zum Identifizieren von Anforderungen, die eine bestimmte Abfragezeichenfolge enthalten. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Hinweis

Die gesamte Abfragezeichenfolge wird mit einer einzelnen Zeichenfolge ohne den führenden ? abgeglichen.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber Alle Operatoren aus der Liste der Standardoperatoren werden unterstützt. Die Vergleichsbedingung Any gleicht jede Anforderung ab, und die Vergleichsbedingung Not Any gleicht keine Anforderungen ab, wenn sie mit der Vergleichsbedingung query string verwendet wird.
Abfragezeichenfolge Mindestens ein Zeichenfolgenwert oder ganzzahliger Wert, der den Wert der abzugleichenden Abfragezeichenfolge darstellt. Die ? nicht am Anfang der Abfragezeichenfolge einbeziehen. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.
Umwandlung der Groß-/Kleinschreibung Jede Transformation aus der Standardliste für Zeichenfolgentransformationen.

Beispiel

In diesem Beispiel stimmen wir mit allen Anforderungen ab, bei denen die Abfrage Zeichenfolge die Zeichenfolge language=en-US enthält. Wir möchten, dass die Übereinstimmungsbedingung die Groß-/Kleinschreibung beachtet, also transformieren wir den Fall nicht.

Screenshot des Portals mit der Übereinstimmungsbedingung der Abfragezeichenfolge.

Remoteadresse

Die Übereinstimmungsbedingung für die Remoteadresse identifiziert Anforderungen anhand des Standorts oder anhand der IP-Adresse des Anfordernden. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

  • Verwenden Sie CIDR-Notation, wenn Sie IP-Adressblöcke angeben. Die Syntax für einen IP-Adressblock besteht aus der IP-Basisadresse, gefolgt von einem Schrägstrich und der Präfixgröße. Beispiel:
    • IPv4-Beispiel:5.5.5.64/26 entspricht allen Anforderungen, die von den Adressen 5.5.5.64 bis 5.5.5.127 eingehen.
    • IPv6-Beispiel: Die Angabe 1:2:3:/48 führt zur Übereinstimmung mit eingehenden Anforderungen von den Adressen 1:2:3:0:0:0:0:0 bis 1:2:3: ffff:ffff:ffff:ffff:ffff.
  • Bei mehreren IP-Adressen und IP-Adressblöcken wird die OR-Logik verwendet.
    • IPv4-Beispiel: Wenn Sie die beiden IP-Adressen 1.2.3.4 und 10.20.30.40 hinzufügen, ist die Bedingung erfüllt, wenn Anforderungen von der Adresse 1.2.3.4 oder 10.20.30.40 eintreffen.
    • IPv6-Beispiel: Wenn Sie die beiden IP-Adressen 1:2:3:4:5:6:7:8 und 10:20:30:40:50:60:70:80 hinzufügen, ist die Bedingung bei allen Anforderungen von den Adressen 1:2:3:4:5:6:7:8 und 10:20:30:40:50:60:70:80 erfüllt.
  • Die Remoteadresse stellt die ursprüngliche Client-IP dar, die entweder aus der Netzwerkverbindung oder typischerweise aus dem X-Forwarded-For Anforderungsheader stammt, wenn sich der Benutzer hinter einem Proxy befindet. Verwenden Sie die Vergleichsbedingung Socketadresse (verfügbar in Standard/Premium), wenn Sie eine Übereinstimmung basierend auf der IP-Adresse der TCP-Anforderung benötigen.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber
  • Im Azure Portal: Geo Match, Geo Not Match, IP Match, oder IP Not Match
  • In ARM-Vorlagen: GeoMatch, IPMatch ; verwenden Sie die negateCondition -Eigenschaft, um die Geo Not Match oder IP Not Match anzugeben.
Wert
  • Für die IP Match- oder IP Not Match-Operatoren oder: Geben Sie einen oder mehrere IP-Adressbereich(e) an. Wenn mehrere IP-Adressbereiche angegeben werden, werden Sie mit der OR-Logik ausgewertet.
  • Für den Geo Match- oder Geo Not Match-Operator: Geben Sie einen oder mehrere Speicherorte mithilfe Ihres Ländercodes an.

Beispiel

In diesem Beispiel wird eine Übereinstimmung mit allen Anforderungen erzielt, die nicht aus den USA stammen.

Screenshot des Portals mit der Übereinstimmungsbedingung einer Remote-Adresse.

Anforderungstext

Der Anforderungstext identifiziert Anforderungen auf der Grundlage eines bestimmten Texts, der im Textkörper der Anforderung vorhanden ist. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Hinweis

Wenn ein Anforderungstext die Größe von 64 KB überschreitet, werden nur die ersten 64 KB für die Übereinstimmungsbedingung des Anforderungstexts berücksichtigt.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber Alle Operatoren aus der Liste der Standardoperatoren werden unterstützt. Die Vergleichsbedingung Any gleicht jede Anforderung ab, und die Vergleichsbedingung Not Any gleicht keine Anforderungen ab, wenn sie mit der Vergleichsbedingung request body verwendet wird.
Wert Mindestens ein Zeichenfolgenwert oder ganzzahliger Wert, der den Wert des abzugleichenden Anforderungstexts darstellt. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.
Umwandlung der Groß-/Kleinschreibung Jede Transformation aus der Standardliste für Zeichenfolgentransformationen.

Beispiel

In diesem Beispiel stimmen wir alle Anforderungen ab, bei denen der Anforderungstext die ERROR-Zeichenfolge enthält. Sie wandeln den Anforderungstext vor dem Auswerten des Vergleichs in Großbuchstaben um, damit auch error und andere Varianten bei der Groß- und Kleinschreibung diese Vergleichsbedingung auslösen.

Screenshot des Portals mit Übereinstimmungsbedingung des Anforderungstexts.

Dateiname der Anforderung

Die Übereinstimmungsbedingung Dateiname der Anforderung identifiziert Anforderungen, die den angegebenen Dateinamen in der Anforderungs-URL enthalten. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber Alle Operatoren aus der Liste der Standardoperatoren werden unterstützt. Die Vergleichsbedingung Any gleicht jede Anforderung ab, und die Vergleichsbedingung Not Any gleicht keine Anforderungen ab, wenn sie mit der Vergleichsbedingung request file name verwendet wird.
Wert Mindestens ein Zeichenfolgenwert oder ganzzahliger Wert, der den Wert des abzugleichenden Dateinamen der Anforderung darstellt. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.
Umwandlung der Groß-/Kleinschreibung Jede Transformation aus der Standardliste für Zeichenfolgentransformationen.

Beispiel

In diesem Beispiel stimmen wir alle Anforderungen ab, bei denen der Name der Anforderungsdatei media.mp4 ist. Sie wandeln den Dateinamen vor dem Auswerten der Entsprechung in Kleinbuchstaben um, damit auch MEDIA.MP4 und andere Varianten bei der Groß- und Kleinschreibung diese Vergleichsbedingung auslösen.

Screenshot des Portals mit Übereinstimmungsbedingung des Anforderungsdateinamens.

Dateierweiterung der Anforderung

Die Übereinstimmungsbedingung Dateierweiterung der Anforderung identifiziert Anforderungen, die die angegebenen Dateierweiterungen in der Anforderungs-URL enthalten. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Hinweis

Schließen Sie keinen führenden Zeitraum ein. Verwenden Sie z. B. html statt .html.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber Alle Operatoren aus der Liste der Standardoperatoren werden unterstützt. Die Vergleichsbedingung Any gleicht jede Anforderung ab, und die Vergleichsbedingung Not Any gleicht keine Anforderungen ab, wenn sie mit der Vergleichsbedingung request file extension verwendet wird.
Wert Mindestens ein Zeichenfolgenwert oder ganzzahliger Wert, der den Wert der abzugleichenden Dateierweiterung der Anforderung darstellt. Schließen Sie keinen führenden Zeitraum ein. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.
Umwandlung der Groß-/Kleinschreibung Jede Transformation aus der Standardliste für Zeichenfolgentransformationen.

Beispiel

In diesem Beispiel stimmen wir alle Anforderungen ab, bei denen die Erweiterung der Anforderungsdatei pdf oder docx ist. Sie wandeln die Erweiterung der Anforderungsdatei vor dem Auswerten der Entsprechung in Kleinbuchstaben um, damit auch PDF, DocX und andere Varianten bei der Groß- und Kleinschreibung diese Vergleichsbedingung auslösen.

Screenshot des Portals mit Übereinstimmungsbedingung der Anforderungsdateierweiterung.

Anforderungsheader

Mit der Übereinstimmungsbedingung für den Anforderungsheader werden Anforderungen identifiziert, die einen bestimmten Header in der Anforderung enthalten. Mit dieser Vergleichsbedingung können Sie überprüfen, ob ein Header vorhanden ist, oder ob der Header mit einem angegebenen Wert übereinstimmt. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Eigenschaften

Eigenschaft Unterstützte Werte
Headername Ein Zeichenfolgenwert, der den Namen des POST-Arguments darstellt.
Betreiber Beliebiger Operator aus der Standardoperator-Liste.
Wert Mindestens ein Zeichenfolgenwert oder ganzzahliger Wert, der den Wert des abzugleichenden Anforderungsheaders darstellt. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.
Umwandlung der Groß-/Kleinschreibung Jede Transformation aus der Standardliste für Zeichenfolgentransformationen.

Beispiel

In diesem Beispiel stimmen wir allen Anforderungen zu, bei denen die Anforderung einen Header mit dem Namen MyCustomHeader enthält, unabhängig von dessen Wert.

Screenshot des Portals mit Übereinstimmungsbedingung des Anforderungsheaders.

Anforderungsmethode

Die Übereinstimmungsbedingung der Anforderungsmethode identifiziert Anforderungen, die die angegebene HTTP-Anforderungsmethode verwenden. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber
  • Im Azure Portal: Equal, Not Equal
  • In ARM-Vorlagen: Equal; verwenden Sie die negateCondition-Eigenschaft, um Nicht Gleich anzugeben.
Anforderungsmethode Mindestens eine HTTP-Methode aus: GET, POST, PUT, DELETE, HEAD, OPTIONS, TRACE. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.

Beispiel

In diesem Beispiel stimmen wir alle Anforderungen ab, die die Anforderungsmethode DELETE nutzt.

Screenshot des Portals mit Übereinstimmungsbedingung der Anforderungsmethode.

Anforderungspfad

Die Übereinstimmungsbedingung Anforderungspfad identifiziert Anforderungen, die den angegebenen Pfad in der Anforderungs-URL enthalten. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Hinweis

Der Pfad ist der Teil der URL nach dem Hostnamen und einem Schrägstrich. In der URL https://www.contoso.com/files/secure/file1.pdf lautet der Pfad z. B. files/secure/file1.pdf.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber
  • Alle Operatoren aus der Liste der Standardoperatoren werden unterstützt. Die Vergleichsbedingung Any gleicht jede Anforderung ab, und die Vergleichsbedingung Not Any gleicht keine Anforderungen ab, wenn sie mit der Vergleichsbedingung request path verwendet wird.
  • Platzhalter: Für einen Treffer muss der Anforderungspfad mit einem Platzhalterausdruck übereinstimmen. Ein Platzhalterausdruck mit dem Zeichen * entspricht null oder mehr Zeichen innerhalb des Pfads. Der Platzhalterausdruck files/customer*/file.pdf entspricht z. B. den Pfaden files/customer1/file.pdf, files/customer109/file.pdf und files/customer/file.pdf, aber nicht files/customer2/anotherfile.pdf.
    • Im Azure Portal: Wildcards, Not Wildcards
    • In ARM-Vorlagen: Wildcard. Verwenden Sie die negateCondition-Eigenschaft, um anzugeben, dass die Werte nicht den Platzhalterzeichen entsprechen dürfen.
Wert Mindestens ein Zeichenfolgenwert oder ganzzahliger Wert, der den Wert des abzugleichenden Anforderungspfades darstellt. Wenn Sie einen vorangestellten Schrägstrich angeben, wird dieser ignoriert. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.
Umwandlung der Groß-/Kleinschreibung Jede Transformation aus der Standardliste für Zeichenfolgentransformationen.
Eigenschaft Unterstützte Werte
Betreiber Alle Operatoren aus der Liste der Standardoperatoren werden unterstützt. Die Vergleichsbedingung Any gleicht jede Anforderung ab, und die Vergleichsbedingung Not Any gleicht keine Anforderungen ab, wenn sie mit der Vergleichsbedingung request path verwendet wird.
Wert Mindestens ein Zeichenfolgenwert oder ganzzahliger Wert, der den Wert des abzugleichenden Anforderungspfades darstellt. Wenn Sie einen vorangestellten Schrägstrich angeben, wird dieser ignoriert. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.
Umwandlung der Groß-/Kleinschreibung Jede Transformation aus der Standardliste für Zeichenfolgentransformationen.

Beispiel

In diesem Beispiel stimmen wir alle Anforderungen ab, bei denen der Pfad der Anforderungsdatei mit files/secure/ beginnt. Sie wandeln die Erweiterung der Anforderungsdatei vor dem Auswerten der Entsprechung in Kleinbuchstaben um, damit auch Anforderungen an files/SECURE/ und andere Varianten bei der Groß- und Kleinschreibung diese Vergleichsbedingung auslösen.

Screenshot des Portals mit Übereinstimmungsbedingung des Anforderungspfades.

Anforderungsprotokoll

Mit der Übereinstimmungsbedingung Anforderungsprotokoll werden Anforderungen identifiziert, die das angegebene Protokoll (HTTP oder HTTPS) verwenden.

Hinweis

Das Protokoll wird manchmal auch als Schema bezeichnet.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber
  • Im Azure Portal: Equal, Not Equal
  • In ARM-Vorlagen: Equal; verwenden Sie die negateCondition-Eigenschaft, um Nicht Gleich anzugeben.
Anforderungsmethode HTTP, HTTPS

Beispiel

In diesem Beispiel stimmen wir alle Anforderungen ab, die das Anforderungsprotokoll HTTP nutzen.

Screenshot des Portals mit Übereinstimmungsbedingung des Anforderungsprotokolls.

Anfrage-URL

Identifiziert Anforderungen, die mit der angegebenen URL übereinstimmen. Die gesamte URL wird ausgewertet, einschließlich des Protokolls und der Abfragezeichenfolge, jedoch nicht des Fragments. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Tipp

Wenn Sie diese Regelbedingung verwenden, müssen Sie das Protokoll und einen nachgestellten Schrägstrich / einschließen. Verwenden Sie beispielsweise https://www.contoso.com/ anstelle von nur www.contoso.com.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber Alle Operatoren aus der Liste der Standardoperatoren werden unterstützt. Die Vergleichsbedingung Any gleicht jede Anforderung ab, und die Vergleichsbedingung Not Any gleicht keine Anforderungen ab, wenn sie mit der Vergleichsbedingung request URL verwendet wird.
Wert Mindestens ein Zeichenfolgenwert oder ganzzahliger Wert, der den Wert der abzugleichenden Anforderungs-URL darstellt. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.
Umwandlung der Groß-/Kleinschreibung Jede Transformation aus der Standardliste für Zeichenfolgentransformationen.

Beispiel

In diesem Beispiel stimmen wir alle Anforderungen ab, bei denen die URL der Anforderung mit https://api.contoso.com/customers/123 beginnt. Wir transformieren die Dateierweiterung der Anforderung vor dem Auswerten der Entsprechung in Kleinbuchstaben, sodass Anforderungen an https://api.contoso.com/Customers/123 und andere Fallvariationen diese Übereinstimmungsbedingung ebenfalls auslöst.

Screenshot des Portals mit Übereinstimmungsbedingung der Anforderungs-URL.

Hostname

Die Vergleichsbedingung Hostnamen identifiziert Anforderungen basierend auf dem angegebenen Hostnamen in der Anforderung vom Client. Die Vergleichsbedingung verwendet den Host-Headerwert zum Auswerten des Hostnamens. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber Alle Operatoren aus der Liste der Standardoperatoren werden unterstützt. Die Vergleichsbedingung Any gleicht jede Anforderung ab, und die Vergleichsbedingung Not Any gleicht keine Anforderungen ab, wenn sie mit der Vergleichsbedingung host name verwendet wird.
Wert Mindestens ein Zeichenfolgenwert, der den Wert des abzugleichenden Anforderungshostnamens darstellt. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.
Umwandlung der Groß-/Kleinschreibung Jede Umwandlung der Groß-/Kleinschreibung aus der Standardliste für Zeichenfolgentransformationen.

Beispiel

In diesem Beispiel werden alle Anforderungen mit einem Host-Header abgeglichen, der mit contoso.com endet.

Screenshot des Portals mit Übereinstimmungsbedingung für Hostnamen.

SSL-Protokoll

Die Vergleichsbedingung SSL-Protokoll identifiziert Anforderungen basierend auf dem SSL-Protokoll einer hergestellten TLS-Verbindung. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber
  • Im Azure Portal: Equal, Not Equal
  • In ARM-Vorlagen: Equal; verwenden Sie die negateCondition-Eigenschaft, um Nicht Gleich anzugeben.
SSL-Protokoll
  • Im Azure-Portal: 1.0, 1.1, 1.2
  • In ARM-Vorlagen: TLSv1, TLSv1.1, TLSv1.2

Beispiel

In diesem Beispiel werden alle Anforderungen, die das TLS 1.2-Protokoll verwenden, abgeglichen.

Screenshot des Portals mit Übereinstimmungsbedingung für das SSL-Protokoll.

Socketadresse

Die Vergleichsbedingung Socketadresse identifiziert Anforderungen basierend auf der IP-Adresse der direkten Verbindung mit dem Azure Front Door-Edge. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Hinweis

Wenn der Client einen HTTP-Proxy oder ein Lastenausgleichsmodul zum Senden der Anforderung verwendet hat, ist die Socketadresse die IP-Adresse des Proxys oder Lastenausgleichsmoduls.

Verwenden Sie die Vergleichsbedingung Remoteadresse, wenn Sie Übereinstimmungen basierend auf der ursprünglichen IP-Adresse des Clients suchen.

  • Verwenden Sie CIDR-Notation, wenn Sie IP-Adressblöcke angeben. Das heißt, die Syntax für einen IP-Adressblock besteht aus der IP-Basisadresse, gefolgt von einem Schrägstrich und der Präfixgröße. Beispiel:
    • IPv4-Beispiel:5.5.5.64/26 entspricht allen Anforderungen, die von den Adressen 5.5.5.64 bis 5.5.5.127 eingehen.
    • IPv6-Beispiel: Die Angabe 1:2:3:/48 führt zur Übereinstimmung mit eingehenden Anforderungen von den Adressen 1:2:3:0:0:0:0:0 bis 1:2:3: ffff:ffff:ffff:ffff:ffff.
  • Bei mehreren IP-Adressen und IP-Adressblöcken wird die OR-Logik verwendet.
    • IPv4-Beispiel: Wenn Sie die beiden IP-Adressen 1.2.3.4 und 10.20.30.40 hinzufügen, ist die Bedingung erfüllt, wenn Anforderungen von der Adresse 1.2.3.4 oder 10.20.30.40 eintreffen.
    • IPv6-Beispiel: Wenn Sie die beiden IP-Adressen 1:2:3:4:5:6:7:8 und 10:20:30:40:50:60:70:80 hinzufügen, ist die Bedingung bei allen Anforderungen von den Adressen 1:2:3:4:5:6:7:8 und 10:20:30:40:50:60:70:80 erfüllt.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber
  • Im Azure Portal: IP Match, Not IP Match
  • In ARM-Vorlagen: IPMatch; Verwenden Sie die negateCondition-Eigenschaft, um Keine IP-Übereinstimmung anzugeben.
Wert Geben Sie einen oder mehrere IP-Adressbereiche an. Wenn mehrere IP-Adressbereiche angegeben werden, werden Sie mit der OR-Logik ausgewertet.

Beispiel

In diesem Beispiel werden alle Anforderungen von IP-Adressen im Bereich 5.5.5.64/26 abgeglichen.

Screenshot des Portals mit Übereinstimmungsbedingung einer Socket-Adresse.

Clientport

Die Vergleichsbedingung Clientport identifiziert Anforderungen basierend auf dem TCP-Port des Clients, der die Anforderung gesendet hat. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber Alle Operatoren aus der Liste der Standardoperatoren werden unterstützt. Die Vergleichsbedingung Any gleicht jede Anforderung ab, und die Vergleichsbedingung Not Any gleicht keine Anforderungen ab, wenn sie mit der Vergleichsbedingung client port verwendet wird.
Wert Eine oder mehrere Portnummern, ausgedrückt als ganze Zahlen. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.

Beispiel

In diesem Beispiel werden alle Anforderungen mit einem Clientport 1234 abgeglichen.

Screenshot des Portals mit Übereinstimmungsbedingung für den Client-Port.

Serverport

Die Vergleichsbedingung Serverport identifiziert Anforderungen basierend auf dem TCP-Port des Azure Front Door-Servers, der die Anforderung akzeptiert hat. Der Port muss 80 oder 443 sein. Sie können mehrere Werte angeben, die mit der OR-Logik kombiniert werden können.

Eigenschaften

Eigenschaft Unterstützte Werte
Betreiber Alle Operatoren aus der Liste der Standardoperatoren werden unterstützt. Die Vergleichsbedingung Any gleicht jede Anforderung ab, und die Vergleichsbedingung Not Any gleicht keine Anforderungen ab, wenn sie mit der Vergleichsbedingung server port verwendet wird.
Wert Eine Portnummer, die entweder 80 oder 443 sein muss. Wenn mehrere Werte angegeben werden, werden Sie mit der OR-Logik ausgewertet.

Beispiel

In diesem Beispiel werden alle Anforderungen mit dem Serverport 443 abgeglichen.

Screenshot des Portals mit Übereinstimmungsbedingung für den Server-Port.

Operatorliste

Für Regeln, die Werte aus der Liste der Standardoperatoren akzeptieren, sind die folgenden Operatoren gültig:

Operator BESCHREIBUNG ARM-Vorlagen-Support
Any Ergibt eine Übereinstimmung, wenn ein beliebiger Wert vorhanden ist, unabhängig davon, worum es sich dabei handelt. operator: Any
Equal Ergibt ein Match, wenn der Wert exakt mit der angegebenen Zeichenfolge übereinstimmt. operator: Equal
Enthält Ergibt ein Match, wenn der Wert die angegebene Zeichenfolge enthält. operator: Contains
Kleiner als Ergibt ein Match, wenn die Länge des Werts kleiner als die angegebene Ganzzahl ist. operator: LessThan
Größer als Ergibt ein Match, wenn die Länge des Werts größer als die angegebene Ganzzahl ist. operator: GreaterThan
Kleiner als oder gleich Ergibt ein Match, wenn die Länge des Werts kleiner als oder gleich der angegebenen Ganzzahl ist. operator: LessThanOrEqual
Größer als oder gleich Ergibt ein Match, wenn die Länge des Werts größer als oder gleich der angegebenen Ganzzahl ist. operator: GreaterThanOrEqual
Beginnt mit Ergibt ein Match, wenn der Wert mit der angegebenen Zeichenfolge beginnt. operator: BeginsWith
Endet mit Ergibt ein Match, wenn der Wert mit der angegebenen Zeichenfolge endet. operator: EndsWith
Keine Ergibt eine Übereinstimmung, wenn kein Wert vorhanden ist. operator: Any und negateCondition : true
Ungleich Ergibt eine Übereinstimmung, wenn der Wert nicht mit der angegebenen Zeichenfolge übereinstimmt. operator: Equal und negateCondition : true
Not Contains Ergibt eine Übereinstimmung, wenn der Wert nicht die angegebene Zeichenfolge enthält. operator: Contains und negateCondition : true
Nicht kleiner als Ergibt eine Übereinstimmung, wenn die Länge des Werts nicht kleiner als die angegebene Ganzzahl ist. operator: LessThan und negateCondition : true
Nicht größer als Ergibt eine Übereinstimmung, wenn die Länge des Werts nicht größer als die angegebene Ganzzahl ist. operator: GreaterThan und negateCondition : true
Nicht kleiner als oder gleich Ergibt eine Übereinstimmung, wenn die Länge des Werts nicht kleiner als oder gleich der angegebenen Ganzzahl ist. operator: LessThanOrEqual und negateCondition : true
Nicht größer als oder gleich Ergibt eine Übereinstimmung, wenn die Länge des Werts nicht größer als oder gleich der angegebenen Ganzzahl ist. operator: GreaterThanOrEqual und negateCondition : true
Beginnt nicht mit Ergibt eine Übereinstimmung, wenn der Wert nicht mit der angegebenen Zeichenfolge beginnt. operator: BeginsWith und negateCondition : true
Endet nicht mit Ergibt eine Übereinstimmung, wenn der Wert nicht mit der angegebenen Zeichenfolge endet. operator: EndsWith und negateCondition : true
Operator BESCHREIBUNG ARM-Vorlagen-Support
Any Ergibt eine Übereinstimmung, wenn ein beliebiger Wert vorhanden ist, unabhängig davon, worum es sich dabei handelt. operator: Any
Equal Ergibt ein Match, wenn der Wert exakt mit der angegebenen Zeichenfolge übereinstimmt. operator: Equal
Enthält Ergibt ein Match, wenn der Wert die angegebene Zeichenfolge enthält. operator: Contains
Kleiner als Ergibt ein Match, wenn die Länge des Werts kleiner als die angegebene Ganzzahl ist. operator: LessThan
Größer als Ergibt ein Match, wenn die Länge des Werts größer als die angegebene Ganzzahl ist. operator: GreaterThan
Kleiner als oder gleich Ergibt ein Match, wenn die Länge des Werts kleiner als oder gleich der angegebenen Ganzzahl ist. operator: LessThanOrEqual
Größer als oder gleich Ergibt ein Match, wenn die Länge des Werts größer als oder gleich der angegebenen Ganzzahl ist. operator: GreaterThanOrEqual
Beginnt mit Ergibt ein Match, wenn der Wert mit der angegebenen Zeichenfolge beginnt. operator: BeginsWith
Endet mit Ergibt ein Match, wenn der Wert mit der angegebenen Zeichenfolge endet. operator: EndsWith
RegEx Ergibt ein Match, wenn der Wert dem angegebenen regulären Ausdruck entspricht. Weitere Informationen finden Sie weiter unten. operator: RegEx
Keine Ergibt eine Übereinstimmung, wenn kein Wert vorhanden ist. operator: Any und negateCondition : true
Ungleich Ergibt eine Übereinstimmung, wenn der Wert nicht mit der angegebenen Zeichenfolge übereinstimmt. operator: Equal und negateCondition : true
Not Contains Ergibt eine Übereinstimmung, wenn der Wert nicht die angegebene Zeichenfolge enthält. operator: Contains und negateCondition : true
Nicht kleiner als Ergibt eine Übereinstimmung, wenn die Länge des Werts nicht kleiner als die angegebene Ganzzahl ist. operator: LessThan und negateCondition : true
Nicht größer als Ergibt eine Übereinstimmung, wenn die Länge des Werts nicht größer als die angegebene Ganzzahl ist. operator: GreaterThan und negateCondition : true
Nicht kleiner als oder gleich Ergibt eine Übereinstimmung, wenn die Länge des Werts nicht kleiner als oder gleich der angegebenen Ganzzahl ist. operator: LessThanOrEqual und negateCondition : true
Nicht größer als oder gleich Ergibt eine Übereinstimmung, wenn die Länge des Werts nicht größer als oder gleich der angegebenen Ganzzahl ist. operator: GreaterThanOrEqual und negateCondition : true
Beginnt nicht mit Ergibt eine Übereinstimmung, wenn der Wert nicht mit der angegebenen Zeichenfolge beginnt. operator: BeginsWith und negateCondition : true
Endet nicht mit Ergibt eine Übereinstimmung, wenn der Wert nicht mit der angegebenen Zeichenfolge endet. operator: EndsWith und negateCondition : true
Nicht RegEx Ergibt eine Übereinstimmung, wenn der Wert nicht dem angegebenen regulären Ausdruck entspricht. Weitere Informationen finden Sie weiter unten. operator: RegEx und negateCondition : true

Tipp

Für numerische Operatoren wie Kleiner als oder Größer als oder gleich basiert der verwendete Vergleich auf der Länge. Der Wert in der Übereinstimmungsbedingung muss eine ganze Zahl sein, die die Länge bestimmt, die Sie vergleichen möchten.

Reguläre Ausdrücke

Reguläre Ausdrücke unterstützen die folgenden Vorgänge nicht:

  • Rückverweise und Erfassung von Teilausdrücken.
  • Willkürliche Assertionen mit einer Nullbreite.
  • Unterroutinenverweise und rekursive Muster.
  • Bedingte Muster.
  • Rückverfolgung von Steuerelementverben.
  • Die \C Einzelbyte-Anweisung – „\C“.
  • Die \R Anweisung für Zeilenvorschubübereinstimmung – „\R“.
  • Die \K Startanweisung zum Zurücksetzen der Übereinstimmung – „\K“.
  • Callouts und eingebetteter Code.
  • Atomische Gruppierung und besitzanzeigende Quantifizierer.

Zeichenfolgentransformationsliste

Für Regeln, die Zeichenfolgen transformieren können, sind folgende Transformationen gültig:

Transformieren BESCHREIBUNG ARM-Vorlagen-Support
In Kleinbuchstaben Konvertiert die Zeichenfolge in eine Darstellung mit Kleinbuchstaben. Lowercase
In Großbuchstaben Konvertiert die Zeichenfolge in eine Darstellung mit Großbuchstaben. Uppercase
Glätten Entfernt führende und nachfolgende Leerzeichen aus der Zeichenfolge. Trim
NULL-Werte entfernen Entfernt NULL-Werte aus der Zeichenfolge. RemoveNulls
URL-Codierung URL-Codierung für die Zeichenfolge. UrlEncode
URL-Decodierung URL-Decodierung für die Zeichenfolge. UrlDecode

Nächste Schritte

  • Weitere Informationen zum Regelmodul für Azure Front Door (klassisch)
  • Erfahren Sie, wie Sie Ihr erstes Regelmodul konfigurieren.
  • Hier finden Sie weitere Informationen zu Regelaktionen.