Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Eine Regel in Azure Front Door-Regelsätzen besteht aus einer oder mehreren Vergleichsbedingungen und einer Aktion. Dieser Artikel enthält detaillierte Beschreibungen der Abgleichbedingungen, die Sie in Azure Front Door-Regelsätzen verwenden können.
Wichtig
Azure Front Door (klassisch) unterstützt die Profilerstellung, das Onboarding neuer Domänen oder verwaltete Zertifikate nicht und wird auf March 31, 2027 eingestellt. Um Dienstunterbrechungen zu vermeiden, migrieren Sie zu Azure Front Door Standard oder Premium. Weitere Informationen finden Sie unter Azure Front Door (klassisch) Außerbetriebnahme.
Eine Regel in (klassischen) Azure Front Door-Regelmodulen besteht aus einer oder mehreren Vergleichsbedingungen und einer Aktion. Dieser Artikel enthält detaillierte Beschreibungen der Vergleichsbedingungen, die Sie in (klassischen) Azure Front Door-Regelmodulen verwenden können.
Eine Regel beginnt mit einer Vergleichsbedingung oder einer Reihe von Vergleichsbedingungen. Eine Regel kann bis zu 10 Vergleichsbedingungen aufweisen. Eine Übereinstimmungsbedingung gibt bestimmte Typen von Anforderungen an, für die definierte Aktionen ausgeführt werden. Wenn Sie mehrere Übereinstimmungsbedingungen verwenden, werden sie mit AND-Logik gruppiert. Für Ü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 Sie Anfragen von mobilen Geräten 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 einer bestimmten IP-Adresse oder einem bestimmten Land/einer bestimmten Region.
- Filtern von Anforderungen nach Headerinformationen
- Filtern Sie Anfragen von mobilen Geräten 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 Übereinstimmungsbedingung 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 |
|---|---|
| Cookie-Name | Ein Zeichenfolgewert, der den Namen des Cookies darstellt. |
| Betreiber | Beliebiger Operator aus der Standardoperator-Liste. |
| Wert | Eine oder mehrere Zeichenketten- oder Ganzzahlwerte, die den Wert des abzugleichenden Anforderungsheaders darstellen. 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.
Beitrags-Argumente
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 mithilfe der ODER-Logik kombiniert werden können.
Hinweis
Die Übereinstimmungsbedingung Post args funktioniert mit dem application/x-www-form-urlencoded-Inhaltstyp.
Eigenschaften
| Eigenschaft | Unterstützte Werte |
|---|---|
| Beitrags-Argumente | 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.
Abfragezeichenfolge
Verwenden Sie die Übereinstimmungsbedingung Abfragezeichenfolge zum Identifizieren von Anforderungen, die eine bestimmte Abfragezeichenfolge enthalten. Sie können mehrere Werte angeben, die mithilfe der ODER-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 eine Zeichenfolge oder ein ganzzahliger Wert, der den Wert der abzugleichenden Abfragezeichenfolge repräsentiert. Das ? nicht zu Beginn der Abfragezeichenfolge einschließen. 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 erfassen wir alle Anforderungen, bei denen die Abfragezeichenfolge 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 mithilfe der ODER-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/26entspricht allen Anforderungen, die von den Adressen 5.5.5.64 bis 5.5.5.127 eingehen. -
IPv6-Beispiel:
1:2:3:/48stimmt mit den Anforderungen überein, die von den Adressen 1:2:3:0:0:0:0:0 bis 1:2:3:ffff:ffff:ffff:ffff:ffff eingehen.
-
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.4und10.20.30.40hinzufü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:8und10:20:30:40:50:60:70:80hinzufü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 über die Netzwerkverbindung oder typischerweise über den X-Forwarded-For-Anforderungsheader kommt, 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
Die Übereinstimmungsbedingung des Anforderungstextkörpers identifiziert Anforderungen anhand eines bestimmten Textes, der im Textkörper der Anforderung vorhanden ist. Sie können mehrere Werte angeben, die mithilfe der ODER-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 | Ein oder mehrere Zeichenfolgen oder Ganzzahlen, die den Wert des Anforderungstexts darstellen, der abgeglichen werden soll. 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. Wir wandeln den Anforderungskörper vor der Auswertung des Vergleichs in Großbuchstaben um, sodass auch error und andere Varianten in der Groß- und Kleinschreibung diese Vergleichsbedingung auslösen.
Anforderungsdateiname
Die Übereinstimmungsbedingung Dateiname der Anforderung identifiziert Anforderungen, die den angegebenen Dateinamen in der Anforderungs-URL enthalten. Sie können mehrere Werte angeben, die mithilfe der ODER-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. Wir wandeln den Dateinamen in Kleinbuchstaben um, bevor wir die Übereinstimmung bewerten, sodass MEDIA.MP4 und andere Groß- und Kleinschreibungsvarianten ebenfalls diese Bedingung auslösen.
Anforderung einer Dateiverlängerung
Die Übereinstimmungsbedingung Dateierweiterung der Anforderung identifiziert Anforderungen, die die angegebene Dateierweiterung im Dateinamen der Anforderungs-URL enthalten. Sie können mehrere Werte angeben, die mithilfe der ODER-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. Wir wandeln die Erweiterung der Anforderungsdatei vor der Bewertung der Übereinstimmung in Kleinbuchstaben um, sodass auch PDF, DocX und andere Varianten bei der Groß- und Kleinschreibung diese Übereinstimmungsbedingung auslösen.
Anforderungs-Header
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 mithilfe der ODER-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 | Eine oder mehrere Zeichenketten- oder Ganzzahlwerte, die den Wert des abzugleichenden Anforderungsheaders darstellen. 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 mithilfe der ODER-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 werden alle Anfragen abgeglichen, die die Anforderungsmethode DELETE nutzen.
Anforderungspfad
Die Übereinstimmungsbedingung Anforderungspfad identifiziert Anforderungen, die den angegebenen Pfad in der Anforderungs-URL enthalten. Sie können mehrere Werte angeben, die mithilfe der ODER-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 Zeichenfolgen- oder Ganzzahlwert, der dem Wert des zu vergleichenden Anforderungspfades entspricht. 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 Zeichenfolgen- oder Ganzzahlwert, der dem Wert des zu vergleichenden Anforderungspfades entspricht. 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. Die Dateierweiterung der Anfrage wird vor der Bewertung der Übereinstimmung in Kleinbuchstaben umgewandelt, sodass auch Anfragen an files/SECURE/ und andere Varianten der Schreibweise 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 mithilfe der ODER-Logik kombiniert werden können.
Tipp
Wenn Sie diese Regelbedingung verwenden, stellen Sie sicher, dass Sie das Protokoll und einen Slash am Ende / angeben. 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 | Eine oder mehrere Zeichenfolgen oder Ganzzahlwerte, die dem Wert der Anforderungs-URL zum Abgleich entsprechen. 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.
Hostnamen
Die Vergleichsbedingung Hostnamen identifiziert Anforderungen basierend auf dem angegebenen Hostnamen in der Anforderung vom Client. Die Vergleichsbedingung verwendet den Headerwert Host, um den Hostnamen auszuwerten. Sie können mehrere Werte angeben, die mithilfe der ODER-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 | Eine oder mehrere Zeichenfolgen, die den Wert des Anforderungshostnamens darstellen, der abgeglichen werden soll. 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 mithilfe der ODER-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 mithilfe der ODER-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/26entspricht allen Anforderungen, die von den Adressen 5.5.5.64 bis 5.5.5.127 eingehen. -
IPv6-Beispiel:
1:2:3:/48stimmt mit den Anforderungen überein, die von den Adressen 1:2:3:0:0:0:0:0 bis 1:2:3:ffff:ffff:ffff:ffff:ffff eingehen.
-
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.4und10.20.30.40hinzufü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:8und10:20:30:40:50:60:70:80hinzufü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.
Client-Port
Die Vergleichsbedingung Clientport identifiziert Anforderungen basierend auf dem TCP-Port des Clients, der die Anforderung gesendet hat. Sie können mehrere Werte angeben, die mithilfe der ODER-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 stimmen wir alle Anfragen mit einem Client-Port von 1234 überein.
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 mithilfe der ODER-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:
| Betreiber | BESCHREIBUNG | ARM-Vorlagenunterstützung |
|---|---|---|
| Beliebig | Ergibt eine Übereinstimmung, wenn ein beliebiger Wert vorhanden ist, unabhängig davon, was es ist. |
operator: Any |
| Gleich | 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 eine Übereinstimmung, wenn die Länge des Werts kleiner als die angegebene Ganzzahl beträgt. |
operator: LessThan |
| Größer als | Erzeugt ein Treffer, 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 | Stimmt überein mit, wenn die Länge des Werts größer oder gleich der angegebenen Ganzzahl ist. |
operator: GreaterThanOrEqual |
| Beginnt mit | Es stimmt überein, wenn der Wert mit der angegebenen Zeichenfolge beginnt. |
operator: BeginsWith |
| Endet mit | Eine Übereinstimmung tritt auf, wenn der Wert mit der angegebenen Zeichenfolge endet. |
operator: EndsWith |
| Keine(r) | 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 |
| Enthält nicht | 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 |
| Betreiber | BESCHREIBUNG | ARM-Vorlagenunterstützung |
|---|---|---|
| Beliebig | Ergibt eine Übereinstimmung, wenn ein beliebiger Wert vorhanden ist, unabhängig davon, was es ist. |
operator: Any |
| Gleich | 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 eine Übereinstimmung, wenn die Länge des Werts kleiner als die angegebene Ganzzahl beträgt. |
operator: LessThan |
| Größer als | Erzeugt ein Treffer, 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 | Stimmt überein mit, wenn die Länge des Werts größer oder gleich der angegebenen Ganzzahl ist. |
operator: GreaterThanOrEqual |
| Beginnt mit | Es stimmt überein, wenn der Wert mit der angegebenen Zeichenfolge beginnt. |
operator: BeginsWith |
| Endet mit | Eine Übereinstimmung tritt auf, wenn der Wert mit der angegebenen Zeichenfolge endet. |
operator: EndsWith |
| RegEx | Entspricht, wenn der Wert dem angegebenen regulären Ausdruck entspricht. Weitere Informationen finden Sie weiter unten. |
operator: RegEx |
| Keine(r) | 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 |
| Enthält nicht | 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 Vergleichsbedingung muss eine ganze Zahl sein, die die Länge angibt, die Sie bestimmen 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 Kontrollverben.
- Die
\CEinzelbyte-Anweisung. - Die
\RAnweisung für das Zeilenumbruchmuster. - Die
\KStartanweisung zum Zurücksetzen des Matches. - Callouts und eingebetteter Code.
- Atomische Gruppierung und Possessive Quantifizierer.
Zeichenfolgentransformationsliste
Für Regeln, die Zeichenfolgen transformieren können, sind folgende Transformationen gültig:
| Transformieren | BESCHREIBUNG | ARM-Vorlagenunterstützung |
|---|---|---|
| In Kleinbuchstaben umwandeln | Konvertiert die Zeichenfolge in eine Darstellung mit Kleinbuchstaben. | Lowercase |
| Zu Großbuchstaben umwandeln | Konvertiert die Zeichenfolge in eine Darstellung mit Großbuchstaben. | Uppercase |
| Zuschneiden | Entfernt führende und nachfolgende Leerzeichen aus der Zeichenfolge. | Trim |
| NULL-Werte entfernen | Entfernt NULL-Werte aus der Zeichenfolge. | RemoveNulls |
| URL-Codierung | URL-kodiert die Zeichenkette. | 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.