Send emails via SMTP relay with Azure Communication Service

  • Thread starter Thread starter qureshiaquib
  • Start date Start date
Q

qureshiaquib

We’ve come across multiple cases where customers want to send emails from Applications migrated to Azure through some kind of SMTP service. Though we’ve seen customers opting for O365 for SMTP relay, this can create issues due to throttling limitations in Office Service. Also, managing mailbox and license assignment on Office 365 console is a different story; customers would want to have seamless SMTP relay service experience from single console on Azure.

Though Azure Communication service supports sending emails outbound but currently it requires you to integrate it via the ACS SDK that Microsoft provide. In scenarios where you don’t want to modify code and just change the pointing of your SMTP server to Azure, you can now use ACS - SMTP relay built into Email communication service.

Azure Communication Service supports different types of notifications, SMTP relay in ACS is now Generally available and this blog post is simple step by step instructions of how you can quickly test the service and then migrate from Sendgrid or another service you’re using to native ACS – Email communication service for better operational experience and support.

Create Azure Communication Service Account​



First step you’ll need to do is to create an ACS account. This is a parent service which has multiple notification services inside it(Chat,SMS, Email etc). Email communications service is one of them.

large?v=v2&px=999.jpg

Create Email communication service​




We’ll have to create ECS which is the actual service that holds configuration details.



large?v=v2&px=999.jpg

Add a custom domain to ECS​




ECS provides Azure managed domain which look like this “GUID.azurecomm.net” this provides limited volume of email hence using custom domain is preferred. Once you add a custom domain, the UI provides you with TXT record which you’ll need to create in your Name server. This would take 15 minutes to verify the domain


large?v=v2&px=999.jpglarge?v=v2&px=999.jpg

Once domain is verified the screen looks like this, you’ll have to create SPF and DKIM records so that your email doesn’t land in junk and ownership is maintained.


large?v=v2&px=999.jpg


Once all the records are created the screen would look like this, please ignore the azure managed domain. You can only have custom domain in the account and doesn’t have to add Azure Domain explicitly.



large?v=v2&px=999.jpg



Attach custom domain to ACS Account​




Once email is validated we’ll need to attach ECS to ACS.



large?v=v2&px=999.jpg



Create and Assign custom RBAC Role for Authentication​




We’ll be using 587 port to send email which is authenticated SMTP. For authentication we have Entra ID authentication. Create a service principal by going to Entra ID – App registration page. Register the app and create a client secret. Note down Client ID, Tenant ID and Secret value. This will be used in next stage for authentication. We’ll need to create a custom RBAC role which has permission to send email. We’ll clone reader role.



large?v=v2&px=999.jpg



And we’ll be adding two actions which is present in Azure Communication service resource provider.



large?v=v2&px=999.jpg



Once the Role is created we’ll need to assign this to service principal


large?v=v2&px=999.jpglarge?v=v2&px=999.jpg



Test SMTP Relay via Powershell​




That’s all, now you’ll need to find out the sender email. Which is default DoNotReply@domain.com



large?v=v2&px=999.jpglarge?v=v2&px=999.jpg



Spoiler (Highlight to read)
Note: As you can see in the screenshot Add button is greyed out. You can add custom sender email by sending couple of emails from the default email address and then raising support case. support engineer can help you change the tier to higher which will allow you to add more custom email address.
Note: As you can see in the screenshot Add button is greyed out. You can add custom sender email by sending couple of emails from the default email address and then raising support case. support engineer can help you change the tier to higher which will allow you to add more custom email address.



You’ll need credentials to authenticate to the service.



  • Username is < Azure Communication Services Resource name>. < Entra Application ID>. < Entra Tenant ID>
  • Password is the client secret which you’ve generated.
  • Port that we’ll need to use is 587
  • SMTP server address is smtp.azurecomm.net



Now you can use any third party application to send email via the above parameters. To showcase we can use PowerShell with the same parameters to send emails.



large?v=v2&px=999.jpglarge?v=v2&px=999.jpg



Conclusion: I trust this guide helps you in configuring SMTP relay and send emails from your custom application without any change to the application/code.



Happy Learning!



Personal Blog post of SMTP relay:
Send emails via SMTP relay with Azure Communication Service

Find similar tech blog on my personal blog
Azure Doctor

Continue reading...
 
Back
Top