Voorwaarden voor regelsovereenkomst

In Azure Front Door-regelsets bestaat een regel uit geen of enkele overeenkomstvoorwaarden en een actie. Dit artikel bevat gedetailleerde beschrijvingen van voorwaarden voor overeenkomsten die u kunt gebruiken in Azure Front Door-regelsets.

Belangrijk

Azure Front Door (klassiek) wordt op 31 maart 2027 buiten gebruik gesteld. Om serviceonderbrekingen te voorkomen, is het belangrijk dat u uw Azure Front Door-profielen (klassiek) tegen maart 2027 migreert naar de Azure Front Door Standard- of Premium-laag. Zie De buitengebruikstelling van Azure Front Door (klassiek) voor meer informatie.

In azure Front Door-regelengines (klassiek) bestaat een regel uit geen of enkele overeenkomstvoorwaarden en een actie. Dit artikel bevat gedetailleerde beschrijvingen van voorwaarden voor overeenkomsten die u kunt gebruiken in azure Front Door-regelengines (klassiek).

Het eerste deel van een regel is een voorwaarde van overeenkomst of een set voorwaarden van overeenkomst. Een regel kan uit maximaal 10 voorwaarden van overeenkomst bestaan. Een voorwaarde van overeenkomst identificeert specifieke typen aanvragen waarvoor gedefinieerde acties worden uitgevoerd. Als u meerdere voorwaarden van overeenkomst gebruikt, worden de voorwaarden van overeenkomst samen gegroepeerd met behulp van EN-logica. Voor alle overeenkomstvoorwaarden die meerdere waarden ondersteunen, wordt OR-logica gebruikt.

U kunt een overeenkomstvoorwaarde gebruiken om het volgende te doen:

  • Filter aanvragen op basis van een specifiek IP-adres, poort of land/regio.
  • Aanvragen filteren op headergegevens.
  • Aanvragen filteren van mobiele apparaten of desktopapparaten.
  • Filter aanvragen uit de bestandsnaam en de bestandsextensie van de aanvraag.
  • Filter aanvragen op hostnaam, SSL-protocol, aanvraag-URL, protocol, pad, queryreeks, post args en andere waarden.
  • Filter aanvragen op basis van een specifiek IP-adres of land/regio.
  • Aanvragen filteren op headergegevens.
  • Aanvragen filteren van mobiele apparaten of desktopapparaten.
  • Filter aanvragen uit de bestandsnaam en de bestandsextensie van de aanvraag.
  • Filter aanvragen op aanvraag-URL, protocol, pad, querytekenreeks, postargumenten en andere waarden.

Apparaattype

Gebruik de voorwaarde voor overeenkomst van het apparaattype om aanvragen te identificeren die afkomstig zijn van een mobiel apparaat of desktopapparaat.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator
  • In Azure Portal: Equal, Not Equal
  • In ARM-sjablonen: Equal; gebruik de negateCondition eigenschap om Niet gelijk aan op te geven
Weergegeven als Mobile, Desktop

Opmerking

In dit voorbeeld komen alle aanvragen overeen die zijn gedetecteerd als afkomstig van een mobiel apparaat.

Schermafbeelding van de portal met de voorwaarde voor overeenkomst van apparaattype.

HTTP-versie

Gebruik de voorwaarde voor overeenkomst met de HTTP-versie om aanvragen te identificeren die worden gedaan met behulp van een specifieke versie van het HTTP-protocol.

Notitie

De voorwaarde voor overeenkomst met DE HTTP-versie is alleen beschikbaar in Azure Front Door Standard/Premium.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator
  • In Azure Portal: Equal, Not Equal
  • In ARM-sjablonen: Equal; gebruik de negateCondition eigenschap om Niet gelijk aan op te geven
Weergegeven als 2.0, , , 1.11.00.9

Opmerking

In dit voorbeeld komen alle aanvragen overeen die zijn verzonden met behulp van het HTTP 2.0-protocol.

Schermafbeelding van de portal met de voorwaarde voor overeenkomst van HTTP-versie.

Cookies aanvragen

Gebruik de voorwaarde voor het matchen van aanvraagcookies om aanvragen te identificeren die een specifieke cookie bevatten.

Notitie

De voorwaarde voor overeenkomst tussen aanvraagcookies is alleen beschikbaar in Azure Front Door Standard/Premium.

Eigenschappen

