Configuring the DocuSign authentication
Securely call the DocuSign digital signature capabilities through the OAuth 2.0
authentication method that is based on the JSON Web Token (JWT) grant. The following articles explain how to configure your Pega
application to create a JWT with your application's authentication credentials and user
details. Upon request, DocuSign validates the JWT and application permissions, and then
issues an access token that allows use of DocuSign services. The following example shows the DocuSign Developer portal with a sample app and
the integration details that you must provide in your application: Create a container for the public key certificate that your application uses to
authenticate calls to DocuSign. Specify how your application generates the JWTs that it uses to access DocuSign
digital signature capabilities by creating a JWT generation profile. Enter signature impersonation This authentication scope is required for applications
that impersonate users to perform API calls. Enable your application to securely exchange messages with DocuSign through OAuth 2.0
by creating an authentication profile. Configuring the client profile Configuring the JWT assertion Configuring the client authentication Configure your application with the DocuSign connection parameters to successfully
authenticate requests to DocuSign during case processing. Updating the sender authentication profile Updating the DocuSign account ID Updating the DocuSign base URL Updating the DocuSign authentication base URL.key
extension filehttps://<host:port>/prweb/PRRestService/DocuSignService/v1/redirect
Creating a keystore by using OpenSSL
.csr
certificate file by using the OpenSSL software. However,
you can use other methods for generating certificates that are more suitable for your
business needs, or that are more compatible with your security standards..csr
,
.crt
, and .p12
files by entering
the following commands:.csr
, enter:openssl req -out CSR.csr -key DS_PrivateKey.key -new
.crt
, enter:openssl x509 -signkey DS_PrivateKey.key -in CSR.csr -req -days 365 -out mycustom.crt
.p12
, enter:openssl pkcs12 -export -out certificate.pfx -inkey DS_PrivateKey.key -in mycustom.crt
.p12
file that you created in step 1.c.Creating a JWT generation profile
Name Map from Map from key Issuer (iss) Constant Enter the integration key of your DocuSign app. Audience (aud) Constant Perform one of the following actions: Subject (sub) Constant Enter the DocuSign user ID that your application
impersonates. Name Map from Map from key scope Constant Creating an authentication profile
Updating the DocuSign connection details
Previous topic Installing the DocuSign component Next topic Monitoring the DocuSign connection status