Setup Outlook Authentication

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

My domain

In order for the GoMeddo 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 GoMeddo to your Office365 environment, you wil need to register an Office365 app for GoMeddo.

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: GoMeddo)

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. GoMeddo 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)

GoMeddo permissions

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

All actions in GoMeddo wil be prefixed with (GoMeddo), 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. (GoMeddo) 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. (GoMeddo) 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 GoMeddo's secret is updated to a new value)

9. (Azure) Click the Copy icon next to the secret value
   
   
   
   

10. (GoMeddo) Paste the value into the clientSecret field and click the Save client secret button

11. (GoMeddo) 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 GoMeddo 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