Connector: Box



Box has a monitoring webpage to check for outages and issues, please check https://status.box.com/ for any issues with the Box service when experiencing problems.

Restrictions

1. The maximum length of any folder or file name is 255.

2. No leading spaces in the filename.

3. No trailing spaces in folder names, file names, or file extensions.

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

5. Restricted characters in the file name: . .. / \

6. Please contact Box for any restriction on the number and size of files and folders to have in one parent folder.

7. When setting up a box connection you need to use the admin or a co-admin account.

8. The maximum upload file size is controlled by Box.  Here is a link to their support article -  https://community.box.com/t5/Managing-Your-Content/What-s-the-maximum-file-size-I-can-upload/ta-p/307

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

10. There is a known issue with the Box connector. If "Exclude files in shared folders" is enabled, and there are multiple shared folders with the same name owned by different users in Box, the job will return the failure: "The truncated name would result in name conflicts on the storage platform." There is no workaround for this other than renaming the folders.

11. Due to changes to the  Box API connection pooling no longer is effective in increasing speed with the Box connector.

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

13. Max tag size in Box is 255 characters, you can enter more characters then that, but Box will auto-truncate it down to 255 characters.

 


Connector Creation Settings

1. If you have an Enterprise License the "Box Content Admin" allows for access to all user accounts on the Enterprise account.

2. If you would like to enable a metadata template for the connector you must enter in the name of the template in the space shown in the below screenshot when setting up the connection.

For information on how to set up a metadata template in box please see this article.



Common issues

Listed below are common issues that can occur with Box and how to fix them.


Concern: Box is ending support for TLS1.0 will this effect my SkySync?

Answer: No. SkySync moved away from TLS1.0 in Jan of 2017 therefore provided that you are on an updated version of SkySync Box's end of support for TLS 1.0 will not effect you.


Error: "User does not have permission to make these changes"

Action: When attempting to move or make changes to files in a shared folder

Reason: Folder owner is disabled


Behavior:"Child jobs are disappearing from user drive mapping Job"

Reason: When a user is deactivated in Box the child job associated with the user drive mapping job will be deleted. This can also be checked by viewing exclusions and confirming that the user is not visible.


400 Bad Request 


400BadRequest.png

This often occurs when the box user has not accepted the box terms of service.  

To resolve the issue, log-in to Box and accept the terms of service.


Unable to obtain valid access token

This is a common error that will be visible as a failure in the job history. The two most common ways to resolve this error can be seen below 

Password Change/Expiration

1. From the home screen in SkySync, click on the Navigation tab to go to the Navigation panel.

nav_panel.png



2. On the left side of the screen, right-click on the connection the job is using, and select Edit.

edit.png



3. In the screen that appears, re-enter the user-name and password for the storage platform account.


login.png


If the above steps do not work, please try the suggestion below.

SkySync App was disabled by the admin

Recent updates at Box may have caused the SkySync app to become disabled by default.

Symptoms leading to this may be:

  • SkySync was functioning properly and is now reporting: The application was unable to obtain a valid access token to the storage platform.

AccessToken.png

  • When creating a box connector, you see the following: Disabled by Administrator

BoxDisabled.png

 

To remedy this, log on to Box as the Admin then perform the following to enable the SkySync app:

You must log in as the Admin account, Co-admin accounts will not see the same options.

1.Click Admin Console

2.Click the settings 'Gear'

3.Click Enterprise Settings

4.Search for SkySync in the Individual Application Controls

5.Make Sure SkySync  is available. 

"The Account 'Joe User' Is Not Authorized to Perform the Requested Operation" Error

When attempting to perform a user drive mapping job against Box, you may encounter the error message in SkySync:  "The Account 'Joe User' Is Not Authorized to Perform the Requested Operation"

Where ‘Joe User’ is a specific user account in your enterprise.

This error is generally due to a newly created Box account where the user has not yet responded to the welcome email, signed in, and been assigned their password.  Once the user completes these onetime security procedures, the account should be active and the user drive mapping sub job should complete successfully.



Content Modified On/ Content Created On

When moving versions to box some content created on and modified on dates may come over incorrectly.  This is a known issue with the API and will not be fixed.


Additional articles about this connector