Adding Azure Active Directory (Office 365) - Updated

Adding data from Azure Active Directory services requires a creation of an Enterprise Application in the Azure Active Directory portal that will grant API access to XpoLog.
An administrator access to the Azure Active Directory portal is required to create the application and grant it the requited permissions, generate secret key, etc.

XpoLog uses the standard API calls over HTTPS (port 443) therefore that port should be open on XpoLog server(s).

Azure Active Directory portal side

1. Go to Microsoft Azure portal (https://portal.azure.com/) and login as Administrator.

   

2. Click on ‘Azure Active Directory’ Icon to open its portal:
   

   

3. Take a note of your Tenant ID displayed in this screen:

   

4. Application Creation - On the left navigation panel, Enter to ‘Enterprise Applications', Click the ‘New Application' and then on 'Create your own application’.

   

5. Give the application a name, check the ‘Non-gallery’ option and click on ‘Create’.

6. After the creation, navigate to 'App registrations', Click the 'New Registration' - name your application (XPLG_INTEGRATION for example) and Register.
   The application will be created and registered:
   

7. You will be redirected to the Application's portal:
   

   1. Take a note of the Application (client) ID:
      

      

   2. Application Secret (Authentication) - On the left navigation panel - click 'Certificates & Secrets', add a new client secret and take a note of the created secret value:
      

      

8. Application Permissions - Enter to ‘API permissions’, Click on Add a permission:

   

   1. Choose the ‘Office 365 Management APIs’ box and add the following permissions:

   2. Under Delegate (search the below values, select them and click the Add permissions button):

      1. ActivityFeed.Read

      2. ActivityReports.Read

   3. Under Application (search the below values, select them and click the Add permissions button):

      1. ActivityFeed.Read

      2. ActivityFeed.ReadDlp

9. Click on 'Microsoft Graph' and add these permissions:

   1. Under Delegate (search the below values, select them and click the Add permissions button):

      1. AuditLog.Read.All

   2. Under Application (search the below values, select them and click the Add permissions button):

      1. AuditLog.Read.All

10. Click on Grant admin consent for… button

11. The final view should look like:
    

XpoLog side

To add a your Azure Active directory data into your XpoLog system:

1. In Add Data pane click on Azure Active Directory. The Source and Collection Setting wizard opens.

   • To change a log source, near Source Type, click on the Change button.

2. Azure connectivity:

   1. In the Client ID, enter your client ID (see above section 9.a. - Application (Client) ID).

   2. In the Client Password, enter your password (see above section 9.b. - client secret value).

   3. In the Tenant ID, enter your tenant ID (see above section 3).

   4. Click verify to ensure connectivity:
      

      

3. Save and click next.

4. In the Time To Retrieve, select the default past time to retrieve data from the selected Azure services.

5. Select the Services you wish to collect data from the available services list (by moving the desired services to the right hand side).

6. Click on the grey box under 'Collection Settings', Open the 'Regional Settings' and change the Log time zone to 'Default [UTC]':

7. Click DONE – XpoLog applies an automated pattern on the incoming log.

8. Click SAVE and follow one of the following:
Save & Close – XpoLog saves the new log and points to the logs tree. locate the log in the logs tree and enter the viewer in order to view the log.
Save & Add Another – XpoLog saves the new log and points to Add Log screen so that you may another log.
Optionally, defining the basic information of the new log (see Setting Log General Information).