Referencia de la sintaxis de UrlList

En esta guía se explica la sintaxis de UrlList para Secure Web Proxy.

UrlList te permite crear muchas entradas de coincidencia que puedes reutilizar en varias reglas.

La sintaxis UrlList permite que coincidan dominios completos o por sufijo, así como URLs con una ruta completa sin parámetros o con una ruta de prefijo.

Comodines admitidos

UrlList admite el carácter comodín asterisco *, que puedes usar como prefijo para buscar coincidencias en subdominios o rutas parciales.

Cuando proporcionas dominios parciales, UrlList solo coincide con tokens de subdominio completos. Si no se proporciona un separador de ruta, UrlList coincide con cualquier ruta. Por ejemplo, si proporcionas example.com, UrlList coincide con example.com/*, incluidos todos los paths del dominio.

Cómo interpreta UrlList las entradas

Secure Web Proxy usa los patrones UrlList que proporciones para compararlos con las URLs y, a continuación, determinar si la URL está permitida o no.

UrlList interpreta las entradas de la siguiente manera:

• Las entradas que contengan un punto (.) y una barra inclinada (/) deben ser URLs bien formadas. Puedes incluir comodines de subdominio y de ruta. El token situado a la izquierda del primer carácter / se interpreta como el dominio de nivel superior, como .com en google.com/news.

• Las entradas que contienen un punto (.) y no contienen una barra inclinada (/) se interpretan como dominios. Puedes incluir el comodín de subdominio. En este caso, el token situado más a la derecha se interpreta como el dominio de nivel superior, como .xyz en abc.xyz.

• Todas las demás entradas no son válidas.

Cuando se compara un patrón UrlList con valores que contienen una barra diagonal (/), como en request.url(), los patrones se interpretan como se ha explicado anteriormente. Sin embargo, cuando se compara un patrón UrlList con valores sin /, como en host(), solo se compara la parte del dominio del patrón.

Ejemplos de coincidencia de patrones

En la siguiente tabla se muestran patrones de ejemplo, URLs de ejemplo con las que coincide cada patrón y URLs de ejemplo con las que no coincide cada patrón.

Patrón	Coincide con	No coincide
*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/