Referencia de sintaxis de listas de URLs

En esta guía, se explica la sintaxis de UrlList para el proxy web seguro.

UrlList te permite crear muchas entradas de coincidencia que puedes volver a usar en varias reglas.

La sintaxis de UrlList admite la coincidencia de dominios completos o por sufijo, y URLs con rutas de acceso completas sin parámetros o con una ruta de acceso de prefijo.

Comodines admitidos

UrlList admite el carácter comodín de asterisco *, que puedes usar como prefijo para hacer coincidir subdominios o rutas de acceso parciales.

Cuando proporcionas dominios parciales, UrlList solo coincide con tokens de subdominio completos. Si no se proporciona un separador de ruta de acceso, UrlList coincidirá con cualquier ruta. Por ejemplo, si proporcionas example.com, entonces UrlList coincide con example.com/*, incluidas todas las rutas de acceso en el dominio.

Cómo interpreta las entradas UrlList

El proxy web seguro usa los patrones UrlList que proporcionas para buscar coincidencias con las URLs y, luego, determinar si la URL está permitida o no.

UrlList interpreta las entradas de acuerdo con lo siguiente:

• Las entradas que contienen un punto (.) y una barra diagonal (/) deben ser URLs con el formato correcto. Puedes incluir comodines de subdominios y rutas de acceso. El token 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 que no contienen una barra diagonal (/) se interpretan como dominios. Puede incluir el comodín de subdominio. En este caso, el token más a la derecha se interpreta como el dominio de nivel superior, como .xyz en abc.xyz.

• Las demás entradas no son válidas.

Cuando un patrón UrlList se compara con valores que contienen una barra diagonal (/), como en request.url(), los patrones se interpretan como se explicó anteriormente. Sin embargo, cuando se compara un patrón UrlList con valores sin un /, como en host(), solo se establece la coincidencia con 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 coinciden los patrones.

Patrón	Coinciden	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/