# 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, specify any SSL or proxy settings necessary to connect to Box:

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

   For example:

       SSLMethod=SSLV23
       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 `oauth_tool.exe`.

   Your default web browser opens to the Box web site. The web page asks you to authorize the connector to access Box.

6. Authorize the application by entering the credentials of the account that you want to ingest data from. To retrieve data from Box Enterprise this account must be an admin or co-admin.

   Box provides the OAuth configuration tool with the necessary OAuth tokens. The OAuth tool creates a file named `oauth.cfg`, which contains the parameters that the connector requires to authenticate with Box. These parameters are automatically included in the connector configuration file, because the connector configuration file includes the following line to import the parameters into the `[MyTask]` section:

       [MyTask] < "oauth.cfg" [OAUTH]

   For more information about including parameters from another file, see Include an External Configuration File. The OAuth tool also prints the parameters it has set to the command-line window so that you can set these directly in the connector's configuration file if you prefer.

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

© Copyright 2020 Micro Focus or one of its affiliates | Send documentation feedback Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a mail client, and then send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm