Warunki dopasowania reguł

W zestawach reguł usługi Azure Front Door reguła nie składa się z żadnych lub pewnych warunków dopasowania i akcji. Ten artykuł zawiera szczegółowe opisy warunków dopasowania, których można używać w zestawach reguł usługi Azure Front Door.

Ważne

Usługa Azure Front Door (klasyczna) zostanie wycofana 31 marca 2027 r. Aby uniknąć zakłóceń w działaniu usługi, należy przeprowadzić migrację profilów usługi Azure Front Door (wersja klasyczna) do warstwy Azure Front Door Standard lub Premium do marca 2027 r. Aby uzyskać więcej informacji, zobacz Wycofywanie usługi Azure Front Door (wersja klasyczna).

W aparatach reguł usługi Azure Front Door (wersja klasyczna) reguła nie składa się z żadnych warunków lub niektórych warunków dopasowania i akcji. Ten artykuł zawiera szczegółowe opisy warunków dopasowania, których można używać w aparatach reguł usługi Azure Front Door (wersja klasyczna).

Pierwszą częścią reguły jest warunek dopasowania lub zestaw warunków dopasowania. Reguła może składać się z maksymalnie 10 warunków dopasowania. Warunek dopasowania identyfikuje określone typy żądań, dla których są wykonywane zdefiniowane akcje. Jeśli używasz wielu warunków dopasowania, warunki dopasowania są grupowane razem przy użyciu logiki AND. Dla wszystkich warunków dopasowania, które obsługują wiele wartości, używana jest logika OR.

Możesz użyć warunku dopasowania, aby:

  • Filtrowanie żądań na podstawie określonego adresu IP, portu lub kraju/regionu.
  • Filtruj żądania według informacji nagłówka.
  • Filtrowanie żądań z urządzeń przenośnych lub urządzeń stacjonarnych.
  • Filtrowanie żądań z nazwy pliku żądania i rozszerzenia pliku.
  • Filtruj żądania według nazwy hosta, protokołu SSL, adresu URL żądania, protokołu, ścieżki, ciągu zapytania, post args i innych wartości.
  • Filtruj żądania na podstawie określonego adresu IP lub kraju/regionu.
  • Filtruj żądania według informacji nagłówka.
  • Filtrowanie żądań z urządzeń przenośnych lub urządzeń stacjonarnych.
  • Filtrowanie żądań z nazwy pliku żądania i rozszerzenia pliku.
  • Filtruj żądania według adresu URL żądania, protokołu, ścieżki, ciągu zapytania, argumentów post i innych wartości.

Typ urządzenia

Użyj warunku dopasowania typu urządzenia, aby zidentyfikować żądania pochodzące z urządzenia przenośnego lub urządzenia stacjonarnego.

Właściwości

Właściwości Obsługiwane wartości
Operator
  • W witrynie Azure Portal: Equal, Not Equal
  • W szablonach usługi ARM: Equal; użyj negateCondition właściwości , aby określić wartość Nie równa
Wartość Mobile, Desktop

Przykład

W tym przykładzie dopasujemy wszystkie wykryte żądania pochodzące z urządzenia przenośnego.

Zrzut ekranu portalu przedstawiający warunek dopasowania typu urządzenia.

Wersja protokołu HTTP

Użyj warunku dopasowania wersji HTTP, aby zidentyfikować żądania, które są wykonywane przy użyciu określonej wersji protokołu HTTP.

Uwaga

Warunek dopasowania wersji HTTP jest dostępny tylko w usłudze Azure Front Door Standard/Premium.

Właściwości

Właściwości Obsługiwane wartości
Operator
  • W witrynie Azure Portal: Equal, Not Equal
  • W szablonach usługi ARM: Equal; użyj negateCondition właściwości , aby określić wartość Nie równa
Wartość 2.0, , 1.1, , 1.00.9

Przykład

W tym przykładzie dopasujemy wszystkie żądania, które zostały wysłane przy użyciu protokołu HTTP 2.0.

Zrzut ekranu portalu przedstawiający warunek dopasowania wersji PROTOKOŁU HTTP.

