Condizioni di corrispondenza delle regole

Nei set di regole di Frontdoor di Azure, una regola è costituita da una o più 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) non supporta la creazione del profilo, il nuovo onboarding del dominio o i certificati gestiti e verrà ritirato il 31 marzo 2027. Per evitare interruzioni del servizio, migrate per Frontdoor di Azure Standard o Premium. Per altre informazioni, vedere ⁠Ritiro di Frontdoor di Azure (versione classica).

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

Una regola inizia con una condizione di corrispondenza o un set di condizioni di corrispondenza. Una regola può avere fino a 10 condizioni di corrispondenza. Una condizione di corrispondenza identifica specifici tipi di richieste per cui verranno eseguite le azioni definite. Se si usano più condizioni di corrispondenza, queste vengono raggruppate usando la logica AND. Per 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 in base al nome e all'estensione di file della richiesta.
  • Filtrare le richieste in base al nome host, al protocollo SSL, all'URL della richiesta, al protocollo, al percorso, alla stringa di query, agli argomenti post e ad altri valori.
  • Filtrare le richieste in base a un indirizzo IP o un Paese/un'area specifica.
  • Filtrare le richieste in base alle informazioni dell'intestazione.
  • Filtrare le richieste provenienti da dispositivi mobili o desktop.
  • Filtrare le richieste in base al nome e all'estensione di 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 desktop.

Proprietà

Proprietà Valori supportati
Operatore
  • Nel portale di Azure: Equal,Not Equal
  • Nei modelli ARM: Equal; usare la proprietà negateCondition per specificare Non uguale
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 proprietà negateCondition per specificare Non uguale
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.

Richiesta di 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 su 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 interi che rappresentano il valore dell'intestazione della richiesta da confrontare. 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.

Argomenti del post

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 dal 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
Argomenti del post Una stringa che rappresenta il nome dell'argomento POST.
Operatore Qualsiasi operatore dall'elenco di operatori standard.
Valore Uno o più valori stringa o intero che rappresentano il valore dell'argomento POST da abbinare. 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 degli argomenti POST.

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 Nessuno non corrisponde a nessuna richiesta, se usata con la condizione di corrispondenza della stringa di query.
Stringa di query Uno o più valori stringa o interi che rappresentano il valore della stringa di query da confrontare. 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 faccia distinzione tra maiuscole e minuscole, quindi non si trasformano maiuscole e minuscole.

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 attraverso 1:2:3: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. Utilizzare la condizione di corrispondenza dell'indirizzo socket (disponibile in Standard/Premium) quando è necessaria la 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 ARM: GeoMatch, IPMatch; usare la proprietà negateCondition per specificare Geo non corrispondente o 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 o Geo Not Match operatori: specificare una o più posizioni 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.

Testo della richiesta

La condizione di corrispondenza del corpo della richiesta identifica le richieste in base al testo specifico che compare 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 Nessuna non corrisponde ad alcuna richiesta, se usata con la condizione di corrispondenza sul corpo dellarichiesta.
Valore Uno o più valori stringa o interi che rappresentano il valore del testo del corpo della richiesta da confrontare. 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 anche error e le altre varianti di maiuscole e minuscole attivano 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 Tutte corrisponde a ogni richiesta, mentre la condizione di corrispondenza Nessuna non corrisponde a nessuna richiesta, se usata con la condizione di corrispondenza del nome file della richiesta.
Valore Uno o più valori stringa o interi che rappresentano il valore del nome file 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 nome del file di richiesta è media.mp4. Il nome del file viene trasformato in minuscolo prima di valutare la corrispondenza, quindi anche MEDIA.MP4 e le altre varianti di maiuscole e minuscole attivano questa condizione di corrispondenza.

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

Estensione del file 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 punto 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 non corrisponde a nessuna richiesta, se usata con la condizione di corrispondenza dell'estensione del file di richiesta.
Valore Uno o più valori stringa o interi che rappresentano il valore dell'estensione del file di richiesta da confrontare. Non includere un punto 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 file della richiesta viene trasformata in minuscolo prima di valutare la corrispondenza, quindi anche PDF, DocX e le altre varianti di maiuscole e minuscole attivano questa condizione di corrispondenza.

Screenshot del portale che mostra la condizione di corrispondenza dell'estensione file della 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 dell'intestazione Una stringa che rappresenta il nome dell'argomento POST.
Operatore Qualsiasi operatore dall'elenco di operatori standard.
Valore Uno o più valori stringa o interi che rappresentano il valore dell'intestazione della richiesta da confrontare. 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 proprietà negateCondition per specificare Non uguale
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 Any non corrisponde a nessuna 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 * per la corrispondenza di zero o più caratteri all'interno del percorso. Ad esempio, l'espressione con caratteri jolly files/customer*/file.pdf corrisponde ai percorsi files/customer1/file.pdf, files/customer109/file.pdf e files/customer/file.pdf, ma non corrisponde a files/customer2/anotherfile.pdf.
    • Nel portale di Azure: Wildcards,Not Wildcards
    • Nei modelli ARM: Wildcard; usare la proprietà negateCondition per specificare Non caratteri jolly