Eigenschappen Ondersteunde waarden
Cookienaam Een tekenreekswaarde die de naam van de cookie aangeeft.
Operator Elke operator uit de lijst met standaardoperators.
Weergegeven als Een of meer tekenreeks- of gehele getallen die de waarde van de aanvraagheader vertegenwoordigen die overeenkomen. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.
Transformatie van hoofdletters en kleine letters Elke transformatie uit de lijst met standaardreekstransformaties.

Opmerking

In dit voorbeeld komen we overeen met alle aanvragen met een cookie met deploymentStampId een naam van 1.

Schermafbeelding van de portal met de voorwaarde voor het vergelijken van aanvragen van cookies.

Post args

Gebruik de voorwaarde voor overeenkomst tussen postargumenten om aanvragen te identificeren op basis van de argumenten die zijn opgegeven in de hoofdtekst van een POST-aanvraag. Eén overeenkomstvoorwaarde komt overeen met één argument uit de hoofdtekst van de POST-aanvraag. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Notitie

De post args match condition werkt met het application/x-www-form-urlencoded inhoudstype.

Eigenschappen

Eigenschappen Ondersteunde waarden
Post args Een tekenreekswaarde die de naam van het ARGUMENT POST vertegenwoordigt.
Operator Elke operator uit de lijst met standaardoperators.
Weergegeven als Een of meer tekenreeks- of gehele getallen die de waarde van het POST-argument vertegenwoordigen die overeenkomen. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.
Transformatie van hoofdletters en kleine letters Elke transformatie uit de lijst met standaardreekstransformaties.

Opmerking

In dit voorbeeld komen alle POST-aanvragen overeen waarbij een customerName argument wordt opgegeven in de hoofdtekst van de aanvraag en waar de waarde begint customerName met de letter J of K. We gebruiken een casetransformatie om de invoerwaarden te converteren naar hoofdletters, zodat waarden beginnen met J, jen kKallemaal overeenkomen.

Schermopname van een overeenkomstvoorwaarde voor post args.

Queryreeks

Gebruik de voorwaarde voor overeenkomst tussen queryreeksen om aanvragen te identificeren die een specifieke querytekenreeks bevatten. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Notitie

De volledige querytekenreeks wordt als één tekenreeks vergeleken, zonder de voorlooptekenreeks ?.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator Alle operators uit de lijst met standaardoperators worden ondersteund. De voorwaarde Elke overeenkomst komt echter overeen met elke aanvraag en de voorwaarde Geen overeenkomst komt niet overeen met een aanvraag, wanneer deze wordt gebruikt met de voorwaarde voor overeenkomst van de querytekenreeks .
Queryreeks Een of meer tekenreeks- of gehele getallen die de waarde van de querytekenreeks vertegenwoordigen die overeenkomen. Neem de aan het ? begin van de querytekenreeks niet op. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.
Transformatie van hoofdletters en kleine letters Elke transformatie uit de lijst met standaardreekstransformaties.

Opmerking

In dit voorbeeld komen alle aanvragen overeen waarbij de querytekenreeks de tekenreeks language=en-USbevat. We willen dat de overeenkomstvoorwaarde hoofdlettergevoelig is, dus we transformeren de case niet.

Schermopname van queryreeksovereenkomstvoorwaarde.

Extern adres

De voorwaarde voor overeenkomst met externe adressen identificeert aanvragen op basis van de locatie of het IP-adres van de aanvrager. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

  • Gebruik CIDR-notatie bij het opgeven van IP-adresblokken. De syntaxis voor een IP-adresblok is het basis-IP-adres, gevolgd door een slash en de grootte van het voorvoegsel. Bijvoorbeeld:
    • IPv4-voorbeeld: 5.5.5.64/26 komt overeen met alle aanvragen die afkomstig zijn van adressen 5.5.5.64 tot en met 5.5.5.127.
    • IPv6-voorbeeld: 1:2:3:/48 komt overeen met alle aanvragen die afkomstig zijn van adressen 1:2:3:0:0:0:0 tot en met 1:2:3: ffff:ffff:ffff:ffff:ffff:ffff.
  • Wanneer u meerdere IP-adressen en IP-adresblokken opgeeft, wordt OR-logica toegepast.
    • IPv4-voorbeeld: als u twee IP-adressen 1.2.3.4 toevoegt en 10.20.30.40de voorwaarde overeenkomt met alle aanvragen die afkomstig zijn van adres 1.2.3.4 of 10.20.30.40.
    • IPv6-voorbeeld: als u twee IP-adressen 1:2:3:4:5:6:7:8 toevoegt en 10:20:30:40:50:60:70:80de voorwaarde wordt vergeleken met aanvragen die afkomstig zijn van een van beide adressen 1:2:3:4:5:6:7:8 of 10:20:30:40:50:60:70:80.
  • Het externe adres vertegenwoordigt het oorspronkelijke client-IP-adres dat afkomstig is van de netwerkverbinding of doorgaans de header X-Forwarded-For-aanvraag als de gebruiker zich achter een proxy bevindt. Gebruik de voorwaarde voor overeenkomst met socketadressen (beschikbaar in Standard/Premium) als u wilt overeenkomen op basis van het IP-adres van de TCP-aanvraag.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator
  • In Azure Portal: Geo Match, Geo Not Match, of IP MatchIP Not Match
  • In ARM-sjablonen: GeoMatch, IPMatch; gebruik de negateCondition eigenschap om Geo Not Match of IP Not Match op te geven
