Warunki dopasowania reguł

W zestawach reguł usługi Azure Front Door reguła składa się z co najmniej jednego warunku 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

Azure Front Door (classic) przechodzi na emeryturę 31 marca 2027 roku. Ponieważ usługa jest wycofywana, nie obsługuje już tworzenia profili, wdrażania nowych domen ani zarządzanych certyfikatów. Aby uniknąć zakłóceń usługi, zmigruj do Azure Front Door w wersji Standard lub Premium. Aby uzyskać więcej informacji, zobacz wycofanie z użycia klasycznej wersji Azure Front Door.

W silnikach reguł usługi Azure Front Door (wersja klasyczna), reguła składa się z co najmniej jednego warunku dopasowania i akcji. Artykuł zawiera szczegółowe opisy warunków dopasowania, których można używać w silnikach reguł usługi Azure Front Door (wersja klasyczna).

Reguła rozpoczyna się od warunku dopasowania lub zestawu warunków dopasowania. Reguła może mieć 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, są one grupowane razem przy użyciu logiki AND. W przypadku 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.
  • Filtruj żądania według 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, argumentów post i innych wartości.
  • Filtrowanie żądań 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.
  • Filtruj żądania według 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
Obsługujący
  • W witrynie Azure Portal: Equal, Not Equal
  • W szablonach usługi ARM: Equal; użyj właściwości negateCondition, aby określić Nie równe
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
Obsługujący
  • W witrynie Azure Portal: Equal, Not Equal
  • W szablonach usługi ARM: Equal; użyj właściwości negateCondition, aby określić Nie równe
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.
Obsługujący Dowolny operator z listy operatorów standardowych.
Wartość Co najmniej jeden ciąg znaków lub liczba całkowita reprezentująca wartość nagłówka żądania, która ma zostać dopasowana. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy standardowych przekształceń ciągów.

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.

Publikowanie argumentów

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
Publikowanie argumentów Wartość ciągu reprezentująca nazwę argumentu POST.
Obsługujący Dowolny operator z listy operatorów standardowych.
Wartość Co najmniej jeden ciąg znaków lub liczba całkowita reprezentująca wartość argumentu POST, którą należy dopasować. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy standardowych przekształceń ciągów.

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 transformacji wielkości liter, aby przekonwertować wartości wejściowe na wielkie litery, dzięki czemu wartości zaczynające się od J, j, K, i k są dopasowane.

Zrzut ekranu portalu przedstawiający warunek dopasowania argumentów.

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 ?.

Właściwości

Właściwości Obsługiwane wartości
Obsługujący Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowania jest zgodny z każdym żądaniem, a warunek Nie Dowolny 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 standardowych przekształceń ciągów.

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 żą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:0 do 1:2:3: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
Obsługujący
  • W witrynie Azure Portal: Geo Match, Geo Not Match, IP Matchlub IP Not Match
  • W szablonach usługi ARM: GeoMatch, IPMatch; użyj właściwości negateCondition aby określić Geolokalizacja nie pasuje lub IP nie pasuje
Wartość
  • Dla operatorów IP Match lub IP 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.
  • Dla operatorów Geo Match lub Geo Not Match: określ jedną lub więcej lokalizacji przy użyciu kodu kraju.

Przykład

W tym przykładzie dopasujemy wszystkie żądania, które nie pochodzą ze Stanów Zjednoczonych.

Zrzut ekranu portalu przedstawiający warunek zgodności 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
Obsługujący Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek dopasowania Dowolny pasuje do każdego żądania, a warunek Nie dowolny nie pasuje do żadnego żądania, gdy jest używany z warunkiem dopasowania treści żądania.
Wartość Co najmniej jeden ciąg lub liczba całkowita reprezentująca wartość tekstu, który ma być dopasowany do treści żądania. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy standardowych przekształceń ciągów.

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 zgodności 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
Obsługujący Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek dopasowania Dowolny odpowiada każdemu żądaniu, a warunek dopasowania Nie żaden nie odpowiada żadnemu żądaniu, gdy 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 standardowych przekształceń ciągów.

Przykład

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

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
Obsługujący Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Any dopasowuje każde żądanie, a warunek Not Any nie dopasowuje żadnego żądania, gdy 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 standardowych przekształceń ciągów.

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. W rezultacie, PDF, DocX oraz inne warianty 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.
Obsługujący Dowolny operator z listy operatorów standardowych.
Wartość Co najmniej jeden ciąg znaków lub liczba całkowita reprezentująca wartość nagłówka żądania, która ma zostać dopasowana. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy standardowych przekształceń ciągów.

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
Obsługujący
  • W witrynie Azure Portal: Equal, Not Equal
  • W szablonach usługi ARM: Equal; użyj właściwości negateCondition, aby określić Nie równe
