Condividi tramite


Condizioni di corrispondenza delle regole

Nei set di regole di Frontdoor di Azure una regola è costituita da nessuna o da alcune condizioni di corrispondenza e da un'azione. Questo articolo fornisce descrizioni dettagliate delle condizioni di corrispondenza che è possibile usare nei set di regole di Frontdoor di Azure.

Importante

Frontdoor di Azure (versione classica) verrà ritirato il 31 marzo 2027. Per evitare interruzioni del servizio, è importante eseguire la migrazione dei profili frontdoor di Azure (versione classica) al livello Frontdoor di Azure Standard o Premium entro marzo 2027. Per altre informazioni, vedere Ritiro di Frontdoor di Azure (versione classica).

Nei motori regole di Frontdoor di Azure (versione classica) una regola è costituita da nessuna o da alcune condizioni di corrispondenza e da un'azione. Questo articolo fornisce descrizioni dettagliate delle condizioni di corrispondenza che è possibile usare nei motori regole di Frontdoor di Azure (versione classica).

La prima parte di una regola è costituita da una o più condizioni di corrispondenza. Una regola può contenere fino a 10 condizioni di corrispondenza. Una condizione di corrispondenza identifica tipi specifici di richieste per cui vengono eseguite le azioni definite. Se si usano più condizioni di corrispondenza, verranno raggruppate insieme tramite la logica AND. Per tutte le condizioni di corrispondenza che supportano più valori, viene usata la logica OR.

È possibile usare una condizione di corrispondenza per:

  • Filtrare le richieste in base a un indirizzo IP, una porta, un Paese/un'area specifici.
  • Filtrare le richieste in base alle informazioni dell'intestazione.
  • Filtrare le richieste provenienti da dispositivi mobili o desktop.
  • Filtrare le richieste a partire dal nome e dall'estensione del file della richiesta.
  • Filtrare le richieste in base a nome host, protocollo SSL, URL della richiesta, protocollo, percorso, stringa di query, argomenti POST e altri valori.
  • Filtrare le richieste in base a un indirizzo IP specifico o a un paese/area geografica.
  • Filtrare le richieste in base alle informazioni dell'intestazione.
  • Filtrare le richieste provenienti da dispositivi mobili o desktop.
  • Filtrare le richieste a partire dal nome e dall'estensione del file della richiesta.
  • Filtrare le richieste in base all'URL della richiesta, al protocollo, al percorso, alla stringa di query, agli argomenti post e ad altri valori.

Tipo di dispositivo

Usare la condizione di corrispondenza del tipo di dispositivo per identificare le richieste provenienti da un dispositivo mobile o da un dispositivo desktop.

Proprietà

Proprietà Valori supportati
Operatore
  • Nel portale di Azure: Equal,Not Equal
  • Nei modelli arm: Equal; usare la negateCondition proprietà per specificare Diverso da
Valore Mobile, Desktop

Esempio

In questo esempio vengono confrontate tutte le richieste rilevate come provenienti da un dispositivo mobile.

Screenshot del portale che mostra la condizione di corrispondenza del tipo di dispositivo.

Versione HTTP

Usare la condizione di corrispondenza della versione HTTP per identificare le richieste effettuate usando una versione specifica del protocollo HTTP.

Nota

La condizione di corrispondenza della versione HTTP è disponibile solo in Frontdoor di Azure Standard/Premium.

Proprietà

Proprietà Valori supportati
Operatore
  • Nel portale di Azure: Equal,Not Equal
  • Nei modelli arm: Equal; usare la negateCondition proprietà per specificare Diverso da
Valore 2.0, 1.1, 1.00.9

Esempio

In questo esempio vengono confrontate tutte le richieste inviate usando il protocollo HTTP 2.0.

Screenshot del portale che mostra la condizione di corrispondenza della versione HTTP.

Richiedere i cookie

Usare la condizione di corrispondenza dei cookie di richiesta per identificare le richieste che includono un cookie specifico.

Nota

La condizione di corrispondenza dei cookie della richiesta è disponibile solo in Frontdoor di Azure Standard/Premium.

Proprietà

