Starting with Resilio Connect v3.8.0, integration with SharePoint Online is available.
1. Configure a connection to SharePoint Online
To integrate Resilio with SharePoint Online, you must set up an application in your SharePoint tenant and configure it in the Resilio Management Console.
Step 1: Create an Application in SharePoint Online
-
Log into the Azure Portal:
- Go to Azure Active Directory.
-
Create a New Application:
- Navigate to App Registrations and select New Registration.
- Enter a name for your application (e.g., "ResilioConnector").
- Choose the Accounts in this organizational directory only option.
- Click Register.
-
Save Application Details:
- After registering, take note of the Application (Client) ID and Directory (Tenant) ID. These will be used in the Resilio Management Console.
-
Generate a Client Secret:
- Go to the Certificates & Secrets tab.
- Click New Client Secret, add a description, and set an expiration period.
- Save the generated Client Secret Value immediately. You won’t be able to view it again.
-
Grant API Permissions:
- Go to the API Permissions tab.
- Click Add a Permission Microsoft Graph Application Permissions.
- Search for and select:
Files.ReadWrite.All
Sites.Read.All
User.Read.All
- Click Add Permissions and grant admin consent.
On the Management Console, go to the Cloud Storages menu and add new storage for SharePoint.
Fill in the following:
- Tenant ID and Client ID from the Azure application.
- Client Secret Value.
- Root (Site Name).
- Drive (Document Library Name - Optional).
2. Create a Job
Apply Preset for SharePoint in the Agent Profile before configuring the job.
When creating a job, select Storage Connectors Macros and choose the configured SharePoint connector.
If the drive was not provided during connection configuration, specify it in the job path.
3. Limitations and Peculiarities
- SharePoint imposes usage limits, and MS Graph API request limits may impact performance. You can learn more about these limits here.
- Intermittent errors, such as "Credentials not resolved (403)," may appear. Retry after a minute or two.
- By default, Microsoft stores SPO data in the tenant's region. You can read more here: Overview of Data Residency and Data Residency Commitments Available.
- To see where data is stored, go to MS365 Admin Center, navigate to Admin->Settings->Org Settings->Organization Profile tab->Data Location (Tenant administrator role is required to see that option).
- Placing a Resilio Agent in the same region has not been proven to improve performance.
- Files and folders created by the Resilio Agent will display "SharePoint App" as the user in SharePoint's UI. This is a built-in user used for such cases.
- Filenames cannot have leading or trailing spaces. These are replaced with underscores.
- The agent does not receive file system notifications from SharePoint Online. Changes are detected during periodic scans.
- Invalid Client Secrets may result in errors like "Not enough permissions to create identifying .sync/ID file." Update the secret and rescan the agent.