Setting up the Microsoft Office 365 Integration

  • Updated

The Microsoft Office 365 integration is available in Hudu 2.0.9 and above.

The Microsoft Office 365 integration allows you to:

  1. Sync basic user information
  2. Sync Assigned product information
  3. Sync Mailbox storage information
  4. Sync Assigned license information

mceclip0.png

The Microsoft Office 365 integration is currently only available to be pulled in for a single tenant at a time. The ability to pull in information through a delegated admin interface is currently still under development.

How to get started

In order to get started, you must first set up the integration in the Microsoft Office 365 Admin.

  1. As an admin, login to Microsoft Office 365. Navigate to the Microsoft 365 admin center.
     
  2. Click on Azure Active Directory in the sidebar.mceclip1.png
  3. You will taken to a new dashboard. Click on Azure Active Directory, then App Registrationsmceclip2.png
  4. Click on + New registrationmceclip0.png
  5. Give your application a name, and choose Accounts in this organizational directory onlymceclip1.png
  6. Copy down the Tenant ID and Application IDmceclip2.png
  7. Head down on the sidebar to Certificates & secrets and generate a new client secret (it's in the value section that will be created). Keep it somewhere to remember it.mceclip4.pngmceclip0.png
  8. Head to API permissions. Delete the default Microsoft Graph User.Read permission.
  9. Give the app the following permissions: These should all be selected as Application Permissionsmceclip5.png
    1. Microsoft Graph -> Directory.Read.All
    2. Microsoft Graph -> Reports.Read.All
    3. Microsoft Graph -> User.Read.All
    4. You no longer need Azure Active Directory Graph as it has been deprecated.
  10. You will now need to click Grant Admin Consent mceclip6.pngmceclip7.png

In Hudu, you will need to navigate to the Office 365 integration (Admin -> Integrations) and set up the integration. You will need to enter the company you are setting it up for, the Application ID, the Tenant ID, the Client Secret Value, and tell Hudu where to match your contacts.  

Once you have started a sync, you should make sure that company is properly matched (you can always unmatch cards that were matched incorrectly) before proceeding to other companies.

Still have questions?

Contact us