App-Registration

Overview

In order for the Reddoxx Toolbox to access the M365 mailboxes, access authorisation must first be granted.
This is done via an App Registration app and is described below.

Azure Portal App Registration

Step 1:

1. log in at portal.azure.com
2. search for the "App registrations"service
3. or select it directly if it is already listed in the list of Azure services
   

Step 2:

1. select "New registration"
2. click on "All applications"
3. click on "Register application"
   

Step 3:

1. Set a name for the application (e.g. Reddoxx Toolbox)
2. click on "Register"
   

Tenant ID, Client ID, Client Secret

Step 1:

1. make a note of the Application ID
2. note the Tenant ID (Directory tenant ID)
3. click on "Add a certificate or secret"
   

Step 2:

1. select "New client secret"
2. assign a suitable name as a description (e.g. Toolbox access)
3. set the validity period
4. click on Add
   

Step 3:
The value and the Secret ID are now displayed in the overview.
The value (1) must be copied here (this is only displayed for a certain time, if this is not noted, a new client secret must be created)

API Permissions

The registered app requires some permissions, which are now configured

Step 1:

1. click on "API permissions"
2. select "Add a Permission"
3. click on "Microsoft Graph"
   

Step 2:

1. click on Application Permissions and select the following permissions which are then provided with "Add Permissions":
   • Application.Read.All
   • Directory.Read.All
   • Mail.Read
   • MailboxSettings.Read
   • RoleManagement.Read.All
   • User.Read.All
     

Step 3:

1. then select "Add a permission" again
2. search in the area "APIs my organization uses"
3. enter the API "Office 365 Exchange Online"
4. click on the API "Office 365 Exchange Online"
   

Step 4:

1. select "Application permissions" again
2. select the "full_access_as_app" permission
3. select the "Exchange.ManageAsApp" permission
4. click on "Add permissions"
   

Step 5:

1. click on "Grant admin consent"
   

2. confirm the Grant admin constent confirmation with "Yes"
   

Microsoft Entra role

Step 1:

1. then log in at entra.microsoft.com
2. search for "roles"
3. select "Microsoft Entra roles and administrators"
   

Step 2:

1. search for "Exchange Administrator" in the list and select it
   

Step 3:

1. click on "Add assignments"
   

Step 4:

1. search for the name of the registered app (in the example here this was "Reddoxx Toolbox")
2. select the app for the assignment
3. confirm this with "Add"
   

Done

Now you can connect to the REDDOXX Toolbox via the APP created in this way.
You need the now known data here:

• Tenant ID
• Client ID
• Client Secret