Syntaxreferenz für UrlList

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 in google.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 in abc.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/