Adobe Sign Module
  • 09 Aug 2024
  • 2 Minutes to read
  • Dark
    Light

Adobe Sign Module

  • Dark
    Light

Article summary

Module Details

Installation LocationCore module
Step Location Integration > AdobeSign
Prerequisites

Adobe Sign is an electronic signature service provided by Adobe Systems. The Adobe Sign Module introduces Flow steps that allow users to create agreements, download signed documents, and retrieve agreement status. These steps use API integration, enabling seamless communication between Adobe Sign and other systems or applications, streamlining the electronic signature process. This integration ensures users can manage agreements, track progress, and access signed documents without manual intervention, saving time and enhancing workflow efficiency.


Configuration

Add and configure Adobe Application

Creating an Adobe application is necessary to obtain API credentials (such as Client ID and Client Secret) that allow the application to authenticate and interact with Adobe Sign services using APIs securely.

  1. Navigate to  API > Acrobat Sign API > API Application and create a new application using the add icon on the top right.
  2. Provide a Name, Display Name, and choose the Domain type.
  3. Once the application is made, click on it and select "View / Edit."
  4. Retrieve the Application ID (Client ID) and Client Secret from this dialog. These credentials will be used for configuring the provider within Decisions.
  5. Click on the application and then the "Configure OAuth for Application" option.
  6. Configure the following:
    1. Redirect URL: {BasePortalURL}/HandleTokenResponse
    2. Scopes: These will depend on the use of the application. The ones mentioned below are the minimum ones to use the module steps.
      1. user_login:account 
      2. agreement_send:account 
      3. agreement_write:account 
      4. agreement_read:account

Creating a provider for Adobe Oauth in Decisions

Navigate to the [Project Name] > Manage > Integration > OAuth > Providers, and click ADD OAUTH PROVIDER. For more information, refer to Establishing an OAuth Provider.

Configure the settings referring to the following table and Save the settings.

Setting NameValue
NameName of OAuth Provider
OAuth VersionOAuth2
Token Request URLhttps://api.[ServerName].adobesign.com/oauth/v2/token
Token Refresh URL (optional)https://api.[ServerName].adobesign.com/oauth/v2/refresh
Authorize URLhttps://secure.[ServerName].adobesign.com/public/oauth/v2
Callback URLhttps://[BasePortalUrl]/HandleTokenResponse
Default Consumer KeyApplication ID from the Adobe API Applications Dashboard
Default Consumer Secret KeyClient Secret from the Adobe API Applications Dashboard

Creating OAuth Token in Decisions

Navigate to the [Project Name] > Manage > Integration > OAuth > Tokens, and click CREATE TOKEN. For more information, refer to Creating OAuth Tokens.

Configure the settings referring to the following table and Save the settings.

Setting NameValue
Token NameName of the OAuth Token
ProviderChoose the exact name of the OAuth Provider's "Name" we created earlier for Adobe Sign.
OAuth FlowAuthorization Code
Use Default Keys (Specified in Providers)True
Resource IdentifierLeave blank
Scope (Multiple values separated by spaces)They are in the format of [Scope]:[Modifier]
user_login:account agreement_send:account agreement_write:account agreement_read:account
Additional Values ( value1=one&value2=two ) (URL encoded)Leave blank

Adobe Sign Steps

Step NameDescription
Create AgreementThis step initiates the agreement creation process and sends the agreement for signing.
Download DocumentThis step retrieves a copy of the signed or approved document.
Get Agreement InfoThis step allows you to retrieve information and status updates about a specific agreement in Adobe Sign.

Data Structures

Incorporated within the Adobe Sign Steps are specific data structures.

  • AdobeSignAgreementCreationData: data structure is used to create an agreement.
  • There are two options for Agreement Info Types: Simplified and Full.
    • Simplified allows you to add some Agreement Recipients, and that's it.
    • Full gives you complete control of AdobeSignAgreementInfo's properties. Read AdobeSign documentation to use it.
  • AdobeSignAgreementInfo: data structure holds all agreement properties. A signed document has SIGNED value in the Status property.
  • AdobeSignAgreementRecipient: data structure holds an agreement signer's name and email.



Was this article helpful?

What's Next