PowerObjects Blog 

for Microsoft Business Applications

| |

Scribe Azure AD App Configuration

Post Author: Joe D365 |

As of March 21, 2021, Microsoft is deprecating the “Online” authentication type for Microsoft Dynamics 365 / CRM for the Customer Engagement product. This means that if you are currently using Scribe Insight (scribe on-prem) to integrate with an online CRM Organization you will need to upgrade your scribe instance to 7.9.5, install the TIBCO Scribe® Insight Adapter for Microsoft Dynamics 365 And CRM 5.6.2 hotfix 11, setup an Azure AD App Registration, and update your integrations and publishers to use the new Azure AD – Client Credentials to authenticate to CRM Online.

https://support.tibco.com/s/article/Microsoft-Dynamics-365-CRM-Online-Authentication-Type-Is-Being-Deprecated

Contents

Requirements

Creating an Azure AD App Registration

Creating a user in CRM for the Azure AD App

Upgrading Scribe to 7.9.5

Installing the TIBCO Scribe Insight Adapter for Microsoft Dynamics 365 And CRM 5.6.2_HF-11

Updating Integration Packages and Publishers to use Azure AD – Client Credentials

Requirements

  • Azure AD App Registration with Client Secret
  • D365 Online
  • Scribe Insight 7.9.5 installation
  • TIBCO Scribe Insight Adapter for Microsoft Dynamics 365 And CRM 5.6.2_HF-11

Creating an Azure AD App Registration

1. Login to https://portal.azure.com

2. Search for App Registrations and select one of the options below to navigate to the App Registrations page.

3. Click on + New registration.

4. Provide a Name for the Scribe Azure AD App, select a Supported Account Type based on requirements for your organization, and click Register.

5. Copy the Application (client) ID from the Overview screen and save it for reference later.

6. Grant API permissions to D365 by selecting API permissions on the left > click + Add a permission > select Dynamics CRM.

7. Select the checkbox for user_impersonation and click Add permissions.

8. Create a Client Secret by clicking on Certificates & Secrets on the left > click + New client secret.

9. Provide a description and time expiration for the client secret.

10. Copy the Client Secret Value and save it for reference later.
Note: You will not be able to copy/view the value again once you navigate away from this screen.

Creating a user in CRM for the Azure AD App

1. Login to your D365 organization.

2. In the top right, click on the Settings gear and open Advanced Settings.

3. Navigate to Security then Users.

4. Change the view to Application Users and click on + New.


5. Make sure the Application User form is selected and paste your Application (client) ID into the Application ID field for the App Registration you will be using for Scribe.

6. Click save and the remaining fields should populate.

7. Grant security roles that will be required for this user.

Upgrading Scribe to 7.9.5

If you are not already on 7.9.5 of Scribe Insight, you will need to reach out to Scribe to download the correct version 7.9.5 from the Tibco eDelivery site as there is now a Small Business, Standard, Professional, and Enterprise edition of Scribe Insight.

https://edelivery.tibco.com/storefront/advancesearch-page.ep?default=1&keyWords=scribe+insight

Follow the provided directions by Scribe for upgrading your Scribe Insight instance.

https://support.tibco.com/s/article/TIBCO-Scribe-Insight-V7-9-5-Release-Notes

Installing the TIBCO Scribe Insight Adapter for Microsoft Dynamics 365 And CRM 5.6.2_HF-11

5.6.2 Hotfix 11 download is available from the Tibco Support (https://support.tibco.com/) website after logging in to the support portal page.

Download instructions https://support.tibco.com/s/article/TIBCO-Scribe-Insight-Adapter-for-Microsoft-Dynamics-365-And-CRM-5-6-2-hotfix-11-is-now-available

1. Close the Workbench, pause active Integration Processes and Publishers (if applicable), close the Console, and stop any Services that start with Scribe.

2. Open SQL Management Studio and run the following query on the SCRIBEINTERNAL database:
DELETE FROM [SCRIBEINTERNAL].[SCRIBE].[ADAPTERMETADATA]
WHERE IDENTIFIER != 'DEFAULT'


3. Extract the contents of the zip file to a folder on the Scribe Insight server and right-click on the InstallCRM562.cmd file and select Run As Administrator.

4. Follow the normal CRM Adapter installation prompts.

5. Restart the Scribe services.

6. From Dynamics CRM, delete the CRM Plugins and Plugin Assembly by navigating to Settings > Customizations > Customize the System > Select SDK Message Processing Steps > filter for Scribe event handlers > select and delete the SDK steps.

Updating Integration Packages and Publishers to use Azure AD – Client Credentials

1. Open the Scribe Console.

2. Navigate to your Collaboration folder with your integration packages.

3. Open each Integration Process and click on Step 1 to open the package to update it.

4. Click on Connections once the integration package loads.

5. Highlight the connection that uses the Adapter for Dynamics 365 and CRM > click Edit > Change Connection > Select Microsoft Dynamics 365 and CRM from Adapters > click OK.

6. Configure the adapter to use the Client ID and Secret.

  • Deployment: Azure AD – Client Credentials
  • Server URL: https://<organizationname>.crm.dynamics.com
  • Organization: Unique Name from the Customizations > Developer Resources page
  • Client ID: Azure AD Application (client) ID from the App Registration
  • Client Secret: Client secret from the above App Registration

7. Save the integration package and activate the process, repeating for each integration to make sure they have all been updated.
Note: If they all share the same adapter, it will update the shared adapter so you will only need to perform this once, but you should still confirm each package can open and connect successfully.

8. Do the same for Publishers and Bridges by opening each publisher and bridge using the Microsoft Dynamics 365 and CRM connector.

9. This will re-publish the plugins in CRM.

10. Test your integrations to make sure everything is functioning as it should.

Joe CRM
By Joe D365
Joe D365 is a Microsoft Dynamics 365 superhero who runs on pure Dynamics adrenaline. As the face of PowerObjects, Joe D365’s mission is to reveal innovative ways to use Dynamics 365 and bring the application to more businesses and organizations around the world.

Leave a Reply

Your email address will not be published. Required fields are marked *

PowerObjects Recommends