Weergegeven als
  • Voor de IP Match of IP Not Match operators: geef een of meer IP-adresbereiken op. Als er meerdere IP-adresbereiken zijn opgegeven, worden deze geëvalueerd met behulp van OR-logica.
  • Voor de Geo Match of Geo Not Match operators: geef een of meer locaties op met behulp van hun landcode.

Opmerking

In dit voorbeeld komen alle aanvragen overeen waarbij de aanvraag niet afkomstig is van de Verenigde Staten.

Schermopname van de voorwaarde voor overeenkomst met externe adressen.

Aanvraagtekst

De overeenkomstvoorwaarde van de aanvraagtekst identificeert aanvragen op basis van specifieke tekst die wordt weergegeven in de hoofdtekst van de aanvraag. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Notitie

Als een aanvraagbody groter is dan 64 kB, wordt alleen de eerste 64 kB in aanmerking genomen voor de voorwaarde van de overeenkomst van de aanvraagbody .

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator Alle operators uit de lijst met standaardoperators worden ondersteund. De voorwaarde Elke overeenkomst komt echter overeen met elke aanvraag en de voorwaarde Geen overeenkomst komt niet overeen met een aanvraag, wanneer deze wordt gebruikt met de voorwaarde voor overeenkomst van de aanvraagbody .
Weergegeven als Een of meer tekenreeks- of gehele getallen die de waarde van de hoofdtekst van de aanvraag vertegenwoordigen die overeenkomen. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.
Transformatie van hoofdletters en kleine letters Elke transformatie uit de lijst met standaardreekstransformaties.

Opmerking

In dit voorbeeld komen alle aanvragen overeen waarbij de hoofdtekst van de aanvraag de tekenreeks ERRORbevat. We transformeren de hoofdtekst van de aanvraag naar hoofdletters voordat we de overeenkomst evalueren, dus error andere casevariaties activeren deze overeenkomstvoorwaarde ook.

Schermopname van de voorwaarde voor overeenkomst van aanvraagbody.

Bestandsnaam van aanvraag

De overeenkomstvoorwaarde van het aanvraagbestand identificeert aanvragen die de opgegeven bestandsnaam in de aanvraag-URL bevatten. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator Alle operators uit de lijst met standaardoperators worden ondersteund. De voorwaarde Elke overeenkomst komt echter overeen met elke aanvraag en de voorwaarde Geen overeenkomst komt niet overeen met een aanvraag, wanneer deze wordt gebruikt met de voorwaarde voor overeenkomst met de bestandsnaam van de aanvraag.
Weergegeven als Een of meer tekenreeks- of gehele getallen die de waarde van de naam van het aanvraagbestand vertegenwoordigen die overeenkomen. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.
Transformatie van hoofdletters en kleine letters Elke transformatie uit de lijst met standaardreekstransformaties.

Opmerking

In dit voorbeeld komen we overeen met alle aanvragen waarbij de bestandsnaam van de aanvraag is media.mp4. We transformeren de bestandsnaam in kleine letters voordat we de overeenkomst evalueren, dus MEDIA.MP4 met andere hoofdletters wordt deze overeenkomstvoorwaarde ook geactiveerd.

Schermopname van voorwaarde voor overeenkomst van aanvraagbestandsbestand.

Bestandsextensie aanvragen

De overeenkomstvoorwaarde van de aanvraagbestandsextensie identificeert aanvragen die de opgegeven bestandsextensie bevatten in de bestandsnaam in de aanvraag-URL. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Notitie

Neem geen voorloopperiode op. Gebruik bijvoorbeeld html in plaats van .html.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator Alle operators uit de lijst met standaardoperators worden ondersteund. De voorwaarde Elke overeenkomst komt echter overeen met elke aanvraag en de voorwaarde Niet elke overeenkomst komt niet overeen met een aanvraag, wanneer deze wordt gebruikt met de voorwaarde voor overeenkomst met de bestandsextensie van de aanvraag.
Weergegeven als Een of meer tekenreeks- of gehele getallen die de waarde van de bestandsextensie van de aanvraag vertegenwoordigen die overeenkomen. Neem geen voorloopperiode op. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.
Transformatie van hoofdletters en kleine letters Elke transformatie uit de lijst met standaardreekstransformaties.

Opmerking

In dit voorbeeld komen we overeen met alle aanvragen waarbij de bestandsextensie van de aanvraag is pdf of docx. We transformeren de bestandsextensie van de aanvraag naar kleine letters voordat we de overeenkomst evalueren, dus PDF, DocXen andere casevariaties activeren ook deze overeenkomstvoorwaarde.

Schermopname van de voorwaarde voor overeenkomst van aanvraagbestandsextensie.

Aanvraagheader

De voorwaarde voor overeenkomst tussen aanvraagheaders identificeert aanvragen die een specifieke header in de aanvraag bevatten. U kunt deze overeenkomstvoorwaarde gebruiken om te controleren of er een header bestaat of om te controleren of de header overeenkomt met een opgegeven waarde. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Eigenschappen

Eigenschappen Ondersteunde waarden
Headernaam Een tekenreekswaarde die de naam van het ARGUMENT POST vertegenwoordigt.
Operator Elke operator uit de lijst met standaardoperators.
Weergegeven als Een of meer tekenreeks- of gehele getallen die de waarde van de aanvraagheader vertegenwoordigen die overeenkomen. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.
Transformatie van hoofdletters en kleine letters Elke transformatie uit de lijst met standaardreekstransformaties.

Opmerking

In dit voorbeeld komen alle aanvragen overeen waarbij de aanvraag een header met de naam MyCustomHeaderbevat, ongeacht de waarde.

Schermopname van de voorwaarde voor overeenkomst van aanvraagheader.

Aanvraagmethode

De voorwaarde voor overeenkomst van de aanvraagmethode identificeert aanvragen die gebruikmaken van de opgegeven HTTP-aanvraagmethode. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator
  • In Azure Portal: Equal, Not Equal
  • In ARM-sjablonen: Equal; gebruik de negateCondition eigenschap om Niet gelijk aan op te geven
Aanvraagmethode Een of meer HTTP-methoden van: GET, POST, PUT, DELETE, HEAD, , OPTIONS. TRACE Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.

Opmerking

In dit voorbeeld komen alle aanvragen overeen waarbij de aanvraag gebruikmaakt van de DELETE methode.

Schermopname van de voorwaarde voor overeenkomst van aanvraagmethode.

Aanvraagpad

De overeenkomstvoorwaarde van het aanvraagpad identificeert aanvragen die het opgegeven pad in de aanvraag-URL bevatten. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Notitie

Het pad is het deel van de URL na de hostnaam en een slash. In de URL https://www.contoso.com/files/secure/file1.pdfis files/secure/file1.pdfhet pad bijvoorbeeld .

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator
  • Alle operators uit de lijst met standaardoperators worden ondersteund. De voorwaarde Elke overeenkomst komt echter overeen met elke aanvraag en de voorwaarde Geen overeenkomst komt niet overeen met een aanvraag, wanneer deze wordt gebruikt met de voorwaarde voor overeenkomst met het aanvraagpad .
  • Jokerteken: komt overeen wanneer het aanvraagpad overeenkomt met een jokertekenexpressie. Een jokertekenexpressie kan het * teken bevatten dat overeenkomt met nul of meer tekens in het pad. De expressie files/customer*/file.pdf met jokertekens komt bijvoorbeeld overeen met de paden files/customer1/file.pdfen files/customer109/file.pdffiles/customer/file.pdfkomt niet overeen, maar komt niet overeenfiles/customer2/anotherfile.pdf.
    • In Azure Portal: Wildcards, Not Wildcards
    • In ARM-sjablonen: Wildcard; gebruik de negateCondition eigenschap om geen jokertekens op te geven
Weergegeven als Een of meer tekenreeks- of gehele getallen die de waarde van het aanvraagpad vertegenwoordigen die overeenkomen. Als u een voorloopslash opgeeft, wordt deze genegeerd. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.
Transformatie van hoofdletters en kleine letters Elke transformatie uit de lijst met standaardreekstransformaties.
Eigenschappen Ondersteunde waarden
Operator Alle operators uit de lijst met standaardoperators worden ondersteund. De voorwaarde Elke overeenkomst komt echter overeen met elke aanvraag en de voorwaarde Geen overeenkomst komt niet overeen met een aanvraag, wanneer deze wordt gebruikt met de voorwaarde voor overeenkomst met het aanvraagpad .
Weergegeven als Een of meer tekenreeks- of gehele getallen die de waarde van het aanvraagpad vertegenwoordigen die overeenkomen. Als u een voorloopslash opgeeft, wordt deze genegeerd. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.
Transformatie van hoofdletters en kleine letters Elke transformatie uit de lijst met standaardreekstransformaties.

Opmerking

In dit voorbeeld komen we overeen met alle aanvragen waarbij het pad naar het aanvraagbestand begint.files/secure/ We transformeren de bestandsextensie van de aanvraag naar kleine letters voordat we de overeenkomst evalueren, dus aanvragen naar files/SECURE/ en andere casevariaties activeren ook deze overeenkomstvoorwaarde.

Schermopname van voorwaarde voor overeenkomst van aanvraagpad.

Aanvraagprotocol

De voorwaarde voor overeenkomst van aanvraagprotocol identificeert aanvragen die gebruikmaken van het opgegeven protocol (HTTP of HTTPS).

Notitie

Protocol wordt ook wel schema genoemd.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator
  • In Azure Portal: Equal, Not Equal
  • In ARM-sjablonen: Equal; gebruik de negateCondition eigenschap om Niet gelijk aan op te geven
Aanvraagmethode HTTP, HTTPS

Opmerking

In dit voorbeeld komen alle aanvragen overeen waarbij de aanvraag gebruikmaakt van het HTTP protocol.

Schermopname van voorwaarde voor overeenkomst van aanvraagprotocol.

Aanvraag-URL

Hiermee worden aanvragen geïdentificeerd die overeenkomen met de opgegeven URL. De volledige URL wordt geëvalueerd, inclusief het protocol en de querytekenreeks, maar niet het fragment. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Tip

Wanneer u deze regelvoorwaarde gebruikt, moet u het protocol en een afsluitende slash /opnemen. Gebruik bijvoorbeeld https://www.contoso.com/ in plaats van alleen www.contoso.com.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator Alle operators uit de lijst met standaardoperators worden ondersteund. De voorwaarde Elke overeenkomst komt echter overeen met elke aanvraag en de voorwaarde Geen overeenkomst komt niet overeen met een aanvraag, wanneer deze wordt gebruikt met de voorwaarde voor overeenkomst van de aanvraag-URL .
Weergegeven als Een of meer tekenreeks- of gehele getallen die de waarde van de aanvraag-URL vertegenwoordigen die overeenkomen. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.
Transformatie van hoofdletters en kleine letters Elke transformatie uit de lijst met standaardreekstransformaties.

Opmerking

In dit voorbeeld komen we overeen met alle aanvragen waarbij de aanvraag-URL begint met https://api.contoso.com/customers/123. We transformeren de bestandsextensie van de aanvraag naar kleine letters voordat we de overeenkomst evalueren, zodat aanvragen naar https://api.contoso.com/Customers/123 en andere casevariaties ook deze overeenkomstvoorwaarde activeren.

Schermopname van aanvraag-URL-overeenkomstvoorwaarde.

Hostnaam

De voorwaarde hostnaamovereenkomst identificeert aanvragen op basis van de opgegeven hostnaam in de aanvraag van de client. De overeenkomstvoorwaarde gebruikt de Host headerwaarde om de hostnaam te evalueren. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator Alle operators uit de lijst met standaardoperators worden ondersteund. De voorwaarde Elke overeenkomst komt echter overeen met elke aanvraag en de voorwaarde Geen overeenkomst komt niet overeen met een aanvraag, wanneer deze wordt gebruikt met de voorwaarde voor overeenkomst met de hostnaam .
Weergegeven als Een of meer tekenreekswaarden die de waarde van de hostnaam van de aanvraag vertegenwoordigen die overeenkomen. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.
Transformatie van hoofdletters en kleine letters Elke casetransformatie vanuit de lijst met standaardreekstransformaties.

