+ System.Text.Encoding.RegisterProvider (System.Text.CodePagesEncodingProvider.Instance);
+
+
+ System.Text.Encoding.RegisterProvider (System.Text.CodePagesEncodingProvider.Instance);
+
+ <configuration>
+ <runtime>
+ <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
+ <dependentAssembly>
+ <assemblyIdentity name="System.Runtime.CompilerServices.Unsafe" publicKeyToken="b03f5f7f11d50a3a" culture="neutral"/>
+ <bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="6.0.0.0" />
+ </dependentAssembly>
+ </assemblyBinding>
+ </runtime>
+ </configuration>
+
+ -
+
+ using (var client = new SmtpClient ()) {
+ client.ServerCertificateValidationCallback = (s,c,h,e) => true;
+
+ client.Connect (hostName, port, SecureSocketOptions.Auto);
+
+ // ...
+ }
+
+
+ bool MyServerCertificateValidationCallback (object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors sslPolicyErrors)
+ {
+ if (sslPolicyErrors == SslPolicyErrors.None)
+ return true;
+
+ // Note: The following code casts to an X509Certificate2 because it's easier to get the
+ // values for comparison, but it's possible to get them from an X509Certificate as well.
+ if (certificate is X509Certificate2 certificate2) {
+ var cn = certificate2.GetNameInfo (X509NameType.SimpleName, false);
+ var fingerprint = certificate2.Thumbprint;
+ var serial = certificate2.SerialNumber;
+ var issuer = certificate2.Issuer;
+
+ return cn == "imap.gmail.com" && issuer == "CN=GTS CA 1O1, O=Google Trust Services, C=US" &&
+ serial == "00BABE95B167C9ECAF08000000006065B6" &&
+ fingerprint == "E79A011EF55EEC72D2B7E391D193761372796836";
+ }
+
+ return false;
+ }
+
+
+ using (var client = new SmtpClient ()) {
+ client.CheckCertificateRevocation = false;
+
+ client.Connect (hostName, port, SecureSocketOptions.Auto);
+
+ // ...
+ }
+
+
+ using (var client = new SmtpClient ()) {
+ // Allow SSLv3.0 and all versions of TLS
+ client.SslProtocols = SslProtocols.Ssl3 | SslProtocols.Tls | SslProtocols.Tls11 | SslProtocols.Tls12 | SslProtocols.Tls13;
+
+ client.Connect ("smtp.gmail.com", 465, true);
+
+ // ...
+ }
+
+ -
+
-
+
using (var client = new ImapClient ()) {
client.Connect ("imap.gmail.com", 993, SecureSocketOptions.SslOnConnect);
-
- // disable OAuth2 authentication unless you are actually using an access_token
- client.AuthenticationMechanisms.Remove ("XOAUTH2");
-
- client.Authenticate ("user@gmail.com", "password");
+ client.Authenticate ("user@gmail.com", "app-specific-password");
// do stuff...
@@ -153,33 +471,68 @@ using (var client = new ImapClient ()) {
-var certificate = new X509Certificate2 (@"C:\path\to\certificate.p12", "password", X509KeyStorageFlags.Exportable);
-var credential = new ServiceAccountCredential (new ServiceAccountCredential.Initializer ("your-developer-id@developer.gserviceaccount.com") {
- // Note: other scopes can be found here: https://developers.google.com/gmail/api/auth/scopes
- Scopes = new[] { "https://mail.google.com/" },
- User = "user@gmail.com"
-}.FromCertificate (certificate));
-
-// Note: result will be true if the access token was received successfully
-bool result = await credential.RequestAccessTokenAsync (cancel.Token);
-
-// use the access token as the password string
-client.Authenticate ("user@gmail.com", credential.Token.AccessToken);
+const string GMailAccount = "username@gmail.com";
+
+var clientSecrets = new ClientSecrets {
+ ClientId = "XXX.apps.googleusercontent.com",
+ ClientSecret = "XXX"
+};
+
+var codeFlow = new GoogleAuthorizationCodeFlow (new GoogleAuthorizationCodeFlow.Initializer {
+ // Cache tokens in ~/.local/share/google-filedatastore/CredentialCacheFolder on Linux/Mac
+ DataStore = new FileDataStore ("CredentialCacheFolder", false),
+ Scopes = new [] { "https://mail.google.com/" },
+ ClientSecrets = clientSecrets
+});
+
+var codeReceiver = new LocalServerCodeReceiver ();
+var authCode = new AuthorizationCodeInstalledApp (codeFlow, codeReceiver);
+var credential = await authCode.AuthorizeAsync (GMailAccount, CancellationToken.None);
+
+if (authCode.ShouldRequestAuthorizationCode (credential.Token))
+ await credential.RefreshTokenAsync (CancellationToken.None);
+
+var oauth2 = new SaslMechanismOAuth2 (credential.UserId, credential.Token.AccessToken);
+
+using (var client = new ImapClient ()) {
+ await client.ConnectAsync ("imap.gmail.com", 993, SecureSocketOptions.SslOnConnect);
+ await client.AuthenticateAsync (oauth2);
+ await client.DisconnectAsync (true);
+}
multipart/mixed
multipart/alternative
@@ -298,7 +651,7 @@ multipart/mixed
P:MimeKit.MimeMessage.HtmlBody .
foreach (var mailbox in message.To.Mailboxes)
@@ -504,7 +857,7 @@ foreach (var mailbox in message.To.Mailboxes)
- Why do attachments with unicode filenames appear as "ATT0####.dat" in Outlook?
+ Why do attachments with Unicode filenames appear as "ATT0####.dat" in Outlook?
An attachment filename is stored as a MIME parameter on the Content-Disposition
@@ -581,7 +934,7 @@ message.WriteTo (options, stream);
T:MimeKit.Cryptography.OpenPgpContext
includes a
- Overload:MimeKit.Cryptography.OpenPgpContext.GetDecryptedStream
+ M:MimeKit.Cryptography.OpenPgpContext.DecryptTo(System.IO.Stream,System.IO.Stream,System.Threading.CancellationToken)
method which can be used to get the raw decrypted stream.
@@ -589,7 +942,7 @@ message.WriteTo (options, stream);
The method variant that has a
T:MimeKit.Cryptography.DigitalSignatureCollection
output parameter is useful in cases where the encrypted PGP blurb is also digitally signed,
- allowing you to get your hands on the list of digitial signatures in order for you to verify
+ allowing you to get your hands on the list of digital signatures in order for you to verify
each of them.
@@ -667,7 +1020,7 @@ message.WriteTo (options, stream);
- To forward a message by simply inlining the original message's text content, you can do something like this:
+ To forward a message by inlining the original message's text content, you can do something like this:
diff --git a/Documentation/Content/Getting-Started.aml b/Documentation/Content/Getting-Started.aml
index 3e0c54e1fa..b3fe5176e7 100644
--- a/Documentation/Content/Getting-Started.aml
+++ b/Documentation/Content/Getting-Started.aml
@@ -1,4 +1,4 @@
-
+
Package Manager Console
http://docs.nuget.org/docs/start-here/using-the-package-manager-console
- , simply enter the following command:
+ , enter the following command:
Install-Package MailKit
@@ -59,39 +59,23 @@
- MailKit.sln includes projects for .NET 4.0,
- .NET 4.5, Xamarin.Android, Xamarin.iOS, and the unit tests.
+ MailKit.sln includes projects for .NET 4.5.2, .NET 4.6, .NET 4.7,
+ .NET 4.8, .NET 5.0, .NET 6.0, .NETStandard 2.0, .NETStandard 2.1, and the unit tests.
- MailKit.Mobile.sln just includes the
- Xamarin.Android and Xamarin.iOS projects.
-
-
-
-
- MailKit.Net45.sln includes the .NET 4.5
- project as well as the unit tests.
-
-
-
-
- MailKit.Net40.sln just includes the
- .NET 4.0 project.
+ MailKit.Documentation.sln includes projects for generating
+ the documentation that you are reading right now.
-
- If you don't have the Xamarin products, you'll probably want to open the
- MailKit.Net45.sln instead of
- MailKit.sln .
-
Once you've opened the appropriate MailKit solution
file in either Xamarin Studio or
- Visual Studio (either will work), you can simply
- choose the Debug or Release build configuration and then build.
+ Visual Studio (either will work), you can
+ choose the Debug or Release
+ build configuration and then build.
diff --git a/Documentation/Content/Introduction.aml b/Documentation/Content/Introduction.aml
index 9963113dd9..97350de02e 100644
--- a/Documentation/Content/Introduction.aml
+++ b/Documentation/Content/Introduction.aml
@@ -16,7 +16,7 @@
SASL Authentication
- Supports the CRAM-MD5, DIGEST-MD5, LOGIN, NTLM, PLAIN, SCRAM-SHA-1, SCRAM-SHA-256, and XOAUTH2 mechanisms.
+ Supports the ANONYMOUS, CRAM-MD5, DIGEST-MD5, LOGIN, NTLM, OAUTHBEARER, PLAIN, SCRAM-SHA-1(-PLUS), SCRAM-SHA-256(-PLUS), SCRAM-SHA-512(-PLUS), and XOAUTH2 mechanisms.
-
+
+ 
- htmlWriter.WriteEndTag (HtmlTagId.BlockQuote); - - // pass the