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.comemgoogle.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.xyzemabc.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/ |