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.