On This Page

Overview

For several platforms, there is an option to share files and folders via a link. The preserved shared links policy determines whether "domain" or "anyone" links are transferred from the source to the destination. Permission Preservation must be configured in your job for Shared Links to be transferred.

This option is automatically enabled when shared links only is selected as the item permissions policy.

Notification emails may be generated on the destination platform when shared links are transferred.

Supported Platforms

The following platforms support shared links. Refer to the Platform Comparison to see conflict between platforms.

Box
Dropbox
SharePoint Online (Office 365/OneDrive for Business Online)
G-Suite

Box

Box supports links for the following:

(Anyone) People with the link: Anyone with the link view only.
(Company) People in your company view only.
(Company) Invited people only: shared link will be view only; invited users can be set as view or edit.
Box has an additional option to view and download but we do not support transferring that and this is not an applicable option for SPO.

DryvIQ only supports anyone or domain (company). When transferring to SharePoint Online, the Box options will be translated as follows:

(Anyone) Anyone with the link can view.
(Company) People in company with the link can view.
(Company) Internal: People in company with the link can view and the invited users from within the company will be added to SPO direct access list with the corresponding edit or view rights.
(Company) External Users: People in company with the link can view and the invited external user will go to the pending access & requests page.

Terms

Anyone/Anonymous: Links that can be shared with anyone

Box: open
Dropbox: public
Google: anyone
SharePoint: anonymous

Domain: Links that can be shared only within your organization or enterprise

Box: company
Dropbox: team_only
Google: domain
SharePoint: organizational

Feature Support

DryvIQ handles shared links differently per platform. The following list defines different ways DryvIQ handles shared links. Refer to the table below to see how DryvIQ handles shared links for each platform that supports this feature.

READ/VIEW RIGHTS UNSAFE-ONLY: Links will be transferred as "View" only.

READ/VIEW AND WRITE/EDIT: Both "read" and "edit" links can be transferred.

ANYONE LINKS UNSAFE-ONLY: Anyone / Anonymous are links that can be shared with anyone.

supported: Feature is fully supported by the Platform and DryvIQ.

not supported: Feature is available by the Platform but not supported by DryvIQ.

not applicable: Feature is not supported by the Platform.

	Box	Dropbox	SharePoint Online	Google Workspace

	Box	Dropbox	SharePoint Online	Google Workspace
Number of Links	1 link per file or folder	1 link per file or folder	multiple links per file or folder	Max 2 links; anonymous and/or a domain
Rights	READ/VIEW RIGHTS UNSAFE-ONLY	READ/VIEW RIGHTS UNSAFE-ONLYVIEW -ONLY	READ/VIEW AND WRITE/EDITDEDIT	READ/VIEW AND WRITE/EDITRITE/
Expiration Date	supported	supportedPPORTED	ANYONE LINKS UNSAFE-ONLY	READ/VIEW RIGHTS UNSAFE-ONLYFE-ONLY
Link Passwords	not supported	not supportedORTED	not applicable	not applicable
Disable Download	not supported	not supportedT	not applicable	not applicable

REST API Examples

These are the two REST API requests you can use to get the information on each type of shared link.

GET {{url}}v1/transfers/items?processing=domain_shared_links&jobs={{job}}

GET {{url}}v1/transfers/items?processing=anyone_shared_links&jobs={{job}}

Example JSON

Permission Preservation Policy must be enabled to transfer Shared Links successfully.

Configuration Options

true: Transfer shared links on files and folders from source to the destination
false: Do not transfer shared links on files and folders from source to the destination (default)

"permissions": {
            "policy": "add",
            "links": true,
            "failures": "exceptions"

Example | Shared Links Basic Job

POST {{url}}v1/jobs

POST {{url}}v1/jobs

Example | Shared Links with Permissions Import

POST {{url}}v1/jobs

POST {{url}}v1/jobs

DryvIQ Migrate

Preserve Shared Links Policy