# Connector Configuration

In SharePoint Security Sync, the user can configure multiple connectors for SharePoint. For example: the user can create multiple connectors such as SharePoint\_1, SharePoint\_2, SharePoint\_3, etc. for SharePoint.

To achieve this, follow the steps given below:

* Navigate to **SharePoint Security Sync App** --> Click **‘Connectors’** Entity --> Click **‘New’** to create a new **‘Connector.’**

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2Fma1O1BHdrKYliXwqNZf1%2FConfiguring%20connector%201.png?alt=media\&token=ebb8caf4-2829-4b0a-a119-e890f7c1a7c8)

* Populate the following fields:
  * **Name:** Give name to the connector&#x20;
  * **Connector Type:** Choose SharePoint from the drop-down.&#x20;
  * **Default Connector:** If required, enable the checkbox to set SharePoint\_1 as default connector.
  * **SharePoint Site:** It is the location of SharePoint, where files and folders will be stored. Select the valid SharePoint site here.

<figure><img src="https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2F64GcRYy3KwIysXG57nfv%2FConfiguring%20connector%202%20(2).png?alt=media&#x26;token=787d67bd-cc65-4898-93ef-92f3e81af667" alt=""><figcaption></figcaption></figure>

* **Auth-Type:** The Auth-Type is of two types - **Credential and App.**
* **Enable DocuSign Integration:** Enable the checkbox to make use of DocuSign features.
* **Signed document naming convention:** Select the naming convention of the document which is stored in CRM by DocuSign when all parties have signed the document.

DocuSign - <https://appsource.microsoft.com/en-us/product/dynamics-365/docusign.3701c77e-1cfa-4c56-91e6-3ed0b622145a?tab=Overview>

DocuSign Plugin integration solution - <http://www.inogic.com/Assets/Trial/DocuSignPluginforSharePointSecuritySync_1_0_0_0_managed.zip>

{% hint style="info" %}
**Note:**

* **User cannot reuse the same SharePoint site for each new connector.**
* **To use DocuSign feature from Attach2Dynamics UI it is necessary to install DocuSign  and DocuSign Plugin for SharePoint Security Sync** **solution in Dynamics 365 CRM.**
  {% endhint %}

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MP7oG9Mgx0-GT8fXSi_%2F-MP9-PlTsKud9Ow4AbKy%2FConn_Config.png?alt=media\&token=036d0d13-0cbc-4622-a8a1-a26c9f5fb242)

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MLfI0t_xGNyJ0C7pDgE%2F-MLfLCxHhAv4IPzB_wR3%2FConfig_4.png?alt=media\&token=e7ed462c-4f98-4fc5-a9c6-231dd58cd379)

### Credentials:

This indicates that **Authentication** with the connector is done through **Credential i.e. id and password**. It is mandatory to enter credentials in order to create a new Connector. For authentication through credentials, for any attachment action, the name of user appears who has authenticated the Connector. Enter value for **Id** and **Password/Secret.** Next authenticate the credentials.

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MLfI0t_xGNyJ0C7pDgE%2F-MLfLfdA1dY55YhcwYk0%2FConfig_5.png?alt=media\&token=9bedfffb-06fa-41a9-b6f4-3fa0754a115f)

{% hint style="info" %}
**Note: In the Id field enter your username and in Password/Secret field enter password. It can be your normal Dynamics 365 CRM credentials.**&#x20;
{% endhint %}

### App:

This is to provide authentication with App. In App authentication, if any action is performed, then the name of logged-in user appears.

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FZE7wQRYaKyBdpddcp5JH%2FShare_App_1.png?alt=media\&token=c07118a7-c6a4-4cde-9c95-7c41d802543a)

In order to know how to generate Id and Password/Secret for App [click here](https://www.inogic.com/blog/how-to-create-azure-active-directory-app/). After you have generated the Id and Password enter them in the fields provided.

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FVbB90ysIN2rKnhWA9WEp%2FShare_App_2.png?alt=media\&token=ee2c6aa3-595a-4c37-aae8-d2da76a7604f)

