Riva CRM Integration - Documentation and Knowledge Base

Dynamics CRM: In Riva, Set the EMEA or APAC Passport URL

Article ID: 344
Last updated: 04 May, 2021
This article applies to Riva On-Premise 2.4.36 or earlier.

For version 2.4.37 or higher, follow the instructions at Create a Dynamics CRM connection.


Create a Riva Dynamics CRM Online Connection

  1. Open the Riva Manager application. On the menu bar, select Setup.

  2. On the left pane, select CRM: Microsoft Dynamics CRM to open the Microsoft Dynamics CRM Wizard.

  3. On the wizard's Welcome page, select Next.

  4. On the page that appears, provide the required information:

    • Address: Select or enter the appropriate URL. Dynamics 365 CRM and Dynamics CRM Online normally provide a login URL that matches the instance of the CRM service that you have subscribed to.

    • Organization: Because most URLs include the organization name as part of the URL, leave the field empty.

    • Authentication Mode: Set it to Passport.

Configure Riva for EMEA or APAC Passport URL

Dynamics CRM Online uses a set of URLs based on the geographic location of each customer, to connect to the hosted CRM service:

https://dev.crm.dynamics.com/ (North America)
https://dev.crm4.dynamics.com (EMEA)
https://dev.crm5.dynamics.com/ (APAC)

By default, Riva is configured to authenticate to Dynamics CRM Online for North American customers. To change that default to use either the EMEA or APAC Passport authentication URL address, apply an app.setting change. The change needs to be made to the following files:

  • To modify the Riva Manager application, the file name is RivaApp.exe.config.

  • To modify the Riva CRM Agent for Exchange, the file name is Omni.Riva.CrmAgentEx.exe.config.

  • To modify the Riva CRM Agent for GroupWise, the file name is Omni.Riva.CrmAgent.exe.config.

Add the key and value combination:

  • For EMEA:

    <add key="MsCrm.PassportUrl" value="dev.crm4.dynamics.com" />

  • For APAC:

    <add key="MsCrm.PassportUrl" value="dev.crm5.dynamics.com" />

For the complete instructions on how to create or modify the required .config files, see Create an App.Setting file to enable advanced options.

Most Common Connection Errors

The most common connection errors are related to not enabling access to the proper URL for the hosted CRM service and the Microsoft Passport authentication service. If you encounter connection errors while configuring the connection, see Microsoft Dynamics CRM online: Connection errors explained for an explanation of some of the possible challenges when configuring and testing connections for Dynamics CRM Online.

Article ID: 344
Last updated: 04 May, 2021
Revision: 7
Views: 16244
Also read

Also listed in