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 |
|
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.
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 |
|
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.
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.
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
oderK
beginnt. Wir verwenden eine Falltransformation, um die Eingabewerte in Großbuchstaben zu konvertieren, sodass Werte übereinstimmen, die mit J
, j
, K
und k
beginnen.
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.
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.
- IPv4-Beispiel:
- 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
und10.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
und10: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.
- IPv4-Beispiel: Wenn Sie die beiden IP-Adressen
- 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 |
|
Wert |
|
Beispiel
In diesem Beispiel wird eine Übereinstimmung mit allen Anforderungen erzielt, die nicht aus den USA stammen.
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.
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.
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.
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.
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 |
|
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.
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 |
|
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.
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 |
|
Anforderungsmethode | HTTP , HTTPS |
Beispiel
In diesem Beispiel stimmen wir alle Anforderungen ab, die das Anforderungsprotokoll HTTP
nutzen.
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.
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.
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 |
|
SSL-Protokoll |
|
Beispiel
In diesem Beispiel werden alle Anforderungen, die das TLS 1.2-Protokoll verwenden, abgeglichen.
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.
- IPv4-Beispiel:
- 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
und10.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
und10: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.
- IPv4-Beispiel: Wenn Sie die beiden IP-Adressen
Eigenschaften
Eigenschaft | Unterstützte Werte |
---|---|
Betreiber |
|
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.
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.
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.
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.
- Weitere Informationen zum Azure Front Door-Regelsatz.
- Erfahren Sie, wie Sie Ihren ersten Regelsatz konfigurieren.
- Hier finden Sie weitere Informationen zu Regelaktionen.