Azure Front Door voorwaarden voor overeenkomst van regels

In Azure Front Door en Azure Front Door Standard/Premium Rule Setbestaat een regel uit geen of een aantal voorwaarden voor overeenkomst en een actie. Dit artikel bevat gedetailleerde beschrijvingen van voorwaarden voor overeenkomst die u kunt gebruiken in Azure Front Door regelset of regelst engine.

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 voorwaarden van overeenkomst die ondersteuning bieden voor meerdere waarden, wordt OR-logica gebruikt.

U kunt een voorwaarde voor overeenkomst gebruiken om het volgende te doen:

• Aanvragen filteren op basis van een specifiek IP-adres, specifiek land of specifieke regio.
• Aanvragen filteren op headergegevens.
• Aanvragen filteren van mobiele apparaten of desktopapparaten.
• Filter aanvragen van de bestandsnaam en bestandsextensie van de aanvraag.
• Filter aanvragen van aanvraag-URL, protocol, pad, queryreeks, post args, enzovoort.

Apparaattype

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

Eigenschappen

Voorbeeld

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

{
  "name": "IsDevice",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "Mobile"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleIsDeviceConditionParameters"
  }
}

{
  name: 'IsDevice'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'Mobile'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleIsDeviceConditionParameters'
  }
}

Post args

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

Eigenschappen

Voorbeeld

In dit voorbeeld komen we overeen met alle POST-aanvragen waarbij een argument is opgegeven in de aanvraag body en waarbij de waarde van customerName begint met de letter of customerName J K . We gebruiken een casetransformator om de invoerwaarden te converteren naar hoofdletters, zodat waarden die beginnen J met , , en allemaal j K k overeenkomen.