Proprietà Valori supportati
Nome cookie Valore stringa che rappresenta il nome del cookie.
Operatore Qualsiasi operatore dall'elenco di operatori standard.
Valore Uno o più valori stringa o integer che rappresentano il valore dell'intestazione della richiesta a cui trovare la corrispondenza. Se vengono specificati più valori, vengono valutati usando la logica OR.
Trasformazione maiuscole/minuscole Qualsiasi trasformazione dall'elenco delle trasformazioni di stringa standard.

Esempio

In questo esempio vengono confrontate tutte le richieste con un cookie denominato deploymentStampId con il valore 1.

Screenshot del portale che mostra la condizione di corrispondenza dei cookie della richiesta.

Post args

Usare la condizione di corrispondenza post args per identificare le richieste in base agli argomenti forniti all'interno del corpo di una richiesta POST. Una singola condizione di corrispondenza corrisponde a un singolo argomento del corpo della richiesta POST. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Nota

La condizione di corrispondenza post args funziona con il application/x-www-form-urlencoded tipo di contenuto.

Proprietà

Proprietà Valori supportati
Post args Valore stringa che rappresenta il nome dell'argomento POST.
Operatore Qualsiasi operatore dall'elenco di operatori standard.
Valore Uno o più valori stringa o integer che rappresentano il valore dell'argomento POST da trovare in corrispondenza. Se vengono specificati più valori, vengono valutati usando la logica OR.
Trasformazione maiuscole/minuscole Qualsiasi trasformazione dall'elenco delle trasformazioni di stringa standard.

Esempio

In questo esempio vengono confrontate tutte le richieste POST in cui viene fornito un customerName argomento nel corpo della richiesta e dove il valore di customerName inizia con la lettera J o K. Viene usata una trasformazione case per convertire i valori di input in lettere maiuscole in modo che i valori che iniziano con J, jK, e k siano tutti corrispondenti.

Screenshot del portale che mostra la condizione di corrispondenza post args.

Stringa di query

Usare la condizione di corrispondenza della stringa di query per identificare le richieste che contengono una stringa di query specifica. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Nota

L'intera stringa di query viene confrontata come una singola stringa, senza l'oggetto iniziale ?.

Proprietà

Proprietà Valori supportati
Operatore Tutti gli operatori dell'elenco di operatori standard sono supportati. Tuttavia, la condizione di corrispondenza Qualsiasi corrisponde a ogni richiesta e la condizione di corrispondenza Non qualsiasi corrisponde ad alcuna richiesta, se usata con la condizione di corrispondenza della stringa di query.
Stringa di query Uno o più valori stringa o integer che rappresentano il valore della stringa di query da trovare. Non includere all'inizio ? della stringa di query. Se vengono specificati più valori, vengono valutati usando la logica OR.
Trasformazione maiuscole/minuscole Qualsiasi trasformazione dall'elenco delle trasformazioni di stringa standard.

Esempio

In questo esempio vengono confrontate tutte le richieste in cui la stringa di query contiene la stringa language=en-US. Si vuole che la condizione di corrispondenza sia con distinzione tra maiuscole e minuscole, quindi non si trasforma il caso.

Screenshot del portale che mostra la condizione di corrispondenza della stringa di query.

Indirizzo remoto

La condizione di corrispondenza dell'indirizzo remoto identifica le richieste in base alla posizione o all'indirizzo IP del richiedente. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

  • Usare la notazione CIDR quando si specificano blocchi di indirizzi IP. La sintassi per un blocco di indirizzi IP è l'indirizzo IP di base seguito da una barra e dalle dimensioni del prefisso. Ad esempio:
    • Esempio IPv4: 5.5.5.64/26 corrisponde a tutte le richieste provenienti dagli indirizzi da 5.5.5.64 a 5.5.5.127.
    • Esempio IPv6: 1:2:3:/48 corrisponde a tutte le richieste provenienti dagli indirizzi 1:2:3:0:0:0:0:0:0 da 1:2:3: ffff:ffff:ffff:ffff:ffff:ffff.
  • Quando si specificano più indirizzi IP e blocchi di indirizzi IP, viene applicata la logica 'OR'.
    • Esempio IPv4: se si aggiungono due indirizzi 1.2.3.4 IP e 10.20.30.40, la condizione viene soddisfatta per tutte le richieste che arrivano dall'indirizzo 1.2.3.4 o 10.20.30.40.
    • Esempio IPv6: se si aggiungono due indirizzi 1:2:3:4:5:6:7:8 IP e 10:20:30:40:50:60:70:80, la condizione viene soddisfatta per tutte le richieste che arrivano dall'indirizzo 1:2:3:4:5:6:7:8 o 10:20:30:40:50:60:70:80.
  • L'indirizzo remoto rappresenta l'IP client originale proveniente dalla connessione di rete o in genere l'intestazione della richiesta X-Forwarded-For se l'utente si trova dietro un proxy. Usare la condizione di corrispondenza dell'indirizzo socket (disponibile in Standard/Premium), se è necessario trovare una corrispondenza in base all'indirizzo IP della richiesta TCP.

Proprietà

Proprietà Valori supportati
Operatore
  • Nella portale di Azure: Geo Match, Geo Not Match, IP MatchoIP Not Match
  • Nei modelli di Resource Manager: GeoMatch, IPMatch; usare la negateCondition proprietà per specificare la corrispondenza geografica non corrispondente o l'indirizzo IP non corrispondente
Valore
  • Per gli IP Match operatori o IP Not Match : specificare uno o più intervalli di indirizzi IP. Se vengono specificati più intervalli di indirizzi IP, vengono valutati usando la logica OR.
  • Per gli Geo Match operatori o Geo Not Match : specificare una o più località usando il codice paese.

Esempio

In questo esempio vengono confrontate tutte le richieste in cui la richiesta non ha avuto origine dal Stati Uniti.

Screenshot del portale che mostra la condizione di corrispondenza dell'indirizzo remoto.

Corpo della richiesta

La condizione di corrispondenza del corpo della richiesta identifica le richieste in base a testo specifico visualizzato nel corpo della richiesta. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Nota

Se un corpo della richiesta supera le dimensioni di 64 KB, solo i primi 64 KB verranno considerati per la condizione di corrispondenza del corpo della richiesta.

Proprietà

Proprietà Valori supportati
Operatore Tutti gli operatori dell'elenco di operatori standard sono supportati. Tuttavia, la condizione di corrispondenza Qualsiasi corrisponde a ogni richiesta e la condizione di corrispondenza Non qualsiasi corrisponde ad alcuna richiesta, se usata con la condizione di corrispondenza del corpo della richiesta.
Valore Uno o più valori stringa o integer che rappresentano il valore del testo del corpo della richiesta per la corrispondenza. Se vengono specificati più valori, vengono valutati usando la logica OR.
Trasformazione maiuscole/minuscole Qualsiasi trasformazione dall'elenco delle trasformazioni di stringa standard.

Esempio

In questo esempio vengono confrontate tutte le richieste in cui il corpo della richiesta contiene la stringa ERROR. Il corpo della richiesta viene trasformato in maiuscolo prima di valutare la corrispondenza, quindi error altre varianti di maiuscole e minuscole attivano anche questa condizione di corrispondenza.

Screenshot del portale che mostra la condizione di corrispondenza del corpo della richiesta.

Nome file della richiesta

La condizione di corrispondenza del nome file di richiesta identifica le richieste che includono il nome file specificato nell'URL della richiesta. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Proprietà

Proprietà Valori supportati
Operatore Tutti gli operatori dell'elenco di operatori standard sono supportati. Tuttavia, la condizione di corrispondenza Qualsiasi corrisponde a ogni richiesta e la condizione di corrispondenza Non qualsiasi corrisponde ad alcuna richiesta, se usata con la condizione di corrispondenza del nome file della richiesta.
Valore Uno o più valori stringa o integer che rappresentano il valore del nome file della richiesta da trovare in corrispondenza. Se vengono specificati più valori, vengono valutati usando la logica OR.
Trasformazione maiuscole/minuscole Qualsiasi trasformazione dall'elenco delle trasformazioni di stringa standard.

Esempio

In questo esempio vengono confrontate tutte le richieste in cui il nome del file di richiesta è media.mp4. Il nome del file viene trasformato in minuscolo prima di valutare la corrispondenza, quindi MEDIA.MP4 altre varianti di maiuscole e minuscole attivano anche questa condizione di corrispondenza.

