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.

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.