Box
Files.com's integration with Box allows you to integrate with Box in several different ways.
Files.com's Remote Server Mount feature gives you the ability connect a specific folder on Files.com to the remote server in a real time manner.
That folder then becomes a client, or window, accessing the files stored in your remote server or cloud.
Once you configure a Mount, any operation you perform on or inside that folder will act directly on the remote in real time. Whether you are dropping a file into that folder, deleting a file, creating a subfolder, or performing any other file/folder operations your Files.com user has permissions for, those operations will "pass through" to the remote in real time.
This powerful feature enables a wide variety of use cases such as accessing files on a counterparty (client or vendor)'s cloud without provisioning individual access to individual users, reducing storage costs by leveraging on-premise or bulk storage solutions, enabling applications to access 3rd party clouds via Files.com API, FTP, SFTP, or Files.com Apps and many more.
Alternatively, Files.com's Remote Server Sync feature give you the ability to push or pull files to or from remote servers. This means that the files will exist in both places at the end of the sync process.
A remote sync can be a "push", where files from your Files.com site are transferred to the remote server, a "pull" where files are transferred from the remote server to your Files.com site, or a two-way "sync" where files that are new or changed in either location are pushed and pulled to maintain a synchronized state between the folder on your Files.com site and that on the remote server.
Add Box as a Remote Server
Create a new Remote Server for your site, and select Box as the remote server type.
You must provide an Internal name for this connection. If you're managing multiple remote servers, make the name clear enough to easily identify this particular connection.
The options for specifying Dedicated IPs and Data Regional Routing will only appear if your site is configured to allow those options. Dedicated IPs are only available when a Custom Domain has been configured. Data Regional Routing is only available if your top-level, or root, folder is set to a non-USA geographic region.
Once your new Remote Server is saved, select the Connect button to connect and authenticate with Box. A popup will display with the Box login form. By logging in, you are connecting your Files.com site with your Box account.
After your Remote Server is connected, you can use it with Files.com as either a Remote Server Mount or Remote Server Sync.
Using Multiple Box Accounts
You can create as many Box Remote Servers as required. Repeat the above instructions and enter different credentials each time the Box login page is presented.
However, if you are using Single-Sign-On (SSO) with Box then your web browser will always try and log you in using your currently logged-in credentials. The popup Box login page will automatically log you in without giving you the option to enter different credentials. This is normal web SSO behavior. If you have this issue, you can try to circumvent the Single-Sign-On by logging out of Box within your web browser prior to connecting the new Remote Server, use an incognito web browser window or use a different computer and web browser that hasn't logged into Box yet.
Add Remote Server Mount
Remote Server Mounts are created by mounting them onto an empty folder in Files.com. This folder should not be the Root of your site, although that is supported if you need it.
Add Remote Server Sync
After creating the Remote Server, you can use it to perform Remote Syncs between your remote server and Files.com.
Case Sensitivity
Be aware of case sensitivity differences when copying, moving, or syncing files and folders between Box and other storage locations. Box is a case insensitive system whereas other systems may be case sensitive. This can cause files to be overwritten, and folders to have their contents merged, if their case insensitive names are a match.
Reauthenticating
What To Do When Your Remote Server Connection Is Disabled
Because Box uses the oAuth authorization protocol, there may be future errors with the authentication even after your remote server is configured and running smoothly for some time. When one of those errors happens, Files.com will disable your Box remote server connection and record the error in your External Events log.
When you've resolved the problem that caused the authentication error, you can re-enable your remote server by saving its configuration. Even if you don't make any changes to the configuration, saving the record will cause Files.com to re-enable the connection so that any associated mounts and syncs will begin working again.
Troubleshooting
Make sure that the permissions of the Box user account are correct. Files.com will only be able to perform actions that are allowed for the Box user. The Box user account being used should have "Editor" permissions, or higher.
There are some actions that are not allowed for "Viewer" permissions unless the user performs those actions on the Box platform itself. This means that some "Viewer" actions that succeed on the Box platform will not succeed for the same user when they access Box from another platform, such as Files.com.
Cannot Download File
When attempting to download a file from a Box Remote Mount folder, you may see errors such as Box errored while trying to Download: '403:'
or Could not download {path} due to:
.
These errors occur when the Box user only has "Viewer" permission and attempts to download a watermarked file. Box only allows watermarked files to be downloaded directly from their own platform via their online viewer app. Watermarked files are prohibited from being downloaded any other way by "Viewer" permission users of Box.
Change the Box user's permission to "Editor" to resolve this issue.