Menu
This guide is to help you with creating a new application in your Azure Directory to interact with the Workflow in BusinessMate. The application will need permissions to read and send mails through Microsoft Graph, the application will also need a “secret”.
The 4 parameters for the config needs:
Client ID (Application ID)
Client Secret
Tenant ID (Directory ID)
User ID
The first step is to create a new application in Azure Directory
Login to your azure account at “https://portal.azure.com/”, then you will be directed to the user homepage as in figure 1.
Now go to the “Azure Active Directory”. (Mark with red rectangle in figure 1.)
Figure 1. Azure user homepage
From the Azure Active Directory we can now go to the “App registrations” as shown in figure 2.
Figure 2. Azure Directory Overview
In the app registration we can now add a new app by click on the “New registration” as shown in figure 3.
Figure 3. Azure App Registration
The application needs a name, and you can select who can access this application or API.
You do not need a redirect URL for the application.
Click “Register” when you have type in a name as shown in figure 4.
Figure 4. Register Application
You will be redirected to the new application page where you can see the essential information’s as shown in figure 5.
Under the “Essentials”, we can get the:
Client ID (Application ID)
Tenant ID (Directory ID)
Now we need to create a new client secret by going to the “Certificates & secrets” page on the left menu bar.
Figure 5. After register the application
In the “Certificates & secrets” page we can now add a new client secret by clicking on the button “+ New client secret” as shown in figure 6.
Figure 6. Certificates & secrets page
After clicking the add client secret button a right sidebar will appear. Here you can give a description of the secret and set a expire date.
When you are done click on “Add” as shown in figure 7.
Figure 7. Add client secret
Now you can get the client secret under “Value” as shown in figure 8.
You can only get the client secret once, after leaving the webpage it will automatically hide the client secret!
Figure 8. Client secret
Next step is to set permissions, so go to the “API permissions” in the left sidebar as shown in figure 9.
Figure 9. API permissions
At the permissions page click on “+ Add a permission” as shown in figure 10.
Figure 10. Permissions page
After clicking on add permission a right sidebar will appear, and you can see different Microsoft services. In our case we will click on “Microsoft Graph” as shown in figure 11.
Figure 11. Select API Permissions
Now click on “Application permissions” and then in the search field search for “mail”. Then open the mail dropdown and select all the permissions you want. In this guide we have selected all in mail as shown in figure 12.
When you have selected the permissions click on the button “Add permissions”.
Figure 12. Select API Permissions for mail
If you are the owner of the company/organization you can grant admin consent for the app, or else you will have the owner to go to the application and give consent. The Owner can grant permissions as shown in figure 13.
Figure 13. Grant permission
When permissions er granted is looks like figure 14.
Figure 14. Permission Granted
The Last thing you need is user ID which can be found under “Users” in Azure Active Directory. Find the user and get his/her user ID under “Identity” in the field “Object ID” as in figure 15.
Figure 15. User information