Github repo: eg-03-csharp-auth-code-grant-core
This repo is a C# .NET Core MVC application that demonstrates:
- Authentication with DocuSign via the Authorization Code Grant flow. When the token expires, the user is asked to re-authenticate. The refresh token is not used in this example.
- Embedded Signing Ceremony. Source. This example sends an envelope, and then uses an embedded signing ceremony for the first signer. With embedded signing, the DocuSign signing ceremony is initiated from your website.
- Send an envelope with a remote (email) signer and cc recipient. Source. The envelope includes a pdf, Word, and HTML document. Anchor text (AutoPlace) is used to position the signing fields in the documents.
- List envelopes in the user's account. Source. The envelopes' current status is included.
- Get an envelope's basic information. Source. The example lists the basic information about an envelope, including its overall status.
- List an envelope's recipients Source. Includes current recipient status.
- List an envelope's documents. Source.
- Download an envelope's documents. Source. The example can download individual documents, the documents concatenated together, or a zip file of the documents.
- Programmatically create a template. Source.
- Send an envelope using a template. Source.
- Send an envelope and upload its documents with multpart binary transfer. Source. Binary transfer is 33% more efficient than using Base64 encoding.
- Embedded sending. Source. Embeds the DocuSign web tool (NDSE) in your web app to finalize or update the envelope and documents before they are sent.
- Embedded DocuSign web tool (NDSE). Source.
- Embedded Signing Ceremony from a template with an added document. Source. This example sends an envelope based on a template. In addition to the template's document(s), the example adds an additional document to the envelope by using the Composite Templates feature.
- Payments example: an order form, with online payment by credit card. Source.
- Get the envelope tab data. Retrieve the tab (field) values for all of the envelope's recipients. Source.
- Set envelope tab values. The example creates an envelope and sets the initial values for its tabs (fields). Some of the tabs are set to be read-only, others can be updated by the recipient. The example also stores metadata with the envelope. Source.
- Set template tab values. The example creates an envelope using a template and sets the initial values for its tabs (fields). The example also stores metadata with the envelope. Source.
- Get the envelope custom field data (metadata). The example retrieves the custom metadata (custom data fields) stored with the envelope. Source.
- Requiring an Access Code for a Recipient Source. This example sends an envelope that requires an access-code for the purpose of multi-factor authentication.
- Requiring SMS authentication for a recipient Source. This example sends an envelope that requires entering in a six digit code from an text message for the purpose of multi-factor authentication.
- Requiring Phone authentication for a recipient Source. This example sends an envelope that requires entering in a voice-based response code for the purpose of multi-factor authentication.
- Requiring Knowledge-Based Authentication (KBA) for a Recipient Source. This example sends an envelope that requires passing a Public records check to validate identity for the purpose of multi-factor authentication.
- Requiring ID Verification (IDV) for a recipient Source. This example sends an envelope that requires submitting a photo of a government issued id for the purpose of multi-factor authentication.
-
A DocuSign Developer Sandbox account (email and password) on demo.docusign.net. Create a free account.
-
A DocuSign Integration Key (a client ID) that is configured to use the OAuth Authorization Code flow. You will need the Integration Key itself, and its secret.
If you use this example on your own workstation, the Integration key must include a Redirect URI of
http://localhost:8080/ds/callbackIf you will not be running the example on your own workstation, use the appropriate DNS name and port instead of
localhost -
C# .NET Core version 2.1 or later.
-
A name and email for a signer, and a name and email for a cc recipient.
-
Download or clone this repository.
-
The repository includes a Visual Studio 2017 solution file and NuGet package references in the project file.
-
Configure the project by editing the existing project file for the API version you wish to use by modifying its
appsettings.jsonSee the Configuration section, below, for more information.
appsettings.json is the configuration file.
Replace the {CLIENT_ID}, {CLIENT_SECRET}, {USER_EMAIL}, and {USER_FULLNAME} text with your values. Do not leave the braces { } in the configuration file.
The Client_id (Integration Key) and its secret are private. Please do not store the appsettings file in your code repository after you have added the private information to it.
To update to production, change all of the authorization service https://account-d.docusign.com addresses to https://account.docusign.com
To use the payments example, create a test payments gateway for your developer sandbox account.
See the PAYMENTS_INSTALLATION.md file for instructions.
Then add the payment gateway account id to the appsettings.json file.
Build and then start the solution.
Your default browser will be opened to https://localhost:8080 and you will see the application's home page.
The examples in this repository can also be used with either the Implicit Grant or JWT OAuth flows. See the Authentication guide for information on choosing the right authentication flow for your application.
This repository uses the MIT License. Please see the LICENSE file for more information.
Pull requests are welcomed. Pull requests will only be considered if their content uses the MIT License.