SSLOPT (JANUS DEFINE parameter): Difference between revisions
m (1 revision) |
mNo edit summary |
||
| Line 4: | Line 4: | ||
<var>SSLOPT</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port. See the [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]. | <var>SSLOPT</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port. See the [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]. | ||
Valid only for CLSOCK and FTPSERVER (as of <var class="product">Sirius Mods</var> 8.0) SSL (Secure Sockets Layer) ports, this parameter specifies that the use of SSL-like encryption is optional for applications using the port. An SSL port is one that includes the <var>[[SSL (JANUS DEFINE parameter)|SSL]]</var> parameter in its definition. | Valid only for <var>[[JANUS DEFINE#type|CLSOCK]]</var> and FTPSERVER (as of <var class="product">Sirius Mods</var> 8.0) SSL (Secure Sockets Layer) ports, this parameter specifies that the use of SSL-like encryption is optional for applications using the port. An SSL port is one that includes the <var>[[SSL (JANUS DEFINE parameter)|SSL]]</var> parameter in its definition. | ||
==CLSOCK ports== | ==CLSOCK ports== | ||
For <var> | For <var>CLSOCK</var> ports, if <var>SSLOPT</var> is set for an SSL port, the SSL or NOSSL parameter (or their equivalents) on $SOCK_CONN and the applicable <var class="product">[[Janus Sockets]]</var> object method calls determines whether or not the connection will be encrypted. If the connection is encrypted, the <var>[[SSLPROT (JANUS DEFINE parameter)|SSLPROT]]</var> setting influences the type of encryption protocol that will be used. | ||
If <var>SSLOPT</var> is set for an SSL port, but no SSL or NOSSL parameter (or their equivalents) is specified on $SOCK_CONN and the applicable <var class="product">Janus Sockets</var> object method calls, the connection is '''not''' encrypted by default. | If <var>SSLOPT</var> is set for an SSL port, but no SSL or NOSSL parameter (or their equivalents) is specified on $SOCK_CONN and the applicable <var class="product">Janus Sockets</var> object method calls, the connection is '''not''' encrypted by default. | ||
| Line 20: | Line 20: | ||
==See also== | ==See also== | ||
<ul> | <ul> | ||
<li>[[List of Janus commands]] | <li>[[List of Janus commands]] | ||
Revision as of 19:38, 29 February 2012
<section begin="desc" />Specifies optional use of SSL<section end="desc" />
SSLOPT is a parameter on JANUS DEFINE, which defines and sets characteristics of a Janus port. See the List of JANUS DEFINE parameters.
Valid only for CLSOCK and FTPSERVER (as of Sirius Mods 8.0) SSL (Secure Sockets Layer) ports, this parameter specifies that the use of SSL-like encryption is optional for applications using the port. An SSL port is one that includes the SSL parameter in its definition.
CLSOCK ports
For CLSOCK ports, if SSLOPT is set for an SSL port, the SSL or NOSSL parameter (or their equivalents) on $SOCK_CONN and the applicable Janus Sockets object method calls determines whether or not the connection will be encrypted. If the connection is encrypted, the SSLPROT setting influences the type of encryption protocol that will be used.
If SSLOPT is set for an SSL port, but no SSL or NOSSL parameter (or their equivalents) is specified on $SOCK_CONN and the applicable Janus Sockets object method calls, the connection is not encrypted by default.
If SSLOPT is not set for an SSL port, SSL is used for all client connections from the port, and specifying the NOSSL parameter on a $Sock_Conn call is treated as an error.
FPTSERVER ports
For FTPSERVER ports, if SSLOPT is set, FTP clients can use the FTP server without using the AUTH FTP command to switch to using SSL. If SSLOPT is not specified, a client attempt to logon without issuing an AUTH FTP command to switch to SSL will result in the logon attempt being rejected with an FTP 534 response and the connection being closed. In other words, without the SSLOPT parameter, FTP commands and data must be exchanged over an encrypted SSL connection.
SSL support was made available for FTPSERVER ports in Sirius Mods 8.0.