Screenshot del portale che mostra la condizione di corrispondenza del nome file della richiesta.

Estensione file della richiesta

La condizione di corrispondenza dell'estensione del file di richiesta identifica le richieste che includono l'estensione di file specificata nel nome file nell'URL della richiesta. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Nota

Non includere un periodo iniziale. Usare, ad esempio, html invece di .html.

Proprietà

Proprietà Valori supportati
Operatore Tutti gli operatori dell'elenco di operatori standard sono supportati. Tuttavia, la condizione di corrispondenza Qualsiasi corrisponde a ogni richiesta e la condizione di corrispondenza Non qualsiasi corrisponde ad alcuna richiesta, se usata con la condizione di corrispondenza dell'estensione del file di richiesta.
Valore Uno o più valori stringa o integer che rappresentano il valore dell'estensione del file di richiesta da trovare in corrispondenza. Non includere un periodo iniziale. Se vengono specificati più valori, vengono valutati usando la logica OR.
Trasformazione maiuscole/minuscole Qualsiasi trasformazione dall'elenco delle trasformazioni di stringa standard.

Esempio

In questo esempio vengono confrontate tutte le richieste in cui l'estensione del file di richiesta è pdf o docx. L'estensione del file di richiesta viene trasformata in minuscolo prima di valutare la corrispondenza, quindi PDF, DocXe altre varianti di maiuscole e minuscole attivano anche questa condizione di corrispondenza.

Screenshot del portale che mostra la condizione di corrispondenza dell'estensione del file di richiesta.

Intestazione della richiesta

La condizione di corrispondenza dell'intestazione della richiesta identifica le richieste che includono un'intestazione specifica nella richiesta. È possibile usare questa condizione di corrispondenza per verificare se esiste un'intestazione o per verificare se l'intestazione corrisponde a un valore specificato. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Proprietà

Proprietà Valori supportati
Nome intestazione Valore stringa che rappresenta il nome dell'argomento POST.
Operatore Qualsiasi operatore dall'elenco di operatori standard.
Valore Uno o più valori stringa o integer che rappresentano il valore dell'intestazione della richiesta a cui trovare la corrispondenza. Se vengono specificati più valori, vengono valutati usando la logica OR.
Trasformazione maiuscole/minuscole Qualsiasi trasformazione dall'elenco delle trasformazioni di stringa standard.

Esempio

In questo esempio vengono confrontate tutte le richieste in cui la richiesta contiene un'intestazione denominata MyCustomHeader, indipendentemente dal relativo valore.

Screenshot del portale che mostra la condizione di corrispondenza dell'intestazione della richiesta.

Metodo di richiesta

La condizione di corrispondenza del metodo di richiesta identifica le richieste che usano il metodo di richiesta HTTP specificato. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Proprietà

Proprietà Valori supportati
Operatore
  • Nel portale di Azure: Equal,Not Equal
  • Nei modelli arm: Equal; usare la negateCondition proprietà per specificare Diverso da
Metodo di richiesta Uno o più metodi HTTP da: GET, POST, PUT, DELETEHEAD, OPTIONSTRACE. Se vengono specificati più valori, vengono valutati usando la logica OR.

Esempio

In questo esempio vengono confrontate tutte le richieste in cui la richiesta usa il DELETE metodo .

Screenshot del portale che mostra la condizione di corrispondenza del metodo di richiesta.

Percorso della richiesta

La condizione di corrispondenza del percorso della richiesta identifica le richieste che includono il percorso specificato nell'URL della richiesta. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Nota

Il percorso è la parte dell'URL dopo il nome host e una barra. Ad esempio, nell'URL https://www.contoso.com/files/secure/file1.pdfil percorso è files/secure/file1.pdf.

Proprietà