Opmerking

In dit voorbeeld komen alle aanvragen overeen met een Host header die eindigt op contoso.com.

Schermopname van de voorwaarde hostnaamovereenkomst.

SSL-protocol

De voorwaarde voor overeenkomst van het SSL-protocol identificeert aanvragen op basis van het SSL-protocol van een tot stand gebrachte TLS-verbinding. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator
  • In Azure Portal: Equal, Not Equal
  • In ARM-sjablonen: Equal; gebruik de negateCondition eigenschap om Niet gelijk aan op te geven
SSL-protocol
  • In Azure Portal: 1.0, 1.11.2
  • In ARM-sjablonen: TLSv1, TLSv1.1TLSv1.2

Opmerking

In dit voorbeeld komen alle aanvragen overeen die gebruikmaken van het TLS 1.2-protocol.

Schermopname van ssl-protocolovereenkomst.

Socketadres

De voorwaarde voor overeenkomst met socketadressen identificeert aanvragen op basis van het IP-adres van de directe verbinding met Azure Front Door Edge. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Notitie

Als de client een HTTP-proxy of een load balancer heeft gebruikt om de aanvraag te verzenden, is het socketadres het IP-adres van de proxy of load balancer.

Gebruik de voorwaarde voor overeenkomst met externe adressen als u moet overeenkomen op basis van het oorspronkelijke IP-adres van de client.

  • Gebruik CIDR-notatie bij het opgeven van IP-adresblokken. Dit betekent dat de syntaxis voor een IP-adresblok het basis-IP-adres is, gevolgd door een slash en de grootte van het voorvoegsel. Bijvoorbeeld:
    • IPv4-voorbeeld: 5.5.5.64/26 komt overeen met alle aanvragen die afkomstig zijn van adressen 5.5.5.64 tot en met 5.5.5.127.
    • IPv6-voorbeeld: 1:2:3:/48 komt overeen met alle aanvragen die afkomstig zijn van adressen 1:2:3:0:0:0:0 tot en met 1:2:3: ffff:ffff:ffff:ffff:ffff:ffff.
  • Wanneer u meerdere IP-adressen en IP-adresblokken opgeeft, wordt OR-logica toegepast.
    • IPv4-voorbeeld: als u twee IP-adressen 1.2.3.4 toevoegt en 10.20.30.40de voorwaarde overeenkomt met alle aanvragen die afkomstig zijn van adres 1.2.3.4 of 10.20.30.40.
    • IPv6-voorbeeld: als u twee IP-adressen 1:2:3:4:5:6:7:8 toevoegt en 10:20:30:40:50:60:70:80de voorwaarde wordt vergeleken met aanvragen die afkomstig zijn van een van beide adressen 1:2:3:4:5:6:7:8 of 10:20:30:40:50:60:70:80.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator
  • In Azure Portal: IP Match, Not IP Match
  • In ARM-sjablonen: IPMatch; gebruik de negateCondition eigenschap om Geen IP-overeenkomst op te geven
Weergegeven als Geef een of meer IP-adresbereiken op. Als er meerdere IP-adresbereiken zijn opgegeven, worden deze geëvalueerd met behulp van OR-logica.

Opmerking

In dit voorbeeld komen alle aanvragen van IP-adressen in het bereik 5.5.5.64/26 overeen.

Schermopname van de voorwaarde voor overeenkomst met socketadres.

Clientpoort

De voorwaarde voor overeenkomst van clientpoort identificeert aanvragen op basis van de TCP-poort van de client die de aanvraag heeft ingediend. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator Alle operators uit de lijst met standaardoperators worden ondersteund. De voorwaarde Elke overeenkomst komt echter overeen met elke aanvraag en de voorwaarde Geen overeenkomst komt niet overeen met een aanvraag, wanneer deze wordt gebruikt met de voorwaarde van de clientpoortovereenkomst .
Weergegeven als Een of meer poortnummers, uitgedrukt als gehele getallen. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.

Opmerking

