The Egnyte for Dynamics integration will allow you to embed an Egnyte window on a Dynamics object. The Dynamics record will be mapped to an Egnyte folder. There is a 1:1 relationship between a Dynamics record and an Egnyte Folder. This document will walk through the steps of installing the integration.

Installation Steps:

1. Setup Azure Active Directory

Create Dynamics Service Account

This will walk you through the steps of getting a Service Account set up in your Microsoft Environment via Azure AD. We will then set up that account in the Dynamics Account.  

1. Log in to the Azure dashboard with your Dynamics CRM credentials (doesn't require additional Azure subscription) link: https://portal.azure.com/#home 

2. Go to Azure Active Directory. Navigate to Azure Active Directory in the side menu or click the link: https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/Overview

mceclip0.png

Section A: Register an Egnyte App.  

3.  Open App registrations from the menu that just opened.

mceclip1.png

4.  On the top bar, click the New registration button at the top.

mceclip2.png

mceclip3.png

5.  Fill out the provided form (provide a name) and Register Application.

mceclip4.png

6.  From the screen that just opened copy Application ID and Directory ID (also referred to as tenant ID),

You will need them later in the integration setup so, copy it elsewhere for reference.

 

mceclip1.png

 

Section B: Configure API Permissions.  

7. Choose the API permissions position from the secondary menu in the sidebar.

8. Click add Permission.

Screen1.png

 

 

9.  Now, choose Dynamics CRM from the list.

10. Make sure user impersonation is checked and click Add permissions at the bottom.

mceclip7.png

11.  The result should be something like this (this is an example):

mceclip8.png

 

Section C: Configure Certificates and Secrets

12. Choose the Certificates & secrets position from the secondary menu in the sidebar.

Screen2.png

 

13. Click New client secret and set an expiration date (see above).

Right after its creation is the only time, you can copy the content of this secret. We will refer to it as Client Secret. Please copy it and save it for future purposes

 

2. Setup Dynamics 365 Sales CRM Dashboard

1. log in to your Dynamics CRM dashboard – your URI will be something along the line here - https://acme.crm.dynamics.com. 

2.  On the right side, go under Settings -> Advanced Settings -> It will open the new page.

3.  Go to a top bar -> Settings Menu, which would overlay the screen on half of the page. 

mceclip10.png

 

4. Open the Security page. 

Screen3.png

 

5. Click on Users.

 

mceclip12.png

6. Choose “Application Users” from the drop-down on the top left-hand side.

7. Click the New button in the top left corner.

Screen4.png

 

8. Fill out new User Information.

9. Paste in the Application ID and Application ID URI value (this is the Application ID from the Azure AD you created earlier and asked to keep handy). Azure AD Object ID can be left blank and will be filled automatically on save.

10. User Name and Primary Email – Please note that this user must be of TYPE admin in the Egnyte Domain where you connect and should have the same email ID. It doesn’t necessarily need to be a Microsoft organization email ID, as shown in the example below.

 

mceclip2.png

11. Save your changes.

12. Now, your application user should make API requests (make sure that all required permissions are provided). A System Administrator role will have the ability to make API Requests. So, ensure you click on “Assign Roles” and assign this user “System administer” permissions in the dialog.

 

mceclip15.png

 

mceclip16.png

 

3. Setup Dynamics Resources

This will create the Resources needed to Add the Egnyte integration in Dynamics. Once you have added these resources, you will be able to add them to your Dynamics Entities.

1.  Download HTML - https://egnyte.egnyte.com/dl/iozpiftQ1Z/new_PintWebresource.html

2.  Log in as a Dynamics Admin.

3.  Go to Settings -> Customization -> Customize the System.

mceclip17.png

4.  Once the new page opens, check on the side menu, and click web resources.

5.  Click new.

Screen5.png

 

6.  Fill out the Web Resource Form for HTML

  • Set name ("new_")  "PintWebresource"
  • Set display name "# Egnyte HTML"  ("#" is to make the search easier) 
  • Set type as "webpage(HTML)"
  • Click upload file and upload Egnyte Html web resource from the prerequisites step.
  • Click save and then publish

mceclip19.png

 

4. Setup Dynamics Entity Configuration

This will allow Admin to add the Egnyte iframe window to any object that the Admin wants to be associated with the integration. That object will have a folder created and mapped in the Egnyte file system. Walkthrough the steps of getting a Service Account setup in your Microsoft Environment via Azure AD.

1.  Log in as dynamics admin

2.  Go to Settings > Customization > Customize the System

mceclip20.png3. On the side menu, click Entities

 

mceclip21.png

4.  Click the Specific entity you want to place Egnyte iframe in. We will use an Account as an example.

mceclip22.png

 

5.  Click on Forms.

 

mceclip23.png

6.  Choose a specific form where an add-on should be placed.

7.  Select the Insert tab.

8.  Select Web resource (you may have to expand the screen to find Web Resource on the menu.

Screen6.png

 

9.  Find created in the previous step Html webpage – Search for “new_PintWebResource.”

10.  Fill the form and click OK

11.  Move position to desired locations

12.  Save and publish.

13. The result should be that you will be able to see “#Egnyte” informs where you placed it.

 mceclip25.png

 

5. Final Admin Configuration

In this step, the Admin will connect the Dynamics CRM to their specific Egnyte Domain. You will also be able to configure the integration to the specific root folder in Egnyte.

1.  Create a new Account entry.  

2.  When you open Egnyte Add-on in edit mode, it will ask you to map it with the Egnyte account.

3.  You will see the authorization button

4.  Click this button and go through OAuth2 but remember that you need to map to Egnyte Admin. Enter the Egnyte domain (for example, acme.egnye.com) 

a) For example, if acme@microsoft.com is used to sign in with Azure ID and Dynamics, use the same username and email address in Egnyte as an admin. b) Additionally, application user in this case what's shown is "pint@egnyte.com" – ensure the same username and email address in the Egnyte domain is also active.

