SSLPROT (JANUS DEFINE parameter): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
 
(32 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:SSLPROT}}
<span class="pageSubtitle">SSLPROT xxx &mdash; Degree of SSL-like encryption</span>
<span class="pageSubtitle"><section begin="desc" />xxx<section end="desc" /></span>


SSLPROT is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port. See the [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]].
==Description==
<var>SSLPROT</var> is a parameter on the <var>[[JANUS DEFINE]]</var> command, which defines and sets characteristics of a Janus port.  


This parameter lets you specify the degree of SSL-like encryption available at this port. ''[[Janus Network Security]]'' currently supports two Secure Socket Layer (SSL) protocols (SSL V2 and SSL V3) and the Transport Layer Security (TLS) protocol, an extension to SSL V3 but developed by the IETF Internet standards group.  
This parameter lets you specify the degree of SSL-like encryption available at this port. <var class="product">[[Janus Network Security|Rocket M204 Janus Network Security]]</var> supports the Secure Socket Layer (SSL) protocol as well as the Transport Layer Security (TLS) protocol, an extension to SSL V3 but developed by the IETF Internet standards group. For the versions and levels of these protocols that are supported, see the parameter table below.


During the negotiation for a connection to or from this port, Janus will offer the most secure protocol available, then, if necessary, will fall back to the next lower one available, and so on. The SSLPROT parameter lets you explicitly disallow one or more protocols from the negotiation.  
During the negotiation for a connection to or from this port, Janus will offer the most secure protocol available, then, if necessary, will fall back to the next lower one available, and so on. The <var>SSLPROT</var> parameter lets you explicitly disallow one or more protocols from the negotiation.  
 
<var>SSLPROT</var> is a bitmask parameter whose main values are:
 
<table class="thJustBold">
<tr class="head"><th>Bit</th><th>Description</th></tr>


SSLPROT is a bitmask parameter whose main values are:
<table class="syntaxTable">
<tr><th>X'01'</th>
<tr><th>X'01'</th>
<td>SSL, V2 support. This is less secure than SSL V3 or TLS.</td></tr>
<td>SSL, V2 support. This is less secure than SSL V3 or TLS. Not supported in <var class="product">Model 204</var> 7.5 and later.</td></tr>
 
<tr><th>X'02'</th>
<tr><th>X'02'</th>
<td>SSL, V3 support. This is less secure than TLS.</td></tr>
<td>SSL, V3 support. This is less secure than TLS.</td></tr>
<tr><th>X'04'</th>
<tr><th>X'04'</th>
<td>TLS, V1 support.</td></tr>
<td>TLS, 1.0 support.</td></tr>
<tr><th>X'07'</th>
 
<td>The default. SSL V2, SSL V3, and TLS are available. Janus will try for them in the order: TLS, SSL V3, SSL V2.
<tr><th>X'08'</th>
</td></tr></table>
<td>TLS 1.1  support. Available as of <var class="product">Model 204</var> 7.5.</td></tr>


<tr><th>X'10'</th>
<td>TLS 1.2  support. Available as of <var class="product">Model 204</var> 7.5.</td></tr>


A typical reason for explicitly specifying an SSLPROT value is to require a more secure connection for a port. If a client attempts to connect to a Janus server port using a protocol explicitly disallowed by SSLPROT, the connection is immediately broken, except for WEBSERV ports where the SSLPROTOCOLERR exception handler will be run if available.  
<tr><th>X'07'</th>
<td>The default under <var class="product">Model 204</var> 7.4 and earlier. SSL V2, SSL V3, and TLS 1.0 are available. Janus will try for them in the order: TLS 1.0, SSL V3, and SSL V2.
<tr><th>X'1E'</th>
<td>The default under <var class="product">Model 204</var> 7.5 and later. SSL V3, and TLS 1.0, TLS 1.1, and TLS1.2 are available. Janus will try for them in the order: TLS 1.2, TLS 1.1, TLS 1.0, and SSL V3.</td></tr>
</table>