In dit voorbeeld komen alle aanvragen overeen met een clientpoort van 1234.

Schermopname van voorwaarde voor overeenkomst van clientpoort.

Serverpoort

De voorwaarde voor overeenkomst van de serverpoort identificeert aanvragen op basis van de TCP-poort van de Azure Front Door-server die de aanvraag heeft geaccepteerd. De poort moet 80 of 443 zijn. U kunt meerdere waarden opgeven die overeenkomen, die kunnen worden gecombineerd met OR-logica.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator Alle operators uit de lijst met standaardoperators worden ondersteund. De voorwaarde Elke overeenkomst komt echter overeen met elke aanvraag en de voorwaarde Geen overeenkomst komt niet overeen met een aanvraag, wanneer deze wordt gebruikt met de voorwaarde voor overeenkomst op de serverpoort .
Weergegeven als Een poortnummer, dat 80 of 443 moet zijn. Als er meerdere waarden zijn opgegeven, worden ze geëvalueerd met behulp van OR-logica.

Opmerking

In dit voorbeeld komen alle aanvragen overeen met een serverpoort van 443.

Schermopname van de voorwaarde serverpoortovereenkomst.

Lijst met operatoren

De volgende operators zijn geldig voor regels die waarden accepteren van de lijst met standaardoperators:

Operator Beschrijving Ondersteuning voor ARM-sjablonen
Alle Komt overeen wanneer er een waarde is, ongeacht wat het is. operator: Any
Is gelijk aan Komt overeen wanneer de waarde exact overeenkomt met de opgegeven tekenreeks. operator: Equal
Contains Komt overeen wanneer de waarde de opgegeven tekenreeks bevat. operator: Contains
Kleiner dan Komt overeen wanneer de lengte van de waarde kleiner is dan het opgegeven gehele getal. operator: LessThan
Greater Than Komt overeen wanneer de lengte van de waarde groter is dan het opgegeven gehele getal. operator: GreaterThan
Kleiner dan of gelijk aan Komt overeen wanneer de lengte van de waarde kleiner is dan of gelijk is aan het opgegeven gehele getal. operator: LessThanOrEqual
Groter dan of gelijk aan Komt overeen wanneer de lengte van de waarde groter is dan of gelijk is aan het opgegeven gehele getal. operator: GreaterThanOrEqual
Begint met Komt overeen wanneer de waarde begint met de opgegeven tekenreeks. operator: BeginsWith
Eindigt op Komt overeen wanneer de waarde eindigt op de opgegeven tekenreeks. operator: EndsWith
Geen Komt overeen wanneer er geen waarde is. operator: Any en negateCondition : true
Is niet gelijk aan Komt overeen wanneer de waarde niet overeenkomt met de opgegeven tekenreeks. operator: Equal en negateCondition : true
Bevat geen Komt overeen wanneer de waarde niet de opgegeven tekenreeks bevat. operator: Contains en negateCondition : true
Niet kleiner dan Komt overeen wanneer de lengte van de waarde niet kleiner is dan het opgegeven gehele getal. operator: LessThan en negateCondition : true
Niet groter dan Komt overeen wanneer de lengte van de waarde niet groter is dan het opgegeven gehele getal. operator: GreaterThan en negateCondition : true
Niet kleiner dan of gelijk aan Komt overeen wanneer de lengte van de waarde niet kleiner is dan of gelijk is aan het opgegeven gehele getal. operator: LessThanOrEqual en negateCondition : true
Niet groter dan of gelijk aan Komt overeen wanneer de lengte van de waarde niet groter is dan of gelijk is aan het opgegeven gehele getal. operator: GreaterThanOrEqual en negateCondition : true
Begint niet met Komt overeen wanneer de waarde niet begint met de opgegeven tekenreeks. operator: BeginsWith en negateCondition : true
Niet eindigt met Komt overeen wanneer de waarde niet eindigt op de opgegeven tekenreeks. operator: EndsWith en negateCondition : true
Operator Beschrijving Ondersteuning voor ARM-sjablonen
Alle Komt overeen wanneer er een waarde is, ongeacht wat het is. operator: Any
Is gelijk aan Komt overeen wanneer de waarde exact overeenkomt met de opgegeven tekenreeks. operator: Equal
Contains Komt overeen wanneer de waarde de opgegeven tekenreeks bevat. operator: Contains
Kleiner dan Komt overeen wanneer de lengte van de waarde kleiner is dan het opgegeven gehele getal. operator: LessThan
Greater Than Komt overeen wanneer de lengte van de waarde groter is dan het opgegeven gehele getal. operator: GreaterThan
Kleiner dan of gelijk aan Komt overeen wanneer de lengte van de waarde kleiner is dan of gelijk is aan het opgegeven gehele getal. operator: LessThanOrEqual
Groter dan of gelijk aan Komt overeen wanneer de lengte van de waarde groter is dan of gelijk is aan het opgegeven gehele getal. operator: GreaterThanOrEqual
Begint met Komt overeen wanneer de waarde begint met de opgegeven tekenreeks. operator: BeginsWith
Eindigt op Komt overeen wanneer de waarde eindigt op de opgegeven tekenreeks. operator: EndsWith
RegEx Komt overeen wanneer de waarde overeenkomt met de opgegeven reguliere expressie. Zie hieronder voor meer informatie. operator: RegEx
Geen Komt overeen wanneer er geen waarde is. operator: Any en negateCondition : true
Is niet gelijk aan Komt overeen wanneer de waarde niet overeenkomt met de opgegeven tekenreeks. operator: Equal en negateCondition : true
Bevat geen Komt overeen wanneer de waarde niet de opgegeven tekenreeks bevat. operator: Contains en negateCondition : true
Niet kleiner dan Komt overeen wanneer de lengte van de waarde niet kleiner is dan het opgegeven gehele getal. operator: LessThan en negateCondition : true
Niet groter dan Komt overeen wanneer de lengte van de waarde niet groter is dan het opgegeven gehele getal. operator: GreaterThan en negateCondition : true
Niet kleiner dan of gelijk aan Komt overeen wanneer de lengte van de waarde niet kleiner is dan of gelijk is aan het opgegeven gehele getal. operator: LessThanOrEqual en negateCondition : true
Niet groter dan of gelijk aan Komt overeen wanneer de lengte van de waarde niet groter is dan of gelijk is aan het opgegeven gehele getal. operator: GreaterThanOrEqual en negateCondition : true
Begint niet met Komt overeen wanneer de waarde niet begint met de opgegeven tekenreeks. operator: BeginsWith en negateCondition : true
Niet eindigt met Komt overeen wanneer de waarde niet eindigt op de opgegeven tekenreeks. operator: EndsWith en negateCondition : true
Niet RegEx Komt overeen wanneer de waarde niet overeenkomt met de opgegeven reguliere expressie. Zie hieronder voor meer informatie. operator: RegEx en negateCondition : true

