Azure Email Communication Services (Lombiq Technologies: OCORE-129)

OrchardCore.sln

@@ -427,8 +427,12 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "OrchardCore.AuditTrail.Abst
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "OrchardCore.AuditTrail", "src\OrchardCore.Modules\OrchardCore.AuditTrail\OrchardCore.AuditTrail.csproj", "{67509F89-E3D6-4FF9-98EC-A9519937A364}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "OrchardCore.Email.Azure", "src\OrchardCore.Modules\OrchardCore.Email.Azure\OrchardCore.Email.Azure.csproj", "{91DD6469-20AE-4F94-AF49-C13E8FCA4343}"
+EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "OrchardCore.Email.Core", "src\OrchardCore\OrchardCore.Email.Core\OrchardCore.Email.Core.csproj", "{D00CF459-396D-49C9-92E2-3FD3C2A59847}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "OrchardCore.Email.Smtp", "src\OrchardCore.Modules\OrchardCore.Email.Smtp\OrchardCore.Email.Smtp.csproj", "{44BF04A1-5C0C-4773-9C1E-FE1013841857}"
+EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "OrchardCore", "OrchardCore", "{2BC850C3-9846-47E1-9068-AC0A8E5537AC}"
 	ProjectSection(SolutionItems) = preProject
 		src\OrchardCore\Directory.Build.props = src\OrchardCore\Directory.Build.props
