Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Create connection | User Interface

  1. Select Connections > Add connection.

  2. Select Syncplicity as the platform on the Add connection modal.

  3. Enter the connection information. Reference the table below for details about each field.

  4. Select Test connection to ensure DryvIQ can connect using the information entered.

  5. You will see a "Connection test succeeded" message on the Add connection modal when DryvIQ establishes connection. (If you don't see this message, verify the information you entered.)

  6. If the connection uses SVA, proceed to Sign in With SVA. Otherwise, select Done to finish creating the connection.

Add Connection Modal - Syncplicity

...

Field

Description

Required

Display as

Enter the display name for the connection. If you will be creating multiple connections, ensure the name readily identifies the connection. The name displays in the application, and you can use it to search for the connection and filter lists.

If you do not add a display name, the connection will automatically be named using the account owner's name. For example, Syncplicity (John Doe). If in Doe). If it will be useful for you to reference the connection by account, you should use the default name. 

Optional

User Type

Required

Connect as standard user

Select this option to create a standard connection to access a user's files and folders. This is the default selection.

Connect as account administrator

Select this option to create an administrator connection, This requires administrator privileges and grants access to all accounts within the organization. This option is often used along with 

/wiki/spaces/S4D/pages/193691984

impersonation to simplify transferring multiple user accounts. When connected as an administrator, the first level of folders will be user names.

Application token

This value is provided by your Syncplicity administrator. Each user can provision a personal application token, which can be used to authenticate in UI-less scenarios via API. This is useful for account administration tasks that run in a headless session. If provisioned, an application token is the only information required to log in a user using OAuth 2.0 client credentials grant. You should protect this token. To learn more, click here.

Required

App key

This value is provided by your Syncplicity administrator. The application key identifies DryvIQ (the third-party application) as defined by OAuth 2.0.  DryvIQ uses the application key and application secret to authenticate with Syncplicity. To learn more, click here.

Required

App secret

This value is provided by your Syncplicity administrator. The application secret serves as the password for the connection as defined by OAuth 2.0. DryvIQ uses the application key and application secret to authenticate with Syncplicity. To learn more, click here.

Required

Behavior When Deleting Items

Select the type of delete DryvIQ should perform when deleting items: Permanent or Soft. Soft delete is the default delete behavior; however, Permanent is the recommended behavior. 

A soft delete marks items as a deleted. You can still access them to restore or permanently delete the items.

A permanent delete removes the items. This delete is not reversible.  

Optional

New SyncPoint type

Select the syncpoint type for the list: Standard Sync Folder or SyncDrive Folder. This option instructs DryvIQ as to the type of folder that should be created when a top-level folder is created through a DryvIQ process. To learn more about these options, click here.

Optional

Test Connection Succeeded

...

Sign In With SVA

Once DryvIQ establishes connection, it will display an additional sign in option for accounts that have storage vault authentication enabled. You must complete the extra sign in step to provide the user authentication that needs to be used for the connection to access the storage vault. If there are multiple storage vaults enabled for the account, you will see a button for each storage vault. If you want to access multiple storage vaults, you must complete the sign in steps for each vault. Similarly, you don't have to sign into a storage vault if you don't want the connector to use it. 

  1. Select the Sign in with button. (The name of the button will reflect the name of the storage vault it is accessing.)

  2. A Syncplicity OneLogin modal appears.

  3. Enter the username for the account and select Continue.

  4. Enter the password for the account and select Continue.

  5. You will see an "SVA sign in succeeded" message when DryvIQ establishes connection. (If you don't see this message, verify the information you entered.)

  6. If there are multiple storage vaults, repeat these steps for each storage vault the connector needs to access. 

  7. Select Done to finish creating the connection.

Syncplicity OneLogin Modal

...

Sign in With SVA Succeeded

...

Features and Limitations

Platforms all have unique features and limitations. DryvIQ’s transfer engine manages these differences between platforms and allows you to configure actions based on Job Policies and Behaviors. Utilize the Platform Comparison tool to see how your integration platforms may interact regarding features and limitations. 

Supported Features

Unsupported Features

Other Features/Limitations

Version preservation

File lock propagation

Path length maximum: n/a
(See Path Lengths below.)

Timestamp preservation

Mirror lock ownership

Segment path length: 260
(See Path Lengths below.)

Author/Owner preservation

File size maximum

No leading spaces in file name/folder names
(See Invalid Characters and Spaces below.)

Account map

Restricted types

No trailing spaces before or after file extensions

Group map

Metadata map

No non-printable ASCII characters

Permission preservation

Tags map

Invalid characters: \  /  <  > 
(See Invalid Characters and Spaces below.)

/wiki/spaces/S4D/pages/193691984

User impersonation

Only syncpoints can be shared with other users and have permissions persist.

Users with a large number of syncpoints are not supported by Syncplicity.

Info

If you are creating a new impersonation job with a Syncplicity connection and the source or destination location is empty, the user you are impersonating has too many syncpoints. You will need to delete the syncpoints before you can create the job.

...