Microsoft O365 Configuration for Laurel

How to setup collection of O365 activities in Laurel

Nick Bazley avatar
Written by Nick Bazley
Updated over a week ago

ℹ️ 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

  • 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

Did this answer your question?