ℹ️ Laurel collects activities from Microsoft's productivity suite, including Microsoft Word, Excel, Powerpoint and others.
As a Microsoft administrator, please collect the following information and provide it to the Laurel team for setup:
Application (Client) ID
Directory (Tenant) ID
Application Secret Value
We will confirm with testing prior to making the application available generally to your users. The steps below help you setup our application and get these values.
Create App Registration
Navigate to Microsoft Azure Admin Portal and login
Click App registrations under Azure services
Click New registration
Register the application
LaurelCloudAssistant-OutlookFolderSearch
Click Register
Navigate to Certificates & secrets located in the left navigation bar
Click New client secret to create a secret with the following configuration:
Description: laurel-secret-1
Expires: 24 months
⚠️ We recommend a long-lived authentication so you do not need to remember to update these values with Laurel; if they expire your timekeepers will lose time that is not recoverable even if the connection is restored.
Please remember to keep note of the expiration in your calendar.
Click Add
Copy the value of the secret
❗ The secret value will not be accessible once created so please be prepared to secure the value in a safe location.
Click Overview tab located in the left navigation bar
Store Application (client) ID in a secure location
Store Directory (tenant) ID in a secure location
Set app permissions
Click API permissions tab in the left navigation bar
Click Add a permission
Click APIs my organization uses tab
Search for Office
Select Office 365 Exchange Online
Click Application permissions
Select the following permission:
full_access_as_app
ℹ️ Laurel attempts to minimize permissions use, but is required to fulfill our promise of time technology and automation. Please see use of these permissions here.
Click Add permissions
Check the Status column to see if the permission has been successfully granted
If you are not the administrator of the Azure account, you will have to get the administrator to grant the permission. The following screenshot shows when a permission has not yet been granted.
If you are an administrator, click the Grant admin consent for LaurelCloudAssistant-OutlookFolderSearch
ℹ️ If you named the application something different, that will appear.
Confirm by clicking Yes
Ensure permissions are shown with a green check mark
✅ You will see a green checkbox next to a set of permissions. There may be others which is okay, the most important are highlighted below.
Send Laurel required information to access the application
Through Intercom or email, please contact your Laurel integration team and send the following information:
Application (Client) ID
Directory (Tenant) ID
Application Secret Value