Configure OAuth Authentication

This section describes how to obtain OAuth tokens, which the connector needs to retrieve content from Salesforce Chatter.

To obtain OAuth tokens

  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 Salesforce Chatter:

    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
  4. In the [OAuthTool] section, set the following parameters:

    AppKey The application key you obtained when you created the application to represent the connector.
    AppSecret The application secret you obtained when you created the application to represent the connector.
    RedirectURL The URL at which the OAuth tool will run. For example, http://localhost:7878/oauth. This must match the address you specified when you created the application to represent the connector.
  5. Save and close the file.
  6. Open a command-line window and run oauth_tool.exe.

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

  7. Authorize the application. You must use the username and password of an account that has permission to view everything that you want to ingest.

    Salesforce Chatter provides the OAuth tokens, and the OAuth configuration tool creates a file named oauth.cfg. This contains the parameters that the connector requires to authenticate with Salesforce Chatter. 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.