SSLOPT (JANUS DEFINE parameter): Difference between revisions
mNo edit summary |
m (remove displaytitle) |
||
| (28 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
<span class="pageSubtitle">Specifies optional use of SSL</span> | |||
<span class="pageSubtitle" | |||
SSLOPT is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port. | <var>SSLOPT</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port. It is specified without a value. | ||
Valid only for CLSOCK 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 < | Valid only for <var>[[JANUS DEFINE#type|CLSOCK]]</var> and <var>[[JANUS DEFINE#type|FTPSERVER]]</var> (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. | ||
If SSLOPT is set for an SSL port, the SSL or NOSSL parameter (or their equivalents) on $ | ==CLSOCK ports== | ||
If <var>SSLOPT</var> is set for an SSL <var>CLSOCK</var> port, the <var>SSL</var> or <var>NOSSL</var> parameter (or their equivalents) on <var>[[$Sock_Conn]]</var> 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 SSLOPT is set for an SSL port, but no SSL or NOSSL parameter (or their equivalents) is specified on $ | If <var>SSLOPT</var> is set for an SSL port, but no SSL or NOSSL parameter (or their equivalents) is specified on <var>$Sock_Conn</var> and the applicable <var class="product">Janus Sockets</var> 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 $ | If <var>SSLOPT</var> is not set for an SSL port, SSL is used for all client connections from the port, and specifying the <var>NOSSL</var> parameter on a <var>$Sock_Conn</var> call is treated as an error. | ||
SSLOPT is | ==FPTSERVER ports== | ||
If <var>SSLOPT</var> is set for an SSL <var>FTPSERVER</var> port, FTP clients can use the <var class="product">[[Janus FTP Server|FTP Server]]</var> without using the FTP <code>AUTH</code> command to switch to using SSL. If <var>SSLOPT</var> is not specified, a client attempt to logon without issuing an <code>AUTH</code> command to switch to SSL results in a rejection of the logon attempt (with an FTP 534 response) and a closing of the connection. | |||
In other words, without the <var>SSLOPT</var> parameter, FTP commands and data must be exchanged over an encrypted SSL connection. | |||
= | [[Janus_FTP_Server#Security_and_Janus_FTP_Server|SSL support]] was made available for <var>FTPSERVER</var> ports in <var class="product">Sirius Mods</var> 8.0. | ||
See | ==See also== | ||
<ul> | |||
<li>[[List of Janus commands]] | |||
<li>[[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]] | |||
</ul> | |||
[[Category:JANUS DEFINE parameters|SSLOPT]] | [[Category:JANUS DEFINE parameters|SSLOPT]] | ||
Latest revision as of 23:59, 7 June 2016
Specifies optional use of SSL
SSLOPT is a parameter on JANUS DEFINE, which defines and sets characteristics of a Janus port. It is specified without a value.
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
If SSLOPT is set for an SSL CLSOCK 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
If SSLOPT is set for an SSL FTPSERVER port, FTP clients can use the FTP Server without using the FTP AUTH command to switch to using SSL. If SSLOPT is not specified, a client attempt to logon without issuing an AUTH command to switch to SSL results in a rejection of the logon attempt (with an FTP 534 response) and a closing of the connection.
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.