SSLPROT (JANUS DEFINE parameter): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (link repair)
Line 5: Line 5:
<var>SSLPROT</var> is a parameter on the <var>[[JANUS DEFINE]]</var> command, which defines and sets characteristics of a Janus port.  
<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. <var class="product">[http://m204wiki.rocketsoftware.com/images/d/de/JansslrNew.pdf 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.
This parameter lets you specify the degree of SSL-like encryption available at this port. <var class="product">[[Media:JansslrNew.pdf|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 <var>SSLPROT</var> 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.  

Revision as of 18:04, 22 March 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. Only available in Model 204 7.5 and later.
X'10' TLS 1.2 support. Only available in Model 204 7.5 and later.
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