mscrm-addons.com Application User for Dynamics 365 (App Access)
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 DocumentsCorePack
Server and Client (App Access).
This article is valid for Dynamics 365 Online only.
Required Dynamics 365 Solution
First 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.22 or
higher.
(MSCRMADDONScomGeneral solution found but version too old)
If the solution does exist and if its version is up-to-date, you can skip this section.
Otherwise, you can download the solution file via the following link:
https://mscrmaddons.blob.core.windows.net/downloads/ApplicationUser/MSCRMADDONScomGen
eral.zip
Next, hit the “Import” button, select the downloaded zip file (MSCRMADDONScomGeneral.zip) and
follow the dialog.
How to register and create the Application User
If you already have installed DocumentsCorePack follow this way
Open Dynamics 365 -> Advanced Settings -> Settings -> “MSCRM-ADDONS” area ->
DocumentsCorePack.
In the loaded configuration page navigate to the “License Server” tab and hit the “Enable App
Access” button:
The Application User configuration will open.
If you have installed the General solution only or do not have access to settings area, follow this way:
Open the “CreateAppUser.html” web resource. Therefore, replace the “[Dynamics365ServerURL]”
placeholder of the following link with your Dynamics 365 server URL and open it:
[Dynamics365ServerURL]/webresources/ptm_general/applicationuser/CreateAppUser.html
e.g.
https://crm875916.crm.dynamics.com/webresources/ptm_general/applicationuser/CreateAppUser.
html
Both ways will open the Application User configuration page:
Once opened, it tries to add your user domain name to the input field automatically.
If the field is empty or the value is wrong, type in the domain name (email address) of an existing
Dynamics 365 user.
Hit “Start” to perform the steps described in the dialog.
Next a new window pointing to “https://login.microsoftonline.com/...” will open. It shows a
Microsoft Online connection dialog. If the window does not open, check your popup blocker.
Login with an Azure Active Directory administrator.
To register the mscrm-addons.com application, hit accept in the next dialog:
Once done, you will be redirected to our the mscrm-addons.com web site.
If the page shows “The enable process has been successful” go back to the dialog.
Hit the “Enable” button to continue.
If the process was successful, you will see the following message:
Please note: You will need this “Security Token” in the connection dialog shown in the next sections.
For each Dynamics 365 user a different “Security Token” is generated.
How to get the Security Token
To retrieve the “Security Token” again or a different Dynamics 365 user needs his token to connect,
just reopen the same page as shown above (section “How to register and create the Application
User”).
The page always shows the “Security Token” for the currently logged in Dynamics 365 user.
If the current user is a Dynamics 365 admin, the page shows the “Security Token” of the
“MSCRMADDONScom.ApplicationUser” application user in addition.
Here the direct link again:
[Dynamics365ServerURL]/webresources/ptm_general/applicationuser/CreateAppUser.html
e.g.
https://crm875916.crm.dynamics.com/webresources/ptm_general/applicationuser/CreateAppUser.
html
Result if logged in with a Dynamics 365 admin user (“[email protected]”):
Result if logged in with a default Dynamics 365 user (“[email protected]”):
Please note: The minimum permission for a none admin user is the “global read permision on the
systemuser entity”. If the current user does not have this privilege, the page will show an error:
Request new License for AppAccess
If you are in trial mode and do not have a DCP license yet, you can skip this section.
For the AppAccess connection a new license key for both the DCP server and the DCP client is
required.
Before you change the connection to AppAccess contact our support ([email protected])
with the subject: “Update license for AppAcceess support”
Further on provide the ID and the unique name of your Dynamics 365 organization.
Both can be found in -> Dynamics 365 -> Advanced Settings -> Settings -> Customizations ->
Developer Resources -> “Instance Reference Information” section -> look for “ID” and “Unique
Name”
More information can be found here:
https://www.mscrm-addons.com/Blog/PostId/9981/unique-organization-name-in-microsoft-
dynamics-365
Use App Access via DCP Online Service Config
(minimum required DocumentsCorePack Service version is 2020.12)
Create a new DocumentsCorePack online service or update an existing one as usual.
More information can be found in the following guide:
https://www.mscrm-
addons.com/Portals/0/MSCRM2015/AM/DocumentsCorePack_AttachmentExtractor_Online_Doku_e
nglish_2018.pdf?ver=2018-07-04-170945-407
But in the “Connection Profile” select “App Access” instead.
To do so, hit on “Connection Profile”:
In the opened dialog select “App Access”. Then the following info box will occur.
It contains a link to this article. Hit “Ok” to continue.
Next, define the “CRM URL” and the “Username”.
And paste the “Security Token” from before (Please note: It has to be the correct token fitting to the
defined Username).
Then hit “Retrieve Organizations” and if an organization was found, continue with “Very Connection
& Save Profile”:
If this process was successful, continue as usual.
Use App Access via DCP Client (Template Designer)
(minimum required DocumentsCorePack Client version is 10.1)
Install the DCP Client or change the connection of an existing installation as usual.
More information can be found in the guide: https://www.mscrm-
addons.com/LinkClick.aspx?fileticket=GKrEAv_bmiw%3d&tabid=116&portalid=0&mid=2084
When you reach the “Connection Dialog” make sure to select “AppAccess”.
Then define “Dynamics 365 Server-Url” and“Username”. Next, hit on “Retrieve all Organizations”.
A small new dialog will pop up. Enter the “Security Token” fitting to the “Username.
If the process was successful you will see one retrieved organization.
Hit “OK” to connect.
Continue as usual.
Top Related