Basic Box Connector Configuration

About this task

The minimum steps required to use the Box connector are the following:

Procedure

  1. Create a new Watson™ Explorer Engine search collection.
  2. In the Configuration tab of your Watson Explorer Engine search collection, click Add a new seed.
  3. A pop-up window displays. Select Box Connector from the scrollable list of available connectors, and click Add; the "Seed Component" options will be displayed.
  4. In the Seed URL box, enter the base URL of your Box site. The default value is box://app.box.com/
    Note: You can crawl different types of URLs, for example:
    • To crawl an entire enterprise: box://app.box.com/
    • To crawl a specific Folder: box://app.box.com/user/USER_ID/folder/FOLDER_ID/FolderName
    • To crawl a specific User: box://app.box.com/user/USER_ID/
  5. In the Client ID field, enter the Client ID provided by Box when you created your application.
  6. In the Client Secret field, enter the Client Secret provided by Box when you created your application.
    Note: If you need to see either your Client ID or Client Secret, log in to your Box account at https://www.box.com, open your application, and see them both listed on the page.
  7. Provide the Path to Private Key. This is the location, on your local file system, of the Private Key that is part of the private-public key pair generated for communication with Box.
    Note: The Private Key must be generated in unencrypted Distinguished Encoding Rules (.DER) format. For additional information about generating a key pair for Box, see https://docs.box.com/docs/app-auth.
  8. In the Key ID field, specify the Public Key ID. This is the other half of the private-public key pair generated for communication with Box.
    Note: For additional information about generating a key pair for Box, see https://docs.box.com/docs/app-auth.
  9. The App User User ID field specifies the user ID of the application user that will be communicating with the system. This is not a normal, regular user ID; it must be the ID of a Box "App User".
  10. Click OK/Apply to save the updated configuration information for the Box connector.

    After saving your changes, you will be able to use the commands on the Overview tab of the Watson Explorer Engine Administration tool. At this point, you can initiate a crawl of Box sites using the Box connector.