Metoda żądania Co najmniej jedna metoda HTTP z: GET, POST, PUT, DELETE, HEAD, OPTIONS, TRACE. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.

Przykład

W tym przykładzie dopasowujemy wszystkie żądania, które używają metody DELETE.

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
Obsługujący
  • Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowuje każde żądanie, a warunek Żaden nie dopasowuje żadnego żądania, gdy jest używany z warunkiem dopasowania ścieżki żądania.
  • Symbol wieloznaczny: Pasuje, gdy ścieżka żądania jest zgodna z wyrażeniem wieloznacznym. Wyrażenie wieloznaczne może zawierać znak *, który pasuje do zero lub większej liczby znaków w ścieżce. Na przykład wyrażenie wieloznaczne files/customer*/file.pdf pasuje do ścieżek files/customer1/file.pdf, files/customer109/file.pdf, i files/customer/file.pdf, ale nie pasuje do files/customer2/anotherfile.pdf.
    • W witrynie Azure Portal: Wildcards, Not Wildcards
    • W szablonach ARM: Wildcard; użyj właściwości negateCondition, aby określić Bez 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 standardowych przekształceń ciągów.
Właściwości Obsługiwane wartości
Obsługujący Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowuje każde żądanie, a warunek Żaden nie dopasowuje żadnego żądania, gdy 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 standardowych przekształceń ciągów.

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/ oraz inne wariacje 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
Obsługujący
  • W witrynie Azure Portal: Equal, Not Equal
  • W szablonach usługi ARM: Equal; użyj właściwości negateCondition, aby określić Nie równe
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.

Wskazówka

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
Obsługujący Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek dopasowania Any odpowiada na każde żądanie, a warunek dopasowania Not Any nie pasuje do żadnego żądania, gdy jest używany z warunkiem dopasowania adresu URL żądania.
Wartość Co najmniej jeden ciąg lub liczba całkowita, które reprezentują wartość do dopasowania w adresie URL żądania. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja z listy standardowych przekształceń ciągów.

Przykład

W tym przykładzie dopasujemy wszystkie żądania, których adres URL żądania zaczyna się od https://api.contoso.com/customers/123. Konwertujemy rozszerzenie pliku żądania na małe litery przed oceną dopasowania, więc żądania do https://api.contoso.com/Customers/123 i inne warianty 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
Obsługujący Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolny dopasowania dopasowuje się do każdego żądania, a warunek Niedopasowania nie dopasowuje się do żadnego żądania, jeśli jest używany z warunkiem dopasowania do nazwy hosta.
Wartość Co najmniej jedna wartość ciągu reprezentująca nazwę hosta żądania, która ma być dopasowana. Jeśli określono wiele wartości, są oceniane przy użyciu logiki OR.
Przekształcanie wielkości liter Każda transformacja przypadku ze standardowej listy przekształceń ciągów.

Przykład

W tym przykładzie dopasowujemy wszystkie żądania z nagłówkiem Host, który kończy się ciągiem contoso.com.

Zrzut ekranu portalu przedstawiający warunek dopasowania nazwy hosta.

Protokół SSL

Warunek dopasowania dla protokołu SSL identyfikuje żądania na podstawie protokołu SSL w ramach 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
Obsługujący
  • W witrynie Azure Portal: Equal, Not Equal
  • W szablonach usługi ARM: Equal; użyj właściwości negateCondition, aby określić Nie równe
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:0 do 1:2:3: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
Obsługujący
  • W witrynie Azure Portal: IP Match, Not IP Match
  • W szablonach usługi ARM: IPMatch; użyj właściwości negateCondition, aby określić nie IP Match
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
Obsługujący Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolne dopasowanie jest zgodny z każdym żądaniem, a warunek Brak jakiegokolwiek dopasowania nie jest zgodny z żadnym żądaniem, jeśli warunek dopasowania portu klienta jest używany.
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
Obsługujący Obsługiwane są wszystkie operatory z listy operatorów standardowych. Jednak warunek Dowolności pasuje do każdego żądania, a warunek Brak Dowolności nie pasuje do żadnego żądania, gdy 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:

