Skip to main content

Office 365

Authorise a Microsoft Office 365 account for use with Jadu Central event bookings, or your own in-house functionality.

Jadu Central can be integrated with the following Office 365 account types:

  • Office 365 Business Premium or above
  • Office 365 Enterprise E3 or above
tip

Office 365 integration uses Azure Active Directory (Azure AD) to access web services provided by Microsoft such as Office 365. Azure AD exposes two sets of endpoints, Azure AD and Azure AD v2.0, Jadu Central supports both, the one you use depends on your Microsoft account.

  1. Click the Settings icon in the left navigation bar. The Settings menu will open.
  2. Click the Integrations link in the first group of links. A list of integrations will now be shown.
  3. Click the Office 365 option in the list of integrations. The Office 365 integration form will open.

Integration elements​

The integration consists of:

Deciding which Azure AD version to use​

If you are unsure which API version to use log into your Microsoft Azure Portal

  1. Login to your office.com admin portal (https://portal.office.com/adminportal/home#/homepage)
  2. Under 'Admin centers' in the menu on the left hand-side, click on 'Azure AD'

Use the table below to identify which guide to follow:

Azure AD versionAzure PortalGuide
Azure ADAzure ADGenerating Office 365 API Client ID and Secret (Azure AD)
Azure AD v2.0Azure AD v2.0Generating Office 365 API Application ID and Key (Azure AD v2.0)

Generating Office 365 API Client ID and Secret (Azure AD)​

The API Client ID and secret can be retrieved from Microsoft Azure portal.

  1. Login to your account on the Microsoft Azure portal (https://manage.windowsazure.com and click on Active Directory in the menu. Select the Activity Directory you would like to use.
  2. Click on Applications in the top menu and then click the Add icon at the bottom of the page. Select Add an application my organization is developing, enter a name for your application, e.g. "Website" and Continue.
  3. Enter the OAuth end point URL in the SIGN-ON URL field. The OAuth end point URL is the callback route, /jadu/integrations/office365/callback, preceeded by your website domain. e.g. https://www.jadu.net/jadu/integrations/office365/callback.
  4. Enter your website URL in the APP ID URI field, e.g. https://www.jadu.net, and click Complete.
  5. Once the Application has created click Configure in the top menu. Make a note of the Client ID value.
  6. Create a new key by selecting a duration from the drop down (it will be visible after saving the application) and click Save. Make a note of the key that is now shown, this will be used as the client secret in the integrations hub.
  7. Click Add application and select Office 365 Exchange Online.
  8. Under Office 365 Exchange Online select the following options from the Delegated Permissions dropdown:
    • Read user calendars
    • Read and write user calendars
    • Read user and shared calendars
    • Read and write user and shared calendars
    • Read calendars in all mailboxes
    • Read and write calendars in all mailboxes
  9. Click the Save button and enter the noted details into Jadu Central

Generating Office 365 API Application ID and Key (Azure AD v2.0)​

Enabling Office 365 integration using Azure AD v2.0

  1. Login to apps.dev.microsoft.com and click on the Add an app button
  2. Enter a name for your application, e.g. "Website", in the Application name field, uncheck Let us help you get started under "Guided Setup" and click the Create button. Make a note of the Application id, this will be used as the client ID in the integrations hub.
  3. Under Application Secrets, click Generate New Password. Make a note of the generated key, this will be used as the Client secret in the integrations hub.
  4. Under Platforms, click the Add Platform button and add Web API and Web
  5. Under the "Web" subsection, in the Redirect URLs field enter the OAuth end point URL. The OAuth end point URL is the callback route, /jadu/integrations/office365/callback, preceeded by your website domain. e.g. https://www.jadu.net/jadu/integrations/office365/callback.
  6. Deselect any selected permissions under Microsoft Graph Permissions and then click the Add button. Add the following permissions, and then click the OK button.
    • Calendars.Read
    • Calendars.Read.Shared
    • Calendars.ReadWrite
    • Calendars.ReadWrite.Shared
    • offline_access
    • openid
    • profile
  7. Click the Add button next to the Application Permissions and select Calendars.Read and Calendars.ReadWrite. Click the OK button.
  8. Enter the OAuth end point URL (/jadu/integrations/office365/callback) in the Home page URL field e.g. "https://www.jadu.net/jadu/integrations/office365/callback".
  9. Uncheck Live SDK support under Advanced Options
  10. Click Save button and enter the noted details into Jadu Central

To configure the Office365 integration​

Once you have your Client ID and Secret (Azure AD) or Application ID and Key (Azure AD v2.0) you need to add them to the Integrations Hub page.

  1. Navigate the Office 365 management area
  2. Enter the client values and choose the correct Azure AD version, and click the Save button
  3. The Connect account button is now visible and you can connect individual Office365 accounts to interact with using the integration.

To authorise an Office 365 account​

  1. Sign into Office 365
  2. Navigate the Office 365 management area in Jadu Central and click the Connect account button
  3. After the page refreshes, the email address of the Office365 account you are currently logged into will be added to the authorised accounts list.
note

Outbound connectivity from the server through your firewall will be necessary to login.microsoftonline.com, outlook.office365.com on port 443.

To un-authorise an Office 365 account​

  1. Sign into Office 365
  2. Navigate the Office 365 management area in Jadu Central and click the cross icon next to the account email address in the list. A new form will open.
  3. Click the Remove button