This is an old revision of the document!

SessionOptions Class

Defines information to allow an automatic connection and authentication of the session. Is used with Session.Open method.

This feature will be available only with the next release.

Advertisement

Syntax

Namespace: WinSCP

public sealed class SessionOptions

Constructors

Name Description
SessionOptions() Default constructor.

Properties

Name Description
FtpMode FtpMode FTP mode. Possible values are FtpMode.Passive (default) and FtpMode.Active.
FtpSecure FtpSecure FTPS mode. Possible values are FtpSecure.None (default), FtpSecure.Implicit, FtpSecure.ExplicitSsl and FtpSecure.ExplicitTls.
string HostName Name of the host to connect to. Mandatory property.
string Password Password for authentication.
int PortNumber Port number to connect to. Keep default 0 to use the default port for the protocol.
Protocols Protocol Protocol to use for the session. Possible values are Protocol.Sftp (default), Protocol.Scp and Protocol.Ftp.
string SshHostKey Host key of the SSH server. Mandatory for SFTP/SCP protocol. You can leave the property null, if you set Session.DefaultConfiguration to false and make sure the host key is already accepted in the configuration, only.
string SshPrivateKey Full path to private key file. The key has to be passphrase-less or Pageant) has to be running with the key loaded (SshPrivateKey then server only to select, what private key Pageant should use, in case more are loaded).
string SslSertificate SSL/TLS certificate to be automatically accepted (useful for certificates signed by untrusted authority).
TimeSpan Timeout Server response timeout. Defaults to 15 seconds.
string UserName Username for authentication. Mandatory property.

Advertisement

Methods

Name Description
void AddRawSettings(string setting, string value) Allows configuring any session settings using raw format as in an INI file. E.g. to enable SSH compression and agent forwarding use AddRawSettings("Compression", "1") and AddRawSettings("AgentFwd", "1").

Remarks

You need to fill in all properties required to connect and authenticate your session automatically.

You always need to fill in Protocol, HostName and UserName1.

In most cases you need to fill in Password. Exceptions are:

  • You use different authentication method than a password authentication, such as public key authetication (with passphrase-less private key or with use of Pageant) for SSH session;
  • The server does not require password.

For SSH (SFTP/SCP) session you need to fill in the SshHostKey to verify the expected server host key.

Example

See overall example for WinSCP .NET assembly.

  1. Except for very rare occasions that the server does not require username.Back

Last modified: by martin