Introduction

Use this extension to send email from your pipeline without a SMTP server. It uses the Microsoft Graph API to send email.

Requirements

To use the extension you need an active business Office 365 license that includes the use of Exchange Online. Exchange online must be configured. Email that are sent are added to the send email folder from the configured mailbox.

Create Azure Enterprise Application

Given the rapid pace in which the Azure Portal changes use these steps as guidelines and not as exact steps.

Create the App and get the Client ID

• Go to azure.portal.com and login with an administrative account
• Go to Azure Active Directory -> App Registrations -> All Applications
• Start a new Application Registration
• Name: e.g. AzureDevOpsGraphEmail
• Supported account types: Accounts in this organizational directory only
• Redirect URI: Web
• Click Create and note the Application ID. This is the Client ID

Get the Client Secret

• Click Certificates & Secrets -> New client Secret
• Description: e.g. AzureDevOpsGraphEmail
• Expires: Never
• Note the secret passphrase. This is the Client Secret

Assign Permissions to the App

• Go to API Permissions
• Add a Permission -> Microsoft Graph
• Application Permissions
• Mail.Send (Send mail as any user) -> Add Permission
• Delete the default assigned permission for Windows Azure Active Directory
• Click Grant admin consent for

Get the Tenant Domain

• Now go to Azure Active Directory -> Custom Domain Names
• Check the domain which is primary. This is the Tenant Domain

From email

The email address you're sending from must exist, and it can be a shared mailbox.

Release Notes

20220731.x.x

• Added release notes

20220728.x.x

• Added TLS 1.2 support

20191211.x.x

• Initial release

More Resources

• Azure AD - Manage Apps
• MS Graph - Register App