Dynamics CRM REST Connection

You can use the Dynamics CRM REST Connection shared resource to create a connection to the Microsoft Dynamics CRM server.

General

In the General panel, you can specify the package that stores the Dynamics CRM REST Connection shared resource, the shared resource name, and the shared resource description.

The following table lists the configurations in the General panel of the Dynamics CRM REST Connection shared resource:

Field Module Property? Description
Package No The name of the package where the new shared resource is located.
Name No The name to be displayed as the label for the shared resource.
Description No A short description for this shared resource.

Service Configuration

In the Service Configuration panel, provide the information related to the Microsoft Dynamics CRM server to which the plug-in connects.

The following table lists the configurations in the Service Configuration panel of the Dynamics CRM REST Connection shared resource:

Field Module Property? Description
Deployment Type No Two types of deployments are supported:
  • Online: Used for connecting to the Microsoft Dynamics CRM online server.
  • On-Premises: Used for connecting to the local Microsoft Dynamics CRM server.

If a self-signed SSL certificate is used to establish a connection between the Microsoft Dynamics CRM On-Premises server and the plug-in, use Java Keytool to import the self-signed SSL certificate into the JRE global truststore; the cacerts JRE global truststore file is located in the TIBCO_HOME/tibcojre64/version_number/lib/security directory.

Authentication Type No The authentication types that are supported by the plug-in. The types depend on the deployment type that you select.
  • If you select the On-Premises deployment, the plug-in supports two types of authentication: NTLM and Kerberos.
User Name Yes The user name used to connect to the Microsoft Dynamics CRM server.
Password Yes The password used to connect to the Microsoft Dynamics CRM server.
Service Root URL Yes

The URL for the service root that provides access to the business data and metadata for your organization.

Note: You can either type the URL for the service root manually or find it automatically by using Discover Service.
Timeout (sec) Yes The timeout value in seconds that applies to the communication with the Microsoft Dynamics CRM server. The default timeout value is 1800 seconds.
The following fields are displayed only when the Kerberos authentication is selected.
LoginModule File Yes Click the icon to locate the LoginModule file.

The file contains the configuration information of the login properties in Java Authentication Authorization Service (JAAS).

Kerberos File Yes Click the icon to locate the Kerberos file.

The file contains the realm and server configuration information.

The following fields are displayed only when the OAuth authentication is selected.
Tenant ID Yes
The unique ID of your Microsoft Azure Active Directory with which you have registered your application.
Tip: To know the Tenant ID, in Microsoft Azure, click

App registrations and click Endpoints. In the fields that are displayed, the string value after host name in the OAUTH 2.0 TOKEN ENDPOINT field is known as Tenant ID. You can copy the OAuth 2.0 Token Endpoint field value by clicking the icon beside it.

Client ID Yes

The unique ID of your native application that you want to connect to the Microsoft Dynamics CRM Online server.

This is application specific and is unique for each application.

Note: Dynamics CRM REST supports only Native Application to be connected to the Dynamics CRM online server.
Tip:

To know the Client ID, in Microsoft Azure, click App registrations, and in the list of registered applications, select a specific registered application. In the application pane, the value assigned under Application ID is known as Client ID.

Proxy Configuration

In the Proxy Configuration panel, you can provide the information related to the proxy server to access Microsoft Dynamics CRM REST endpoints outside of a firewall.

The following table lists the configurations in the Proxy Configuration panel of the Dynamics CRM REST Connection shared resource:

Field Module Property? Description
Use Proxy Yes If you use a proxy server to access Microsoft Dynamics CRM REST endpoints outside of a firewall, select the Use Proxy check box.
Proxy Server Yes The host name or IP address of the proxy server.
Proxy Port Yes The port number of the proxy server.
Proxy Username Yes The user name used to connect to the proxy server.
Proxy Password Yes The password used for the specified user name when connecting to the proxy server.

Discover Service

Ensure that you have configured all the necessary parameters when using Discover Service. You can click Discover Service to open the Discovery Web API dialog, type the URL in the field, and click Ok. The URL for the service root is found automatically. If the discovery service information is authenticated, the associated URL for the service root is automatically entered in the Service Root URL field.

Test Connection

You can click Test Connection to test whether the specified configuration fields result in a valid connection to the Microsoft Dynamics CRM server.

Note: If illegal/incorrect key size error is displayed when testing the connection to the Microsoft Dynamics CRM server with the Kerberos authentication, you must replace the local_policy.jar and US_export_policy.jar JRE security files that are located in the TIBCO_HOME/tibcojre64/version_number/lib/security directory with the files you can download from Oracle website. For more details, contact TIBCO Support team.
Note: If you enter an incorrect Kerberos file and correct it later, restart your Business studio.