Żądanie plików cookie

Użyj warunku dopasowania żądań plików cookie, aby zidentyfikować żądania, które zawierają określony plik cookie.

Uwaga

Warunek dopasowania plików cookie żądania jest dostępny tylko w usłudze Azure Front Door Standard/Premium.

Właściwości

Właściwości Obsługiwane wartości
Nazwa pliku cookie Wartość ciągu reprezentująca nazwę pliku cookie.
Operator Dowolny operator z listy operatorów standardowych.
Wartość Co najmniej jeden ciąg lub liczba całkowita reprezentująca wartość nagłówka żądania do dopasowania. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy przekształceń ciągów standardowych.

Przykład

W tym przykładzie dopasujemy wszystkie żądania, które mają plik cookie o nazwie deploymentStampId z wartością 1.

Zrzut ekranu portalu przedstawiający warunek dopasowania żądań plików cookie.

Post args

Użyj warunku dopasowania post args, aby zidentyfikować żądania na podstawie argumentów podanych w treści żądania POST. Pojedynczy warunek dopasowania pasuje do pojedynczego argumentu z treści żądania POST. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Uwaga

Warunek dopasowania args wpisu działa z typem application/x-www-form-urlencoded zawartości.

Właściwości

Właściwości Obsługiwane wartości
Post args Wartość ciągu reprezentująca nazwę argumentu POST.
Operator Dowolny operator z listy operatorów standardowych.
Wartość Co najmniej jeden ciąg lub liczba całkowita reprezentująca wartość argumentu POST do dopasowania. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy przekształceń ciągów standardowych.

Przykład

W tym przykładzie dopasujemy wszystkie żądania POST, w których customerName argument jest podany w treści żądania i gdzie wartość customerName zaczyna się literą J lub K. Używamy przekształcenia wielkości liter, aby przekonwertować wartości wejściowe na wielkie litery, tak aby wartości rozpoczynające się od J, j, Ki k zostały dopasowane.

Zrzut ekranu portalu przedstawiający warunek dopasowania args.

Ciąg zapytania

Użyj warunku dopasowania ciągu zapytania, aby zidentyfikować żądania zawierające określony ciąg zapytania. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Uwaga

Cały ciąg zapytania jest dopasowywany jako pojedynczy ciąg bez wiodącego ?ciągu .

Właściwości

Właściwości Obsługiwane wartości
Operator Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowania jest zgodny z każdym żądaniem, a warunek Brak dopasowania nie jest zgodny z żadnym żądaniem, jeśli jest używany z warunkiem dopasowania ciągu zapytania.
Ciąg zapytania Co najmniej jedna wartość ciągu lub liczba całkowita reprezentująca wartość ciągu zapytania, która ma być zgodna. Nie dołączaj wartości ? na początku ciągu zapytania. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy przekształceń ciągów standardowych.

Przykład

W tym przykładzie dopasujemy wszystkie żądania, w których ciąg zapytania zawiera ciąg language=en-US. Chcemy, aby warunek dopasowania był uwzględniany w wielkości liter, więc nie przekształcamy przypadku.

Zrzut ekranu portalu przedstawiający warunek dopasowania ciągu zapytania.

Adres zdalny

