Integrating ONLYOFFICE with Box

Server version

Step 1. Creating authorization keys

To create the authorization keys required to connect Box to your portal:

1. Go to the Box Developers page.
2. Sign in to your account.
3. Click Create new app.
4. On the page that opens, select the Custom app application type and select the User Authentication (OAuth 2.0) method.
5. Enter a unique name for your application and click Create App.
6. On the Configuration page that opens, enter https://service.onlyoffice.com/oauth2.aspx in the Redirect URI field of the OAuth 2.0 Redirect URI section.
7. In the Application Scopes > Content Actions, select the Write all files and folders stored in Box checkbox.
8. In the OAuth 2.0 Credentials section, copy or note down the Client ID and Client secret.
9. Click Save Changes in the upper right corner of the page.

Step 2. Connecting Box on the portal

To connect Box on your portal:

1. Click the icon in the upper-right corner to open Settings.
2. Select the Integration tab.
3. Open the Third-Party Services page.
4. Scroll down to Box and click the switcher to enable it.
5. In the Box window that opens, enter the Client ID and Client secret obtained in the previous step.
   
6. Click Enable to connect the service.

Cloud version

Connecting your Box account

In the cloud version, authorization key parameters are set up automatically. To connect your Box account to the Documents module:

1. In the left sidebar, click the three dots under the Connect section and select Other account in the Connecting account window, or go to Settings > Connected clouds and click Connect cloud.
   
2. Enter the connection URL, your user name, and password, then click Save.
   The WebDAV URL for your Box account can be found by signing in to Box, clicking the Settings icon in the lower left corner, and copying the URL from the WebDAV field. The URL has the following format: https://yourdomain.com/remote.php/webdav/. Paste the full URL, including the protocol, into the Connection URL field.
3. Click the button to grant ONLYOFFICE access to your Box account. Your Box documents will appear in the Documents module as a folder.
4. Change the folder name if necessary.
5. To make Box documents visible to all portal users, select the Make shared checkbox to place them in the Common Documents folder. If left deselected, the Box account will be visible to you only.
6. Click Save.

Editing Box documents

To edit a document stored in Box:

1. Locate the Box folder in the Documents module and open it.
2. Browse to the file you want to edit and click it. If necessary, a dialog will prompt you to convert the document to the OpenOffice XML format for faster viewing and editing. To keep the original file, select the Save the file copy in the original format as well checkbox.
3. Click Convert.
4. Click Open when the message appears that the document has been successfully converted.

After editing, close the document to save the changes.