Janus CLSOCK ports will attempt to connect under the most secure protocol available, and will fall back to the next-most secure protocol available; if less-secure protocols are disallowed by SSLPROT, the connection attempt will fail.  
A typical reason for explicitly specifying an <var>SSLPROT</var> value is to require a more secure connection for a port. If a client attempts to connect to a Janus server port using a protocol explicitly disallowed by <var>SSLPROT</var>, the connection is immediately broken, except for <var>[[JANUS DEFINE#type|WEBSERV]]</var> ports where the <var>SSLPROTOCOLERR</var> exception handler will be run if available.  


Before Version 6.0 of the ''[[Sirius Mods]]'', only SSL V2 was supported and the SSLPROT parameter was not available.  
Janus <var>[[JANUS DEFINE#type|CLSOCK]]</var> ports will attempt to connect under the most secure protocol available, and will fall back to the next-most secure protocol available; if less-secure protocols are disallowed by <var>SSLPROT</var>, the connection attempt will fail.  


SSLPROT is valid for SRVSOCK, &P$WBSYB port types.
<var>SSLPROT</var> is valid for <var>[[JANUS DEFINE#type|SRVSOCK]]</var>, <var>CLSOCK</var>, <var>WEBSERV</var>, <var>[[JANUS DEFINE#type|OPENSERV]]</var>, and <var>[[JANUS DEFINE#type|SDS]]</var> port types.


==References==
==See also==


See: [[List of Janus commands]] | [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]].
<ul>
<li>[[SSLCIPH (JANUS DEFINE parameter)]]
<li>[[List of Janus commands]]
<li>[[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]
</ul>


[[Category:JANUS DEFINE parameters|SSLPROT]]
[[Category:JANUS DEFINE parameters|SSLPROT]]

Latest revision as of 15:42, 17 June 2016

SSLPROT xxx — Degree of SSL-like encryption

Description

SSLPROT is a parameter on the JANUS DEFINE command, which defines and sets characteristics of a Janus port.

This parameter lets you specify the degree of SSL-like encryption available at this port. Rocket M204 Janus Network Security supports the Secure Socket Layer (SSL) protocol as well as the Transport Layer Security (TLS) protocol, an extension to SSL V3 but developed by the IETF Internet standards group. For the versions and levels of these protocols that are supported, see the parameter table below.

During the negotiation for a connection to or from this port, Janus will offer the most secure protocol available, then, if necessary, will fall back to the next lower one available, and so on. The SSLPROT parameter lets you explicitly disallow one or more protocols from the negotiation.

SSLPROT is a bitmask parameter whose main values are:

BitDescription
X'01' SSL, V2 support. This is less secure than SSL V3 or TLS. Not supported in Model 204 7.5 and later.
X'02' SSL, V3 support. This is less secure than TLS.
X'04' TLS, 1.0 support.
X'08' TLS 1.1 support. Available as of Model 204 7.5.
X'10' TLS 1.2 support. Available as of Model 204 7.5.
X'07' The default under Model 204 7.4 and earlier. SSL V2, SSL V3, and TLS 1.0 are available. Janus will try for them in the order: TLS 1.0, SSL V3, and SSL V2.
X'1E' The default under Model 204 7.5 and later. SSL V3, and TLS 1.0, TLS 1.1, and TLS1.2 are available. Janus will try for them in the order: TLS 1.2, TLS 1.1, TLS 1.0, and SSL V3.

A typical reason for explicitly specifying an SSLPROT value is to require a more secure connection for a port. If a client attempts to connect to a Janus server port using a protocol explicitly disallowed by SSLPROT, the connection is immediately broken, except for WEBSERV ports where the SSLPROTOCOLERR exception handler will be run if available.

Janus CLSOCK ports will attempt to connect under the most secure protocol available, and will fall back to the next-most secure protocol available; if less-secure protocols are disallowed by SSLPROT, the connection attempt will fail.

SSLPROT is valid for SRVSOCK, CLSOCK, WEBSERV, OPENSERV, and SDS port types.

See also

Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=SSLPROT_(JANUS_DEFINE_parameter)&oldid=84603"