Documentation

Box integration

Box files and folders can be linked and embedded in intranet pages, and searched from the intranet using ThoughtFarmer's Cloud drive integration features. To use Box integration features such as linking and search, Box integration must first be set up.

To set up Box integration, you need a Box account (either corporate or developer), and a Box Custom App that allows integration between Box and ThoughtFarmer. You need to be using https in order to use Box.

For user instructions on Box integration features, see Cloud drive integrations. 

Create a Box Custom App

  1. Go to https://developer.box.com.
  2. Click Console.
  3. Sign in to your Box account if you haven't already done so.
  4. Click Create New App.
  5. Choose Custom App, then click Next.
  6. For the Authentication Method, choose Standard OAuth 2.0 (User Authentication), and click Next.
  7. Type a name for the app (users will see this name when they are logging in to Box), and click Create App.
  8. Click View Your App.
  9. In the Configuration tab, scroll down to find the OAuth2 Credentials, where you can copy the Client ID and Client Secret (You will need to paste these into ThoughtFarmer when setting up the Box integration with ThoughtFarmer).
  10. Scroll down to the OAuth 2.0 Redirect URI section, and enter your TF URL plus "/box", e.g. "https://mytfsite.example.com/box";. Note that you must use https.
  11. Scroll down to the CORS Domains section, and enter your TF URL, e.g. "https://mytfsite.example.com".
  12. Click Save changes.

Enable Box integration

  1. On your ThoughtFarmer intranet site, go to the Admin panel: Integrations section > Cloud drives page.
  2. Under the Box tab, click the toggle beside Box integration to turn it ON.

    9.3Admin122146Boxintegration.png
     
  3. Click in the Box Drive Client ID box and paste the Client ID value that you copied when creating the Box Custom App in the instructions above.
  4. Click Save beside the Box Client ID box.
  5. Click in the Box Client Secret box and paste the Client Secret value that you copied when creating the Box Custom App in the instructions above.
  6. Click Save beside the Box Client Secret box.
  7. The Reference Name box will contain a default name for the Box integration. This is the name users will see when they are accessing cloud drive integration features for Box on the intranet. If you wish to change the reference name, click the pencil icon to edit, type a new reference name in the box and click Save.
  8. If you want to allow users to search Box from the intranet, click the Box Search toggle to turn it ON.

    9.3Admin122146BoxSearch.png
    1. When Box Search is turned ON, another option appears that controls the maximum number of Box search results that will appear in the Find-as-you-type search results. To edit the number of results, click the pencil icon, enter the new number and click Save. (To learn more about cloud drive search, see Search cloud drives.)
  9. Box integration is now enabled.