Connector : Syncplicity
Restrictions
The following is a list of the restrictions with the Syncplicty connector.
1. The maximum length of any folder or file name is 260.
2. No leading or trailing spaces in folder names, file names, or file extensions.
3. Restricted characters in the file name: < > : / \ " ' | ? * . [ ] { } ( ) ! ;
Installation
This a cloud service provider but they do have the concept of "Storage Vaults". These data repositories can be hosted in the cloud or on premises.
– Syncplicity has the concept of storage vaults where the content is physically or virtually stored. Each Sync Point must be associated with a specific Storage vault and one storage vault can be set as the default for all new sync points by Syncplicity. There is no visibility for this with SkySync and is managed within the Syncplicity account.
In order to add a Syncplicity connection in SkySync, you will need to first acquire the application token, App Key, an App Secret, then grant the account you wish to use the "access content on behalf of managed users" privilege.
Acquiring the Application Token
1. Login to your Syncplicity account.
2. Click on the "Account" tab. Under "Profile", your application token may already be displayed. If not, there will be a "Create" button. Click it to generate the token. Note this token, as you will need to enter it in the SkySync application.
Granting the Access Privilege
A Syncplicity account cannot grant itself the necessary privilege. You will need to use an account other than your own. To do so, follow these steps:
1. Logout of your account, and login using a different account.
2. Click on the "admin" then "user accounts" toolbars.
3. Select your account. Then under the "Privileges" section click the "Modify" button next to "Access only own content through API."
4. Select the "Access content on behalf of managed users through API." radio button.
Obtaining a Syncplicity App Key and App Secret
Contact Syncplicity Support in order to obtain your App Key and App Secret.
Creating a Syncplicity Connection
1. Select the Authentication Type, Enter the App Key, App Secret, and Application Token and choose what type of Syncpoint you would like SkySync to create.
2. If you wish to view all the content for users in your enterprise the "List Content for All Users in Your Enterprise" checkbox must be checked, and you must be using an admin account.
3. If using "Application Token + Storage Vault Authentication" you must Authenticate the SVA by clicking "Authenticate" button that pops up, which will ask you to enter in your admin credentials for the SVA account.
Authentication Type Restrictions
1. There are 2 types of authentication types: "Application Token" and "Application Token + Storage Vault Authentication"
2. You cannot edit the connector to use a different type of authentication then was originally set up with the connector, you must create a new connector.
Rate Limits
Syncplicity has some aggressive rate limitations in place.
1. This limitations can not be adjust by the user and they would need to contact Syncplicity.
2. These rate limitations are determined by app key and app secret entered so if multiple instances are setup using that same set of credentials they share the limitation.
Sync Points
Sync Points - Root folders on a Syncplicity connector is known as a sync points and they have a special relationship to storage vaults and permissions.
1. Any root folder is a sync point. Each Sync point can be assigned to a storage vault in the native interface. For newly created root folders there is a default sync point.
2. Wtihin SkySync there is no way to see what Storage Vault a sync point has been assigned.
3. There is a drop down field on the connection setting which allows for the creation of sync points as either standard folders or SyncDrive folders.
3. Permissions only exist on sync points and do not extend int the nested paths. When doing a permissions migration into Syncplicity only the sync points can be set.
User Permissions
1. Any New user accounts need to be enable to use the API. It can be requested under the specific account but it requires a second account to authorize access.
2.We recommend that you do not increase parallel writes above 6 parallel writes
3. User Drive Mapping
- There is no way to get a user list if it is selected as a source
Permissions – Syncplicity support permission migrations but only for the sync points. When creating a permissions migration job from a connector that supports the full range of permissions the job will only migrate the permissions for the root sync points in Syncplicity.
User Drive Mapping – Unlike some other connectors Syncplicity does not show the list of users attached to the enterprise account. You need to externally assemble the list of users to either create a user map or to impersonate a specific user.
App Settings
There is a new appsetting override to be able to set SkySync to point to EU cloud storage vault. The following lines need to be added to the appsetting file in the SkySync installation folder.
<add key="SyncplicityBaseUrl" value="https://api.eu.syncplicity.com/"/>
<add key="SyncplicityBaseXmlUrl" value="https://xml.eu.syncplicity.com/" />
For instructions on how to edit the app setting click here