SonicOS 7 Match Objects

Matching URI List Objects

The matching process for URI List Objects is based on tokens. A valid token sequence is composed of one or more tokens, joined by a specific character, like “.” or “/”. A URI represents a token sequence. For example, the URI www.example.com is a token sequence consisting of www, example, and com, joined by a “.”. Generally, if a URI contains one of the URIs in a URI List Object, then the URI List Object matches that URI.

Normal matching

If a list object contains a URI such as example.com, then that object matches URIs defined as:

[<token sequence>(.|/)]example.com[(.|/)<token sequence>]

For example, the URI List Object matches any of the following URIs:

  • example.com
  • www.example.com
  • example.com.uk
  • www.example.com.uk
  • example.com/path

The URI List Object does not match the URI, specialexample.com, because specialexample is identified as a different token than example.

Wildcard matching

Wildcard matching is supported. An asterisk (*) is used as the wildcard character, and represents a valid sequence of tokens. If a list object contains a URI such as example.*.com, then that list object matches URIs defined as:

[<token sequence>(.|/)]example.<token sequence>.com[(.|/)<token sequence>]

For example, the URI List Object example.*.com matches any of the following URIs:

  • example.exam1.com
  • example.exam1.exam2.com
  • www.example.exam1.com/path

The URI List Object does not match the URI:

  • example.com

This is because the wildcard character (*) represents a valid token sequence that isn’t present in example.com.

IPv6 Address Matching

IPv6 address string matching is also supported. While an IPv4 address can be handled as a normal token sequence, an IPv6 address string needs to be handled specially. If a URI List Object contains a URI such as [2001:2002::2008], then that URI List Object matches URIs defined as:

[2001:2002::2008][/<token sequence>]

For example, the URI List Object matches any of the following URIs:

  • [2001:2002::2008]
  • [2001:2002::2008]/path
  • [2001:2002::2008]/path/abc.txt

IPv6 Wildcard Matching

Wildcard matching in the IPv6 address string is supported. If a list object contains a URI such as [2001:2002:*:2008]/*/abc.mp3, then that list object matches URIs defined as:

[2001:2002:<token sequence>:2008]/<token sequence>/abc.mp3

For example, the URI List Object matches any of the following URIs:

  • [2001:2002:2003::2007:2008]/path/abc.txt
  • [2001:2002:2003:2004:2005:2006:2007:2008]/path/path2/abc.txt

Was This Article Helpful?

Help us to improve our support portal

Techdocs Article Helpful form

  • Hidden
  • Hidden

Techdocs Article NOT Helpful form

  • Still can't find what you're looking for? Try our knowledge base or ask our community for more help.
  • Hidden
  • Hidden