JANUS DEFINEIPGROUP: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (misc formatting)
Line 2: Line 2:
<span class="pageSubtitle">Create named group of ip addresses</span>
<span class="pageSubtitle">Create named group of ip addresses</span>


This command creates a named group which contains any number of IP addresses. The <var class="term">groupname</var> can then be used to control ''[[Janus Web Server]]'' or ''[[Janus Sockets]]'' access based on IP address.
This command creates a named group which contains any number of IP addresses. The <var class="term">groupname</var> can then be used to control <var class="product">[[Janus Web Server]]</var> or <var class="product">[[Janus Sockets]]</var> access based on IP address.


==Syntax==
==Syntax==
<p class="syntax"> JANUS DEFINEIPGROUP groupname ipaddress(es)
<p class="syntax"> JANUS DEFINEIPGROUP <span class="term">groupname ipaddress(es) </span>
</p>
</p>


Where each parameter is positional and required:
Where each parameter is positional and required:


<table class="syntaxTable">
<table>
<tr><th>groupname</th>
<tr><th>groupname</th>
<td>A 1 - 30 character name of the group with which IP addresses are being associated for <var>ALLOW</var> and <var>DISALLOW</var> rules in <var>JANUS WEB</var>, <var>JANUS CLSOCK</var>, or <var>JANUS SRVSOCK</var> commands.</td></tr>
<td>A 1 - 30 character name of the group with which IP addresses are being associated for <var>ALLOW</var> and <var>DISALLOW</var> rules in <var>JANUS WEB</var>, <var>JANUS CLSOCK</var>, or <var>JANUS SRVSOCK</var> commands.</td></tr>
<tr><th>ipaddress(es)</th>
<tr><th>ipaddress(es)</th>
<td>A list of IP addresses or subnet masks in "dotted" format. IP addresses are formatted nnn.nnn.nnn.nnn. For example, 198.242.244.47 is a valid IP address. Subnet masks are formatted in one of two ways:
<td>A list of IP addresses or subnet masks. IPV4 addresses are formatted  in "dotted" format: <var class="term">nnn.nnn.nnn.nnn</var>. For example, 198.242.244.47 is a valid IP address. IPV4 subnet masks are formatted in one of two ways:
 
<ul>
<ul>
<li>With a slash separating the subnet identifier from the subnet mask, as in "198.242.244.0/255.255.255.0"</li>
<li>With a slash separating the subnet identifier from the subnet mask, as in "198.242.244.0/255.255.255.0"</li>
<li>With a dash (&#x201C;-&#x201D;) separating the subnet identifier from the number of subnet mask bits, as in "198.242.244.0-24".</li>
 
<li>With a hyphen (<tt>-</tt>) separating the subnet identifier from the number of subnet mask bits, as in <code>198.242.244.0-24</code>.</li>
</ul>
</ul>


All formats may be used in any combination, separated by spaces or commas, on the same command.  
These formats may be used in any combination, separated by spaces or commas, on the same command.  


Note: Translation of a name to an IP address is not supported on this command.
<p class="note"><b>Note:</b> Translation of a name to an IP address is not supported on this command. </p>
</td></tr>
</td></tr>
</table>
</table>
Line 29: Line 30:
The <var>DEFINEIPGROUP</var> command may be abbreviated <var>DEFIPGROUP</var>, <var>DEFIPG</var>, and <var>DEFINEIPG</var>.  
The <var>DEFINEIPGROUP</var> command may be abbreviated <var>DEFIPGROUP</var>, <var>DEFIPG</var>, and <var>DEFINEIPG</var>.  


==Example==
The following example builds an IP group called <code>PRIVILEGED</code> made of all IP addresses in the 198.242.0.0 subdomain (using 16 mask bits), all addresses in the 169.231.11.0 subdomain (using 24 mask bits) and the single IP address 184.194.222.7.
The following example builds an IP group called <code>PRIVILEGED</code> made of all IP addresses in the 198.242.0.0 subdomain (using 16 mask bits), all addresses in the 169.231.11.0 subdomain (using 24 mask bits) and the single IP address 184.194.222.7.



Revision as of 22:32, 19 September 2016

Create named group of ip addresses

This command creates a named group which contains any number of IP addresses. The groupname can then be used to control Janus Web Server or Janus Sockets access based on IP address.

Syntax

JANUS DEFINEIPGROUP groupname ipaddress(es)

Where each parameter is positional and required:

groupname A 1 - 30 character name of the group with which IP addresses are being associated for ALLOW and DISALLOW rules in JANUS WEB, JANUS CLSOCK, or JANUS SRVSOCK commands.
ipaddress(es) A list of IP addresses or subnet masks. IPV4 addresses are formatted in "dotted" format: nnn.nnn.nnn.nnn. For example, 198.242.244.47 is a valid IP address. IPV4 subnet masks are formatted in one of two ways:
  • With a slash separating the subnet identifier from the subnet mask, as in "198.242.244.0/255.255.255.0"
  • With a hyphen (-) separating the subnet identifier from the number of subnet mask bits, as in 198.242.244.0-24.

These formats may be used in any combination, separated by spaces or commas, on the same command.

Note: Translation of a name to an IP address is not supported on this command.

The DEFINEIPGROUP command may be abbreviated DEFIPGROUP, DEFIPG, and DEFINEIPG.

Example

The following example builds an IP group called PRIVILEGED made of all IP addresses in the 198.242.0.0 subdomain (using 16 mask bits), all addresses in the 169.231.11.0 subdomain (using 24 mask bits) and the single IP address 184.194.222.7.

JANUS DEFIPG PRIVILEGED 198.242.0.0-16 169.231.11.0-24 184.194.222.7

See also