# Configure OAuth Authentication

The connector can authenticate using a user name and API key, or by using OAuth.

To configure OAuth authentication

1. Go to the Telligent community site and add a new "OAuth Client" as described in the Telligent documentation.

   - Ensure that you set the "Callback URL" to the URL where you will run the OAuth tool (by default, `https://localhost:7878/oauth`).
   - Set the "Client Type" to "Confidential".
   - Permit the "Authorization Code" grant flow. You can optionally select the "Trusted Client" check box.
2. Open the folder where you installed the connector.
3. Open the file `oauth_tool.cfg` in a text editor.

4. In the `[Default]` section, specify any SSL or proxy settings:

   `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=Negotiate
       ProxyHost=10.0.0.1
       ProxyPort=8080

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

   `AuthorizeUrl` | The authorize URL for your Telligent Community instance.
   `TokenUrl` | The token URL for your Telligent Community instance.
   `AppKey` | The application key that was provided when you set up the new OAuth Client in step 1.
   `AppSecret` | The application secret that was provided when you set up the new OAuth Client in step 1.

   Do not modify the other parameters in this section.

6. Open a command-line window and run `oauth_tool.exe`.

7. (If you selected the "Trusted Client" check box in step 1, skip this step because you will not be prompted for credentials). Your default web browser opens to the Telligent web site, which asks you to authorize the application to access Telligent. Authorize the application by entering your credentials.

8. The OAuth tool creates a file named `oauth.cfg`, which contains the parameters that the connector requires to authenticate. Include these parameters in the connector configuration file as follows:

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

   For more information about importing 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.

9. You can now configure a task to retrieve data. See Retrieve Information from a Telligent Community.

_FT_HTML5_bannerTitle.htm