{
  "name": "PostArgs",
  "parameters": {
    "selector": "customerName",
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
        "J",
        "K"
    ],
    "transforms": [
        "Uppercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRulePostArgsConditionParameters"
}

{
  name: 'PostArgs'
  parameters: {
    selector: 'customerName'
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'J'
      'K'
    ]
    transforms: [
      'Uppercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRulePostArgsConditionParameters'
  }
}

Queryreeksen

Gebruik de voorwaarde voor overeenkomst van queryreeks om aanvragen te identificeren die een specifieke queryreeks bevatten. U kunt meerdere waarden opgeven die overeenkomen, die worden gecombineerd met behulp van OR-logica.

Eigenschappen

Voorbeeld

In dit voorbeeld komen we overeen met alle aanvragen waarbij de queryreeks de tekenreeks language=en-US bevat. We willen dat de voorwaarde voor overeenkomst casegevoelig is, dus we transformeren de case niet.

{
  "name": "QueryString",
  "parameters": {
    "operator": "Contains",
    "negateCondition": false,
    "matchValues": [
      "language=en-US"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleQueryStringConditionParameters"
  }
}

{
  name: 'QueryString'
  parameters: {
    operator: 'Contains'
    negateCondition: false
    matchValues: [
      'language=en-US'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleQueryStringConditionParameters'
  }
}

Extern adres

De overeenkomstvoorwaarde voor het externe adres identificeert aanvragen op basis van de locatie of het IP-adres van de aanvraag. U kunt meerdere waarden opgeven die overeenkomen, die worden gecombineerd met behulp van OR-logica.

• 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: komt overeen met aanvragen die afkomstig zijn van de adressen 5.5.5.64/26 5.5.5.64 tot en met 5.5.5.127.
  • IPv6-voorbeeld: komt overeen met aanvragen die afkomstig zijn van adressen 1:2:3:/48 1:2:3:0:0:0:0:0 tot en met 1:2:3: 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 en toevoegt, wordt de voorwaarde afgestemd op aanvragen die afkomstig zijn van adres 1.2.3.4 10.20.30.40 1.2.3.4 of 10.20.30.40.
  • IPv6-voorbeeld: als u twee IP-adressen en toevoegt, wordt de voorwaarde afgestemd op aanvragen die afkomstig zijn van een van beide adressen 1:2:3:4:5:6:7:8 10:20:30:40:50:60:70:80 1:2:3:4:5:6:7:8 of 10:20:30:40:50:60:70:80.
• Extern adres vertegenwoordigt het oorspronkelijke client-IP-adres dat afkomstig is van de netwerkverbinding of meestal de aanvraagheader X-Forwarded-For als de gebruiker zich achter een proxy- of proxy-header voor houdt.

Eigenschappen

Voorbeeld

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

{
  "name": "RemoteAddress",
  "parameters": {
    "operator": "GeoMatch",
    "negateCondition": true,
    "matchValues": [
      "US"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters"
  }
}

{
  name: 'RemoteAddress'
  parameters: {
    operator: 'GeoMatch'
    negateCondition: true
    matchValues: [
      'US'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters'
  }
}

Aanvraagbody

De voorwaarde voor de overeenkomst van de aanvraagtekst identificeert aanvragen op basis van specifieke tekst die wordt weergegeven in de aanvraagtekst. U kunt meerdere waarden opgeven die overeenkomen, die worden gecombineerd met behulp van OR-logica.

Eigenschappen

Voorbeeld

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

{
  "name": "RequestBody",
  "parameters": {
    "operator": "Contains",
    "negateCondition": false,
    "matchValues": [
      "ERROR"
    ],
    "transforms": [
      "Uppercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestBodyConditionParameters"
  }
}

{
  name: 'RequestBody'
  parameters: {
    operator: 'Contains'
    negateCondition: false
    matchValues: [
      'ERROR'
    ]
    transforms: [
      'Uppercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestBodyConditionParameters'
  }
}

Bestandsnaam van aanvraag

De voorwaarde voor de overeenkomst van de aanvraagbestandsnaam identificeert aanvragen die de opgegeven bestandsnaam in de aanvraag-URL bevatten. U kunt meerdere waarden opgeven die overeenkomen, die worden gecombineerd met behulp van OR-logica.

Eigenschappen

Voorbeeld

In dit voorbeeld komen we overeen met alle aanvragen waarbij de naam van het aanvraagbestand media.mp4 is. We transformeren de bestandsnaam naar kleine letters voordat we de overeenkomst evalueren, dus ook andere MEDIA.MP4 hoofdlettervariaties activeren deze overeenkomstvoorwaarde.

{
  "name": "UrlFileName",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "media.mp4"
    ],
    "transforms": [
      "Lowercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFilenameConditionParameters"
  }
}

{
  name: 'UrlFileName'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'media.mp4'
    ]
    transforms: [
      'Lowercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFilenameConditionParameters'
  }
}

Bestandsextensie aanvragen

De voorwaarde voor de overeenkomst van de bestandsextensie van de aanvraag identificeert aanvragen die de opgegeven bestandsextensie bevatten in de bestandsnaam in de aanvraag-URL. U kunt meerdere waarden opgeven die overeenkomen, die worden gecombineerd met behulp van OR-logica.

Eigenschappen

Voorbeeld

In dit voorbeeld komen we overeen met alle aanvragen waarbij de aanvraagbestandsextensie pdf of docx is. We transformeren de aanvraagbestandsextensie naar kleine letters voordat we de overeenkomst evalueren, zodat , en andere casevariaties ook PDF DocX deze overeenkomstvoorwaarde activeren.

{
  "name": "UrlFileExtension",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "pdf",
      "docx"
    ],
    "transforms": [
      "Lowercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFileExtensionMatchConditionParameters"
  }

{
  name: 'UrlFileExtension'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'pdf'
      'docx'
    ]
    transforms: [
      'Lowercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFileExtensionMatchConditionParameters'
  }
}

Aanvraagheader

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

Eigenschappen

Voorbeeld

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

{
  "name": "RequestHeader",
  "parameters": {
    "selector": "MyCustomHeader",
    "operator": "Any",
    "negateCondition": false,
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestHeaderConditionParameters"
  }
}

{
  name: 'RequestHeader'
  parameters: {
    selector: 'MyCustomHeader',
    operator: 'Any'
    negateCondition: false
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestHeaderConditionParameters'
  }
}

Aanvraagmethode

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

Eigenschappen

Voorbeeld

In dit voorbeeld komen we overeen met alle aanvragen waarbij de aanvraag de methode DELETE gebruikt.

{
  "name": "RequestMethod",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "DELETE"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestMethodConditionParameters"
  }
}

{
  name: 'RequestMethod'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'DELETE
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestMethodConditionParameters'
  }
}

Aanvraagpad

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

Eigenschappen

Voorbeeld

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

{
  "name": "UrlPath",
  "parameters": {
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
      "files/secure/"
    ],
    "transforms": [
      "Lowercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlPathMatchConditionParameters"
  }
}

{
  name: 'UrlPath'
  parameters: {
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'files/secure/'
    ]
    transforms: [
      'Lowercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlPathMatchConditionParameters'
  }
}

Aanvraagprotocol

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

Eigenschappen

Voorbeeld

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

{
  "name": "RequestScheme",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "HTTP"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestSchemeConditionParameters"
  }
}

{
  name: 'RequestScheme'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'HTTP
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestSchemeConditionParameters'
  }
}

Aanvraag-URL

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

Eigenschappen

Voorbeeld

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 en andere casevariaties https://api.contoso.com/Customers/123 deze overeenkomstvoorwaarde ook activeren.

{
  "name": "RequestUri",
  "parameters": {
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
      "https://api.contoso.com/customers/123"
    ],
    "transforms": [
      "Lowercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestUriConditionParameters"
  }
}

{
  name: 'RequestUri'
  parameters: {
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'https://api.contoso.com/customers/123'
    ]
    transforms: [
      'Lowercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestUriConditionParameters'
  }
}

Lijst met operatoren

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

Reguliere expressies

Reguliere expressies bieden geen ondersteuning voor de volgende bewerkingen:

• Backreferences en het vastleggen van subexpressies.
• Willekeurige beweringen met een breedte van nul.
• Subroutineverwijzingen en recursieve patronen.
• Voorwaardelijke patronen.
• Backtracking van werkwoorden voor besturingselementen.
• De \C single-byte-richtlijn.
• De \R newline match-richtlijn.
• Het \K begin van de match reset-richtlijn.
• Bijroepen en ingesloten code.
• Atomische groepering en bezittige kwantifiers.

Volgende stappen

Azure Front Door:

• Meer informatie over Azure Front Door-engine
• Meer informatie over het configureren van uw eerste engine voor regels.
• Meer informatie over regelengine-acties

Azure Front Door Standard/Premium:

• Meer informatie over Azure Front Door Standard/Premium Rule Set.
• Meer informatie over het configureren van uw eerste regelset.
• Meer informatie over regelsetacties.