Warunek dopasowania adresu zdalnego identyfikuje żądania na podstawie lokalizacji lub adresu IP elementu żądającego. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

  • Użyj notacji CIDR podczas określania bloków adresów IP. Składnia bloku adresów IP to podstawowy adres IP, po którym następuje ukośnik i rozmiar prefiksu. Na przykład: .
    • Przykład protokołu IPv4: 5.5.5.64/26 pasuje do wszystkich żądań pochodzących z adresów 5.5.5.64 do 5.5.5.127.
    • Przykład IPv6: 1:2:3:/48 pasuje do wszystkich żądań, które docierają z adresów 1:2:3:0:0:0:0 do 1:2:3: ffff:ffff:ffff:ffff:ffff:ffff.ffff.
  • Po określeniu wielu adresów IP i bloków adresów IP zostanie zastosowana logika "OR".
    • Przykład IPv4: jeśli dodasz dwa adresy 1.2.3.4 IP i 10.20.30.40, warunek jest zgodny dla wszystkich żądań pochodzących z adresu 1.2.3.4 lub 10.20.30.40.
    • Przykład IPv6: jeśli dodasz dwa adresy 1:2:3:4:5:6:7:8 IP i 10:20:30:40:50:60:70:80, warunek jest zgodny dla wszystkich żądań pochodzących z adresu 1:2:3:4:5:6:7:8 lub 10:20:30:40:50:60:70:80.
  • Adres zdalny reprezentuje oryginalny adres IP klienta, który pochodzi z połączenia sieciowego lub zazwyczaj nagłówek żądania X-Forwarded-For, jeśli użytkownik znajduje się za serwerem proxy. Użyj warunku dopasowania adresu gniazda (dostępnego w warstwie Standardowa/Premium), jeśli chcesz dopasować go na podstawie adresu IP żądania TCP.

Właściwości

Właściwości Obsługiwane wartości
Operator
  • W witrynie Azure Portal: Geo Match, Geo Not Match, IP Matchlub IP Not Match
  • W szablonach usługi ARM: GeoMatch, użyj negateCondition właściwości , IPMatchaby określić niezgodność geograficzną lub adres IP nie pasuje
Wartość
  • IP Match Dla operatorów orIP Not Match: określ co najmniej jeden zakres adresów IP. Jeśli określono wiele zakresów adresów IP, są oceniane przy użyciu logiki OR.
  • Geo Match Dla operatorów orGeo Not Match: określ co najmniej jedną lokalizację przy użyciu kodu kraju.

Przykład

W tym przykładzie dopasujemy wszystkie żądania, których żądanie nie pochodzi z Stany Zjednoczone.

Zrzut ekranu portalu przedstawiający warunek dopasowania adresu zdalnego.

Treść żądania

Warunek dopasowania treści żądania identyfikuje żądania na podstawie określonego tekstu wyświetlanego w treści żądania. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Uwaga

Jeśli treść żądania przekracza rozmiar 64 KB, tylko pierwsze 64 KB zostanie uznane za warunek dopasowania treści żądania.

Właściwości

Właściwości Obsługiwane wartości
Operator Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowanie jest zgodny z każdym żądaniem, a warunek Brak dopasowania nie jest zgodny z żadnym żądaniem, jeśli jest używany z warunkiem dopasowania treści żądania.
Wartość Co najmniej jeden ciąg lub liczba całkowita reprezentująca wartość tekstu treści żądania do dopasowania. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy przekształceń ciągów standardowych.

Przykład

W tym przykładzie dopasujemy wszystkie żądania, w których treść żądania zawiera ciąg ERROR. Przekształcamy treść żądania na wielkie litery przed oceną dopasowania, więc error i inne odmiany wielkości liter również wyzwalają ten warunek dopasowania.

Zrzut ekranu portalu przedstawiający warunek dopasowania treści żądania.

Nazwa pliku żądania

Warunek dopasowania nazwy pliku żądania identyfikuje żądania, które zawierają określoną nazwę pliku w adresie URL żądania. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Właściwości

Właściwości Obsługiwane wartości
Operator Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowania jest zgodny z każdym żądaniem, a warunek Brak dopasowania nie jest zgodny z żadnym żądaniem, jeśli jest używany z warunkiem dopasowania nazwy pliku żądania.
Wartość Co najmniej jeden ciąg lub liczba całkowita reprezentująca wartość nazwy pliku żądania do dopasowania. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy przekształceń ciągów standardowych.

Przykład

W tym przykładzie dopasujemy wszystkie żądania, w których nazwa pliku żądania to media.mp4. Przekształcamy nazwę pliku na małe litery przed oceną dopasowania, więc MEDIA.MP4 i inne odmiany wielkości liter również wyzwalają ten warunek dopasowania.

Zrzut ekranu portalu przedstawiający warunek dopasowania nazwy pliku żądania.

Żądanie rozszerzenia pliku

