Audience: System Administrator
This article covers processes in both Contract Eagle and DocuSign. We will update this article whenever our product changes but we may not have captured recent changes to DocuSign's screens or processes. Please bear that in mind as you follow this guide.
You have two options for setting up integration with DocuSign:
1. Contract Eagle creates the API connection for you. This approach is much easier, and all you need is a standard single user license for DocuSign. If this is your preferred approach, all you need to do is get in touch. We will create the API connection and schedule a time to step through the authorization with you.
or
2. You create your own API key. This is only possible if you have a DocuSign API license. If you prefer this approach, the steps are set out below.
Once integration setup has been completed, a Power User needs to add DocuSign to each contract type requiring electronic signing.
Create your own API key and integration with Contract Eagle
Electronic Signing Integration is set up in the the Admin menu > System Preferences > Integrations tab. We recommend you have the Integrations tab open in one browser window, and use another window to log in to your DocuSign account. You will be copying and pasting information between the two windows.
1. Log into Contract Eagle and go to the Admin menu > System Preferences > Integrations tab. Make sure you are in the section for “DocuSign” setup.
2. In another browser tab or window, log in to your company’s DocuSign account at https://www.docusign.com. Click your Account avatar in the top right and select Go to Admin.
3. In DocuSign Admin, go to Integrations > API and Keys.
4. Click the Add App / Integration Key button.
5. Enter an App Name for the new integration, eg “Contract Eagle”.
6. Click the copy button next to the Integration Key field.
7. Go into Contract Eagle, in your other browser tab, and paste the key into the “Integration Key” field.
8. Staying in Contract Eagle, highlight and copy the first line of red text of the “Redirect URI”: from “https://” to “-docusign”.
9. Go back into DocuSign and scroll down to “Additional Settings”. Click the + Add URl button and paste in the copied Redirect URI.
10. Staying in DocuSign, scroll up and click the + Add Secret Key button.
11. Click the copy button next to the Secret Key. Do this carefully – once you’ve clicked Save, you won’t be able to see the same Secret Key again. You would need to add a new one and copy it.
12. Scroll to the top and click Save.
13. Go back into Contract Eagle and paste the text of the Secret Key into the Secret Key field. Tab or click somewhere outside the field to enable the Authorize button underneath.
14. Click Authorize.
15. A DocuSign window will pop up (make sure your browser isn’t blocking this), prompting you to log into your account.
16. After entering your password, you will go back to the Contract Eagle settings screen.
DocuSign is now authorized for use within Contract Eagle.
Configure DocuSign Connect (HMAC) authentication
DocuSign HMAC authentication requires
a Business Pro or Enterprise Pro level DocuSign plan or;
on the Standard DocuSign Plan, the Connect add-on (requested via DocuSign)
Once the Contract Eagle / DocuSign integration has been authorized, DocuSign Connect authentication can be enabled. This is an important security feature that ensures push notifications sent from DocuSign originated from DocuSign and have not been tampered with.
The following steps are required to enable HMAC message security for DocuSign-initiated push notifications to Contract Eagle.
Generate a Key on the DocuSign portal
Add the key to Contract Eagle
Verify push notifications are successfully validated
Step 1: Generating the Key
Log in to your DocuSign portal as a user with administrator permissions on the account.
Select the Settings option from the main menu:
On the Settings screen, navigate to the Integrations > Connect menu option from the left-hand menu.
Select the Connect Keys tab, and then select the Add Secret Key button.
Important:
|
Step 2: Add the key to Contract Eagle
In Contract Eagle, navigate to the Admin > System Preferences menu option.
Select the Integrations tab and scroll down to the Electronic Signatures – DocuSign section.
Select to Enable DocuSign Connect
Enter the key number and HMAC Key generated on the DocuSign site.
Click the Save button at the bottom of the screen (or right click and select Save from the context menu)
Step 3: Verifying Operation
Please contact support@contracteagle.com to confirm correct operation once DocuSign Connect authentication has been setup and at least one document has been signed since the authentication was enabled.