So I thought SendGrid was the only free email option in Azure. However, there is another email service that is almost as easy to set up, Mailjet.
To get started with Mailjet, search it by name in the Azure Marketplace and add it to your resource group. There are several plans to choose from, ranging from the free plan that allows 6000 email (monthly), to 900K emails. Mailjet has additional email campaign features like mail tracking, the responsive marketing tool, dedicated IP, and contact management. The Premium accounts include segmentation, A/X testing and campaign comparison.
Mailjet seems to emphasize security. In fact, from the Azure Portal, my API Key is in 'Quarantine' which means there is a per hour send limit (I believe 1000 is the limit on the free plan). Validation requires the addition of some DNS records to ensure that you in fact own the email domains you are using. An email SPF and DKIM record is required to fully validate your account.
To verify your email domain, you'll need access to your DNS record management. Go to Account Settings->Senders & Domains->Setup SPF/DKIM Authentication to accress the screen that provides and verifies the details required for your DNS record set.
It will take at least 30 minutes to a couple of hours or possibly longer for the DNS records to be propagated. The verification screen can be closed and checked later if needed, the values it displays will not be changed, so it is safe to close the window. You may want to wait a day before coming back to this screen to ensure the validation succeeded.
From the Azure portal you'll be asked to supply a Mailjet contact, including an email address. This information is transferred over to Mailjet and the email account will have to be verified by Mailjet.
The odd thing about setting up accounts like this from Azure is that a proper Mailjet account that you can use to login from the Mailjet login will not be created. What I ended up doing was doing a password reset from the Mailjet login screen using the email address I used my Mailjet contact record.
The Mailjet password reset works like any other password reset, you get a link emailed to your account and clicking that link opens a screen allowing you to choose a new password. Once I had my account sorted out I could log into my Mailjet account using the web front end instead of using the Azure "Manage" button to access the account.
It is highly recommended, well, mandatory really, that you use TLS to connect to Mailjet. To setup an Umbraco or Sitecore instance with Mailjet is simple. Go to the Mailjet Properties in Azure to obtain these values. The settings work as follows:
This is an example of my web.config settings for Umbraco.
You can test your email configuration by setting up an Umbraco Workflow and requesting a content review. This will send an email to the reviewer account. If you don't have workflow setup, you can also use the password reset feature to test the email configuration.
You can also use the Umbraco Health Check from the "Develop" tools in the back office. Navigate to the "Develop" tools gear and pick the "Health Check" tab. Click "check group", if the SMTP server is not valid, or cannot be connected to with the account credentials, an error is displayed.
If you need to send emails from you site, or collect contacts and manage campaigns, you'll want to use the Mailjet API. There is a convenient library that can be installed via NuGet. There is ample documentation on the Mailjet site with examples for this library. In a future post I will go through my implementation of an email contact subscribe and unsubscribe implementation in Umbraco.
Best of luck with you Azure Mailjet implementation!
Photo by Tim Evans on Unsplash