Preserve Shared Links Policy



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 Version: 5.9.1
Release Date: November 7, 2024