Networking and Web Address Syntax
From UntangleWiki
Contents |
About Untangle Server Syntax
Throughout the Untangle Server Administrative Interface, Administrators must enter information about their network and web locations. In some cases the values entered can be exact, and in others the text entered indicates a range of values.
Networking Syntax
Exact IP Address
The Simple IP Address syntax is an exact IP address. Examples include:
- 192.168.10.1
- 66.94.230.42
Exact IP Address & Netmask
The Network/Netmask syntax is used to define an IP Address and netmask with a single value. Examples include:
- 192.168.1.1/24
- 66.94.230.42/16
The format is IP Address/number where IP Address is an IP address and when number is a number between 0 and 32. This second value is short for a netmask, defining the number of leading ones when expressed in bit form. For example, the mask 255.255.255.0 can be expressed as /24 and the mask 255.255.0.0 can be expressed as /16.
IP Address Range
The IP Range syntax defines a collection of contiguous IP addresses. It is expressed as address-address, where a dash (-) is used to separate the ends of the range. Examples include:
- 192.168.10.1-192.168.10.100
- 66.94.230.1-66.94.230.100
In many cases, IP Range Syntax and Network/Netmask Syntax can be used interchangeably.
The IP Matcher syntax is used in several components within the Untangle Server. It is the most powerful means to express a range of IP Addresses. Where a field within the Administrative Interface specifies IP Matcher Syntax, one can enter values in either Simple IP Address, Network/Netmask, or IP Range Syntax.
Exact Port Number
The Simple Port is a port number without expressing range. It is a number between 0 and 65,535.
Port Range
The Port Range syntax defines a collection of contiguous ports. It is expressed as port-port, where a dash (-) is used to separate the ends of the range. port is a number between 0 and 65,535. Examples include:
- 1024-2048
- 20-26
The Port Matcher syntax is used in several components within the Untangle Server. It is the most powerful means to express a range of ports. Where a field within the Administrative Interface specifies Port Matcher Syntax, one can enter values in either Simple Port or Port Range Syntax.
Wildcard
You indicate a wildcard by not specifying the value in any value text box. In other words, if you don't specify a port number in the value text box, Untangle Server looks for matches on all ports.
Web Address (URL) Syntax
The Web Domain syntax is used to describe a top-level web domain. Examples include:
These examples are different from complete URLs. For example, the domain http://some_site.com/malk will also match http://some_site.com/duff. Untangle Server uses only the top of the URL (the hostname).
The URL Matcher Syntax describes all or part of a website. Unlike Web Domain Syntax, the URL Matcher syntax specifies locations within a domain instead of just the top-level of the domain. Examples include:
In the first example above, http://some_site.com/duff/about.html matches, but http://some_site.com/malk does not.