Warunek dopasowania rozszerzenia pliku żądania identyfikuje żądania, które zawierają określone rozszerzenie pliku w nazwie pliku w adresie URL żądania. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Uwaga

Nie uwzględniaj okresu wiodącego. Na przykład użyj polecenia html zamiast .html.

Właściwości

Właściwości Obsługiwane wartości
Operator Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowania jest zgodny z każdym żądaniem, a warunek Nie pasuje do żadnego żądania, jeśli jest używany z warunkiem dopasowania rozszerzenia pliku żądania.
Wartość Co najmniej jedna wartość ciągu lub liczby całkowitej reprezentująca wartość rozszerzenia pliku żądania do dopasowania. Nie uwzględniaj okresu wiodącego. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy przekształceń ciągów standardowych.

Przykład

W tym przykładzie dopasujemy wszystkie żądania, w których rozszerzenie pliku żądania to pdf lub docx. Przekształcamy rozszerzenie pliku żądania na małe litery przed oceną dopasowania, więc PDFDocX, i inne odmiany wielkości liter również wyzwalają ten warunek dopasowania.

Zrzut ekranu portalu przedstawiający warunek dopasowania rozszerzenia pliku żądania.

Nagłówek żądania

Warunek dopasowania nagłówka żądania identyfikuje żądania, które zawierają określony nagłówek w żądaniu. Możesz użyć tego warunku dopasowania, aby sprawdzić, czy nagłówek istnieje lub czy nagłówek jest zgodny z określoną wartością. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Właściwości

Właściwości Obsługiwane wartości
Nazwa nagłówka Wartość ciągu reprezentująca nazwę argumentu POST.
Operator Dowolny operator z listy operatorów standardowych.
Wartość Co najmniej jeden ciąg lub liczba całkowita reprezentująca wartość nagłówka żądania do dopasowania. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy przekształceń ciągów standardowych.

Przykład

W tym przykładzie dopasujemy wszystkie żądania, w których żądanie zawiera nagłówek o nazwie MyCustomHeader, niezależnie od jego wartości.

Zrzut ekranu portalu przedstawiający warunek dopasowania nagłówka żądania.

Metoda żądania

Warunek dopasowania metody żądania identyfikuje żądania używające określonej metody żądania HTTP. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Właściwości

Właściwości Obsługiwane wartości
Operator
  • W witrynie Azure Portal: Equal, Not Equal
  • W szablonach usługi ARM: Equal; użyj negateCondition właściwości , aby określić wartość Nie równa
Metoda żądania Co najmniej jedna metoda HTTP z: GET, , PUTPOST, DELETE, HEAD, OPTIONS, TRACE. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.

Przykład

W tym przykładzie dopasujemy wszystkie żądania, w których żądanie używa DELETE metody .

Zrzut ekranu portalu przedstawiający warunek dopasowania metody żądania.

Ścieżka żądania

Warunek dopasowania ścieżki żądania identyfikuje żądania, które zawierają określoną ścieżkę w adresie URL żądania. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Uwaga

Ścieżka jest częścią adresu URL po nazwie hosta i ukośniku. Na przykład w adresie URL https://www.contoso.com/files/secure/file1.pdfścieżka to files/secure/file1.pdf.

Właściwości

Właściwości Obsługiwane wartości
Operator
  • Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowania jest zgodny z każdym żądaniem, a warunek Brak dopasowania nie jest zgodny z żadnym żądaniem, jeśli jest używany z warunkiem dopasowania ścieżki żądania.
  • Symbol wieloznaczny: pasuje, gdy ścieżka żądania jest zgodna z wyrażeniem wieloznacznymi. Wyrażenie wieloznaczne może zawierać * znak odpowiadający zero lub więcej znaków w ścieżce. Na przykład wyrażenie files/customer*/file.pdf wieloznaczne pasuje do ścieżek files/customer1/file.pdf, files/customer109/file.pdfi files/customer/file.pdf, ale nie jest zgodne files/customer2/anotherfile.pdfz .
    • W witrynie Azure Portal: Wildcards, Not Wildcards
    • W szablonach usługi ARM: Wildcard; użyj negateCondition właściwości , aby określić nieznajdowanie symboli wieloznacznych
