Connecting XFP with Office 365

Office 365 integration allows you to authorize an Office 365 account for use with Jadu XFP (e.g. event booking) and your own custom developments.

Once the API client ID and secret have been saved you will be able to click 'Authorize account' button to add a new account.

Office 365 integration uses Azure Active Directory (Azure AD) to access web services provided by Microsoft such as Office 365.

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

  1. Login to portal.azure.com
  2. Under 'Azure services' find and open 'App registrations'
  3. Click on 'New registration'
  4. Enter a name for your application, e.g. "Website" leave the Supported account types to "Accounts in this organizational directory only" and click "Register"
  5. Make a note of the "Application (client) id", this will be used as the client ID in the integrations hub.
  6. Click on "Certificates & secrets" in the left sidebar
  7. Click "New client secret"
  8. Give the secret a name for example the domain name of your site and choose "Never" under Expires. If you choose "In 1 year" or "In 2 years" the integration between Jadu and Office 365 will stop working when the secret expires and will need a new secret generated. 9 Click "Add" to create the secret
  9. Make a note of the value of the secret, you will not be able to view the value again once you've left the page.
  10. Click on "Authentication" in the left sidebar
  11. Under redirect URIs add a new Redirect URI of type: Web and Redirect URI: your site domain with /jadu/integrations/office365/callback appended e.g. "https://www.jadu.net/jadu/integrations/office365/callback".
  12. Under "Implicit grant" enable "Access tokens" and "ID tokens"
  13. Select "Accounts in any organizational directory (Any Azure AD directory - Multitenant)" under Supported account types
  14. Click on "API Permissions" in the left sidebar
  15. Click "Add a permission"
  16. Click "Microsoft Graph"
  17. Click "Delegated permissions"
  18. Choose "Calenders.Read", "Calenders.Read.Shared", "Calenders.ReadWrite", "Calenders.ReadWrite.Shared", "offline_access", "open_id" and "profile".
  19. Click "Application permissions"
  20. Choose "Calendars.Read" and "Calendars.ReadWrite"
  21. Click on "Expose an API" in the left sidebar
  22. Click "Add a scope"
  23. Give the scope a name e.g. "access_as_user"
  24. Select "Admins and users" under "Who can consent?"
  25. Under "Admin consent display name" enter a name e.g. "Access jadu.net"
  26. Under "Admin consent description" enter a description e.g. "Allow the client application to access jadu.net on behalf of the signed-in user."
  27. Under "User consent display name" enter a name e.g. "Access jadu.net"
  28. Under "User consent description" enter a description e.g. "Allow the client application to access jadu.net on your behalf."
  29. Click "Add scope"

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 to Utilities > Integrations
  2. Select "Office365" from the list
  3. Enter the client values and choose the correct Azure AD version (typically 2.0)
  4. Click the Save button
  5. The Connect account button is now visible and you can connect individual Office365 accounts to interact with using the integration.

To authorise an Office365 account

  1. Sign into Office365
  2. Navigate to Utilities > Integrations
  3. Select "Office365"
  4. Click the Connect account button
  5. 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 Office365 account

  1. Sign into Office365
  2. Navigate to Utilities > Integrations
  3. Select "Office365"
  4. Click the cross icon next to the account email address in the list
  5. A new form will open
  6. Click the Remove button

results matching ""

    No results matching ""