👁 Image
batteries.Email 1.0.26

batteries.Email 👁 logo

👁 NuGet Version

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",
    "UseSsl": true,
   }
   

3. Add the background service

   builder.Services.AddSingleton<IEmailSender, 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