In diesem Leitfaden wird die UrlList
-Syntax für Secure Web Proxy erläutert.
Mit UrlList
können Sie viele Übereinstimmungseinträge erstellen, die Sie für mehrere Regeln wiederverwenden können.
Die UrlList
-Syntax unterstützt die Übereinstimmung mit vollständigen Domains oder Suffixen sowie URLs mit vollständigem Pfad ohne Parameter oder einem Präfixpfad.
Unterstützte Platzhalter
UrlList
unterstützt das Platzhalterzeichen *
, das Sie als Präfix verwenden können, um Teilsubdomains oder Teilpfade abzugleichen.
Wenn Sie Teildomains angeben, werden mit UrlList
nur vollständige Subdomain-Tokens abgeglichen. Wenn kein Pfadtrennzeichen angegeben ist, stimmt UrlList
mit jedem Pfad überein. Wenn Sie beispielsweise example.com
angeben, entspricht UrlList
example.com/*
, einschließlich aller Pfade in der Domain.
So werden Einträge von UrlList
interpretiert
Der Secure Web Proxy verwendet die von Ihnen angegebenen UrlList
-Muster, um sie mit URLs abzugleichen und dann zu bestimmen, ob die URL zulässig oder unzulässig ist.
UrlList
interpretiert Einträge so:
Einträge, die einen Punkt (
.
) und einen Schrägstrich (/
) enthalten, müssen korrekt formatierte URLs sein. Sie können Subdomain- und Pfad-Platzhalter verwenden. Das Token links vom ersten/
-Zeichen wird als Top-Level-Domain interpretiert, z. B..com
ingoogle.com/news
.Einträge, die einen Punkt (
.
) und keinen Schrägstrich (/
) enthalten, werden als Domains interpretiert. Sie können den Subdomain-Platzhalter verwenden. Das rechtseste Token wird in diesem Fall als Top-Level-Domain interpretiert, z. B..xyz
inabc.xyz
.Alle anderen Einträge sind ungültig.
Wenn ein UrlList
-Muster mit Werten abgeglichen wird, die einen Schrägstrich (/
) enthalten, z. B. in request.url()
, werden die Muster wie oben beschrieben interpretiert. Wenn ein UrlList
-Muster jedoch mit Werten ohne /
abgeglichen wird, z. B. in host()
, wird nur der Domainteil des Musters abgeglichen.
Beispiele für Musterabgleich
Die folgende Tabelle enthält Beispielmuster sowie Beispiel-URLs, die mit den einzelnen Mustern übereinstimmen bzw. nicht übereinstimmen.
Muster | Stimmt überein mit | Stimmt nicht überein |
---|---|---|
*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/ |