After the Connector record is created the connector credentials need to be authenticated.

To authenticate the connector, click on the **Authenticate button** on the command bar.&#x20;

Please ensure the credentials are correct and you have **Global Administrator** privileges and also are a **SharePoint site owner.**

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FaecVymL2hVisIF8Ib6gE%2FAuthenticate_1.png?alt=media\&token=c066f9d1-d365-46e2-ba49-50570ea0a8c8)

This button is visible only to users with **System Administration** or **SharePoint Security Sync Administrator** role.

Once the **Authenticate** button is clicked, a Pop-up window will appear. Fill in your credentials and then confirmation Pop-up will be opened.&#x20;

In the Pop-up, please select **Consent on behalf of your organization** --> Click on the **Accept** button.

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MUNgRgpfFYuvbrwxKV-%2F-MUNnUjOmbajV4Vulk4z%2FConnector%20Config_1.png?alt=media\&token=e1995ec1-21a5-4fac-9292-a2ac74a72ee5)

After clicking on the Accept button, if the credentials are correct then you will get a Success message window.

<figure><img src="https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FKgOSu01dpbpKmFE50LlZ%2Fimage.png?alt=media&#x26;token=20a0fa8d-b63a-4525-88c4-284b9f24c567" alt=""><figcaption></figcaption></figure>

Now if any logged-in user uploads or performs any attachment action on files in SharePoint, their name will appear for the action. Let’s upload a few files and see how it works.

• Navigate to a desired **‘Entity’** e.g. **Accounts Entity**.

<figure><img src="https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FxcnyNcej2frrrVOcogYe%2FConnector%20Configuration%201.png?alt=media&#x26;token=5245c60f-bdc9-45e8-adc0-5b5e6e2aad32" alt=""><figcaption></figcaption></figure>

• Click on required **Account Record.**

<figure><img src="https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FEQyqfYbC1HycEGivjn30%2FConnector%20Configuration%202.png?alt=media&#x26;token=48dfc2dd-813c-403d-9d2a-6dfeea9806c1" alt=""><figcaption></figcaption></figure>

• Now Click on **‘Attach2Dynamics’** Button.

<figure><img src="https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2Fs1uG4JjrhDqVC17zkgqC%2FConnector%20Configuration%203.png?alt=media&#x26;token=74a0ebd1-d6fd-49e3-9903-ab36906cd79f" alt=""><figcaption></figcaption></figure>

• Click on **‘Upload’** Button.

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FOT0dn4u9y24N68DSCUMe%2FConnector%20Configuration%204.png?alt=media\&token=d532e2f3-6993-44fb-a689-92511f0d8fb6)

• Now your **‘Files’** will be uploaded on SharePoint.

<figure><img src="https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FJfHsgz62UjUW3bK7Ec77%2FConnector%20Configuration%205.png?alt=media&#x26;token=53bc427d-0d1b-4ad1-8749-388e54e3ef8d" alt=""><figcaption></figcaption></figure>

Here, the name of the admin appears when they are logged in and have uploaded the file.

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FPDdF69XM7fTBnLtI6GaV%2FConnector%20Configuration%206.png?alt=media\&token=94f137eb-66a4-4b01-a6ee-7dc286443947)

Now let’s take another use-case when a user, who is not an admin uploads a file. James is a Sales Manager who does not have admin rights. Now he uploads the files while being logged in, and his name appears as the user uploading the file.

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FuoGQPQwJHWeNh3cUCaZy%2FConnector%20Configuration%207.png?alt=media\&token=1901e391-2228-4454-9f24-4f2ce9adff02)

{% hint style="info" %}
**Note: SharePoint Security Sync supports multiple SharePoint sites and syncs the privileges with ease.**
{% endhint %}

{% hint style="success" %}
For further queries, reach out to us at <crm@inogic.com>
{% endhint %}
