Box Connector 12.12

# Configure OAuth Authentication

You must configure OAuth authentication so that the connector can authenticate with Box. Micro Focus recommends that you use the OAuth configuration tool that is supplied with the connector.

NOTE: There is no need to complete this procedure if you ran the OAuth configuration tool during the installation process.

To configure OAuth authentication

1. Open the folder where you installed the connector.
2. Open the file `oauth_tool.cfg` in a text editor.

3. In the `[Default]` section, set any SSL or proxy settings that are required to access the repository:

   `SSLMethod` | The version of SSL/TLS to use.
   `ProxyHost` | The host name or IP address of the proxy server to use.
   `ProxyPort` | The port of the proxy server to use.

   For example:

       SSLMethod=NEGOTIATE
       ProxyHost=10.0.0.1
       ProxyPort=8080

4. In the `[OAuthTool]` section, set the following parameters:

   `AppKey` | The client ID provided when you created a Box application to represent the connector.
   `AppSecret` | The client secret provided when you created a Box application to represent the connector.

   Do not modify the other parameters in this section.

5. Open a command-line window and run the following command:

   `oauth_tool.exe oauth_tool.cfg OAuthTool`

   Your default web browser opens to the Box web site. The web page asks you to log in and grant consent.

6. Log in and grant consent.

   NOTE: To retrieve data from Box Enterprise you must log in as an admin or co-admin.

   The web page displays a message stating that the OAuth details have been successfully stored, and the OAuth tool creates the files `oauth.cfg` and `oauth2_sites.bin`. When you configure the connector, import the parameters from `oauth.cfg` into your task configuration. For more information about including parameters from another file, see Include an External Configuration File.

7. You can now configure a task to retrieve data from Box. See Retrieve Information from Box or Retrieve Information from Box Enterprise.

© Copyright 2022 Micro Focus or one of its affiliates
Version 12.12 | Last updated June 2022

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL Box Connector 12.12

Topic Title: Configure OAuth Authentication