@@ -1343,6 +1347,14 @@ Global
 		{20356393-B16D-466C-8203-877A534E287D}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{20356393-B16D-466C-8203-877A534E287D}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{20356393-B16D-466C-8203-877A534E287D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{91DD6469-20AE-4F94-AF49-C13E8FCA4343}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{91DD6469-20AE-4F94-AF49-C13E8FCA4343}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{91DD6469-20AE-4F94-AF49-C13E8FCA4343}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{91DD6469-20AE-4F94-AF49-C13E8FCA4343}.Release|Any CPU.Build.0 = Release|Any CPU
+		{44BF04A1-5C0C-4773-9C1E-FE1013841857}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{44BF04A1-5C0C-4773-9C1E-FE1013841857}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{44BF04A1-5C0C-4773-9C1E-FE1013841857}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{44BF04A1-5C0C-4773-9C1E-FE1013841857}.Release|Any CPU.Build.0 = Release|Any CPU
 		{5527BACF-FA5D-4617-978B-7EDE8942E6F6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{5527BACF-FA5D-4617-978B-7EDE8942E6F6}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{5527BACF-FA5D-4617-978B-7EDE8942E6F6}.Release|Any CPU.ActiveCfg = Release|Any CPU
@@ -1590,6 +1602,8 @@ Global
 		{2D93F509-1FB3-4E22-92F0-588D0EFBA921} = {F23AC6C2-DE44-4699-999D-3C478EF3D691}
 		{CBF6DB53-FD0C-47F8-9E60-A1D247ACFD05} = {A066395F-6F73-45DC-B5A6-B4E306110DCE}
 		{20356393-B16D-466C-8203-877A534E287D} = {F23AC6C2-DE44-4699-999D-3C478EF3D691}
+		{91DD6469-20AE-4F94-AF49-C13E8FCA4343} = {A066395F-6F73-45DC-B5A6-B4E306110DCE}
+		{44BF04A1-5C0C-4773-9C1E-FE1013841857} = {A066395F-6F73-45DC-B5A6-B4E306110DCE}
 		{5527BACF-FA5D-4617-978B-7EDE8942E6F6} = {90030E85-0C4F-456F-B879-443E8A3F220D}
 		{E9428DE8-5D81-4359-BF84-31435041FF1A} = {F23AC6C2-DE44-4699-999D-3C478EF3D691}
 		{95187E6A-5B74-4475-8FEB-758ACD012DCC} = {90030E85-0C4F-456F-B879-443E8A3F220D}

src/OrchardCore.Build/Dependencies.props

@@ -12,6 +12,7 @@
     <PackageManagement Include="AWSSDK.S3" Version="3.7.104.11" />
     <PackageManagement Include="AWSSDK.Extensions.NETCore.Setup" Version="3.7.7" />
     <PackageManagement Include="AWSSDK.SecurityToken" Version="3.7.101.60" />
+    <PackageManagement Include="Azure.Communication.Email" Version="1.0.1" />
     <PackageManagement Include="Azure.Extensions.AspNetCore.Configuration.Secrets" Version="1.3.0" />
     <PackageManagement Include="Azure.Extensions.AspNetCore.DataProtection.Blobs" Version="1.3.2" />
     <PackageManagement Include="Azure.Identity" Version="1.10.4" />
@@ -37,6 +38,7 @@
     <PackageManagement Include="MailKit" Version="4.3.0" />
     <PackageManagement Include="Markdig" Version="0.34.0" />
     <PackageManagement Include="MessagePack" Version="2.2.60" />
+    <PackageManagement Include="Microsoft.Extensions.Diagnostics.Testing" Version="8.1.0" />
     <PackageManagement Include="Microsoft.Extensions.Azure" Version="1.7.1" />
     <PackageManagement Include="Microsoft.Identity.Web" Version="2.16.0" />
     <PackageManagement Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />

src/OrchardCore.Cms.Web/appsettings.json

@@ -32,6 +32,10 @@
     //  "BlobName": "", // Optional, defaults to Sites/tenant_name/DataProtectionKeys.xml. Templatable, refer docs.
     //  "CreateContainer": true // Creates the container during app startup if it does not already exist.
     //},
+    //"OrchardCore_Email_Azure": {
+    //  "DefaultSender": "",
+    //  "ConnectionString": "" // Set to your Azure Communication Service email connection string.
+    //},
     // See https://docs.orchardcore.net/en/latest/docs/reference/modules/Markdown/#markdown-configuration
     //"OrchardCore_Markdown": {
     //  "Extensions": "nohtml+advanced"

src/OrchardCore.Modules/OrchardCore.Email.Azure/AdminMenu.cs

@@ -0,0 +1,36 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.Extensions.Localization;
+using OrchardCore.Navigation;
+
+namespace OrchardCore.Email.Azure
+{
+    public class AdminMenu : INavigationProvider
+    {
+        protected readonly IStringLocalizer S;
+
+        public AdminMenu(IStringLocalizer<AdminMenu> localizer)
+        {
+            S = localizer;
+        }
+
+        public Task BuildNavigationAsync(string name, NavigationBuilder builder)
+        {
+            if (!string.Equals(name, "admin", StringComparison.OrdinalIgnoreCase))
+                return Task.CompletedTask;
+
+            builder
+                .Add(S["Configuration"], configuration => configuration
+                    .Add(S["Settings"], settings => settings
+                        .Add(S["Email"], S["Email"].PrefixPosition(), email => email
+                            .AddClass("email").Id("email")
+                            .Add(S["Azure Email Settings"], S["Azure Email Settings"].PrefixPosition(), options => options
+                                .Action("Options", "Admin", new { area = "OrchardCore.Email.Azure" })
+                                .Permission(Permissions.ViewAzureEmailOptions)
+                                .LocalNav())
+                )));
+
+            return Task.CompletedTask;
+        }
+    }
+}

src/OrchardCore.Modules/OrchardCore.Email.Azure/AzureEmailSettings.cs

@@ -0,0 +1,13 @@
+namespace OrchardCore.Email.Azure
+{
+    /// <summary>
+    /// Represents a settings for Azure email.
+    /// </summary>
+    public class AzureEmailSettings : EmailSettings
+    {
+        /// <summary>
+        /// Gets or sets the connection string.
+        /// </summary>
+        public string ConnectionString { get; set; }
+    }
+}

src/OrchardCore.Modules/OrchardCore.Email.Azure/Controllers/AdminController.cs

@@ -0,0 +1,36 @@
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Extensions.Options;
+using OrchardCore.Email.Azure.ViewModels;
+
+namespace OrchardCore.Email.Azure.Controllers
+{
+    public class AdminController : Controller
+    {
+        private readonly IAuthorizationService _authorizationService;
+        private readonly AzureEmailSettings _options;
+
+        public AdminController(IAuthorizationService authorizationService, IOptions<AzureEmailSettings> options)
+        {
+            _authorizationService = authorizationService;
+            _options = options.Value;
+        }
+
+        public async Task<IActionResult> Options()
+        {
+            if (!await _authorizationService.AuthorizeAsync(User, Permissions.ViewAzureEmailOptions))
+            {
+                return Forbid();
+            }
+
+            var model = new OptionsViewModel
+            {
+                DefaultSender = _options.DefaultSender,
+                ConnectionString = _options.ConnectionString
+            };
+
+            return View(model);
+        }
+    }
+}

src/OrchardCore.Modules/OrchardCore.Email.Azure/Extensions/OrchardCoreBuilderExtensions.cs

@@ -0,0 +1,21 @@
+using Microsoft.Extensions.Configuration;
+using OrchardCore.Email.Azure;
+using OrchardCore.Environment.Shell.Configuration;
+
+namespace Microsoft.Extensions.DependencyInjection
+{
+    public static class OrchardCoreBuilderExtensions
+    {
+        public static OrchardCoreBuilder ConfigureAzureEmailSettings(this OrchardCoreBuilder builder)
+        {
+            builder.ConfigureServices((tenantServices, serviceProvider) =>
+            {
+                var configurationSection = serviceProvider.GetRequiredService<IShellConfiguration>().GetSection("OrchardCore_Email_Azure");
+
+                tenantServices.PostConfigure<AzureEmailSettings>(settings => configurationSection.Bind(settings));
+            });
+
+            return builder;
+        }
+    }
+}

src/OrchardCore.Modules/OrchardCore.Email.Azure/Manifest.cs

@@ -0,0 +1,11 @@
+using OrchardCore.Modules.Manifest;
+
+[assembly: Module(
+    Name = "Azure Email Communication Services",
+    Author = ManifestConstants.OrchardCoreTeam,
+    Website = ManifestConstants.OrchardCoreWebsite,
+    Version = ManifestConstants.OrchardCoreVersion,
+    Description = "Provides email settings configuration and a default email service based on Azure Communication Services (ACS).",
+    Dependencies = ["OrchardCore.Email"],
+    Category = "Messaging"
+)]

src/OrchardCore.Modules/OrchardCore.Email.Azure/OrchardCore.Email.Azure.csproj

@@ -0,0 +1,29 @@
+<Project Sdk="Microsoft.NET.Sdk.Razor">
+
+  <PropertyGroup>
+    <AddRazorSupportForMvc>true</AddRazorSupportForMvc>
+    <!-- NuGet properties-->
+    <Title>OrchardCore Azure Email</Title>
+    <Description>$(OCFrameworkDescription)
+
+      Provides email settings configuration and a default email service based on Azure Communication Services.</Description>
+    <PackageTags>$(PackageTags) OrchardCoreFramework</PackageTags>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <FrameworkReference Include="Microsoft.AspNetCore.App" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\OrchardCore\OrchardCore.Admin.Abstractions\OrchardCore.Admin.Abstractions.csproj" />
+    <ProjectReference Include="..\..\OrchardCore\OrchardCore.DisplayManagement\OrchardCore.DisplayManagement.csproj" />
+    <ProjectReference Include="..\..\OrchardCore\OrchardCore.Email.Abstractions\OrchardCore.Email.Abstractions.csproj" />
+    <ProjectReference Include="..\..\OrchardCore\OrchardCore.Navigation.Core\OrchardCore.Navigation.Core.csproj" />
+    <ProjectReference Include="..\..\OrchardCore\OrchardCore.Module.Targets\OrchardCore.Module.Targets.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Azure.Communication.Email" />
+  </ItemGroup>
+
+</Project>

src/OrchardCore.Modules/OrchardCore.Email.Azure/Permissions.cs

@@ -0,0 +1,33 @@
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using OrchardCore.Security.Permissions;
+
+namespace OrchardCore.Email.Azure
+{
+    public class Permissions : IPermissionProvider
+    {
+        public static readonly Permission ViewAzureEmailOptions = new(nameof(ViewAzureEmailOptions), "View Azure Email Options");
+
+        public Task<IEnumerable<Permission>> GetPermissionsAsync()
+        {
+            return Task.FromResult(new[]
+            {
+                ViewAzureEmailOptions,
+            }
+            .AsEnumerable());
+        }
+
+        public IEnumerable<PermissionStereotype> GetDefaultStereotypes()
+        {
+            return new[]
+            {
+                new PermissionStereotype
+                {
+                    Name = "Administrator",
+                    Permissions = new[] { ViewAzureEmailOptions },
+                },
+            };
+        }
+    }
+}