Docusign
Docusign
Prerequisites
Before you can establish a connection with Docusign using the OAuth authentication method, you must create and configure a custom OAuth application.
-
In Docusign, navigate to Settings > Integrations > Apps and Keys.
-
Click Add App and Integration Key and name your application.
-
Click Create App.
-
In General Info, note the Integration Key field. You need to copy and paste this key into the OAuthClientId field in CData Connect Cloud.
-
In Authentication > Secret Keys, click Add Secret Key. You need to copy and paste this key into the OAuth Client Secret field in CData Connect Cloud..
-
In Additional Settings > Redirect URIs, click Add URI. Enter
https://oauth.cdata.com/oauth/
as the redirect URI. -
(Optional) If you are using JWT authentication, in Service Integration > RSA Keypairs, click Generate RSA to generate an RSA public key and private key. You need to copy and paste the private key into the OAuth JWT Cert field in CData Connect Cloud.
-
(Optional) If you are using JWT authentication, in the Apps and Keys home page, note My Account Information > User ID. You need to copy and paste this key into the OAuth JWT Subject field in CData Connect Cloud.
Refer to the Docusign documentation for more details about building a Docusign integration.
Setup Guide
Follow these steps to connect Docusign to your CData Connect Cloud account:
-
Open the Connections page of the CData Connect Cloud dashboard.
-
Click + Add Connection in the upper-right corner.
-
Type Docusign into the search field, then click the data source name.
-
On the Basic Settings tab of the new connection, enter a connection name or keep the default name.
-
Select an AuthScheme and follow the relevant instructions below.
Authentication Methods
OAuth
-
For OAuth Client Id, copy and paste the Docusign integration key you created in the prerequisites.
-
For OAuth Client Secret, copy and paste the secret key you created in the prerequisites.
-
The Callback URL is the redirect URI for your OAuth app. On CData Connect Cloud, this is
https://oauth.cdata.com/oauth/
. -
Click Sign in to connect securely through OAuth. This action opens the Docusign sign-in page in a new tab.
-
Log in to your Docusign account and provide the requested permissions (if applicable).
-
At the top of the CData Connect Cloud Add Docusign Connection page, click Save & Test.
-
If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.
-
If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.
-
OAuthJWT
-
For OAuth JWT Cert, copy and paste the RSA private key you generated in the prerequisites.
-
For OAuth JWT Subject, copy and paste your Docusign user Id. Retrieve your user Id in Docusign by navigating to Settings > Apps and Keys > My Account Information > User ID.
-
For OAuth JWT Issuer, copy and paste the Docusign integration key you created in the prerequisites.
-
At the top of the CData Connect Cloud Add Docusign Connection page, click Save & Test.
-
If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.
-
If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.
-
More Information
For more information about interactions between CData Connect Cloud and Docusign, see this information page.