Valore Uno o più valori stringa o interi che rappresentano il valore del percorso della richiesta da confrontare. 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 Any non corrisponde a nessuna richiesta, se usata con la condizione di corrispondenza del percorso della richiesta.
Valore Uno o più valori stringa o interi che rappresentano il valore del percorso della richiesta da confrontare. 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 anche le richieste a files/SECURE/ e le altre varianti di maiuscole e minuscole attivano questa condizione di corrispondenza.

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

Protocollo di 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 proprietà negateCondition per specificare Non uguale
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 di 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 utilizza questa condizione della regola, verificare 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 Any corrisponde a ogni richiesta e la condizione di corrispondenza Not Any non corrisponde ad alcuna richiesta, se utilizzata con la condizione di corrispondenza dell'URL richiesta.
Valore Uno o più valori stringa o intero che rappresentano il valore dell'URL della richiesta da corrispondere. 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 file della richiesta viene trasformata in minuscolo prima di valutare la corrispondenza, quindi anche le richieste a https://api.contoso.com/Customers/123 e le altre varianti di maiuscole e minuscole attivano questa condizione di corrispondenza.

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

Nome dell'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, mentre la condizione di corrispondenza Non alcuna non corrisponde a nessuna richiesta, se usata con la condizione di corrispondenza del nome host .
Valore Uno o più valori stringa che rappresentano il valore del nome host della richiesta da abbinare. Se vengono specificati più valori, vengono valutati usando la logica OR.
Trasformazione maiuscole/minuscole Qualsiasi trasformazione di 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 proprietà negateCondition per specificare Non uguale
Protocollo SSL
  • Nel portale di Azure: 1.0, 1.1, 1.2
  • Nei modelli ARM: 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 all'edge di 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 quando è necessaria la 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 attraverso 1:2:3: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 ARM: IPMatch; usare la proprietà negateCondition 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 abbinamento 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 soddisfa ogni richiesta e la condizione di corrispondenza Nessuna non soddisfa alcuna richiesta, se usata con la condizione di corrispondenza della porta del 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 del 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 Qualunque corrisponde a ogni richiesta, mentre la condizione di corrispondenza Non Qualunque non 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 ARM
Qualsiasi Corrisponde quando è presente un qualsiasi valore. operator: Any
Uguale 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
Minore o uguale a Corrisponde quando la lunghezza del valore è minore o uguale all'intero specificato. operator: LessThanOrEqual
Maggiore o uguale 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
Nessuno di questi/e Corrisponde quando non esiste alcun valore. operator: Any e negateCondition : true
Non uguale 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
Non maggiore di Corrisponde quando la lunghezza del valore non è maggiore dell'intero specificato. operator: GreaterThan e negateCondition : true
Non minore o uguale a 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 ARM
Qualsiasi Corrisponde quando è presente un qualsiasi valore. operator: Any
Uguale 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
Minore o uguale a Corrisponde quando la lunghezza del valore è minore o uguale all'intero specificato. operator: LessThanOrEqual
Maggiore o uguale 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
Nessuno di questi/e Corrisponde quando non esiste alcun valore. operator: Any e negateCondition : true
Non uguale 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
Non maggiore di Corrisponde quando la lunghezza del valore non è maggiore dell'intero specificato. operator: GreaterThan e negateCondition : true
Non minore o uguale a 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 intero che specifica la lunghezza da confrontare.

Espressioni regolari

Le espressioni regolari non supportano le operazioni seguenti:

  • Retroreferenze e acquisizione di sottoespressioni.
  • Asserzioni arbitrarie a larghezza zero.
  • Riferimenti a subroutine e modelli ricorsivi.
  • Modelli condizionali.
  • Verbi di controllo backtracking.
  • Direttiva \C a byte singolo.
  • Direttiva corrispondenza nuova riga \R.
  • 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 ARM
In minuscole Converte la stringa nella rappresentazione minuscola. Lowercase
In maiuscolo Converte la stringa nella rappresentazione maiuscola. Uppercase
Taglia Elimina lo spazio vuoto iniziale e finale dalla stringa. Trim
Rimuovere i valori Null Rimuove i valori Null dalla stringa. RemoveNulls
Codifica dell'URL Codifica la stringa in formato URL. UrlEncode
Decodifica URL URL-decodifica la stringa. UrlDecode

Passaggi successivi