Tip

Voor numerieke operators zoals Kleiner dan en Groter dan of gelijk aan wordt de gebruikte vergelijking gebaseerd op lengte. De waarde in de overeenkomstvoorwaarde moet een geheel getal zijn dat de lengte aangeeft die u wilt vergelijken.

Reguliere expressies

Reguliere expressies bieden geen ondersteuning voor de volgende bewerkingen:

  • Backreferences en het vastleggen van subexpressies.
  • Willekeurige asserties met nul breedte.
  • Subroutineverwijzingen en recursieve patronen.
  • Voorwaardelijke patronen.
  • Backtracking control verbs.
  • De \C richtlijn met één byte.
  • De \R nieuwe regelovereenkomstrichtlijn.
  • De \K begindatum van de richtlijn voor het opnieuw instellen van overeenkomsten.
  • Bijschriften en ingesloten code.
  • Atomische groepering en bezitelijke kwantificatoren.

Lijst met tekenreekstransformaties

Voor regels die tekenreeksen kunnen transformeren, zijn de volgende transformaties geldig:

Transformeren Beschrijving Ondersteuning voor ARM-sjablonen
Kleine letters Converteert de tekenreeks naar de kleine letters. Lowercase
In hoofdletters Converteert de tekenreeks naar de hoofdletterweergave. Uppercase
Trim Trimt voorloop- en volgspaties uit de tekenreeks. Trim
Null-waarden verwijderen Verwijdert null-waarden uit de tekenreeks. RemoveNulls
URL-codering URL-codeert de tekenreeks. UrlEncode
URL-decoderen URL-decodeert de tekenreeks. UrlDecode

Volgende stappen

  • Meer informatie over de Regelengine van Azure Front Door (klassiek)
  • Meer informatie over het configureren van uw eerste regelengine.
  • Meer informatie over regelsacties