Configure OAuth Authentication

This section describes how to configure OAuth authentication, so that the connector can retrieve information from Confluence.

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 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 application key you obtained from Confluence.
    AppSecret The application secret you obtained from Confluence.
  5. Save and close the file.
  6. Open a command-line window and run oauth_tool.exe.

    Your default web browser opens to the Confluence web site.

  7. Authorize the application to access the repository. You must use the username and password of an account that has permission to view everything that you want to ingest (such as an administrator account).

    The OAuth configuration tool creates a file named oauth.cfg. This contains the parameters that the connector requires to authenticate. You can import these parameters into the connector configuration file, for example:

    [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.