Setup Outlook Authentication

Booker25 allows you to sync Dimension records with Outlook calendars through Office365. This article explains how to connect your Booker25 environment with your Office365 environment.

My domain

In order for the Booker25 Outlook extension to work, you will need to setup and deploy My Domain to your users. More information on this can be found here

Create Office365 app

In order to connect Booker25 to your Office365 environment, you wil need to register an Office365 app for Booker25.

  1. Login to your Office365 environment
  2. Navigate to the Admin center



  3. From there navigate to the Azure Active Directory Admin Center



  4. Click Azure Active Directory



  5. Click on App registrations


From here we can create a new app registration

  1. If you see the pink banner, click on the banner saying 'The preview experience for App registrations is available. Click this banner to launch the preview experience'. Else just proceed as is.



  2. Click New registration



  3. Choose a name for the application (for example: Booker25)
  4. Under Supported account types, leave the default 'Accounts in this organizational directory only (<directory name>)' checked
  5. Under Redirect URI (optional), select Web and use https://login.salesforce.com/lightning/n/B25__ClassicSettings as the url for production instances and  https://test.salesforce.com/lightning/n/B25__ClassicSettings for sandboxes.

  6. Click Register

Set permissions

Office365 permissions

Now we need to set the permissions on this newly created app. Booker25 needs Read and Write permissions on calendars in your Office65 organisation in order to sync Reservations to and from Outlook calendars.

To set these permissions do the following:

  1. Click the API permissions menu item of the app you just created



  2. Click Add a permission
  3. Click Microsoft Graph



  4. Click Application permissions
  5. Expand the Calendars section
  6. Check the checkbox next to Calendars.ReadWrite
  7. Click Add permissions (you can ignore the warnings)

Booker25 permissions

Next, we need to supply Booker25 with the authentication information required. To do this, we will be switching back and forth between the Booker25 Outlook Settings tab (App Launcher > Booker25 > Settings > Outlook Settings) and the Azure Active Directory tab from the previous section.

All actions in Booker25 wil be prefixed with (Booker25), and actions in Azure will be prefixed with (Azure).

  1. (Azure) Go to the Overview menu item of the app you just created



  2. (Azure) Click the Copy icon next to Directory (tenant) ID



  3. (Booker25) Paste the Directory (tenant) ID into the tenantId field on the Outlook Settings page and click Save tenant id



  4. (Azure) Click the Copy icon next to the Application (client) ID
  5. (Booker25) Paste the Application (client) ID into the clientId field and click Save client id
  6. (Azure) Click on the Certificates & secrets menu item



  7. (Azure) Click the New client secret button in the Client secrets section



  8. (Azure) Give the secret a description and choose an expiration time (Note: when the secret expires, the sync wil stop working until Booker25's secret is updated to a new value)
  9. (Azure) Click the Copy icon next to the secret value



  10. (Booker25) Paste the value into the clientSecret field and click the Save client secret button
  11. (Booker25) Click the Grant Admin Consent button
  12. A new tab wil open, asking you to log into your Office365 account
  13. Accept the prompt to grant admin consent to the app you created
  14. You should now be redirected to the Booker25 Outlook Settings page (you may need to re-login to Salesforce). The Outlook Settings tab should now look like this



Sync Dimension records

  1. You can now proceed to setting up Dimension records for syncing: Connect Dimension records to Outlook calendars



On this page