More .NET libraries
-
Rebex Mail Pack
IMAP, MS Graph, EWS, POP3, SMTP, MIME, S/MIME, MSG
-
Rebex Total Pack
All Rebex .NET libraries together
Back to feature list...
Connecting
On this page:
Connecting to servers using IMAP protocol
To connect to an IMAP server running on default port (143), call the single-parameter Connect
method.
A plain (unencrypted) connection is established.
// create IMAP client instance
var client = new Rebex.Net.Imap();
// connect to a server
client.Connect(hostname);
' create IMAP client instance
Dim client = New Rebex.Net.Imap()
' connect to a server
client.Connect(hostname)
Connect
method as an additional argument.
Connecting to servers using explicit or implicit TLS/SSL
To establish a secure TLS/SSL connection to an IMAP server, use the Connect
method with SslMode
argument.
Tip: Learn about the difference between explicit and implicit TLS/SSL modes.
// create IMAP client instance
var client = new Rebex.Net.Imap();
// connect to a server using explicit TLS/SSL
client.Connect(hostname, SslMode.Explicit);
// connect to a server using implicit TLS/SSL
//client.Connect(hostname, SslMode.Implicit);
' create IMAP client instance
Dim client = New Rebex.Net.Imap()
' connect to a server using explicit TLS/SSL
client.Connect(hostname, SslMode.Explicit)
' connect to a server using implicit TLS/SSL
'client.Connect(hostname, SslMode.Implicit);
Server certificate is validated automatically by Rebex IMAP, but you can customize the validation process as well.
Tip: For advanced security options, see TLS/SSL core section.
Switching to encrypted communication
It's also possible to establish a plain (unencrypted) connection first and upgrade to TLS/SSL later using the Secure
method.
// create IMAP client instance
var client = new Rebex.Net.Imap();
// connect to a server on default (not-secured) port 143
client.Connect(hostname);
// secure the connection with TLS/SSL
client.Secure();
// authenticate securely
client.Login(username, password);
' create IMAP client instance
Dim client = New Rebex.Net.Imap()
' connect to a server on default (not-secured) port 143
client.Connect(hostname)
' secure the connection with TLS/SSL
client.Secure()
' authenticate securely
client.Login(username, password)
Setting connection options
There are various connection options such as character sets, proxies, SMTP extensions, and more.
// create IMAP client instance
// ...
// use SOCKS5 proxy
client.Proxy.ProxyType = ProxyType.Socks5;
// ...
// set UTF-8 encoding for commands and responses
client.Encoding = Encoding.UTF8;
// allow only TLS 1.1
client.Settings.SslAllowedVersions = TlsVersion.TLS11;
// connect, log in, retrieve emails
// ...
' create IMAP client instance
' ...
' use SOCKS5 proxy
client.Proxy.ProxyType = ProxyType.Socks5
' ...
' set UTF-8 encoding for commands and responses
client.Encoding = Encoding.UTF8
' allow only TLS 1.1
client.Settings.SslAllowedVersions = TlsVersion.TLS11
' connect, log in, send emails
' ...
Getting info about the connection
Once connected (or authenticated), you can get useful information about the current connection such as server name, server port or user name. Don't be afraid - user's password is not stored with the connection.
// create IMAP client instance
var client = new Rebex.Net.Imap();
// connect to a server
client.Connect(hostname, SslMode.Explicit);
// display info
Console.WriteLine("Connected to {0}:{1}.", client.ServerName, client.ServerPort);
// authenticate
client.Login(username, password);
// display info to the user
Console.WriteLine("Logged on as {0}.", client.UserName);
' create IMAP client instance
Dim client = New Rebex.Net.Imap()
' connect to a server
client.Connect(hostname, SslMode.Explicit)
' display info
Console.WriteLine("Connected to {0}:{1}.", client.ServerName, client.ServerPort)
' authenticate
client.Login(username, password)
' display info to the user
Console.WriteLine("Logged on as {0}.", client.UserName)
Getting info about TLS/SSL connection
To get information about SSL connection, use TlsSocket
property.
// create IMAP client instance
var client = new Rebex.Net.Imap();
// connect to a server
client.Connect(hostname, SslMode.Explicit);
// Cipher property contains a lot of information about the current cipher
Console.WriteLine("TLS cipher info: {0}", client.TlsSocket.Cipher);
// ServerCertificate property provides access to server certificate
// the first certificate in the chain is the server's certificate
CertificateChain chain = client.TlsSocket.ServerCertificate;
Console.WriteLine("Server's certificate info: Subject: {0}, Issuer: {1}",
chain[0].GetSubject(), chain[0].GetIssuer());
' create IMAP client instance
Dim client = New Rebex.Net.Imap()
' connect to a server
client.Connect(hostname, SslMode.Explicit)
' Cipher property contains a lot of information about the current cipher
Console.WriteLine("TLS cipher info: {0}", client.TlsSocket.Cipher)
' ServerCertificate property provides access to server certificate
' the first certificate in the chain is the server's certificate
Dim chain As CertificateChain = client.TlsSocket.ServerCertificate
Console.WriteLine("Server's certificate info: Subject: {0}, Issuer: {1}",
chain(0).GetSubject(), chain(0).GetIssuer())
Back to feature list...