Versions Compared

Key

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

...

  1. Select Connections > Add connection.

  2. Select Box (Service Accounts) as the platform on the Add connection modal.

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

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

  5. Select Done.

Add Connection Modal - Box (Service Accounts)

...

Field

Notes

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.

Required

User Type

Required

Connect as a 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 an 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 impersonation to simplify transferring multiple user accounts. When connected as an administrator, the first level of folders will be user names.

Client ID 

This value will be provided by your administrator. It can be found in your Box Developers Console or in the boxAppSettings section of {{public key}}_config.json.

Required

Client Secret 

This value will be provided by your administrator. It can be found in your Box Developers Console or in the boxAppSettings section of {{public key}}_config.json. 

Required

Enterprise ID

Enter the Enterprise ID if the connection will list content for all users on your connection root. This field is not required when an Account ID is being used. 

The Enterprise ID cannot be used with an Account ID; the options are mutually exclusive.

Required if not using an Account ID

Account ID 

Enter the account ID (user ID) if the connection will impersonate a single account. This field is not required when an Enterprise ID is being used. 

The Account ID cannot be used with an Enterprise ID; the options are mutually exclusive.

Required if not using an Enterprise ID

Public Key ID

Enter the public key for the account. This value can be obtained from your manually generated keypair or in the boxAppSettings section of {{public key}}_config.json.

Required

Private Key

Enter the private key for the account. This value can be obtained from your manually generated keypair or in the boxAppSettings section of {{public key}}_config.json. 

When you download the {{public key}}_config.json, the private key is displayed in the privatekey element. It looks something like this: 

"privateKey": "-----BEGIN ENCRYPTED PRIVATE KEY-----\xYZXYZxYZXyzxyzx.....................A0b0CAB0cAbCaBcabcabCA+B\noi0=\n-----END ENCRYPTED PRIVATE KEY-----\n",

You only need to add the values between the quotation marks. In the above example, you would add the following as the private key:

-----BEGIN ENCRYPTED PRIVATE KEY-----\xYZXYZxYZXyzxyzx.....................A0b0CAB0cAbCaBcabcabCA+B\noi0=\n-----END ENCRYPTED PRIVATE KEY-----\n

Required

Password 

Enter the password for the account. This value can be obtained from your manually generated keypair or in the boxAppSettings section of {{public key}}_config.json. The password is generated by Box when created via the download keypair from your Box Developers Console.

Required

Behavior When Deleting Items

Select the type of delete SkySync 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

...

Supported Features (tick)

Unsupported Features  (error)

Other Features/Limitations (warning)

Version preservation

Restricted types

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

Timestamp preservation

File size maximum: 15 GB
(See File Size Limits below.)

Author/Owner preservation 
(See Owner Permissions below.)

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

File lock propagation

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

Mirror lock ownership

No leading spaces in file name/folder names

Account map
(See Account Map below.)

No trailing spaces in folder names, file names, or file extensions
(See Invalid Characters and Spaces below.)

Group map 
(See Group Maps below.)

No non-printable characters
Any non-printable ASCII characters will not be filtered by SkySync.

Permission preservation

Box has download limitations for the number of folders and files contained in one folder. Please consult Box documentation for further details.

User impersonation

Box accounts that do not have administrator-level access cannot remove group permissions on files during a job transfer.

Metadata map

Google document types natively created on Box can be moved and will maintain formatting. However, they will have the native Google file extensions (.gdoc, .gsheet, etc.).

Tags map

The maximum tag size in Box is 255 characters. You can enter more characters than the maximum, but Box will truncate it down to 255 characters.

...