Wartość Co najmniej jeden ciąg lub liczba całkowita reprezentująca wartość ścieżki żądania do dopasowania. Jeśli określisz ukośnik wiodący, zostanie zignorowany. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy przekształceń ciągów standardowych.
Właściwości Obsługiwane wartości
Operator Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowania jest zgodny z każdym żądaniem, a warunek Brak dopasowania nie jest zgodny z żadnym żądaniem, jeśli jest używany z warunkiem dopasowania ścieżki żądania.
Wartość Co najmniej jeden ciąg lub liczba całkowita reprezentująca wartość ścieżki żądania do dopasowania. Jeśli określisz ukośnik wiodący, zostanie zignorowany. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy przekształceń ciągów standardowych.

Przykład

W tym przykładzie dopasujemy wszystkie żądania, w których ścieżka pliku żądania zaczyna się od files/secure/. Przekształcamy rozszerzenie pliku żądania na małe litery przed oceną dopasowania, więc żądania do files/SECURE/ i inne odmiany wielkości liter również wyzwalają ten warunek dopasowania.

Zrzut ekranu portalu przedstawiający warunek dopasowania ścieżki żądania.

Protokół żądania

Warunek dopasowania protokołu żądania identyfikuje żądania używające określonego protokołu (HTTP lub HTTPS).

Uwaga

Protokół jest czasami nazywany również schematem.

Właściwości

Właściwości Obsługiwane wartości
Operator
  • W witrynie Azure Portal: Equal, Not Equal
  • W szablonach usługi ARM: Equal; użyj negateCondition właściwości , aby określić wartość Nie równa
Metoda żądania HTTP, HTTPS

Przykład

W tym przykładzie dopasujemy wszystkie żądania, w których żądanie używa HTTP protokołu.

Zrzut ekranu portalu przedstawiający warunek dopasowania protokołu żądania.

Adres URL żądania

Identyfikuje żądania zgodne z określonym adresem URL. Cały adres URL jest oceniany, w tym protokół i ciąg zapytania, ale nie fragment. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Napiwek

Jeśli używasz tego warunku reguły, pamiętaj, aby uwzględnić protokół i ukośnik /końcowy . Na przykład użyj polecenia https://www.contoso.com/ zamiast tylko www.contoso.com.

Właściwości

Właściwości Obsługiwane wartości
Operator Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowanie jest zgodny z każdym żądaniem, a warunek Nie pasuje do żadnego żądania, jeśli jest używany z warunkiem dopasowania adresu URL żądania.
Wartość Co najmniej jeden ciąg lub liczba całkowita reprezentująca wartość adresu URL żądania do dopasowania. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy przekształceń ciągów standardowych.

Przykład

W tym przykładzie dopasujemy wszystkie żądania, których adres URL żądania zaczyna się od https://api.contoso.com/customers/123. Przekształcamy rozszerzenie pliku żądania na małe litery przed oceną dopasowania, więc żądania do https://api.contoso.com/Customers/123 i inne odmiany wielkości liter również wyzwolą ten warunek dopasowania.

Zrzut ekranu portalu przedstawiający warunek dopasowania adresu URL żądania.

Nazwa hosta

Warunek dopasowania nazwy hosta identyfikuje żądania na podstawie określonej nazwy hosta w żądaniu od klienta. Warunek dopasowania używa wartości nagłówka Host do oceny nazwy hosta. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Właściwości

Właściwości Obsługiwane wartości
Operator Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowania jest zgodny z każdym żądaniem, a warunek Brak dopasowania nie jest zgodny z żadnym żądaniem, jeśli jest używany z warunkiem dopasowania nazwy hosta.
Wartość Co najmniej jedna wartość ciągu reprezentująca wartość nazwy hosta żądania do dopasowania. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każdy przypadek przekształca się z listy przekształceń ciągów standardowych.

Przykład

W tym przykładzie dopasujemy wszystkie żądania do nagłówka kończącego Host się ciągiem contoso.com.