Proprietà Valori supportati
Operatore
  • Tutti gli operatori dell'elenco di operatori standard sono supportati. Tuttavia, la condizione di corrispondenza Any corrisponde a ogni richiesta e la condizione di corrispondenza Non qualsiasi corrisponde ad alcuna richiesta, se usata con la condizione di corrispondenza del percorso della richiesta.
  • Carattere jolly: corrisponde quando il percorso della richiesta corrisponde a un'espressione con caratteri jolly. Un'espressione con caratteri jolly può includere il * carattere in modo che corrisponda a zero o più caratteri all'interno del percorso. Ad esempio, l'espressione files/customer*/file.pdf con caratteri jolly corrisponde ai percorsi files/customer1/file.pdf, files/customer109/file.pdfe files/customer/file.pdf, ma non corrisponde a files/customer2/anotherfile.pdf.
    • Nel portale di Azure: Wildcards,Not Wildcards
    • Nei modelli di Resource Manager: Wildcard; usare la negateCondition proprietà per specificare Caratteri jolly non presenti
Valore Uno o più valori stringa o integer che rappresentano il valore del percorso della richiesta che deve corrispondere. Se si specifica una barra iniziale, viene ignorata. Se vengono specificati più valori, vengono valutati usando la logica OR.
Trasformazione maiuscole/minuscole Qualsiasi trasformazione dall'elenco delle trasformazioni di stringa standard.
Proprietà Valori supportati
Operatore Tutti gli operatori dell'elenco di operatori standard sono supportati. Tuttavia, la condizione di corrispondenza Any corrisponde a ogni richiesta e la condizione di corrispondenza Non qualsiasi corrisponde ad alcuna richiesta, se usata con la condizione di corrispondenza del percorso della richiesta.
Valore Uno o più valori stringa o integer che rappresentano il valore del percorso della richiesta che deve corrispondere. Se si specifica una barra iniziale, viene ignorata. Se vengono specificati più valori, vengono valutati usando la logica OR.
Trasformazione maiuscole/minuscole Qualsiasi trasformazione dall'elenco delle trasformazioni di stringa standard.

Esempio

In questo esempio vengono confrontate tutte le richieste in cui il percorso del file di richiesta inizia con files/secure/. L'estensione del file di richiesta viene trasformata in minuscolo prima di valutare la corrispondenza, quindi le richieste a files/SECURE/ e altre varianti di maiuscole e minuscole attivano anche questa condizione di corrispondenza.

Screenshot del portale che mostra la condizione di corrispondenza del percorso della richiesta.

Protocollo richiesta

La condizione di corrispondenza del protocollo di richiesta identifica le richieste che usano il protocollo specificato (HTTP o HTTPS).

Nota

Il protocollo è talvolta detto schema.

Proprietà

Proprietà Valori supportati
Operatore
  • Nel portale di Azure: Equal,Not Equal
  • Nei modelli arm: Equal; usare la negateCondition proprietà per specificare Diverso da
Metodo di richiesta HTTP, HTTPS

Esempio

In questo esempio vengono confrontate tutte le richieste in cui la richiesta usa il HTTP protocollo.

Screenshot del portale che mostra la condizione di corrispondenza del protocollo di richiesta.

Richiesta URL

Identifica le richieste che corrispondono all'URL specificato. L'intero URL viene valutato, incluso il protocollo e la stringa di query, ma non il frammento. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Suggerimento

Quando si usa questa condizione della regola, assicurarsi di includere il protocollo e una barra /finale . Ad esempio, usare https://www.contoso.com/ anziché solo www.contoso.com.

Proprietà

Proprietà Valori supportati
Operatore Tutti gli operatori dell'elenco di operatori standard sono supportati. Tuttavia, la condizione di corrispondenza Qualsiasi corrisponde a ogni richiesta e la condizione di corrispondenza Non qualsiasi corrisponde ad alcuna richiesta, se usata con la condizione di corrispondenza dell'URL della richiesta.
Valore Uno o più valori stringa o integer che rappresentano il valore dell'URL della richiesta di cui trovare la corrispondenza. Se vengono specificati più valori, vengono valutati usando la logica OR.
Trasformazione maiuscole/minuscole Qualsiasi trasformazione dall'elenco delle trasformazioni di stringa standard.

Esempio

In questo esempio vengono confrontate tutte le richieste in cui l'URL della richiesta inizia con https://api.contoso.com/customers/123. L'estensione del file di richiesta viene trasformata in minuscolo prima di valutare la corrispondenza, quindi le richieste a https://api.contoso.com/Customers/123 e altre varianti di maiuscole e minuscole attiveranno anche questa condizione di corrispondenza.