mceclip26.png

5. You will be asked to fill the form and put Application user data. In addition, the resource URI is https://<your dynamics subdomain>.crm.dynamics.com.  Please enter resource URI without / slash at the end. 

6. For the Tenant ID and Application ID fields, put the information as described in Section A, step 6.  

7. You also need to put the Egnyte folder path – use this path for example. “/Shared/CRM/Dynamics.” (You can choose any name after /Shared/ in this folder path if you want to customize)

 

Once you select folder structure, and have Dynamics -> Egnyte Sync Done, later on for any reason, if you need to change a folder structure then it is not currently supported in the 1st version.

 

8. Submit the form

mceclip27.png

9. Once this is completed, you will be able to see Egnyte embedded UI to access your files with a new "Account:" record as shown in this example. 

If you ran into issues with uploading files and received failed status, please check your browser and cookies flag and ensure you disable the flag. For example, chrome://flags/#same-site-by-default-cookies for the Chrome browser or other relevant options if you use other browsers to check.

 

 

Dynamics.png

 

Screenshot__753_.png

 

6. Permission Settings

Depending on your permissions allowed by your Dynamics account, you may have to set up the following Permissions to Egnyte Admins and Users. It should be a known fact to Dynamics admin.

Setup for Admin

1.  Log in as Dynamics Admin

2.  Go to Settings > Security

mceclip30.png

3.  Select Users

mceclip31.png

4.  Edit an Admin user and click Manage Role

 

mceclip32.png

5.  Add the "Egnyte - Service User" role by Checking the box. If you do not see this role – you can also try “System Administer’s profile."

 

mceclip33.png

Setup Individual Users or Teams

1.  Log in as Dynamics Admin

2.  Go to Settings > Security

mceclip34.png

3.  Select Users or Teams

4.  Edit a User/Team and click Manage Role

5.  Add "Egnyte - Authorized User" role

Make sure that admin is not in that team because his role will be reduced from Service User to Authorized User

Limitations

  • Microsoft Dynamics 365 for sales (on-Premises) is not supported.