JANUS WEB: Difference between revisions
m (→References) |
mNo edit summary |
||
Line 76: | Line 76: | ||
<tr><th>url</th> | <tr><th>url</th> | ||
<td>Universal Resource Locator (URL). Every web request contains a URL, which can be considered to specify the "name" or "identity" of the "object" being requested. For example, the URL may specify the name of a file or the name (and some parameters) of an application. The '''url''' specified in the JANUS WEB command is a case-sensitive pattern, which is compared to the requested URL; the last rule that matches the URL is the rule that applies. The pattern can include an asterisk (*) as a "wildcard" indicator (<tt>*.jpg</tt> thus specifies any URL with a .jpg suffix). <blockquote> Janus port definitions include the UPCASE specification by default. If you define a web rule using a lowercase URL, the rule may fail in the default case where the incoming URL is converted to uppercase. For example, a TYPE rule that uses the pattern <tt>*.pdf</tt> may not recognize a request for a file of type PDF. </blockquote> The '''url''' value can also be the name of an | <td>Universal Resource Locator (URL). Every web request contains a URL, which can be considered to specify the "name" or "identity" of the "object" being requested. For example, the URL may specify the name of a file or the name (and some parameters) of an application. The '''url''' specified in the JANUS WEB command is a case-sensitive pattern, which is compared to the requested URL; the last rule that matches the URL is the rule that applies. The pattern can include an asterisk (*) as a "wildcard" indicator (<tt>*.jpg</tt> thus specifies any URL with a .jpg suffix). <blockquote> Janus port definitions include the UPCASE specification by default. If you define a web rule using a lowercase URL, the rule may fail in the default case where the incoming URL is converted to uppercase. For example, a TYPE rule that uses the pattern <tt>*.pdf</tt> may not recognize a request for a file of type PDF. </blockquote> The '''url''' value can also be the name of an [[JANUS WEB exception rules|exception condition]]. | ||
</td></tr> | </td></tr> | ||
</table> | </table> | ||
The optional parameters allowed for the JANUS WEB command depend on the '''rule_type''' that was specified. The various rule types are shown in the following sections, followed by a section giving examples and showing the interaction of JANUS WEB commands ([[JANUS WEB Rule matching order and examples]]), and a section explaining | The optional parameters allowed for the JANUS WEB command depend on the '''rule_type''' that was specified. The various rule types are shown in the following sections, followed by a section giving examples and showing the interaction of JANUS WEB commands ([[JANUS WEB Rule matching order and examples]]), and a section explaining [[JANUS WEB exception rules|exception URLs]]. | ||
The JANUS CLSOCK and JANUS SRVSOCK commands, described in the ''Janus TCP/IP Base Reference Manual'', are used by ''[[Janus Sockets]]'' to establish rules for CLSOCK ports and SRVSOCK ports, respectively. .do end Note that the JANUS WEB command differs from the corresponding rules available with the JANUS CLSOCK and JANUS SRVSOCK commands in the following ways: | The JANUS CLSOCK and JANUS SRVSOCK commands, described in the ''Janus TCP/IP Base Reference Manual'', are used by ''[[Janus Sockets]]'' to establish rules for CLSOCK ports and SRVSOCK ports, respectively. .do end Note that the JANUS WEB command differs from the corresponding rules available with the JANUS CLSOCK and JANUS SRVSOCK commands in the following ways: |
Revision as of 20:23, 14 October 2011
<section begin="desc" />Define web port characteristics<section end="desc" />
The JANUS WEB command defines the rules for a Janus Web Server running on a WEBSERV port. Web rules control access and routing of URL requests, and they can cause a request for a URL to initiate a complex database process.
Syntax
<section begin="syntax" /> JANUS WEB portname rule_type [method] url - [optional parameters] <section end="syntax" />
JANUS WEB command syntax
The JANUS WEB command differs from most Janus commands in that it usually takes a set of commands to fully specify the rules that give a web server its characteristics. For instance, it may take a number of commands to specify user ID access, to restrict the range of IP addresses that may connect, and then to specify the server's routing and behavior based on different types of requested URLs. The order in which JANUS WEB commands are specified also affects how they are processed.
The first four parameters are positional, and all parameters are required but the method:
portname | The 1- to 30-character name of the port for which the access and URL processing rules are being defined. | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rule_type | The type of web rule that is being specified for the port. Valid values are:
The order in which the JANUS WEB rule types are shown above is the order in which they are processed. Within each rule_type, rules are processed from most recent to oldest:
| ||||||||||||||||||
method | The HTTP method(s) that applies to the rule. The method value can be any of the following:
By specifying a method on a JANUS WEB command, you indicate the rule is only to apply to that method. If no method is specified, GET+POST is assumed. | ||||||||||||||||||
url | Universal Resource Locator (URL). Every web request contains a URL, which can be considered to specify the "name" or "identity" of the "object" being requested. For example, the URL may specify the name of a file or the name (and some parameters) of an application. The url specified in the JANUS WEB command is a case-sensitive pattern, which is compared to the requested URL; the last rule that matches the URL is the rule that applies. The pattern can include an asterisk (*) as a "wildcard" indicator (*.jpg thus specifies any URL with a .jpg suffix). The url value can also be the name of an exception condition. |
The optional parameters allowed for the JANUS WEB command depend on the rule_type that was specified. The various rule types are shown in the following sections, followed by a section giving examples and showing the interaction of JANUS WEB commands (JANUS WEB Rule matching order and examples), and a section explaining exception URLs.
The JANUS CLSOCK and JANUS SRVSOCK commands, described in the Janus TCP/IP Base Reference Manual, are used by Janus Sockets to establish rules for CLSOCK ports and SRVSOCK ports, respectively. .do end Note that the JANUS WEB command differs from the corresponding rules available with the JANUS CLSOCK and JANUS SRVSOCK commands in the following ways:
- JANUS WEB does not allow any optional parameters (for example, USGROUP) on the DISALLOW rule.
- The default access for WEBSERV non-SSL ports and SRVSOCK ports is ALLOW. The default access for WEBSERV SSL ports and CLSOCK ports is DISALLOW.
- ALLOW and DISALLOW are the only rule types for JANUS CLSOCK and JANUS SRVSOCK; there are a number of other rule types for JANUS WEB.