Zrzut ekranu portalu przedstawiający warunek dopasowania nazwy hosta.

Protokół SSL

Warunek dopasowania protokołu SSL identyfikuje żądania na podstawie protokołu SSL ustanowionego połączenia TLS. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Właściwości

Właściwości Obsługiwane wartości
Operator
  • W witrynie Azure Portal: Equal, Not Equal
  • W szablonach usługi ARM: Equal; użyj negateCondition właściwości , aby określić wartość Nie równa
Protokół SSL
  • W witrynie Azure Portal: 1.0, , 1.11.2
  • W szablonach usługi ARM: TLSv1, TLSv1.1TLSv1.2

Przykład

W tym przykładzie dopasujemy wszystkie żądania używające protokołu TLS 1.2.

Zrzut ekranu portalu przedstawiający warunek dopasowania protokołu SSL.

Adres gniazda

Warunek dopasowania adresu gniazda identyfikuje żądania na podstawie adresu IP bezpośredniego połączenia z usługą Azure Front Door Edge. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Uwaga

Jeśli klient użył serwera proxy HTTP lub modułu równoważenia obciążenia do wysłania żądania, adres gniazda jest adresem IP serwera proxy lub modułu równoważenia obciążenia.

Użyj warunku dopasowania adresu zdalnego, jeśli chcesz dopasować go na podstawie oryginalnego adresu IP klienta.

  • Użyj notacji CIDR podczas określania bloków adresów IP. Oznacza to, że składnia bloku adresów IP to podstawowy adres IP, po którym następuje ukośnik i rozmiar prefiksu. Na przykład: .
    • Przykład protokołu IPv4: 5.5.5.64/26 pasuje do wszystkich żądań pochodzących z adresów 5.5.5.64 do 5.5.5.127.
    • Przykład IPv6: 1:2:3:/48 pasuje do wszystkich żądań, które docierają z adresów 1:2:3:0:0:0:0 do 1:2:3: ffff:ffff:ffff:ffff:ffff:ffff.ffff.
  • Po określeniu wielu adresów IP i bloków adresów IP zostanie zastosowana logika "OR".
    • Przykład IPv4: jeśli dodasz dwa adresy 1.2.3.4 IP i 10.20.30.40, warunek jest zgodny dla wszystkich żądań pochodzących z adresu 1.2.3.4 lub 10.20.30.40.
    • Przykład IPv6: jeśli dodasz dwa adresy 1:2:3:4:5:6:7:8 IP i 10:20:30:40:50:60:70:80, warunek jest zgodny dla wszystkich żądań pochodzących z adresu 1:2:3:4:5:6:7:8 lub 10:20:30:40:50:60:70:80.

Właściwości

Właściwości Obsługiwane wartości
Operator
  • W witrynie Azure Portal: IP Match, Not IP Match
  • W szablonach usługi ARM: IPMatch; użyj negateCondition właściwości , aby określić niezgodność adresów IP
Wartość Określ co najmniej jeden zakres adresów IP. Jeśli określono wiele zakresów adresów IP, są oceniane przy użyciu logiki OR.

Przykład

W tym przykładzie dopasujemy wszystkie żądania z adresów IP w zakresie 5.5.5.64/26.

Zrzut ekranu portalu przedstawiający warunek dopasowania adresu gniazda.

Port klienta

Warunek dopasowania portu klienta identyfikuje żądania na podstawie portu TCP klienta, który złożył żądanie. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Właściwości

Właściwości Obsługiwane wartości
Operator Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolne dopasowanie jest zgodny z każdym żądaniem, a warunek Brak dopasowania nie jest zgodny z żadnym żądaniem, jeśli jest używany z warunkiem dopasowania portu klienta.
Wartość Co najmniej jedna liczba portów wyrażona jako liczba całkowita. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.

Przykład

W tym przykładzie dopasujemy wszystkie żądania do portu klienta 1234.

Zrzut ekranu portalu przedstawiający warunek dopasowania portu klienta.

Port serwera