Obsługujący Opis Obsługa szablonów ARM
Dowolne Dopasowuje się, gdy istnieje jakakolwiek wartość, niezależnie od tego, jaka ona jest. operator: Any
Równe Dopasowanie, gdy wartość dokładnie pasuje do określonego ciągu. operator: Equal
Zawiera Dopasowuje, 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ż Pasuje, 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ż lub równa określonej liczbie całkowitej. 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 Pasuje, gdy wartość zaczyna się od określonego ciągu. operator: BeginsWith
Kończy się na Dopasowuje się, gdy wartość kończy się określonym ciągiem. operator: EndsWith
Żadne Dopasowanie, gdy nie ma wartości. operator: Any i negateCondition: true
Nie równa się Dopasowanie, gdy wartość nie jest zgodna z określonym ciągiem. operator: Equal i negateCondition: true
Nie zawiera Dopasowuje, gdy wartość nie zawiera określonego ciągu. operator: Contains i negateCondition: true
Nie mniejsze niż Dopasowanie, gdy długość wartości nie jest mniejsza niż określona liczba całkowita. operator: LessThan i negateCondition: true
Nie większe niż Dopasowanie, kiedy długość wartości nie przekracza określonej liczby całkowitej. operator: GreaterThan i negateCondition: true
Nie mniej niż lub równe Pasuje, gdy długość wartości nie jest mniejsza niż lub równa określonej liczbie całkowitej. operator: LessThanOrEqual i negateCondition: true
Nie większe niż lub równe Pasuje, gdy długość wartości nie jest większa lub równa określonej liczbie całkowitej. operator: GreaterThanOrEqual i negateCondition: true
Nie zaczyna się od Dopasuje, gdy wartość nie zaczyna się od określonego ciągu. operator: BeginsWith i negateCondition: true
Nie kończy się na Pasuje, gdy wartość nie kończy się określonym ciągiem. operator: EndsWith i negateCondition: true
Obsługujący Opis Obsługa szablonów ARM
Dowolne Dopasowuje się, gdy istnieje jakakolwiek wartość, niezależnie od tego, jaka ona jest. operator: Any
Równe Dopasowanie, gdy wartość dokładnie pasuje do określonego ciągu. operator: Equal
Zawiera Dopasowuje, 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ż Pasuje, 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ż lub równa określonej liczbie całkowitej. 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 Pasuje, gdy wartość zaczyna się od określonego ciągu. operator: BeginsWith
Kończy się na Dopasowuje się, gdy wartość kończy się określonym ciągiem. operator: EndsWith
RegEx Dopasowuje się, gdy wartość pasuje do określonego wyrażenia regularnego. Aby uzyskać więcej informacji, zobacz poniżej. operator: RegEx
Żadne Dopasowanie, gdy nie ma wartości. operator: Any i negateCondition: true
Nie równa się Dopasowanie, gdy wartość nie jest zgodna z określonym ciągiem. operator: Equal i negateCondition: true
Nie zawiera Dopasowuje, gdy wartość nie zawiera określonego ciągu. operator: Contains i negateCondition: true
Nie mniejsze niż Dopasowanie, gdy długość wartości nie jest mniejsza niż określona liczba całkowita. operator: LessThan i negateCondition: true
Nie większe niż Dopasowanie, kiedy długość wartości nie przekracza określonej liczby całkowitej. operator: GreaterThan i negateCondition: true
Nie mniej niż lub równe Pasuje, gdy długość wartości nie jest mniejsza niż lub równa określonej liczbie całkowitej. operator: LessThanOrEqual i negateCondition: true
Nie większe niż lub równe Pasuje, gdy długość wartości nie jest większa lub równa określonej liczbie całkowitej. operator: GreaterThanOrEqual i negateCondition: true
Nie zaczyna się od Dopasuje, gdy wartość nie zaczyna się od określonego ciągu. operator: BeginsWith i negateCondition: true
Nie kończy się na Pasuje, gdy wartość nie kończy się określonym ciągiem. operator: EndsWith i negateCondition: true
Nie jest RegEx Pasuje, gdy wartość nie jest zgodna z określonym wyrażeniem regularnym. Aby uzyskać więcej informacji, zobacz poniżej. operator: RegEx i negateCondition: true

Wskazówka

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żeń.
  • Dowolne asercji o zerowej szerokości.
  • Odwołania do podprogramów i wzorce rekurencyjne.
  • Wzorce warunkowe.
  • Czasowniki kontrolek wycofywania.
  • Dyrektywa jedno bajtowa \C .
  • Dyrektywa dopasowywania nowej linii \R.
  • \K Dyrektywa rozpoczynająca reset dopasowania.
  • Komunikaty i osadzony kod.
  • Atomowe grupowanie i kwantyfikatory zachłanne.

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łć Opis Obsługa szablonów ARM
Zmiana na małe litery Konwertuje ciąg na małe litery. Lowercase
Do wielkich liter Konwertuje ciąg na wielkie litery. Uppercase
Przycinanie Usuwa wiodące i końcowe spacje z ciągu. Trim
Usuń wartości null Usuwa wartości null z ciągu. RemoveNulls
Kodowanie adresu URL Ciąg jest kodowany w formacie URL. UrlEncode
Dekodowanie adresu URL Dekoduje ciąg znaków z formatu URL. UrlDecode

Następne kroki

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