Integrated System Solutions
Configuration Guide

Email Notification
Configuration

Configure your Art2link ESB deployment to send notification emails through your own Office 365 tenant. This is a one-time setup that takes about 10 minutes.

Before you begin — required permissions
Application Developer (minimum) — required to create the App Registration in Microsoft Entra ID. In most tenants all users can register apps by default; if yours is restricted, ask your IT administrator to assign you this role.
Application Administrator or Global Administrator — required to grant tenant-wide admin consent for the Mail.Send and Mail.Read application permissions. This step cannot be completed without an admin role.
Access to Microsoft Entra admin center — entra.microsoft.com
1
Step One
Create the App Registration

Go to entra.microsoft.com and sign in. In the left menu, expand the Identity section, then select Applications › App registrations. Click New registration in the top toolbar.

Fill in the registration form with the following values:

FieldValue
NameSomething descriptive, e.g. Art2link ESB Email Sender
Supported account typesAccounts in this organizational directory only (Single tenant)
Redirect URILeave blank

Click Register to create the application.

Entra ID — Register an application
Register an application form with name and single tenant selected
What happens next: After clicking Register you will be taken directly into the newly created app registration. Leave this page open — the next steps continue here.
2
Step Two
Create a Client Secret

In the left menu of your app registration, select Certificates & secrets. Click New client secret to open the panel on the right.

Certificates & secrets — Add a client secret panel
Add a client secret panel with description and expiry fields

Give the secret a meaningful description (e.g. Art2link ESB Email Secret) and choose an expiry period. 730 days (24 months) is a reasonable default. Click Add.

⏰
Set a calendar reminder. Note the exact expiry date and put a reminder in your calendar for one week before it expires. When a client secret expires the email notifications will stop working until you create a new secret and update the configuration in Art2link ESB.

Once the secret is created it appears in the list. Copy the Value immediately — this is the only time it will be shown in full. After you navigate away it will be masked and cannot be recovered.

Certificates & secrets — copy the secret Value (highlighted)
Client secrets list showing the Value column highlighted in red
⚠️
Copy the Value now, not the Secret ID. The Value is the long string in the highlighted column. Save it somewhere secure (e.g. your password manager) — you will need it in Step 4.
3
Step Three
Configure API Permissions

In the left menu, select API permissions. Click Add a permission. In the panel that opens, select Microsoft Graph — it is the first tile in the top row.

Select Application permissions (not Delegated). In the search box type Mail. Locate the Mail section in the results, expand it, and check the following two permissions:

PermissionPurpose
Mail.SendAllows Art2link ESB to send notification emails as any user in the tenant
Mail.ReadAllows Art2link ESB to verify mailbox access and support future delivery confirmation features

Click Add permissions to save.

Microsoft Graph — Mail.Read and Mail.Send selected
Request API permissions panel with Mail.Read and Mail.Send checked

Back on the API permissions page, you will see ⚠ Not granted warnings next to both permissions. You must now grant tenant-wide admin consent. Click Grant admin consent for [your tenant name] and confirm the prompt.

API permissions — Grant admin consent for Cerebrum City
API permissions page showing Grant admin consent button highlighted
Admin role required for this step. The Grant admin consent button is only available to users with the Application Administrator, Cloud Application Administrator, or Global Administrator role. If you do not see it or it is greyed out, ask your IT administrator to complete this step.
4
Step Four
Configure Art2link ESB

You need two more values from the app registration before switching over to Art2link ESB. In the left menu select Overview. In the Essentials section, locate and copy:

ValueWhere to find it
Application (client) IDEssentials section, left column
Directory (tenant) IDEssentials section, left column, below the Client ID
App Registration Overview — Application ID and Tenant ID
App registration overview with Application client ID and Directory tenant ID highlighted

Now open Art2link ESB and navigate to Settings. In the email configuration section, populate the fields with the values you have collected:

Art2link ESB FieldValue
Tenant IDDirectory (tenant) ID from the Overview
Client IDApplication (client) ID from the Overview
Client SecretThe Value you copied in Step 2
FromA valid email address in your Office 365 tenant (e.g. Art2linkESB@yourOrg.com)
The From address must be a valid mailbox in your Office 365 tenant. It does not need to be a shared mailbox — any licensed user mailbox will work. The address will appear as the sender on all Art2link ESB notification emails.

Save your settings and verify the configuration by creating an Activity Notification in Art2link ESB. If everything is configured correctly the notification email will be delivered.

Configuration complete

Art2link ESB is now connected to your Office 365 tenant and ready to send notification emails. Remember to renew your client secret before it expires.

×
ESC to close  ·  click outside to dismiss