Overview

The Adobe Sign integration for Microsoft SharePoint provides an integrated solution for creating, sending, tracking and managing electronic signatures. The integration is available for Microsoft SharePoint 2010 and works with both hosted and on premise instances of SharePoint. The solution is developed as a plugin for Microsoft SharePoint and provides:

  • Ability to add Adobe Sign as a SharePoint web part, which can be used by SharePoint users for sending and tracking documents for signature
  • Send any document from a SharePoint document library for signature
  • Ability to send documents to a single recipient or sending to a batch of recipients using SharePoint lists and mapping data from SharePoint lists into documents when the documents get sent for signature
  • Adding electronic signature as an activity within SharePoint workflows to automate the process of documents being sent for signature based on events within SharePoint
  • Archival of all signed agreements within SharePoint

Requirements

The Adobe Sign solution can only be installed and configured by a Microsoft SharePoint administrator; you also need administrative privileges on the SharePoint server to install the solution. Please consult SharePoint documentation and your organization’s SharePoint administrator for additional systems permissions that may be required to install SharePoint plugins. To configure the solution, you also need to be an account administrator on Adobe Sign and have access to your Adobe Sign account API Key. System requirements below encompass both the server and client components required to successfully install and run Adobe Sign for SharePoint.

  • Microsoft SharePoint hosted or on premise
  • Internet Explorer 11+

Install the Adobe Sign WSP on Site Collection


Upload and Activate the .wsp Package

1. Obtain the latest .wsp package

2. Navigate to Site Collection > Site Settings > Web Designer Galleries > Solutions

Note: _catalogs/solutions/Forms/AllItems.aspx

Navigate to Solutions

 

3. Upload the .wsp file

Solutions Page

 

4. Activate site feature manually:

  • Navigate to Site Settings > Site Actions > Manage site features
  • Click the Activate button next to Adobe eSign Workflow Actions
  • Click the Activate button next to Adobe eSign Workflow Actions Config List
2office-365-feature-activate


Populate the eSign Config List

Populating the eSign Config list requires you to generate and input several unique fields. 

It is recommended that you open Notepad or some other text editor so you can save the generated keys, then input them all at one time.

You need to:

  • Generate the eSignIntegrationKey (done in the Adobe Sign app)
  • Obtain the spTenantID in SharePoint
  • Generate the spClientID and spClientSecret keys in SharePoint
  • Grant the new service principal permissions in SharePoint
  • Insert the eSignConnectorURL


Step 1: Generate the eSignIntegrationKey

To generate an Integration Key in Adobe Sign:

1. Log in to your administrative user for your Adobe Sign account

2. Navigate to Account > Adobe Sign API > API Information

3. Click the Integration Key link in the middle of the page

Integration Key Link2-rebrand edit

The Create Integration Key interface loads:

1. Provide an intuitive name for your key (e.g. SharePoint)

2. The Integration Key must have the following elements enabled:

  • agreement_read
  • agreement_write
  • agreement_send
  • library_read
Generate Integration Key

 

3. Click Save once the key is configured.

The Access Tokens page is exposed showing the keys defined in your account.

4. Click the key definition created for SharePoint

  • The Integration Key link is exposed at the top of the definition.

5. Click the Integration Key link

Integration Key Link

 

The Integration key is exposed:

6. Copy this key and save it to add to the eSign Config List

7. Click OK

  • You are now done in the Adobe Sign application and can log out
The Integration Key


Step 2: Obtain the spTenantID

To obtain the spTenantID value:

1.        Navigate to Site Settings > Users and Permissions > Site App Permissions.

2.       Under the App Identifier, copy the part after @

  • ie: i:0i.t|ms.sp.ext|d559ac84-d8e6-4515-9229-89w01@870fe83b-ye9d-96d3-n1d0-9et51ar2e792e
spTenantID

3. Save this value to insert into the eSign Config List


Step 3: Generate the spClientID and spClientSecret keys

