Microsoft OneDrive for Business

Set up Azure

First, you need to contact your Azure administrator and ask for three parameters which you’ll need when you create a connector.

  • Application (Client) ID

  • Client Secret

  • Directory (Tenant) ID

You can read the Azure procedure here.

Configure network and firewall access

You will need to give Exonar Reveal network access, including firewall access, to OneDrive.

For further details, take a look at this documentation from Microsoft.

Create the data source in Exonar

In Exonar, create a data source:

  1. From the main menu select Data Sources

  2. Click NewNew Data Source

  3. In the New Data Source dialog, select the dataset this new data source will belong to by:

    1. choosing an existing dataset from the dropdown, or

    2. clicking Add to new Data Set and typing the name of your dataset

      If you use option 3b, remember to add the dataset to at least one security group

      If you don’t, no users will be able to see the data from this data source

  4. Click Next

  5. Select the Office 365 data source and click Next

  6. Select which Office 365 service you want to use: Exchange, SharePoint, or OneDrive

  7. Enter the Azure credentials for this data source

    Your Azure administrator can supply these

    If you want to ingest all the content of your OneDrive, leave the Folder Path field blank

    You’ll receive an error message if you attempt to ingest all your data using a folder path such as this:

    /personal/example_user_exonar_com
    

    If you want to ingest a folder such as this one on OneDrive:

    My files > OneDrive-XYZ-files > Example
    

    Use this path:

    /OneDrive-XYZ-files/Example
    
  8. Think about the ingestion scope you want to use:

    For this scope:

    We crawl mailbox content for this:

    Everything

    All users that a tenant has

    Domain

    All users belonging to a domain under the tenant

    Group email

    All users belonging to a domain group

    User email

    An individual domain user

  9. Optionally, click Test Credentials

    Exonar validates them and shows you what the credentials allow you to crawl

    Test the Azure credentials for Office365 OneDrive
  10. Click Next

  11. Choose your ingestion scope:

    • Everything

    • Domain

    • Group email

    • User email

    Depending on the scope you choose, you’ll need to find:

    • domain name

    • email address for the user or group of users

    • folder path

  12. Fill in the domain and email and folder path if needed.

    If the scope is Everything, you don’t need any parameters.

    Optionally, click Test Connection

Note

In most cases, this test is reliable. However, you might want to configure a data source before the target server is available, or perhaps during a scheduled maintenance window when the check isn’t possible.

Also, Office 365 cannot be fully validated without attempting to crawl data.

The Ignore this warning checkbox allows you to set up the data source even if validation fails.

  1. Select the country for this data source and click Next

    The country is used in geographical visualisations

  2. Optionally, click Add Custom Description

    This allows you to use you own description for this data source, rather than accept the default description that Exonar provides

  3. Set the Crawl priority

  4. Specify whether you want to crawl once or continuously

  5. Click Start Crawl Immediately if you want to crawl the data right now

    Or you can start a crawl manually anytime you want

  6. Click Create Data Source