OneDrive Datasource and Connector Configuration

OneDrive is a file hosting service that is part of the Microsoft Office Online services. The Fusion OneDrive connector crawls a OneDrive for Business instance and retrieves data from it for indexing within Fusion.

To set up the Fusion connector, first create an Azure App with the appropriate API authorizations. Then proceed to configuring the crawl. Details follow.

Configure OneDrive for use with the Fusion connector

Create and register a Microsoft Azure App for use with the Fusion OneDrive connector.

  1. Navigate to the Azure Portal login page.

  2. Log in using an Azure admin account, or create a new one.

  3. Use an existing application or create a new one. To create a new application:

    1. From the My Applications page, click Add an app.

    2. Give your app a name and click Create.

  4. Take note of the Application ID. Take note of this. This Application ID be the "clientId" parameter when creating Fusion OneDrive datasources.

  5. Click Generate new password and take note of this password. This password will be the "clientSecret" parameter when creating Fusion OneDrive datasources.

  6. Under Platforms, click Add platform and then Web.

  7. Fill in a redirect URL to whatever you want, such as: http://localhost:8090. We won’t need the redirect URL to point to a valid website.

  8. Add the following permissions to the application:

    • Delegated permissions: Files.Read.All, Sites.Read.All, User.Read, Directory.Read.All (Admin Only), People.Read.All (Admin Only), User.Read.All (Admin Only)

    • Application permissions: Directory.Read.All (Admin Only), Files.Read.All (Admin Only), People.Read.All (Admin Only), Sites.Read.All (Admin Only), User.Read.All (Admin Only)

  9. Click Save. The application is now ready to be authorized by an O365 account administrator for use with the connector.

Find your Azure Tenant Name and Tenant ID

Before you can proceed, you need your Azure Tenant Name and Azure Tenant ID (also known as Directory ID) for your office 365 online account.

  1. Log in to Microsoft Azure as an administrator.

  2. In the Microsoft Azure portal, click Azure Active Directory.

  3. Under Manage, click Properties.

    • The tenant name is shown in the Name box. Take note of this.

    • The tenant ID is shown in the Directory ID box. Take note of this. This will be the "clientSecret" parameter when creating Fusion OneDrive datasources.

    Tenant name and IDS

Approve the application to make OneDrive API requests

To authenticate the Fusion connector:

  1. Open a web browser and enter the following URL:

    https://login.microsoftonline.com/<tenant_name>.onmicrosoft.com/oauth2/authorize?client_id=<application_id>&response_type=code&redirect_uri=http://localhost:8090&response_mode=query&resource=https://graph.microsoft.com&state=12345
    • Replace <tenant_name> with the Azure Tenant Name we found from the previous step.

    • Replace <application_id> in the client_id parameter with your Application ID from above.

  2. Access the URL. A list of permissions displays.

    accept screen for One Drive connector permissions

    1. Click Grant admin consent for <your tenant> and confirm. You can now use this application to crawl your OneDrive for Business accounts.

Configuration