...

...

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.

...

Supported Platforms

The following platforms support shared links. Refer to thePlatform Comparisonto 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.

SkySync 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.

• Image Added

...

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

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

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

Example JSON

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

{
    "name":"Shared Links Example",
    "kind": "transfer",
    "transfer": {
        "transfer_type": "copy",
        "large_item": "skip",
        "batch_mode": "always",
    	"timestamps": "true",
    	"tags": "none",
    	"permissions": {
            "policy": "add",
            "links": true,
            "failures": "exceptions"
    	},
    	"segment_transform": true,
    	"preserve_owners": true,
    	"duplicate_names": "rename",
    	"empty_containers": "create",
    	"versioning": {
        	"preserve": "native",
        	"select": "all"
    	},
        "source": {
            "connection": { "id": "{{cloud_connection_source}}" },
            "target": {
                "path": "/sourcePath"
            }
        },
        "destination": {
            "connection": { "id": "{{cloud_connection_destination}}" },
            "target": {
                "path": "/destinationPath"
            }
        }
    },
    "schedule": {
        "mode": "manual"
    },
    "stop_policy": {
        "on_success": 2,
        "on_failure": 2
    },
    "category": {
    	"name": "Report | Shared Link Jobs"
   }
}

Example | Shared Links with Permissions Import

{
  "name":"Shared Links with Permissions Import",
  "kind": "transfer",
  "transfer": {
    "audit_level": "trace",
    "transfer_type": "copy",
    "permissions": {
      "policy": "add",
      "failures": "exceptions",
      "links": true,
      "import": {
        "source": {
          "text": {
            ["delimiter"]: ",", //optional, defaults to comma
            "target": {
              "path": "/permissions_import.csv"
            }
          }
        },
        "output": {
          "format": "text"
        }
      }
    }, 
    "source": {
      "connection": {
        "id": "{{nfs_connection}}" 
      },
      "target": {
        "path":"/"
      }
    },
    "destination": {
      "connection": {
        "id": "{{cloud_connection}}"
      },
      "target": {
        "path": "/destinationPath"
      }
    }
  },
    "schedule": {
        "mode": "manual"
    },
    "stop_policy": {
        "on_success": 2,
        "on_failure": 2
    },
    "category": {
    	"name": "Report | Shared Link Jobs"
   }
}