Sources
OneDrive
Ingest your files into Unstructured from OneDrive.
The requirements are as follows.
-
A OneDrive account.
-
The User Principal Name (UPN) for the OneDrive account. This is typically the OneDrive account user’s email address.
-
The path to the target OneDrive folder, starting from the OneDrive account’s root folder, for example
my-folder/my-subfolder
. -
The client ID, tenant ID, and client secret for the Microsoft Entra ID app registration that has access to the target OneDrive account and also has the correct set of Microsoft Graph authentication scopes. These scopes include:
Files.ReadWrite.All
(if both reading and writing are needed)Sites.ReadWrite.All
(if both reading and writing are needed)User.Read.All
Directory.Read.All
See also:
- Registering your app for Microsoft Graph
- OneDrive authentication and sign-in
- OneDrive API documentation
To create the source connector:
- On the sidebar, click Connectors.
- Click Sources.
- Cick New or Create Connector.
- Give the connector some unique Name.
- In the Provider area, click OneDrive.
- Click Continue.
- Follow the on-screen instructions to fill in the fields as described later on this page.
- Click Save and Test.
Fill in the following fields:
- Name (required): A unique name for this connector.
- Client ID (required): The application (client) ID of the Microsoft Entra ID app registration that has access to the OneDrive account.
- Tenant ID (required): The directory (tenant) ID of the Entra ID app registration.
- Authority URL (required): The authentication token provider URL for the Entra ID app registration. The default is
https://login.microsoftonline.com
. - Principal Name (required): The User Principal Name (UPN) for the OneDrive user account in Entra ID. This is typically the user’s email address.
- Client Credential (required): The client secret for the Entra ID app registration.
- Path (source connector only): The path to the target folder in the OneDrive account, starting with the account’s root folder, for example
my-folder/my-subfolder
. - Recursive (source connector only): Check this box to recursively access files from subfolders within the specified OneDrive path.
- Remote URL (destination connector only):
onedrive://
, followed by the path to the target folder in the OneDrive account, starting with the account’s root folder, for exampleonedrive://my-folder/my-subfolder
.