Referência da sintaxe de UrlList

Este guia explica a sintaxe do UrlList para o Secure Web Proxy.

UrlList permite criar muitas entradas de correspondência que podem ser reutilizadas em várias regras.

A sintaxe UrlList é compatível com domínios correspondentes na íntegra ou por sufixo e URLs com caminho completo sem parâmetros ou um caminho de prefixo.

Caracteres curinga aceitos

UrlList oferece suporte ao caractere curinga de asterisco *, que pode ser usado como prefixo para corresponder subdomínios parciais ou caminhos parciais.

Quando você fornece domínios parciais, UrlList corresponde apenas a tokens de subdomínio completos. Se um separador de caminho não for fornecido, UrlList vai corresponder a qualquer caminho. Por exemplo, se você fornecer example.com, UrlList corresponderá a example.com/*, incluindo todos os caminhos no domínio.

Como UrlList interpreta entradas

O Secure Web Proxy usa os padrões UrlList que você fornece para fazer a correspondência com os URLs e, em seguida, determina se o URL é permitido ou não.

UrlList interpreta as entradas de acordo com os seguintes valores:

• Entradas que contêm um ponto (.) e uma barra (/) precisam ser URLs bem formados. Você pode incluir caracteres curinga de subdomínio e caminho. O token à esquerda do primeiro caractere / é interpretado como o domínio de nível superior, como .com em google.com/news.

• As entradas que contêm um ponto (.) e que não contêm uma barra (/) são interpretadas como domínios. Você pode incluir o caractere curinga de subdomínio. Nesse caso, o token mais à direita é interpretado como o domínio de nível superior, como .xyz em abc.xyz.

• Todas as outras entradas são inválidas.

Quando um padrão UrlList é correspondido com valores que contêm uma barra (/), como em request.url(), os padrões são interpretados conforme explicado anteriormente. No entanto, quando um padrão UrlList corresponde a valores sem um /, como em host(), somente a parte do domínio do padrão é correspondida.

Exemplos de correspondência de padrões

Na tabela a seguir, mostramos exemplos de padrões, exemplos de URLs que correspondem a cada padrão e exemplos de URLs que não correspondem a cada padrão.

Padrão	Corresponde a	Não corresponde
*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/