OneDrive & SharePoint / Google Drive integrations
This page explains how to connect Dastra to Microsoft OneDrive & SharePoint or Google Drive to use your cloud storage as the main document management system for the workspace.
Benefits of custom cloud storage
By default, Dastra's document management system relies on Azure Blob Storage: files are encrypted, scanned for viruses, and redundantly stored on a secondary server. For more details, see the security documentation.
In some organizations, this storage duplicates an existing cloud file system (SharePoint, OneDrive, Google Drive). Dastra integrates natively with these providers to avoid this duplication:
Microsoft OneDrive & SharePoint: a OneDrive or a SharePoint document library of your Microsoft 365 organization;
Google Drive.

Connection type: user OAuth
Setting up the integration
Open Workspace settings > Integrations, then click Microsoft OneDrive & SharePoint or Google Drive.
Click Add integration. You will be redirected to the provider's login page, where you will be asked to authorize access to your storage.
Choosing the drive (OneDrive & SharePoint only)
After authentication, Dastra lists the drives the connected account can reach. Choose the one Dastra will use in Choosing the Root Drive:
/ (e.g. Root site / Documents)
A document library of a SharePoint site of your organization
Recommended for enterprise use: shared space, not tied to a personal account
Your personal drive
Personal OneDrive of the connected account
Avoid in production: grants access to all personal drive files
Click Refresh if a site or library you just created does not appear yet.
Choosing a root folder (OneDrive & SharePoint only)
By default, Dastra uses the root of the drive. You can restrict it to a folder of the drive:
Under Root folder, click Choose a folder.
Browse the drive and click Select on the folder to use. Use the root of the drive goes back to the default.
Save the configuration.
Dastra then stores its files in this folder, and browsing from Dastra is limited to it: users cannot go above it. This is the simplest way to share a single folder of a SharePoint library with Dastra, without exposing the rest of the library.

If the root folder is deleted or moved in SharePoint or OneDrive, Dastra displays an error asking you to choose another folder in the integration settings.
Attaching cloud files to a Dastra entity
From any entity (processing activity, task, stakeholder…), you can attach files stored in your cloud:
Open the file panel of the entity
Select the data source at the top left of the panel

Browse your drive via the file manager
Click Add a file from the library to attach the file

You can also upload new files directly from Dastra to your drive.
A storage whose use case is deactivated in the integration settings is no longer offered as a data source.
Limitations
OneDrive & SharePoint
The connection uses user OAuth, not the Microsoft Graph API. If the account that set up the integration is deactivated, the connection is interrupted.
Dastra only works in the chosen drive, and in its root folder when one is set.
For enterprise environments, prefer a SharePoint document library over a personal drive.
Google Drive
Only files created from within Dastra can be added or modified in Google Drive. Dastra does not have access rights to files created directly in Drive. This is a limitation of the OAuth connector.
Files created in Dastra can be shared with other collaborators without restriction.
Last updated
Was this helpful?