Setting up Office 365 instance

Configure your Office 365 instance so that it can be scanned by Quality Clouds. With this step you ensure that you are in control of the data which Quality Clouds accesses in your instance.

Make sure you have your Azure administrator login credentials. 

1. Create a new App registration

Quality Clouds connects to Office 365 instances through an app registration, which needs to be defined in your Active Directory.

→ To create a new App Registration

  1. Log into the Microsoft Azure administration console at https://portal.azure.com
  2. Go to Azure Active Directory > App registrations > New registrationOffice 365 - Instance definition
  3. Fill in the New registration form, and choose Accounts in this organizational directory only for the Supported Account Types.Office 365 - azure application registration
  4. Assign the following API persmissions (of the type Application permissions)  via the API permissions > Add a permission button:  
    • Azure Active Directory Graph
      • User.Read
    • Microsoft Graph
      • AuditLog.Read.All
      • Directory.Read.All
      • Files.Read.All
      • Groups.Read-All
      • Reports.Read.All
      • Sites.Read.All
      • User.Read.All

These are read-only permissions, and Quality Clouds will not modify the data in your Office 365 instance.


2. Generate and note down the client secret

In order to configure the O365 environment in Quality Clouds, you need an authentication token (API secret) with following attributes of the newly registered app:

  • Application (client) ID
  • Directory (tenant) ID 

→ To obtain the authentication token (API secret)

  1. In the Microsoft Azure administration console at https://portal.azure.com, go to Azure Active Directory > App registrations > (choose your newly registered Quality Clouds app).
  2. Go to Certificates & secrets > New Client Secret           A new secret is generated. Once created, the secret cannot be recovered. You can always generate a new one, if necessary. 
  3. Note down the generated Application (client) ID and Diectory (tenant) ID to use in the setup of your O365 environment in Quality Clouds.