Dynamics Connector 25.3
Dynamics Connector Help

# Configure OAuth Authentication (on-premise)

You must configure OAuth authentication so that the connector can a authenticate with the Dynamics repository. Use this procedure if your Dynamics instance is on-premise.

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 the Dynamics repository:

   `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:

   `AuthorizeUrl` | The URL that the OAuth tool should use to obtain the log on page for the Dynamics repository.
   `TokenUrl` | The URL that the OAuth tool should use to obtain an access token.
   `RefeshUrl` | The URL that the OAuth tool should use to obtain a refresh token.
   `AppKey` | The client ID or application key that was provided when you set up an 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 oauth_tool.cfg OAuthTool`.

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

6. Authorize the application by entering the credentials of the account that you want to ingest data from. The user account that you use should be entered in the `Username` parameter when you configure the connector.

   Dynamics provides the OAuth tool with the OAuth refresh token.

   The OAuth tool creates a file named `oauth.cfg`, which contains the parameters that the connector requires to authenticate with Dynamics.

7. Ensure the parameters set by the OAuth tool in the file `oauth.cfg` are included in the connector configuration file.

   You can merge these parameters into the connector configuration file using the following syntax:

       [FetchTasks] < "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 you can set them directly in the connector configuration file if you prefer.

8. You can now configure a task to retrieve data from Dynamics. See Configure the Connector.

Copyright 2025 Open Text
Version 25.3 | Last updated July 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Dynamics Connector 25.3

Topic Title: Configure OAuth Authentication (on-premise)