Connecting to Box
The last step in setting up the Jive-Box connection is connecting to Box from the Jive side.
User interface: Avatar > Add-ons > Storage Providers
You can use the add-ons settings to connect to Box, to set Box as the default storage provider for uploaded files, and to decide which users can set up places to be connected to a Box folder. Each place you connect to Box will store uploaded files in a separate folder inside that account. These files can be updated on either the Jive side or the Box side, and social interactions such as comments on added files will be visible on both sides.
Note: Only uploaded files are stored in the external storage provider. Images and attachments continue to use whatever binary storage location you're already using for your community.
Before you start to set up the Jive side of the connection, you should set up the Box side, as described in Configuring Box to work with Jive and Setting up Box Integration User.
To set up the connection on the Jive side:
-
Click your avatar in the upper right corner, and select Add-ons.
-
On the Available tab, find Box.com Integration and click Install next to it.
-
Click Configure Now. When prompted, provide the account credentials for the Jive Integration User, and then click Grant access to Box.
-
Click Save and Activate.
-
Go to the Storage Management tab and click Add Integration.
-
Select Jive+Box as the Provider Type.
-
In Display Name, type the name you want community users to see displayed when you are selecting a storage provider for the group.
-
Click Add.
-
Authenticate with the Box Integration User account.
-
If you want all your community users to be able to create groups that use this Box connection for storage, select the Enabled check box.
-
If you want only some of your users to be able to create places that use this storage instance, clear the Enabled check box and start typing the name of a Jive permission group in Permissions Override.
These groups are granted permission to create groups linked to this storage instance.
-
Use Mapping Options to determine how Box users connect with Jive users. We recommend that you use the default setting, which is email address.
Managing Box
To integrate selected places with Box as the external file storage provider and to socialize the documents you store in your Box folders, you can connect a Box account to a community. The initial relationship is created when you connect a Box admin account to your community. A Box Integration user with rights to this account is created in Jive. When community users and administrators create places, a folder within the Box account is created and identified with the name of the place. Files added to or modified in that folder from either the Box side or the Jive side are then synchronized. When a community member uploads a file to the group, the file is posted to the Box group using the Box Integration user.
This means community members don't need Box accounts to access the information in places to which they have rights. They can access and modify any files posted there from the Jive side. However, they won't have access to the contents of the folder from the Box side unless they also have a Box account. Box users who have access to the folder will also need a Jive account if they want to add more documents to the Jive-linked Box folder or modify its contents. Users can comment on documents from either side, and their comments will be visible from both Box and Jive.
Note: If you connect a space to Box, be aware that spaces with the All Registered Users permission in Jive are mapped to All Enterprise Users in Box. Users who have this permission in Box will be able to see the content, even if they don't have rights to access the Jive space.
Requirements for Box add-on
- StreamOnce add-on. For more information about the add-on, see the Jive StreamOnce documentation.
Setting up Box integration
The complete setup includes these steps:
-
On the Box side, apply the correct settings to your Box enterprise account as described in Configuring Box to Work with Jive.
-
On the Box side, create the Box Integration User. This user is the account you'll use to connect your Jive community to Box. It's also the basis for a Jive system user that will be a member of every Box-linked place in Jive, linking it to the associated Box folder.
-
On the Jive side, make sure the StreamOnce add-on is installed, and then connect Jive to Box using the Jive Integration User credentials. Then decide whether users can create new places with a Box-connected folder, as described in Connecting to Box.
Note: If you're using an SSO solution such as Okta with Box, make sure the integration user is defined as an admin. Otherwise, the identity provider could remove the integration user's administrative privileges from Box, breaking the integration.