From 57f4b8a3e0805636167749035ee4304a31d5db08 Mon Sep 17 00:00:00 2001
From: Mark Harrison <mark.harrison@octopus.com>
Date: Wed, 26 Feb 2025 14:58:35 +0000
Subject: [PATCH 1/2] Add step template to support sending email via MailKit

---
 gulpfile.babel.js              |   2 +
 step-templates/logos/email.png | Bin 0 -> 10012 bytes
 step-templates/send-email.json | 148 +++++++++++++++++++++++++++++++++
 3 files changed, 150 insertions(+)
 create mode 100644 step-templates/logos/email.png
 create mode 100644 step-templates/send-email.json

diff --git a/gulpfile.babel.js b/gulpfile.babel.js
index 114233eb4..bb441ee37 100644
--- a/gulpfile.babel.js
+++ b/gulpfile.babel.js
@@ -145,6 +145,8 @@ function humanize(categoryId) {
       return "EdgeCast";
     case "elmah":
       return "ELMAH";
+    case "email":
+      return "Email";  
     case "entityframework":
       return "Entity Framework";
     case "event-tracing":
diff --git a/step-templates/logos/email.png b/step-templates/logos/email.png
new file mode 100644
index 0000000000000000000000000000000000000000..b5ba86bdc4e192af773ea167d80be11fb11a15d2
GIT binary patch
literal 10012
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
Uvl_v;ciaG7O+$@JHK)k`0$F)1vH$=8

literal 0
HcmV?d00001

diff --git a/step-templates/send-email.json b/step-templates/send-email.json
new file mode 100644
index 000000000..784881845
--- /dev/null
+++ b/step-templates/send-email.json
@@ -0,0 +1,148 @@
+{
+    "Id": "b163a315-24b7-4bf8-9cca-d9011f57019a",
+    "Name": "Send Email using MailKit",
+    "Description": "This step template supports sending an email using the [MailKit](https://github.com/jstedfast/MailKit) library, a cross-platform .NET library for IMAP, POP3, and SMTP.\n\n- Support for multiple TO addresses (separated by `,`).\n- Support for multiple CC addresses (separated by `,`).\n- *Optional* support for a separate `reply-to` address.\n\nThis step **does not** support running on PowerShell: Windows Desktop Edition.\n\n---\n\n**Required:** \n- The `MailKit` and `MimeKit` packages are installed on the target or worker. If the packages can't be found, the step will attempt to download them from [https://www.nuget.org](https://www.nuget.org).\n- PowerShell Core (including when running on Windows).\n\n*Notes:*\n\n- Tested on Octopus `2025.1`.\n- Tested on Windows and Linux with PowerShell Core only.",
+    "ActionType": "Octopus.Script",
+    "Version": 1,
+    "CommunityActionTemplateId": null,
+    "Packages": [],
+    "GitDependencies": [],
+    "Properties": {
+      "Octopus.Action.PowerShell.Edition": "Core",
+      "Octopus.Action.EnabledFeatures": "Octopus.Features.SelectPowerShellEditionForWindows",
+      "Octopus.Action.Script.ScriptSource": "Inline",
+      "Octopus.Action.Script.Syntax": "PowerShell",
+      "Octopus.Action.Script.ScriptBody": "$ErrorActionPreference = \"Stop\";\n\nif ($PSEdition -eq \"Core\") {\n    $PSStyle.OutputRendering = \"PlainText\"\n}\n$emailSubject = $OctopusParameters[\"SendEmail.Subject\"]\n$emailSmtpServer = $OctopusParameters[\"SendEmail.SmtpServer\"]\n$emailSmtpPort = $OctopusParameters[\"SendEmail.SmtpPort\"]\n$emailCredentialsUsername = $OctopusParameters[\"SendEmail.Credentials.Username\"]\n$emailCredentialsPassword = $OctopusParameters[\"SendEmail.Credentials.Password\"]\n$emailSecureSocketOption = $OctopusParameters[\"SendEmail.SecureSocketOption\"]\n\n$validSecureSocketOptions = @(\"None\", \"Auto\", \"SslOnConnect\", \"StartTls\", \"StartTlsWhenAvailable\")\nif(-not $validSecureSocketOptions.Contains($emailSecureSocketOption)) {\n    Write-Error \"Invalid SecureSocketOption: $emailSecureSocketOption. Must be one of: $($validSecureSocketOptions -join \", \").\"\n    return\n}\n\n$emailFromAddress = $OctopusParameters[\"SendEmail.FromAddress\"]\n$emailToAddresses = $OctopusParameters[\"SendEmail.TOAddresses\"]\n$emailCcAddresses = $OctopusParameters[\"SendEmail.CCAddresses\"]\n$emailReplyToAddress = $OctopusParameters[\"SendEmail.ReplyToAddress\"]\n\n$HtmlBody = $OctopusParameters[\"SendEmail.HtmlBody\"]\n$TextBody = $OctopusParameters[\"SendEmail.TextBody\"]\n\nWrite-Verbose \"Checking for MimeKit and MailKit packages.\"\ntry {\n    \n    $MimeKitPackage = (Get-Package MimeKit -ErrorAction Stop) | Select-Object -First 1\n} \ncatch {\n    $MimeKitPackage = $null\n}\nif ($null -eq $MimeKitPackage) {\n    Write-Output \"Downloading MimeKit from nuget.org.\"\n    Install-Package -Name 'MimeKit' -Source \"https://www.nuget.org/api/v2\" -SkipDependencies -Force -Scope CurrentUser\n    $MimeKitPackage = (Get-Package MimeKit) | Select-Object -First 1\n}\n\ntry {\n    $MailKitPackage = (Get-Package MailKit -ErrorAction Stop) | Select-Object -First 1\n} \ncatch {\n    $MailKitPackage = $null\n}\nif ($null -eq $MailKitPackage) {\n    Write-Output \"Downloading MailKit from nuget.org.\"\n    Install-Package -Name 'MailKit' -Source \"https://www.nuget.org/api/v2\" -SkipDependencies -Force -Scope CurrentUser\n    $MailKitPackage = (Get-Package MailKit) | Select-Object -First 1\n}\n\n$MimeKitPath = Join-Path (Get-Item $MimeKitPackage.source).Directory.FullName \"lib/netstandard2.1/MimeKit.dll\"\n$MailKitPath = Join-Path (Get-Item $MailKitPackage.source).Directory.FullName \"lib/netstandard2.1/MailKit.dll\"\n\nAdd-Type -Path $MimeKitPath\nAdd-Type -Path $MailKitPath\n\n# Validation/Setting of Secure Socket Options needed after libraries loaded\nswitch($emailSecureSocketOption) {\n    \"Auto\" {\n        $secureSocketOption = [MailKit.Security.SecureSocketOptions]::Auto\n    }\n    \"None\" {\n        $secureSocketOption = [MailKit.Security.SecureSocketOptions]::None\n    }\n    \"SslOnConnect\" {\n        $secureSocketOption = [MailKit.Security.SecureSocketOptions]::SslOnConnect\n    }\n    \"StartTls\" {\n        $secureSocketOption = [MailKit.Security.SecureSocketOptions]::StartTls\n    }\n    \"StartTlsWhenAvailable\" {\n        $secureSocketOption = [MailKit.Security.SecureSocketOptions]::StartTlsWhenAvailable\n    }\n    default {\n        Write-Error \"Invalid SecureSocketOption: $emailSecureSocketOption. Must be one of: $($validSecureSocketOptions -join \", \").\"\n        return\n    }\n}\n\n$SMTP = New-Object MailKit.Net.Smtp.SmtpClient\n\n$Message = New-Object MimeKit.MimeMessage\n$ContentBuilder = [MimeKit.BodyBuilder]::new()\n\n$ContentBuilder.HtmlBody = $HtmlBody\n$ContentBuilder.TextBody = $TextBody\nWrite-Verbose \"Setting From address: $emailFromAddress\" \n$Message.From.Add($emailFromAddress)\n$toAddresses = $emailToAddresses -split \",\"\nWrite-Verbose \"Setting TO addresses: $emailToAddresses\"\nforeach($toAddress in $toAddresses) {\n    $Message.To.Add($toAddress)\n}\n\nif(-not [string]::IsNullOrWhitespace($emailCcAddresses)) {\n    Write-Verbose \"Setting CC addresses: $emailCcAddresses\"\n    $ccAddresses = $emailCcAddresses -split \",\"\n    foreach($ccAddress in $ccAddresses) {\n        $Message.Cc.Add($ccAddress)\n    }\n}\nif(-not [string]::IsNullOrWhitespace($emailReplyToAddress)) {\n    Write-Verbose \"Setting ReplyTo address: $emailReplyToAddress\"\n    $Message.ReplyTo.Add($emailReplyToAddress)\n}\n\nWrite-Verbose \"Setting subject to: $emailSubject\"\n$Message.Subject = $emailSubject\nWrite-Verbose \"Setting MimeMessage Body contents\"\n$Message.Body = $ContentBuilder.ToMessageBody()\nWrite-Verbose \"Connecting to SMTP server: $emailSmtpServer on port: $emailSmtpPort (using SecureSocketOption=$emailSecureSocketOption)\"\n$SMTP.Connect($emailSmtpServer, $emailSmtpPort, $secureSocketOption)\nWrite-Verbose \"Authenticating...\"\n$SMTP.Authenticate($emailCredentialsUsername, $emailCredentialsPassword)\nWrite-Output \"Sending email...\"\n$SMTP.Send($Message)\nWrite-Output \"Email sent.\"\n$SMTP.Disconnect($true)\n$SMTP.Dispose()"
+    },
+    "Parameters": [
+      {
+        "Id": "65b67843-2cd5-48a5-ac9d-611de16246a7",
+        "Name": "SendEmail.SmtpServer",
+        "Label": "SMTP Server",
+        "HelpText": "The SMTP Server address e.g. `smtp.gmail.com`",
+        "DefaultValue": "",
+        "DisplaySettings": {
+          "Octopus.ControlType": "SingleLineText"
+        }
+      },
+      {
+        "Id": "3d87558e-aa18-46af-85bb-644890d6654b",
+        "Name": "SendEmail.SmtpPort",
+        "Label": "SMTP Port",
+        "HelpText": "The SMTP Port used for connecting. Typical SMTP ports are: \n- `25`\n- `587` (STARTTLS)\n- `465` (SSL)",
+        "DefaultValue": "",
+        "DisplaySettings": {
+          "Octopus.ControlType": "SingleLineText"
+        }
+      },
+      {
+        "Id": "0c1f7ae0-8cd4-45a5-b53b-e5019ad5ecb0",
+        "Name": "SendEmail.SecureSocketOption",
+        "Label": "SSL Option",
+        "HelpText": "The [SSL Option](https://mimekit.net/docs/html/T_MailKit_Security_SecureSocketOptions.htm) to use:\n- `None`: No SSL or TLS encryption should be used\n- `Auto`: Allow the [IMailService](https://mimekit.net/docs/html/T_MailKit_IMailService.htm) to decide which SSL or TLS options to use (default). If the server does not support SSL or TLS, then the connection will continue without any encryption.\n- `SslOnConnect`: The connection should use SSL or TLS encryption immediately.\n- `StartTls`: Elevates the connection to use TLS encryption immediately after reading the greeting and capabilities of the server. If the server does not support the STARTTLS extension, then the connection will fail and a NotSupportedException will be thrown.\n- `StartTlsWhenAvailable`: Elevates the connection to use TLS encryption immediately after reading the greeting and capabilities of the server, but only if the server supports the STARTTLS extension.\n\nDefault: `Auto`.",
+        "DefaultValue": "Auto",
+        "DisplaySettings": {
+          "Octopus.ControlType": "Select",
+          "Octopus.SelectOptions": "None|None\nAuto|Auto\nSslOnConnect|Use SSL\nStartTls|Use STARTTLS\nStartTlsWhenAvailable|Start Tls When Available"
+        }
+      },
+      {
+        "Id": "208a3bab-b331-4fa6-a122-459593a4c98f",
+        "Name": "SendEmail.Credentials.Username",
+        "Label": "Authentication Username",
+        "HelpText": "The username to authenticate with the SMTP Server.",
+        "DefaultValue": "",
+        "DisplaySettings": {
+          "Octopus.ControlType": "Sensitive"
+        }
+      },
+      {
+        "Id": "d42aba20-174a-4b51-af88-78d332f09a08",
+        "Name": "SendEmail.Credentials.Password",
+        "Label": "Authentication Password",
+        "HelpText": "The password to authenticate with the SMTP Server.",
+        "DefaultValue": "",
+        "DisplaySettings": {
+          "Octopus.ControlType": "Sensitive"
+        }
+      },
+      {
+        "Id": "8eafb51b-599b-4c51-8d35-974c5843c9cb",
+        "Name": "SendEmail.Subject",
+        "Label": "Email Subject",
+        "HelpText": "The Email Subject",
+        "DefaultValue": "",
+        "DisplaySettings": {
+          "Octopus.ControlType": "SingleLineText"
+        }
+      },
+      {
+        "Id": "bc4d18f8-e096-4911-84ce-e35268c83934",
+        "Name": "SendEmail.FromAddress",
+        "Label": "From Address",
+        "HelpText": "The sender address of the Email",
+        "DefaultValue": "",
+        "DisplaySettings": {
+          "Octopus.ControlType": "SingleLineText"
+        }
+      },
+      {
+        "Id": "302fb573-5720-47b6-bbd7-7d0077ca75ba",
+        "Name": "SendEmail.TOAddresses",
+        "Label": "TO addresses",
+        "HelpText": "The recipients of the Email. Multiple addresses can be supplied, separated by a `,`.",
+        "DefaultValue": "",
+        "DisplaySettings": {
+          "Octopus.ControlType": "SingleLineText"
+        }
+      },
+      {
+        "Id": "be2267f6-36b0-4f7e-a7cf-f274e56aff2f",
+        "Name": "SendEmail.CCAddresses",
+        "Label": "(Optional) CC addresses",
+        "HelpText": "The *optional* CC (carbon-copy) recipients of the Email. Multiple addresses can be supplied, separated by a `,`.",
+        "DefaultValue": "",
+        "DisplaySettings": {
+          "Octopus.ControlType": "SingleLineText"
+        }
+      },
+      {
+        "Id": "b43c49fd-3214-4310-a8cf-10489a3c858f",
+        "Name": "SendEmail.ReplyToAddress",
+        "Label": "(Optional) Reply-to address",
+        "HelpText": "The *optional* `reply-to` address.",
+        "DefaultValue": "",
+        "DisplaySettings": {
+          "Octopus.ControlType": "SingleLineText"
+        }
+      },
+      {
+        "Id": "9e07a17f-a044-4f6f-ac0c-5d131058a270",
+        "Name": "SendEmail.HtmlBody",
+        "Label": "HTML Message Body",
+        "HelpText": "The HTML message body of the Email.",
+        "DefaultValue": "",
+        "DisplaySettings": {
+          "Octopus.ControlType": "MultiLineText"
+        }
+      },
+      {
+        "Id": "bd111434-193d-413b-9d7e-279381061a0c",
+        "Name": "SendEmail.TextBody",
+        "Label": "Plain Text Message Body",
+        "HelpText": "The Text message body of the Email.",
+        "DefaultValue": "",
+        "DisplaySettings": {
+          "Octopus.ControlType": "MultiLineText"
+        }
+      }
+    ],
+    "StepPackageId": "Octopus.Script",
+    "$Meta": {
+      "ExportedAt": "2025-02-26T14:52:39.564Z",
+      "OctopusVersion": "2025.2.937",
+      "Type": "ActionTemplate"
+    },
+    "LastModifiedBy": "harrisonmeister",
+    "Category": "email"
+  }

From 29738e686795895690dad7b0ccce7299b241dc89 Mon Sep 17 00:00:00 2001
From: Mark Harrison <mark.harrison@octopus.com>
Date: Wed, 26 Feb 2025 15:08:32 +0000
Subject: [PATCH 2/2] Rename step

---
 step-templates/{send-email.json => send-email-using-mailkit.json} | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename step-templates/{send-email.json => send-email-using-mailkit.json} (100%)

diff --git a/step-templates/send-email.json b/step-templates/send-email-using-mailkit.json
similarity index 100%
rename from step-templates/send-email.json
rename to step-templates/send-email-using-mailkit.json