Microsoft Graph OneDrive


Microsoft OneDrive is a file hosting service and synchronisation service operated by Microsoft as part of its web version of Office.

3Sixty supports 3 types of OneDrive:

  • Personal Drive

  • Business Drive

  • "SharePoint" Drive - (Document library within a SharePoint site)

Authentication Connection

Standard Authentication Configuration

Use this authentication connector when accessing a "SharePoint" Drive. For more information see Microsoft Graph Authentication Connection.

The application will require the following permissions:

  • Repository: Sites.Read.All

OAuth Authentication Configuration

Use this authentication connector when accessing a Personal or Business Drive. The name of this connector is Microsoft Graph oAuth Connector

Configuration Fields

  • Service URL: This should be set to : https://login.microsoftonline.com

  • Scope: These are the permissions required to access OneDrive files. Multiple permissions are separated by a space. Default scope: user.read files.readwrite.all

  • Tenant: The directory tenant the application plans to operate against, in GUID or domain-name format. Note: When accessing a personal drive replace the guid with the word "common".

  • Client ID: The client id of the application.

  • Client Secret: The client secret for the application.

Discovery Connector

Documents retrieved from OneDrive will have the same metadata as those read from SharePoint.

Discovery Connection Configuration

  • Tenant Name: The name of the tenant. All O365 SharePoint instances use the structure [tenant].sharepoint.com. We use this to construct urls and gather siteIds.

  • Sites to Crawl: The base sites to crawl. Root will crawl your Team site.

  • Crawl Subsites: If the site has any subsites, crawl them as well. For example, if you leave the list above as root, but there is a subsite ([tenant].sharepoint.com/mySite), it will not be crawled unless this box is checked.

Integration Connection

Caution:  RUNNING ERRORS
As of the 3.1.1 release, MSGraph connectors cannot rerun errored documents. We are aware of the issue, and it will be addressed in the next release.

Important:  WARNING
The Microsoft Graph APIs throttle connections that make what it considers excessive api calls. They have not shared these metrics, and they are determined dynamically based on previous usage and presumably account type. See this link for more details

Job Configuration

Works with Business and SharePoint OneDrive. Personal drives not supported at this time.

Repository Configuration Fields

  • Site Names: A list of sites to crawl. Only applicable if accessing a SharePoint Drive via a standard authenication connection

  • Query: A query to run against each drive. For a Business drive, leave blank to retrieve all items in the drive. For a Personal drive you must enter at least one search term.

  • Process Folders: Process folders as well as documents. Note: Empty folders will be processed.

  • Get Versions: Retrieve document versions.

  • Include Permissions: Include the folder/document permissions.

Content Services Connection

This section covers the OneDrive specific configuration of the Content Service Connector. For a description of how to set up a content services connector generically see Content Service Connectors.

The only configuration required for this connector is the OneDrive Authentication Connector.

Works with Personal, Business, and SharePoint OneDrive.

Supported Methods

  • checkIn

  • checkOut

  • createFile

  • createFolder

  • deleteACL

  • deleteFolder

  • deleteObjectByID

  • getACLs

  • getFileContent

  • getObjectProperties

  • getTypes

  • listFolderItems

  • listVersions

  • setACLs

  • updateFile

  • updateProperties

Need help integrating Microsoft Graph OneDrive? We can help.