Warunek dopasowania portu serwera identyfikuje żądania na podstawie portu TCP serwera usługi Azure Front Door, który zaakceptował żądanie. Port musi mieć wartość 80 lub 443. Można określić wiele wartości do dopasowania, które można połączyć przy użyciu logiki OR.

Właściwości

Właściwości Obsługiwane wartości
Operator Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowanie jest zgodny z każdym żądaniem, a warunek Brak dopasowania nie jest zgodny z żadnym żądaniem, jeśli jest używany z warunkiem dopasowania portu serwera.
Wartość Numer portu, który musi mieć wartość 80 lub 443. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.

Przykład

W tym przykładzie dopasujemy wszystkie żądania do portu serwera 443.

Zrzut ekranu portalu przedstawiający warunek dopasowania portu serwera.

Lista operatorów

W przypadku reguł, które akceptują wartości z listy operatorów standardowych, prawidłowe są następujące operatory:

Operator Opis Obsługa szablonów usługi ARM
Dowolne Dopasowanie, gdy istnieje dowolna wartość, niezależnie od tego jaka jest. operator: Any
Równe Dopasowanie, gdy wartość dokładnie pasuje do określonego ciągu. operator: Equal
Contains Dopasowanie, gdy wartość zawiera określony ciąg. operator: Contains
Mniejsze od Dopasowanie, gdy długość wartości jest mniejsza niż określona liczba całkowita. operator: LessThan
Większe niż Dopasowanie, gdy długość wartości jest większa niż określona liczba całkowita. operator: GreaterThan
Mniejsze lub równe Dopasowanie, gdy długość wartości jest mniejsza niż określona liczba całkowita lub jej równa. operator: LessThanOrEqual
Większe lub równe Dopasowanie, gdy długość wartości jest większa niż określona liczba całkowita lub jej równa. operator: GreaterThanOrEqual
Zaczyna się od Dopasowanie, gdy wartość zaczyna się od określonego ciągu. operator: BeginsWith
Kończy się na Dopasowanie, gdy wartość kończy się określonym ciągiem. operator: EndsWith
Żadne z Dopasowanie, gdy nie ma wartości. operator: i negateCondition : Anytrue
Nie równa się Dopasowanie, gdy wartość nie jest zgodna z określonym ciągiem. operator: i negateCondition : Equaltrue
Nie zawiera Dopasowanie, gdy wartość nie zawiera określonego ciągu. operator: i negateCondition : Containstrue
Nie mniejsze niż Dopasowanie, gdy długość wartości nie jest mniejsza niż określona liczba całkowita. operator: i negateCondition : LessThantrue
Nie większe niż Dopasowanie, gdy długość wartości nie jest większa niż określona liczba całkowita. operator: i negateCondition : GreaterThantrue
Nie mniejsze niż lub równe Dopasowanie, gdy długość wartości nie jest mniejsza niż określona liczba całkowita lub jej równa. operator: i negateCondition : LessThanOrEqualtrue
Nie większe niż lub równe Dopasuje, gdy długość wartości nie jest większa lub równa określonej liczbą całkowitą. operator: i negateCondition : GreaterThanOrEqualtrue
Nie zaczyna się od Dopasuje, gdy wartość nie zaczyna się od określonego ciągu. operator: i negateCondition : BeginsWithtrue
Nie kończy się na Pasuje, gdy wartość nie kończy się określonym ciągiem. operator: i negateCondition : EndsWithtrue
Operator Opis Obsługa szablonów usługi ARM
Dowolne Dopasowanie, gdy istnieje dowolna wartość, niezależnie od tego jaka jest. operator: Any
Równe Dopasowanie, gdy wartość dokładnie pasuje do określonego ciągu. operator: Equal
Contains Dopasowanie, gdy wartość zawiera określony ciąg. operator: Contains
Mniejsze od Dopasowanie, gdy długość wartości jest mniejsza niż określona liczba całkowita. operator: LessThan
Większe niż Dopasowanie, gdy długość wartości jest większa niż określona liczba całkowita. operator: GreaterThan
Mniejsze lub równe Dopasowanie, gdy długość wartości jest mniejsza niż określona liczba całkowita lub jej równa. operator: LessThanOrEqual
Większe lub równe Dopasowanie, gdy długość wartości jest większa niż określona liczba całkowita lub jej równa. operator: GreaterThanOrEqual
Zaczyna się od Dopasowanie, gdy wartość zaczyna się od określonego ciągu. operator: BeginsWith
Kończy się na Dopasowanie, gdy wartość kończy się określonym ciągiem. operator: EndsWith
RegEx Dopasowanie, gdy wartość jest zgodna z określonym wyrażeniem regularnym. Aby uzyskać więcej informacji, zobacz poniżej. operator: RegEx
Żadne z Dopasowanie, gdy nie ma wartości. operator: i negateCondition : Anytrue
Nie równa się Dopasowanie, gdy wartość nie jest zgodna z określonym ciągiem. operator: i negateCondition : Equaltrue
Nie zawiera Dopasowanie, gdy wartość nie zawiera określonego ciągu. operator: i negateCondition : Containstrue
Nie mniejsze niż Dopasowanie, gdy długość wartości nie jest mniejsza niż określona liczba całkowita. operator: i negateCondition : LessThantrue
Nie większe niż Dopasowanie, gdy długość wartości nie jest większa niż określona liczba całkowita. operator: i negateCondition : GreaterThantrue
Nie mniejsze niż lub równe Dopasowanie, gdy długość wartości nie jest mniejsza niż określona liczba całkowita lub jej równa. operator: i negateCondition : LessThanOrEqualtrue
Nie większe niż lub równe Dopasuje, gdy długość wartości nie jest większa lub równa określonej liczbą całkowitą. operator: i negateCondition : GreaterThanOrEqualtrue
Nie zaczyna się od Dopasuje, gdy wartość nie zaczyna się od określonego ciągu. operator: i negateCondition : BeginsWithtrue
Nie kończy się na Pasuje, gdy wartość nie kończy się określonym ciągiem. operator: i negateCondition : EndsWithtrue
Nie jest wyrażeniem regularnym Pasuje, gdy wartość nie jest zgodna z określonym wyrażeniem regularnym. Aby uzyskać więcej informacji, zobacz poniżej. operator: i negateCondition : RegExtrue

