This article describes how administrators can configure Shinydocs™ Discovery Search to connect with Box™, allowing end-users to download and preview files stored on the platform.
Box may enforce API rate limits that could be exceeded during the initial crawl of Box data. This may result in overage fees. Please contact Box support for any questions regarding rate limits and how to monitor usage.
Registering the Discovery Search app in Box
Adding Discovery Search as a Custom App
If you do not have a Box account, please create one.
Log into https://developer.box.com
Navigate to My Apps
Create New App
Select Custom App from the list of Application Types
Select User Authentication (OAuth 2.0) from the list of Authentication Methods
Enter an appropriate App Name (for example, Discovery Server)
Copy the resulting Client ID and Client Secret and save them for later use (these will be entered later when you configure the Box connection in Discovery Search)
Configuring the Discovery Search app
The Redirect URI must be formatted correctly:
HTTPS is required
This is the URL that users will be directed to once they connect to Box.
Enter the Discovery Search server URL in OAuth 2.0 Redirect URI (for example, https://mycompany:9300/Box/AuthCode)
In the Application Scopes section, under Content Actions, enable Read all files and folders stored in Box
Enable Write all files and folders stored in Box
Save the changes
Configuring the Box connection in Discovery Search
You will need copies of the Client ID, the Client Secret, and the Redirect URI to complete this section.
Navigate to the Application settings menu
Select Box settings
As noted from the Discovery Search app registration in Box, enter the Box client id, the Box client secret, and the Box redirect URL
Update the number of Max concurrent perm checks if you want to increase the number of permission checks that can be executed concurrently for each user running a search
Update the number of index items that are permission checked upon retrieval from the index in Perm check chunk size if desired
Save the changes
Restart the Discovery Search application in IIS
An index of the Box data must exist before Discovery Search can be used to find documents. Ensure a crawl with Shinydocs Cognitive Toolkit against the Box instance has been completed before testing. Please refer to Initial Discovery - Box for instructions about how to use Cognitive Toolkit to crawl Box data.
End-users must log into Box from the Discovery Search user dropdown to review or download Box files within Discovery Search.
Authorizing access to Box
Navigate to https://<fqdn>:<port>/Box/Authorize
You may be prompted to log in
Click Grant access to Box.
You are redirected to the Discovery Search homepage.
Run a search for Box content
Confirm content from Box is returned