Screenshot del portale che mostra la condizione di corrispondenza dell'URL della richiesta.

Nome host

La condizione di corrispondenza del nome host identifica le richieste in base al nome host specificato nella richiesta dal client. La condizione di corrispondenza usa il valore dell'intestazione Host per valutare il nome host. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Proprietà

Proprietà Valori supportati
Operatore Tutti gli operatori dell'elenco di operatori standard sono supportati. Tuttavia, la condizione di corrispondenza Any corrisponde a ogni richiesta e la condizione di corrispondenza Non qualsiasi corrisponde ad alcuna richiesta, se usata con la condizione di corrispondenza del nome host.
Valore Uno o più valori stringa che rappresentano il valore di request hostname to match. Se vengono specificati più valori, vengono valutati usando la logica OR.
Trasformazione maiuscole/minuscole Qualsiasi trasformazione tra maiuscole e minuscole dall'elenco delle trasformazioni di stringa standard.

Esempio

In questo esempio vengono confrontate tutte le richieste con un'intestazione Host che termina con contoso.com.

Screenshot del portale che mostra la condizione di corrispondenza del nome host.

Protocollo SSL

La condizione di corrispondenza del protocollo SSL identifica le richieste in base al protocollo SSL di una connessione TLS stabilita. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Proprietà

Proprietà Valori supportati
Operatore
  • Nel portale di Azure: Equal,Not Equal
  • Nei modelli arm: Equal; usare la negateCondition proprietà per specificare Diverso da
Protocollo SSL
  • Nel portale di Azure: 1.0, 1.1,1.2
  • Nei modelli di Resource Manager: TLSv1, TLSv1.1, TLSv1.2

Esempio

In questo esempio vengono confrontate tutte le richieste che usano il protocollo TLS 1.2.

Screenshot del portale che mostra la condizione di corrispondenza del protocollo SSL.

Indirizzo socket

La condizione di corrispondenza dell'indirizzo socket identifica le richieste in base all'indirizzo IP della connessione diretta al perimetro frontdoor di Azure. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Nota

Se il client usa un proxy HTTP o un servizio di bilanciamento del carico per inviare la richiesta, l'indirizzo socket è l'indirizzo IP del proxy o del servizio di bilanciamento del carico.

Usare la condizione di corrispondenza dell'indirizzo remoto se è necessario trovare una corrispondenza in base all'indirizzo IP originale del client.

  • Usare la notazione CIDR quando si specificano blocchi di indirizzi IP. Ciò significa che la sintassi per un blocco di indirizzi IP è l'indirizzo IP di base seguito da una barra e dalla dimensione del prefisso. Ad esempio:
    • Esempio IPv4: 5.5.5.64/26 corrisponde a tutte le richieste provenienti dagli indirizzi da 5.5.5.64 a 5.5.5.127.
    • Esempio IPv6: 1:2:3:/48 corrisponde a tutte le richieste provenienti dagli indirizzi 1:2:3:0:0:0:0:0:0 da 1:2:3: ffff:ffff:ffff:ffff:ffff:ffff.
  • Quando si specificano più indirizzi IP e blocchi di indirizzi IP, viene applicata la logica 'OR'.
    • Esempio IPv4: se si aggiungono due indirizzi 1.2.3.4 IP e 10.20.30.40, la condizione viene soddisfatta per tutte le richieste che arrivano dall'indirizzo 1.2.3.4 o 10.20.30.40.
    • Esempio IPv6: se si aggiungono due indirizzi 1:2:3:4:5:6:7:8 IP e 10:20:30:40:50:60:70:80, la condizione viene soddisfatta per tutte le richieste che arrivano dall'indirizzo 1:2:3:4:5:6:7:8 o 10:20:30:40:50:60:70:80.

Proprietà

Proprietà Valori supportati
Operatore
  • Nel portale di Azure: IP Match,Not IP Match
  • Nei modelli di Resource Manager: IPMatch; usare la negateCondition proprietà per specificare Not IP Match
Valore Specificare uno o più intervalli di indirizzi IP. Se vengono specificati più intervalli di indirizzi IP, vengono valutati usando la logica OR.

Esempio