Napiwek

W przypadku operatorów liczbowych, takich jak Mniejsze niż i Większe niż lub równe, używane porównanie jest oparte na długości. Wartość w warunku dopasowania powinna być liczbą całkowitą określającą długość, którą chcesz porównać.

Wyrażenia regularne

Wyrażenia regularne nie obsługują następujących operacji:

  • Odwołania wsteczne i przechwytywanie podwyrażenia.
  • Dowolne asercji o zerowej szerokości.
  • Odwołania podrzędne i wzorce cyklicznego.
  • Wzorce warunkowe.
  • Czasowniki kontrolek wycofywania.
  • Dyrektywa jedno bajtowa \C .
  • Dyrektywa \R match newline.
  • \K Początek dyrektywy resetowania dopasowania.
  • Objaśnienie i osadzony kod.
  • Grupowanie niepodzielne i kwantyfikatory opętujące.

Lista przekształceń ciągów

W przypadku reguł, które mogą przekształcać ciągi, prawidłowe są następujące przekształcenia:

Przekształcanie opis Obsługa szablonów usługi ARM
Do małych liter Konwertuje ciąg na małą reprezentację. Lowercase
Do wielkich liter Konwertuje ciąg na wielką reprezentację. Uppercase
Trim Przycina wiodące i końcowe odstępy od ciągu. Trim
Usuwanie wartości null Usuwa wartości null z ciągu. RemoveNulls
Kodowanie adresu URL Adres URL koduje ciąg. UrlEncode
Dekodowanie adresu URL Adres URL dekoduje ciąg. UrlDecode

Następne kroki

  • Dowiedz się więcej na temat aparatu reguł usługi Azure Front Door (wersja klasyczna)
  • Dowiedz się, jak skonfigurować pierwszy aparat reguł.
  • Dowiedz się więcej o akcjach reguł