Enabling Box Share

If you enable Box Share, users can select a document to share, and IBM Content Navigator creates a link to the specific version of the document. The user can also specify email addresses to send a link to the shared document. Box Share can only be enabled if your Box repository uses server authentication.

Before you begin

Users can share a document if they have permission to edit or view the document. Users who have edit access can share a document and can update the share options regardless of who shared the document. Users who have view access can share a document and can update the share options for documents that they share, but cannot update the share options for documents that someone else shared.
Important:

If you set up Box sharing before IBM® Content Navigator Version 3.0, you must create a new Box repository that uses server authentication to continue using Box Share in Version 3.0.

If you were sharing before IBM Content Navigator Version 3.0, the boxShareAdminRefresh task must also be manually deleted from the Task console. Locate and select boxShareAdminRefresh from the Task console, and then delete the task.
Remember: When authenticating to Box with server authentication, the time on the IBM Content Navigator server must be in sync with the time to which Box adheres, which can be found at: http://www.unixtimestamp.com/. If the times are not in sync, the following error is displayed in the IBM Content Navigator log: {"error":"invalid_grant","error_description":"Please check the 'XXX' claim."} Where XXX is one of several values returned by Box.

Procedure

To enable Box Share:

  1. Enable your Box application to use server authentication (JWT or JSON Web Token). Follow the instructions for generating an RSA Keypair, submitting the public key, and granting access in the Enterprise Admin Console provided in Authentication with JWT in the Box documentation.
  2. An administrator must complete the following steps to configure server authentication in IBM Content Navigator.
    1. In the IBM Content Navigator admin settings, click Repositories and select the Box repository that you will be using for sharing. If the repository is not listed, you need to add it as a new repository here, and select Box as the repository type.
    2. Select Server Authentication (OAuth 2.0 with JWT) in the Authentication Type section of the repository settings.
    3. Enter the Enterprise ID, public key ID, and private key file path in the appropriate fields. You created these values when you set up your Box repository for server authentication (Authentication with JWT), and they can be found in the application settings for your repository in Box.
    4. Click Connect....
  3. Enable task manager in the administration tool Settings.
  4. IBM FileNet® Content Manager repository only: Set the Task manager connection ID, enable Box Share. When you save this configuration setting, an add-on is installed on the repository. Box Share is supported on IBM FileNet Content Manager Version 5.2.0 or later.
  5. IBM Content Manager repository only: Set the Task manager connection ID, enable Box Share, and select the item types that you want users to be able to share. When you save this configuration setting, the classes that you selected are modified on the repository.
  6. For the desktop, enable Box Share, select the Box repository for sharing, and configure whether to allow users to edit the email address to send from when sharing a document.
    Important: If the authenticating repository for the desktop is an IBM Content Manager repository, ensure that the IBM Content Manager users are also LDAP users.

Results

If you enabled Box share services on a Box repository that you added to the desktop, the Box Share and Delete Box Share menu actions are automatically added to the default context menu.

For documents shared in prior releases, the Box repositories that are used to share those documents must remain in the desktop from which they were shared. If these repositories are removed, previously shared documents do not display the share icon and are no longer be shared.

If you create a new custom context menu by copying the default context menu, the Box Share and Delete Box Share menu actions are automatically added to the new custom context menu. However, these menu actions are not automatically added to any custom context menus that you created before Version 2.0.3 Fix Pack 6. To add the menu actions, edit your custom context menu, select the Box Share and Delete Box Share menu actions from the available actions list, and add them to the selected actions list.

If you enable Box Share, a mapping of user IDs and email addresses is required so that the user’s email address can be displayed and used to send the link to the document. For more information about mapping user IDs and email addresses, see Configuring the Email mapping plug-in.

When you share a document from an IBM Content Manager repository, the document version might change, but the content is not affected. For more information, see IBM Content Manager repository document versions might be affected by Box Share.