To generate the spClientID and spClientSecret keys:

1. In the URL for your SharePoint site, after sharepoint.com/sites/{yoursite} paste the following string: _layouts/15/appregnew.aspx

AppReg URL

참고:

Don’t miss the underscore leading layouts

  • A new page opens that allows you to generate both keys

2. Click the Generate buttons for both Client ID and Client Secret

3. Copy both keys and save them to enter into the eSign Config List

4. Insert the following literal values into the remaining fields:

  • Title – Adobe Sign
  • App Domain – spintegration.echosign.com/sharepoint
  • Redirect URL – https://spintegration.echosign.com/sharepoint
Generate SP Keys

5. Click Create

  • This puts a new service principal in Azure AD
  • You can reuse the same principal across site collections


Step 4: Grant the new service principal permissions

Grant the new service principal permissions to the site by

1. In the URL for your SharePoint site, after sharepoint.com/sites/{yoursite} paste the following string: _layouts/15/appinv.aspx

  • This has to be done on every site where workflows are expected to run
2016-09-22_15-14-26

참고:

Don’t miss the underscore leading layouts

The fields should contain the content for the application from the previous step:

  • App Id – This is the Client ID you just generated
  • Title – Adobe Sign
  • App Domain – spintegration.echosign.com/sharepoint
  • Redirect URL - https://spintegration.echosign.com/sharepoint

2. Copy and paste the below code into the Permission Request XML: field

<AppPermissionRequests AllowAppOnlyPolicy="true">
<AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="FullControl" />
  </AppPermissionRequests>
Grant Permissions

참고:

The app elevates the user to run with app permissions (Full control in the example above. You can reduce the permission grant to allow full control of a site or lesser level)

 

3. Click Create

4. Click Trust It when the page reloads

Trust the App

 

You can see the resulting permissions in Site Settings > Site App Permissions

Site Permissions


Step 5: Insert the eSignConnectorURL

The eSignConnectorURL is the literal value:  https://spintegration.echosign.com/sharepoint


Configure the eSignConfig List

1. In the Site Contents of the site where the Adobe eSign Workflow Config List feature was activated, find and click on the eSignConfig list

2. Create new item to open a new config form

Blank eSigConfig

3. Fill in the following values:

  • Title - "Config"
  • spClientID – Insert the ClientID value from Step 3
  • spClient Secret – Insert the ClientSecret value from step 3
  • spTenantID – Insert the TenantID from step 2
  • eSignIntegrationKey – Insert the Adobe Sign Integration Key from step 1
  • eSignConnectorURL – Enter: https://spintegration.echosign.com/sharepoint
  • debugStatments – No

4. Click Save

Security Considerations for Reading the eSignConfig List from Workflow Action

It is best practice to only allow site collection administrators access to eSignConfig list.

If the workflow is started by the user who has access to eSignConfig list, then the workflow runs without problems. However, if the user does not have access to the list, then the workflow actions need to be wrapped into app step.

1. On the site where the workflow is published

  • Navigate to Site Settings > Site Features
  • Activate Workflows can use app permissions feature.

2. Get the id of the workflow service principal

  • Navigate to Site Settings > Site App Permissions

Example: Workflow i:0i.t|ms.sp.ext|d55e6c84-d8e6-4515-9229-896we4554601@870f107b-dc9d-47d3-9ad0-9d851rr2e762e

3. Give the workflow service principal permissions in _layouts/15/appinv.aspx similar to what we did with the actual application

sharepoint-designer-app-step-give-permissions

4. Trust the Workflow service principal

 

Now the app step should be available in SharePoint Designer (restart is required):

Installed


Downloadable PDF copy

다운로드

이 작업에는 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License의 라이센스가 부여되었습니다.  Twitter™ 및 Facebook 게시물은 Creative Commons 약관을 적용받지 않습니다.

법적 고지 사항   |   온라인 개인 정보 보호 정책