Dialogue Cloud

The WS-Trust authentication protocol that has been used until now to connect to the Microsoft Dataverse will be deprecated on April 4th 2022. If your CRM Service for Dynamics 365 was configured to use this authentication method, it will need to be reconfigured to prevent service interruption.

To configure authentication for CRM Service for Dynamics 365, you will need to create a connection string according to the following instructions.

Configuring CRM Service for Dynamics 365 to use ClientSecret authentication

Updated Microsoft authentication protocols specify more secure means to allow applications to communicate with each other and authorize access to data. Creating an Azure Application Registration is an essential part of this authorization process.


To configure authentication for CRM Service for Dynamics 365 you will need the following:

For more information about Azure Application Registration see Microsoft's "Use single-tenant server-to-server authentication".

The ClientId and ClientSecret IDs are created during the Azure App Registration procedure.

To register a new Azure application

  1. Sign in to your organization's Azure Portal via this Link to Azure Portal.
  2. From the Azure Portal Menu, select Azure Active Directory, then select App registrations.
  3. In the App registration window, select New registration.
  4. In the Register an application window that appears, do the following:
    • In the Name field, enter suitable name for your application. This name can be changed at any time. It will be used in a later configuration step (see To create a Dynamics 365 application user).
    • In the Supported account types section, select Accounts in this organizational directory only (MyOrganization only - single tentant).
    • Don't enter anything for Redirect URI (optional) .
    • Select Register to complete initial app registration. Details of your newly created app will appear.

    This short video provides an overview of the above procedure:

  1. Click on the Copy button to the right of the Application (client) id to copy the number you will use as the ClientID in a later step.

Copy Application (client) ID

  1. Choose Certificates & secrets from the Manage menu list and choose New client secret. In the Add a client secret pane that appears, do the following:
    • Enter a Description to identify the client secret
    • Select an expiry date in the Expires drop down menu
    • Click on Add to create the client secret
  2. The Client secret you just created will appear in the Client secrets list.

    Warning: Both the client secret and the connection string will stop working after the expiry period. It is highly recommended that you set yourself a reminder to update these before they expire.
  1. For the Client secret you just created, click on the Copy button to the right of the Value entry to copy the ClientSecret value we will be using in a later step (see image). Do not use the Secret ID.
  2. Warning: Client secret Values can only be viewed and copied immediately after creation. It is essential to copy and save this value before leaving the page.
  1. Choose API permissions from the Manage menu list and choose Add a permission. In the Request API permissions pane that appears, do the following:
    • Select Dynamics CRM and then select Delegated permissions.
    • Find the user_impersonation permission and click the check box next to it.
    • Select Add.

Creating a Dynamics 365 application user

To access an Azure application you must use an Application user. A Dynamics 365 application user is tied to an Azure AD application and performs tasks in Dynamics 365 on behalf of that application. This procedure is described in the following section. For additional information, refer to Microsoft's Manage application users in the Power Platform admin center.

To create a Dynamics 365 application user

  1. Browse to your Power Platform admin center (https://admin.powerplatform.microsoft.com/) and select Environments. Select your Environment from the list. Details of your environment will be displayed.
  2. Select Settings from the top ribbon and then select Users + permissions followed by Application users. A list of application users will appear.
  3. Select New app user from the top ribbon. The Create a new app user page will appear. Do the following:
    • Select + Add an app , select the Dynamics 365 application you created earlier (see To register a new Azure application) and select Add.
    • Select the appropriate Business unit from the list.
    • Select for Security roles to choose the security roles for this new application user. The following security roles must be assigned to the Application User:
      • Remote requests to the CRM Dynamics 365 environment
      • Read rights for these entities:
        • Contact (required)
        • Cases (required)
        • Leads (optional)
      • Activities (optional, starting with bundle 2022.03)
      • Write rights for these entities (optional, from bundle 2022.03):
        • Leads
        • Activities
    • Select Save then select Create to save the app user.
  1. Copy the Environment url.
  2. Once you have the Environment URL, the ClientID and the ClientSecret, you can set up the ConnectionString using the A365 Password tool. This ConnectionString must be entered in your UCC according to To add or edit the UCC Plugin ConnectionString Setting.