Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
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.

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 to open its portal:
    Image Added

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

  4. Application Creation - On the left navigation panel, click Enterprise applications and create a new application.

  5. Click the 'Click here to switch to the old app gallery experience' - Name it (XPLG_INTEGRATION for example) and select the option 'Register an application you're working on to integrate with Azure AD'
    Click create to create application:
    Image Added

     

  6. Select 'Application you're developing':

    Image Added

  7. Click the link 'Ok, take me to App Registrations to register my new application' link

    Image Added

  8. Click the 'New Registration' - name your application (XPLG_INTEGRATION for example) and click Register.
    The application will be created and registered:
    Image Added

  9. You will be redirected to the Application's portal:
    1. Take a note of the Application (client) ID:
      Image Added
    2. Application Secret (Authentication) - On the left navigation panel - click Certificates and Secrets, add a new client secret set desired expiration), and take a note of the created secret value:
      Image Added

     

  10. Application Permissions - Click API permissions

  11. Click Add a permission

    1. Click Office 365 Management APIs and add these 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

  12. 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

  13. Click on Grant admin consent for… button

  14. The final view should look like:
    Image Added

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:
      Image Added
  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 DONE – XpoLog applies an automated pattern on the incoming log. Verify that data is displayed and parsed properly.
    Image Added
  7. 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).