Including this package will replace the original mail target and has the same options as the original mail target, see docs of the original mailTarget. But Mailkit does not yet support SmtpAuthentication = NTLM.

This library is integration tested with the SmtpServer NuGet package

How to use

1. Install the package:

   Install-Package NLog.MailKit or in your csproj:

   <PackageReference Include="NLog.MailKit" Version="6.*" />

2. Add to your nlog.config:

   <extensions> <add assembly="NLog.MailKit"/> </extensions>

   Alternative register from code using fluent configuration API:

   LogManager.Setup().SetupExtensions(ext => ext.RegisterTarget<NLog.MailKit.MailTarget>());

See the NLog Wiki for available options and examples.

Note that the option skipCertificateValidation="true" can prevent AuthenticationException if your remote certificate for smtpServer is invalid - not recommend!

OAuth2 Authentication

Mailkit supports OAuth2 authentication by specifying SmtpAuthentication = OAuth2 together with:

• SmtpUserName = ${gdc:OAuthClientId}
• SmtpPassword = ${gdc:OAuthClientSecret}

Before using OAuth2 authentication, make sure to acquire an access token from your email provider (e.g., Gmail, Outlook) and store it in the Global Diagnostics Context (GDC) with the key OAuthClientSecret (And ensure it is refreshed before expiry). Alternative store the access token in an environment variable and use the NLog ${environment:variable=OAuthClientSecret} instead of NLog GDC.

• Using OAuth2 With Microsoft Outlook Exchange
• Using OAuth2 With Google GMail

License

BSD. License of MailKit is MIT