In questo esempio vengono confrontate tutte le richieste dagli indirizzi IP nell'intervallo 5.5.5.64/26.

Screenshot del portale che mostra la condizione di corrispondenza dell'indirizzo socket.

Porta client

La condizione di corrispondenza della porta client identifica le richieste in base alla porta TCP del client che ha effettuato la richiesta. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Proprietà

Proprietà Valori supportati
Operatore Tutti gli operatori dell'elenco di operatori standard sono supportati. Tuttavia, la condizione di corrispondenza Qualsiasi corrisponde a ogni richiesta e la condizione di corrispondenza Non qualsiasi corrisponde ad alcuna richiesta, se usata con la condizione di corrispondenza della porta client.
Valore Uno o più numeri di porta, espressi come numeri interi. Se vengono specificati più valori, vengono valutati usando la logica OR.

Esempio

In questo esempio vengono confrontate tutte le richieste con una porta client 1234.

Screenshot del portale che mostra la condizione di corrispondenza della porta client.

Porta server

La condizione di corrispondenza della porta server identifica le richieste in base alla porta TCP del server Frontdoor di Azure che ha accettato la richiesta. La porta deve essere 80 o 443. È possibile specificare più valori da associare, che possono essere combinati usando la logica OR.

Proprietà

Proprietà Valori supportati
Operatore Tutti gli operatori dell'elenco di operatori standard sono supportati. Tuttavia, la condizione di corrispondenza Qualsiasi corrisponde a ogni richiesta e la condizione di corrispondenza Non qualsiasi corrisponde ad alcuna richiesta, se usata con la condizione di corrispondenza della porta server.
Valore Numero di porta, che deve essere 80 o 443. Se vengono specificati più valori, vengono valutati usando la logica OR.

Esempio

In questo esempio vengono confrontate tutte le richieste con una porta server 443.

Screenshot del portale che mostra la condizione di corrispondenza della porta del server.

Elenco operatori

Per le regole che accettano valori dall'elenco di operatori standard, gli operatori seguenti sono validi:

Operatore Descrizione Supporto del modello di Resource Manager
Qualsiasi Corrisponde quando è presente un qualsiasi valore. operator: Any
Uguale a Corrisponde quando il valore corrisponde esattamente alla stringa specificata. operator: Equal
Contiene Corrisponde quando il valore contiene la stringa specificata. operator: Contains
Minore di Corrisponde quando la lunghezza del valore è minore dell'intero specificato. operator: LessThan
Maggiore di Corrisponde quando la lunghezza del valore è maggiore dell'intero specificato. operator: GreaterThan
Less Than or Equal Corrisponde quando la lunghezza del valore è minore o uguale all'intero specificato. operator: LessThanOrEqual
Greater Than or Equal Corrisponde quando la lunghezza del valore è maggiore o uguale all'intero specificato. operator: GreaterThanOrEqual
Inizia con Corrisponde quando il valore inizia con la stringa specificata. operator: BeginsWith
Termina con Corrisponde quando il valore termina con la stringa specificata. operator: EndsWith
Not Any Corrisponde quando non esiste alcun valore. operator: Any e negateCondition : true
Diverso da Corrisponde quando il valore non corrisponde alla stringa specificata. operator: Equal e negateCondition : true
Non contiene Corrisponde quando il valore non contiene la stringa specificata. operator: Contains e negateCondition : true
Not Less Than Corrisponde quando la lunghezza del valore non è minore dell'intero specificato. operator: LessThan e negateCondition : true
Not Greater Than Corrisponde quando la lunghezza del valore non è maggiore dell'intero specificato. operator: GreaterThan e negateCondition : true
Not Less Than or Equal Corrisponde quando la lunghezza del valore non è minore o uguale all'intero specificato. operator: LessThanOrEqual e negateCondition : true
Non maggiore o uguale a Corrisponde quando la lunghezza del valore non è maggiore o uguale all'intero specificato. operator: GreaterThanOrEqual e negateCondition : true
Non inizia con Corrisponde quando il valore non inizia con la stringa specificata. operator: BeginsWith e negateCondition : true
Non termina con Corrisponde quando il valore non termina con la stringa specificata. operator: EndsWith e negateCondition : true
Operatore Descrizione Supporto del modello di Resource Manager
Qualsiasi Corrisponde quando è presente un qualsiasi valore. operator: Any
Uguale a Corrisponde quando il valore corrisponde esattamente alla stringa specificata. operator: Equal
Contiene Corrisponde quando il valore contiene la stringa specificata. operator: Contains
Minore di Corrisponde quando la lunghezza del valore è minore dell'intero specificato. operator: LessThan
Maggiore di Corrisponde quando la lunghezza del valore è maggiore dell'intero specificato. operator: GreaterThan
Less Than or Equal Corrisponde quando la lunghezza del valore è minore o uguale all'intero specificato. operator: LessThanOrEqual
Greater Than or Equal Corrisponde quando la lunghezza del valore è maggiore o uguale all'intero specificato. operator: GreaterThanOrEqual
Inizia con Corrisponde quando il valore inizia con la stringa specificata. operator: BeginsWith
Termina con Corrisponde quando il valore termina con la stringa specificata. operator: EndsWith
RegEx Corrisponde quando il valore corrisponde all'espressione regolare specificata. Per altri dettagli, vedere di seguito. operator: RegEx
Not Any Corrisponde quando non esiste alcun valore. operator: Any e negateCondition : true
Diverso da Corrisponde quando il valore non corrisponde alla stringa specificata. operator: Equal e negateCondition : true
Non contiene Corrisponde quando il valore non contiene la stringa specificata. operator: Contains e negateCondition : true
Not Less Than Corrisponde quando la lunghezza del valore non è minore dell'intero specificato. operator: LessThan e negateCondition : true
Not Greater Than Corrisponde quando la lunghezza del valore non è maggiore dell'intero specificato. operator: GreaterThan e negateCondition : true
Not Less Than or Equal Corrisponde quando la lunghezza del valore non è minore o uguale all'intero specificato. operator: LessThanOrEqual e negateCondition : true
Non maggiore o uguale a Corrisponde quando la lunghezza del valore non è maggiore o uguale all'intero specificato. operator: GreaterThanOrEqual e negateCondition : true
Non inizia con Corrisponde quando il valore non inizia con la stringa specificata. operator: BeginsWith e negateCondition : true
Non termina con Corrisponde quando il valore non termina con la stringa specificata. operator: EndsWith e negateCondition : true
Non regex Corrisponde quando il valore non corrisponde all'espressione regolare specificata. Per altri dettagli, vedere di seguito. operator: RegEx e negateCondition : true

Suggerimento

Per gli operatori numerici, ad esempio minore di e maggiore o uguale a, il confronto si basa sulla lunghezza. Il valore nella condizione di corrispondenza deve essere un numero intero che specifica la lunghezza da confrontare.

Espressioni regolari

Le espressioni regolari non supportano le operazioni seguenti:

  • Backreference e acquisizione di sottoespressioni.
  • Asserzioni arbitrarie di larghezza zero.
  • Riferimenti a subroutine e modelli ricorsivi.
  • Modelli condizionali.
  • Verbi di controllo backtracking.
  • Direttiva \C a byte singolo.
  • Direttiva \R di corrispondenza di nuova riga.
  • Inizio \K della direttiva di reimpostazione della corrispondenza.
  • Callout e codice incorporato.
  • Raggruppamento atomico e quantificatori possessivi.

Elenco di trasformazioni di stringa

Per le regole che possono trasformare le stringhe, le trasformazioni seguenti sono valide:

Trasformazione Descrizione Supporto del modello di Resource Manager
In lettere minuscole Converte la stringa nella rappresentazione minuscola. Lowercase
In maiuscolo Converte la stringa nella rappresentazione maiuscola. Uppercase
Taglia Taglia gli spazi vuoti iniziali e finali dalla stringa. Trim
Rimuovere i valori Null Rimuove i valori Null dalla stringa. RemoveNulls
Codifica URL Codifica url la stringa. UrlEncode
Decodifica URL URL decodifica la stringa. UrlDecode

Passaggi successivi

  • Altre informazioni sul motore regole di Frontdoor di Azure (versione classica)
  • Informazioni su come configurare il primo motore regole.
  • Altre informazioni sulle azioni delle regole