Questa guida illustra la sintassi UrlList
per Secure Web Proxy.
UrlList
consente di creare molte voci di corrispondenza che puoi riutilizzare in più regole.
La sintassi di UrlList
supporta la corrispondenza dei domini per intero o per suffisso e degli URL con percorso completo senza parametri o con un percorso prefisso.
Caratteri jolly supportati
UrlList
supporta il carattere jolly asterisco *
, che puoi utilizzare come prefisso per trovare corrispondenze di sottodomini o percorsi parziali.
Quando fornisci domini parziali, UrlList
corrisponde solo ai token di sottodominio completi. Se non viene fornito un separatore di percorso, UrlList
corrisponde a qualsiasi percorso. Ad esempio, se specifichi example.com
, UrlList
corrisponde a example.com/*
, inclusi tutti i percorsi del dominio.
In che modo UrlList
interpreta le voci
Secure Web Proxy utilizza i pattern UrlList
da te forniti per stabilire una corrispondenza con gli URL e quindi determinare se l'URL è consentito o non consentito.
UrlList
interpreta le voci in base a quanto segue:
Le voci che contengono un punto (
.
) e una barra (/
) devono essere URL in formato corretto. Puoi includere caratteri jolly nel sottodominio e nel percorso. Il token a sinistra del primo carattere/
viene interpretato come il dominio di primo livello, ad esempio.com
ingoogle.com/news
.Le voci che contengono un punto (
.
) e che non contengono una barra (/
) vengono interpretate come domini. Puoi includere il carattere jolly del sottodominio. Il token più a destra in questo caso viene interpretato come il dominio di primo livello, come.xyz
inabc.xyz
.Tutte le altre voci non sono valide.
Quando un pattern UrlList
viene confrontato con valori che contengono una barra (/
), ad esempio in request.url()
, i pattern vengono interpretati come spiegato in precedenza. Tuttavia, quando un pattern UrlList
viene confrontato con valori senza /
, ad esempio in host()
, viene soddisfatta solo la parte del dominio del pattern.
Esempi di corrispondenza di pattern
La tabella riportata di seguito mostra i pattern di esempio, gli URL di esempio corrispondenti a ogni pattern e gli URL di esempio che non corrispondono.
Pattern | Corrisponde a | Non corrisponde |
---|---|---|
*example.com |
example.com/ server.example.com/ sample.server.example.com/ example.com/path example.com/path?q=query example.com/path/subpath sample.server.example.com/path/ |
myexample.com/ example.com.bad.com/ us13.altostrat.com/go/example.com/path www.google.com/search?q=example.com |
*.example.com |
server.example.com/ sample.server.example.com/ sample.server.example.com/path/ |
myexample.com/ example.com.bad.com/ us13.altostrat.com/go/example.com/path www.google.com/search?q=example.com example.com/ example.com/path example.com/path/subpath |
example.com |
example.com/ example.com/path example.com/path/subpath |
myexample.com/ example.com.bad.com/ us13.altostrat.com/go/example.com/path www.google.com/search?q=example.com server.example.com/ sample.server.example.com/ sample.server.example.com/path/ |
*server.example.com |
server.example.com/ sample.server.example.com/path sample.server.example.com/path/ |
myexample.com/ example.com.bad.com/ us13.altostrat.com/go/example.com/path www.google.com/search?q=example.com example.com/ example.com/path example.com/path/subpath |
*example.com/ |
example.com/ server.example.com/ sample.server.example.com/ |
myexample.com/ example.com.bad.com/ us13.altostrat.com/go/example.com/path www.google.com/search?q=example.com example.com/path/ example.com/path/subpath sample.server.example.com/path/ |
*example.com/path* |
example.com/path example.com/path/subpath sample.server.example.com/path/ |
myexample.com/ example.com.bad.com/ us13.altostrat.com/go/example.com/path www.google.com/search?q=example.com example.com/ server.example.com/ sample.server.com/ |
*example.com/path/* |
example.com/path/subpath sample.server.example.com/path/ |
myexample.com/ example.com.bad.com/ us13.altostrat.com/go/example.com/path www.google.com/search?q=example.com example.com/ server.example.com/ sample.server.example.com/ example.com/path |
*example.com/path/ |
sample.server.example.com/path/ | myexample.com/ example.com.bad.com/ us13.altostrat.com/go/example.com/path www.google.com/search?q=example.com example.com/ sample.example.com/ sample.server.example.com/ example.com/path example.com/path/subpath |
example.com/ |
example.com/ | myexample.com/ example.com.bad.com/ us13.altostrat.com/go/example.com/path www.google.com/search?q=example.com server.example.com/ sample.server.example.com/ example.com/path example.com/path/subpath sample.server.example.com/path/ |