Panduan ini menjelaskan sintaksis UrlList
untuk Proxy Web Aman.
UrlList
memungkinkan Anda membuat banyak entri pencocokan yang dapat digunakan kembali di berbagai aturan.
Sintaksis UrlList
mendukung domain yang cocok secara lengkap atau menurut akhiran, dan URL dengan
jalur lengkap tanpa parameter atau jalur awalan.
Karakter pengganti yang didukung
UrlList
mendukung karakter pengganti tanda bintang *
, yang dapat Anda gunakan sebagai
awalan untuk mencocokkan subdomain parsial atau jalur parsial.
Jika Anda memberikan domain parsial, UrlList
hanya cocok dengan token subdomain lengkap. Jika pemisah jalur tidak disediakan, UrlList
akan cocok dengan jalur apa pun. Misalnya, jika Anda memberikan example.com
, UrlList
akan cocok dengan example.com/*
, termasuk semua jalur di domain.
Cara UrlList
menafsirkan entri
Proxy Web Aman menggunakan pola UrlList
yang Anda berikan untuk dicocokkan dengan
URL, lalu menentukan apakah URL diizinkan atau tidak diizinkan.
UrlList
menafsirkan entri sesuai dengan hal berikut:
Entri yang berisi titik (
.
) dan garis miring (/
) harus berupa URL yang diformat dengan baik. Anda dapat menyertakan karakter pengganti subdomain dan jalur. Token di sebelah kiri karakter/
pertama ditafsirkan sebagai domain level teratas, seperti.com
dalamgoogle.com/news
.Entri yang berisi titik (
.
) dan tidak berisi garis miring (/
) diinterpretasikan sebagai domain. Anda dapat menyertakan karakter pengganti subdomain. Dalam hal ini, token yang paling kanan diinterpretasikan sebagai domain level teratas, seperti.xyz
diabc.xyz
.Semua entri lainnya tidak valid.
Saat pola UrlList
dicocokkan dengan nilai yang berisi
garis miring (/
), seperti dalam request.url()
, pola akan ditafsirkan seperti yang dijelaskan
sebelumnya. Namun, jika pola UrlList
cocok dengan nilai tanpa
/
, seperti di host()
, hanya bagian domain dari pola yang cocok.
Contoh pencocokan pola
Tabel berikut menunjukkan contoh pola, contoh URL yang cocok dengan setiap pola, dan URL contoh yang setiap pola tidak cocok.
Pola | Mencocokkan dengan | Tidak cocok |
---|---|---|
*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/ |