batteries.Email 1.0.15

batteries.Email

Description

This package contains a useful email service based on MailKit.

Usage

The message bus manager can be used for managing multiple instances of message bus on different locations.

Here is how to use it:

1. Add the setting binding

   builder.Services.AddOptions<SmtpSettings>()
   .BindConfiguration("MailSettings")
   .ValidateDataAnnotations()
   .ValidateOnStart();
   builder.Services.AddSingleton(resolver => resolver.GetRequiredService<IOptions<SmtpSettings>>().Value);
   
   

2. Adapt your appsettings.json and include the necessary settings: <small>(remember some provider like gmail enforce the usage of app passwords)</small>

   "MailSettings": {
    "SmtpServer": "smtp.gmail.com",
    "Port": 465,
    "Username": "my-fancy-gmail-account@gmail.com",
    "Password": "xxxx xxxx xxxx xxxx",
    "SenderAddress": "no-reply@no-mail.com",
    "SenderName": "Fancy Service"
   }
   

3. Add the background service

   builder.Services.AddSingleton<SmtpEmailService>();
   builder.Services.AddSingleton<IHostedService, SmtpEmailService>(serviceProvider => serviceProvider.GetService<SmtpEmailService>());
   builder.Services.AddSingleton<IEmailSender, SmtpEmailService>(serviceProvider => serviceProvider.GetService<SmtpEmailService>());
   

4. Inject the service (for example in one controller)

   public class DataController : ControllerBase
   {
       private readonly ILogger<DataController> logger;
       private readonly IEmailSender sender;
   
       public DataController(ILogger<DataController> logger, IEmailSender sender)
       {
           this.logger = logger;
           this.sender = sender;
       }
   }
   

OAuth2 and Microsoft Office 356

Preparation:

Follow this guide or the official guide for granting mailbox permission to a service principal.

todo