How to configure R2 Docuo to send mail via Azure – Microsoft Graph

This guide details the process of creating in your organization’s Microsoft Azure Portal an application record that allows R2 Docuo to send your emails securely through the Microsoft Graph API.

Prerequisites

• Access to the Microsoft Azure Portal.
• Credentials for an account with Global Administrator or Application Administrator privileges in your organization’s Microsoft 365 environment.
• The R2 Docuo certificate file (.cer) downloaded from https://downloads.r2docuo.com/certificate.zip.
• An account of your organization with a mailbox on your Exchange Online

Mailing Application Registration

To register a new application in the Microsoft Azure Portal you will need to follow the steps below. You must complete all of them before configuring it in Docuo.

Access to the application registration page

1. Access the Microsoft Azure Portal at https://portal.azure.com and sign in with your organization’s Microsoft 365 account administrator credentials.
   
   
2. If the App registrations option appears directly , click on it. Otherwise go to search for App registrations in the search bar, once located*,* click on the icon*.*.
   
   

Create a new application record

1. Click on New Registration to create the application for R2 Docuo to access.
   
   
   
2. Enter a name that makes it clear what the application will be used for, e.g. “Application for sending mails from R2 Docuo”.
3. Under Supported account types, click Only accounts in this organizational directory (your company name).
4. Click on Register. The new application page will open:
   
   
   
5. Copy and save the value of the de Application ID (customer) y Directory ID (tenant) . Which you will need to enter in the mailing configuration in R2 Docuo later on.

Certificate of access

1. Download R2 Docuo certificate file (public key) from the following URL: https://downloads.r2docuo.com/certificate.zip
2. Unzip the ZIP file and save r2docuo.cer to your hard disk.
3. In the application we have created in the Azure portal Click on Certificates and secrets, select the Certificates tab on the right and click on Upload certificate.
   
   
4. Select the certificate file r2docuo.cer from your hard disk.

Grant permissions to the application

1. Now we are going to define the permissions of your application, click on API Permissions and then on Add a Permission
   
   
   
2. Search and click on the Microsoft Graph option
   
   
   
3. Now click on Application Permissions
   
   
   
4. Enter Mail.Send in the search box. Once found mark it in the list.
   
   
5. Click on Add permissions. By default, the new permission, Mail.Send, appears in your permissions list with the status Not Granted.
   
   
   
6. You must grant consent with the Grant button located on the list toolbar*.* If successful, the permission will appear like this:
   
   
   
7. Now we need to add another permission to be able to create calendar events. Click again on Add permissions. We go back to choose Application permission and in the search engine we search for Calendars.ReadWrite. We grant permissions again and if everything is correct the permissions will be as follows:
   
   
   

Docuo mailing configuration

1. You must access your R2 Docuo account at https://myaccount.r2docuo.com by entering the credentials of the R2 Docuo repository owner.
   
   
   
2. Choose the repository from which you want to send mails through Azure and click in the Actions column on theNut button to access its configuration.
   
   
   
3. Find the Mail Server section and click on Change mail server:
   
   
   
4. Select the option My own mail server and choose Office 365 (Microsoft Graph) from the list.
5. Enter the data with the Tenant and Customer identifiers and the name and e-mail address of the service account you wish to use for sending e-mails.
6. Click on send a test mail
7. If everything is correct click Save changes and your R2 Docuo repository will be configured and ready to use the specified Office 365 account to send mails.