This article describes how you can create an mscrm-addons.com Application User for your Dynamics 365 organization. Further on it shows how you can use this user to connect via the DocumentsCorePack online service (App Access).
Please create your service via connection type Server2Server first. Once this service is saved, you can change the connection profile to AppAccess. This article is valid for Dynamics 365 online only!
Prerequisites:
DocumentsCorePack version at least 2020.114
MSCRMADDONScom General solution at least 2020.49
If you are not sure with which version you are working with, this article will help you.
Table of contents:
- How to register and create the Application User
- How to connect DocumentsCorePack service via the App
- Troubleshooting
- How to check if the required Dynamics 365 Solution is installed
- How to get the required Dynamics 365 Solution
- What to do if you have installed the General Solution only and have no access to the settings area
- How to get the credentials for the Application User again
- What to do when no Azure Active Directory administrator account is available
- How to activate the user impersonation
.
1 How to register and create the Application User
After installing DocumentsCorePack, open your Dynamics 365 > Advanced Settings > Settings > MSCRM-ADDONS area > DocumentsCorePack.
Figure 1: DocumentsCorePack in your Dynamics 365
In the loaded configuration page, navigate to the License Server tab and select Enable App Access.
The mscrm-addons.com Application User page opens. Now enter the ❶ e-mail address of your Dynamics 365 Administrator.
Now define which kind of Azure AD App you want to register:
A: Client/Secret based App (classic): It is for connecting to Dynamics 365 only or
B: Certificate based App (new): This is for connecting to Dynamics 365 AND/OR SharePoint.
Select the App you want to connect and hit the ❷ Start button.
Follow the step-by-step description based on whether you select the Client/Secret based App or the Certificate based App option.
Figure 3: The Application User – Client/Secret or Certificate based decision page
To proceed, you must enter the credentials of an Azure Active Directory administrator account. This account has to be a Dynamics 365 administrator as well (A + B).
Please note: If the window does not open, you should check your popup blocker.
Figure 4: Microsoft Online connection dialog
Grant permission to register the App (A + B). Please Accept.
Figure 5: Register the mscrm-addons.com application
This window shows that the enable process has been successful. To continue go back to the dialog (A + B).
Back in the dialog hit the Enable button to continue (A + B).
Figure 7: Hit Enable to finish the process
This overview is shown (A + B).
❶ Username
❷ AzurAD Domain
❸ Security Token
Figure 8: New credentials for Client/Secret and Certificate based
Your AppAccess User whether for A Client/Secret based App or the B Certificate based App is created.
.
2 How to connect DocumentsCorePack service via the App
Create a new DocumentsCorePack online service or update an existing one as usual. More information can be found in the corresponding user guide.
Now open your Connection profile and make the following settings:
Select your Connection type: App Access (A + B)
Now use the generated credentials to continue with your connection via the App.
A: “Client/Secret”- based App:
❶ Username
❷ AzureAD Domain
❸ Security Token
Please note: Fill in all the generated credentials as you can see in Figure 9. In some circumstances the AzureAD Domain does not appear. Hit the ❹ Retrieve Organizations button.
Figure 9: Create Connection profile for Client/Secret based app
.
B: “Certificate”- based App:
❶ Username
❷ AzureAD Domain
❸ Security Token
❹ Certificate Based
Please note: Fill in all the generated credentials as you can see in Figure 10. In some circumstances the AzureAD Domain does not appear. Hit the ❺Retrieve Organizations button.
Figure 10: Create Connection profile for Certificate based app
Hit the ❺ Retrieve Organizations button and enter your ❻ SharePoint Username and ❼ setup the connection.
Figure 11: Setup SharePoint connection
When your AppAccess authentication to SharePoint was successful, this information is shown (B).
Figure 12: SharePoint Authentication Info
Now click on the Verify Connection & Save Profile button and your service will be updated. Please do not close this window or navigate away! This is a good time for a coffee break (A + B).
Figure 13: Verify connectivity and permissions
If this process was successful, you only need a license to continue.
.
3 Troubleshooting
How to check if the required Dynamics 365 Solution is installed
Make sure that you have the required MSCRMADDONScomGeneral solution installed.
To do so, open Dynamics 365 > Advanced Settings > Settings > Solutions.
Check if a solution named MSCRMADDONScomGeneral exists and if its version is 2020.49.
Figure 15: MSCRMADDONScomGeneral solution
Please note: If you are in trial mode, you can skip this section.
.
How to get the required Dynamics 365 Solution
If the version is too old, you can download the solution file here. After the download, hit the Import button, select the downloaded .zip file (MSCRMADDONScomGeneral.zip) and follow the dialog.
Figure 16: Select Solution Package-dialog
.
What to do if you have installed the General Solution only and do not have access to the settings area
Open the CreateAppUser.html web resource by replacing the Dynamics365ServerURL placeholder of the following link with your Dynamics 365 server URL:
[Dynamics365ServerURL]/webresources/ptm_general/applicationuser/CreateAppUser.html]
It could look like this:
https://crm875916.crm.dynamics.com/webresources/ptm_general/applicationuser/CreateAppUser.html
This will open the mscrm-addons.com Application User configuration.
.
How to get the credentials for the Application User again
Just navigate in your Dynamics 365 to DocumentsCorePack and Click on the License tab and click the App Access Info.
Here is the direct link again to get to this site:
[Dynamics365ServerURL]/webresources/ptm_general/applicationuser/CreateAppUser.html
Example:
https://crm875916.crm.dynamics.com/webresources/ptm_general/applicationuser/CreateAppUser.html
Figure 17: Dynamics 365 > DCP Server-based > AppAccess Info
The mscrm-addons.com Application User overview opens.
Please note: In this example both options are installed, and you have an overview via the drop-down menu.
Figure 18: mscrm-addons.com Application User – overview
Please note: Admin user rights are requested! If the current user does not have this privilege, the page will show an error:
Figure 19: Error without minimum permission
.
What to do when no Azure Active Directory administrator account is available
If you do not have an Azure Active Directory administrator account available, you can ask your admin to consent. Once done, repeat the steps.
A: For Client/Secret based:
https://login.microsoftonline.com/[AAD TenantId]/adminconsent?client_id=aa3c57aa-ce9d-4140-90bf-1c1235dafc54&state=appuser&redirect_uri=https://graphapi.mscrm-addons.com
B: For Certificate based:
https://login.microsoftonline.com/[AAD TenantId]/adminconsent?client_id=7b92eea5-1022-406b-b750-3325713c916e&state=appuser&redirect_uri=https://graphapi.mscrm-addons.com
Your Administrator only has to replace the placeholder [AAD TenantId] with the actual ID of your AAD Tenant or with the domain name of the tenant. Once done, you will be redirected to our the mscrm-addons.com website and if this page shows The enable process has been successful, go back to the DocumentsCorePack dialog.
Please note: You can find all the relevant information here.
Figure 20: AAD TenantId = Directory ID
.
How to activate the user impersonation
If you want your mail traffic personalized after creating an AppAccess user, it is necessary to add a settingskey:
Name: ImpersonateServiceCall
Value: true
Product: AutoMerge
That’s it! We appreciate your feedback! Please share your thoughts by sending an email to support@mscrm-addons.com.