Configuring Office 365 SMTP

Pre-requisites:

• Inforiver installation is On-premises and the SMTP environment variable should be set to Office365 as shown in the image below.

• You need to have admin privileges in Office 365 as well as be the workspace admin for Inforiver to configure these steps.

Microsoft supports OAuth2.0 client credential flow for application permissions which allows us to authenticate to Azure AD without the need of having an authenticating user in the process. The authentication is entirely based on the tenant ID, client ID and client secret of an application (Inforiver).

Using GRAPH API authentication, Inforiver captures the required user tokens for sending emails.

Permissions required in Office 365

Inforiver requires the following permissions to be granted in Office 365 as explained below.

Permissions required in Office 365 for Inforiver

Mail.Send: This permission is required to send emails which would be granted when the user configures the Office365 SMTP settings and provides consent.

Mail.ReadWrite: This additional permission is required to send large file attachments, which would be granted if the user enables the large file attachment settings.

Let us see the steps to configure the above settings.

Steps to Configure MS Office 365 SMTP

1. Go to the Tenant Settings page by clicking on the Settings menu on the left side of the window. (Note: Only Workspace Admin has access to the Tenant Settings page of Inforiver).

2. Enter the required From Email Address. A mail box should be configured for the user or for the group that is specified in the From Email Address. (They should have a shared mail box access).

Tenant Settings Page

3. The email entered is form-validated by the app, after which the Enable button is enabled on the screen.

4. Click Enable. This opens the Microsoft 365 consent screen where the user has to provide the consent. Admin privileges are required to provide consent.

5. After providing the consent, Inforiver is granted the Mail.Send permission.

Since we have provided a pre-configured From Email Address in MS Office SMTP settings who is going to be the sole sender, Enable Single Sender Identity option will be greyed out and locked for toggle.

The tenant settings table will save the encrypted user tokens after a successful login.

Reset MS office SMTP user tokens

1. Click Reset to reset the SMTP user tokens and settings.

Reset SMTP settings

2. After reset, the configured email address is removed. The user can then configure it again if required by following the above steps.

From Email Address - Removed

Update 'From Email Address' in MS office SMTP

1. Go to the Tenant Settings page.

2. Reset SMTP user tokens as explained above.

3. Enter the desired email ID in the From Email Address and provide the consent in the Microsoft 365 consent screen.

Enter 'From Email Address'

4. The new Email Address (sender) is updated successfully.

Update 'From Email Address' without Reset:

You can update the From Email Address without resetting the SMTP settings as explained below:

1. Go to the Tenant Settings page.

2. Check if the Office SMTP is configured. If it is configured, please enter a valid From Email Address that is to be updated.

Update 'From Email Address'

3. Click Save button.

4. This opens the consent popup screen.

5. After providing the consent, the new From Email address is updated.

Steps to Enable Large File Attachments in MS office SMTP

1. To enable large file attachments, toggle the button Enable large file attachments and click Save.

Enable large file attachments

Note: If the From Email Address is not configured already, please configure it by following the steps listed here. While configuring, you can toggle the large attachments button before clicking Enable.

2. After clicking Save (or Enable, in case you're configuring the email now) the consent screen appears.

3. By providing the consent, Inforiver is granted both the Mail.Send and Mail.ReadWrite permissions.

The tenant settings table will save the user tokens (encrypted) after a successful login.

Note: The toggle button to enable/disable large file attachments is locked and greyed out after authorizing it.

The acquired tokens can be deleted by a Reset and then you can disable the large file attachments if required.

large file attachments toggle is greyed out

Delegated mail box

You can create an empty group email and delegate the complete access of the group email to any org email user using the Send As permission. This configuration needs to be done in the portal for groups.

Once configured, the From Email Address will be the group email ID of the empty distribution list.

Group Email ID in From Email Address

But internally, it uses the graph access tokens of the delegated user.

Note: The delegated user should have configured the SMTP settings and provided consent.

Provide Consent for Inforiver