- Resolved an issue that prevented the use of
RequestJWTApplicationToken
with a production account URL. - Updated C# SDK dependencies.
- BouncyCastle.Cryptography: Version bumped from 2.3.1 to 2.4.0.
- Microsoft.IdentityModelJsonWebTokens: Version bumped from 7.5.2 to 8.2.0.
- Updated the SDK release version.
- Fixed Deadlock issue with UI Apps (E.g. WinForms).
- Fixed deserialization issue of text/csv type response
- Removed the staging base path and OAuth path constant.
- Updated the SDK release version.
API Changes (Click to expand)
Added support for version v2.1-24.2.00.00 of the Docusign ESignature API.
Updated Envelopes: get
Added new optional query parameter named include_anchor_tab_locations
of type string.
Updated Envelopes: update
Added new optional query parameter named recycle_on_void
of type string.
Updated EnvelopeViews : createCorrect
Request body object correctViewRequest
has been changed to envelopeViewRequest
.
- Added fields:
freeEnvelopeSendsRemainingForAdvancedDocGen
-
Added fields:
defaultSigningResponsiveView
defaultSigningResponsiveViewMetadata
dss_SCOREFDN_196_Rebrand_DocuSignIsNotAVerb
enableAdditionalAdvancedWebFormsFeatures
enableAdditionalAdvancedWebFormsFeaturesMetadata
-
Removed fields:
enableSaveAsEnvelopeCustomFieldInWebForms
enableSaveAsEnvelopeCustomFieldInWebFormsMetadata
- Added field:
rowValues
- Added field:
canNotaryCorrectEnvelope
- Added field:
enableTabAgreementDetails
enableTabAgreementDetailsMetadata
bulkSendingCopyDocGenFormFieldRowValue
- Improved error logging capabilities for the SDK
- Introduced async versions of
ApiClient
authorization methods. - Corrected SDK metadata.
- Updated the SDK release version.
- Introduced async versions of
ApiClient
authorization methods. - Corrected SDK metadata.
- Updated the SDK release version.
API Changes (Click to expand)
Added support for version v2.1-24.2.00.00 of the Docusign ESignature API.
Updated Envelopes: get
Added new optional query parameter named include_anchor_tab_locations
of type string.
Updated Envelopes: update
Added new optional query parameter named recycle_on_void
of type string.
Updated EnvelopeViews : createCorrect
Request body object correctViewRequest
has been changed to envelopeViewRequest
.
- Added fields:
freeEnvelopeSendsRemainingForAdvancedDocGen
-
Added fields:
defaultSigningResponsiveView
defaultSigningResponsiveViewMetadata
dss_SCOREFDN_196_Rebrand_DocuSignIsNotAVerb
enableAdditionalAdvancedWebFormsFeatures
enableAdditionalAdvancedWebFormsFeaturesMetadata
-
Removed fields:
enableSaveAsEnvelopeCustomFieldInWebForms
enableSaveAsEnvelopeCustomFieldInWebFormsMetadata
- Added field:
rowValues
- Added field:
canNotaryCorrectEnvelope
- Added field:
enableTabAgreementDetails
enableTabAgreementDetailsMetadata
bulkSendingCopyDocGenFormFieldRowValue
- Improved error logging capabilities for the SDK
- Updated the SDK release version.
API Changes (Click to expand)
The "token_scopes"
parameter has been moved from path parameters to query parameters for the above mentioned endpoint.
Updated EnvelopeView:CreateSender and EnvelopeView:CreateEdit
The body parameter returnUrlRequest
has been changed to envelopeViewRequest
.
envelopeViewRequest
has the same properties as the previous returnUrlRequest
but now includes additional viewAccess
and settings
properties, where settings is a complex object with several UI controls for the view experience.
Updated TemplateViews: createEdit
The body parameter returnUrlRequest
has been changed to templateViewRequest
.
templateViewRequest
has the same properties as the previous returnUrlRequest
but now includes an additional viewAccess
string.
- Updated existing models
-
Added fields:
allowConnectEnvelopeRemovedEvent
allowOrganizationBranding
allowOrganizationBrandingMetadata
allowPendingDestinationUrlEdition
allowPendingDestinationUrlEditionMetadata
disableBulkSendRecipientLimit
disableBulkSendRecipientLimitMetaData
enableAdvancedSearch
enableAdvancedSearchMetadata
enableContentSearch
enableContentSearchMetadata
enableMultiUserRepositoryFeatures
enableMultiUserRepositoryFeaturesMetadata
enablePremiumDataVerificationExtensions
enablePremiumDataVerificationExtensionsMetadata
enableSaveAsEnvelopeCustomFieldInWebForms
enableSaveAsEnvelopeCustomFieldInWebFormsMetadata
enableScheduledRelease
enableScheduledReleaseMetadata
isvOemEmbed
isvOemEmbedMetaData
-
Removed fields:
enableInboxRelevanceSortForRecentAccounts
enableInboxRelevanceSortForRecentAccountsMetadata
enableScheduledRelease
enableScheduledReleaseMetadata
enableSearch
enableSearchMetadata
enableSearchUI
enableSearchUIMetadata
- Added fields:
enableEnvelopeTypes
enableEnvelopeTypesMetadata
- Added field:
uSigState
- Added field:
uSigState
- Added property:
lastModifiedOn
- Added property:
displayFormat
- Added properties:
accountAgreementsAccessType
accountAgreementsAccessTypeMetadata
canBulkUploadAgreements
canBulkUploadAgreementsMetadata
canManageAgreementParties
canManageAgreementPartiesMetadata
envelopeViewDocumentSettings
envelopeViewEnvelopeCustomFieldSettings
envelopeViewRecipientSettings
envelopeViewRequest
envelopeViewSettings
envelopeViewTaggerSettings
envelopeViewTemplateSettings
paletteItemSettings
paletteSettings
templateViewRequest
returnUrlRequest
- Updated C# SDK dependencies.
- BouncyCastle.Cryptography: Version bumped from 2.3.0 to 2.3.1.
- Microsoft.IdentityModel.JsonWebTokens: Version bumped from 7.5.1 to 7.5.2.
- Updated from System.IdentityModel.Tokens.Jwt to Microsoft.IdentityModel.JsonWebTokens for token handling.
- Added support for version v2.1-24.1.01.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Updated C# SDK dependencies.
- Microsoft.CSharp: Version bumped from 4.5.0 to 4.7.0.
- Newtonsoft.Json: Version bumped from 13.0.1 to 13.0.3.
- System.ComponentModel.Annotations: Version bumped from 4.5.0 to 5.0.0.
- Microsoft.IdentityModel.Protocols: Version bumped from 5.4.0 to 7.3.1.
- System.IdentityModel.Tokens.Jwt: Version bumped from 5.4.0 to 7.3.1.
- BouncyCastle.Cryptography: Version bumped from 2.2.1 to 2.3.0.
- Updated the SDK release version.
- Added support for version v2.1-23.4.02.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Modified the default path to
Demo_REST_BasePath
- Revised the logic to determine the
oAuthBasePath
based on thebaseUrl
. - Added support for version v2.1-23.4.02.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-23.3.01.02 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-23.3.01.02 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-23.3.00.02 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-23.3.00.01 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-23.2.00.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Removed support for .NET Framework 4.5.2. Miminum requirement is now .NET Framework 4.6.2
- Removed BouncyCastle.Crypto and Portable.BouncyCastle dependencies as they've been deprecated and added BouncyCastle.Cryptography which is the recommended replacement and is being maintained.
- Added support for version v2.1-23.1.01.01 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-23.1.01.01 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-23.1.01.01 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-23.1.01.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-22.4.02.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-22.3.01.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-22.3.00.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Removed external reference to RestSharp
- Added support for version v2.1-22.2.00.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- ApiClient in Api/*Api.cs files is now a DocuSignClient, so functionality based on direct access to attributes of previous RestSharp-based client will not work anymore.
- Following Api classes removed:
- DataFeedApi.cs
- SignatureApi.cs
- Added support for version v2.1-22.2.00.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-22.1.02.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-22.1.01.00 of the DocuSign ESignature API.
- Updated the SDK release version.
-
Following models are renamed
ScheduledSendingApiModel
is renamed toScheduledSending
DelayedRoutingApiModel
is renamed toDelayedRouting
- Added support for version v2.1-21.4.02.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-21.4.01.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-21.4.00.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Added support for version v2.1-21.3.00.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Fixed file upload ability to AccountBrands::updateResource (DCM-3867).
- Added support for version v2.1-21.2.02.00 of the DocuSign ESignature API.
- Updated the SDK release version.
- Updated Bouncy Castle version to latest stable (DCM-6142).
- Removed an obsolete
Parameter
class from ApiClient. - Updated the SDK release version.
- Updated RestSharp version to latest stable (DCM-6070).
- Updated the SDK release version.
- Added support for version v2.1-21.2.00.00 of the DocuSign eSignature API.
- Updated the SDK release version.
- Added support for version v2.1-21.2.00.00 of the DocuSign eSignature API.
- Updated the SDK release version.
- Added support for API exceptions to pass along API response headers information from DocuSign (DCM-4453).
- Updated the SDK release version.
- Removed methods
GetAccountSettingsExport
,GetSealProviders
from Accounts. - Removed methods
CreateConnectSecret
,DeleteConnectSecret
,GenerateConnectSecret
,GetConnectSecrets
from Connect. - Removed methods
GetDynamicSystemSettings
,GetTemplateInfo
,GetApplianceInfo
,GetAccount
,GetCustomFields
,GeleteCustomFieldsV2
,GetDocumentPages
,GetImage
,GetLocalePolicy
,UpdatePageInfo
,CreatePageInfo
,DeletePageInfo
,UpdatePdf
,GetPdf
,GetPdfBlob
,UpdatePdfBlob
,CreatePdfBlob
,UpdateRecipientDeniedDocumentCopy
,DeleteRecipientDeniedDocumentCopy
,GetSignerAttachment
,DeleteSignerAttachment
, from Envelopes. - Removed methods
CompleteSignHash
,GetUserInfo
,HealthCheck
,SignHashSessionInfo
,UpdateTransaction
from TrustServiceProviders. - Removed methods
GetUserListExport
from Users.
- Added new methods
GetBulkSendBatchEnvelopes
to BulkEnvelopes.
- Added support for version v2.1-21.1.02.00 of the DocuSign eSignature API.
- Updated the SDK release version.
- Removed methods
GetAccountSettingsExport
,GetSealProviders
from Accounts. - Removed methods
CreateConnectSecret
,DeleteConnectSecret
,GenerateConnectSecret
,GetConnectSecrets
from Connect. - Removed methods
GetDynamicSystemSettings
,GetTemplateInfo
,GetApplianceInfo
,GetAccount
,GetCustomFields
,GeleteCustomFieldsV2
,GetDocumentPages
,GetImage
,GetLocalePolicy
,UpdatePageInfo
,CreatePageInfo
,DeletePageInfo
,UpdatePdf
,GetPdf
,GetPdfBlob
,UpdatePdfBlob
,CreatePdfBlob
,UpdateRecipientDeniedDocumentCopy
,DeleteRecipientDeniedDocumentCopy
,GetSignerAttachment
,DeleteSignerAttachment
, from Envelopes. - Removed methods
CompleteSignHash
,GetUserInfo
,HealthCheck
,SignHashSessionInfo
,UpdateTransaction
from TrustServiceProviders. - Removed methods
GetUserListExport
from Users.
- Added new methods
GetBulkSendBatchEnvelopes
to BulkEnvelopes.
- Added support for version v2.1-21.1.02.00 of the DocuSign eSignature API.
- Updated the SDK release version.
- Updated the SDK release version to fix C# SDK Nuget 5.4.0 does not work with .NET Framework 4.8. (DCM-5727)
- Added new methods
DeleteCustomFieldsV2
,DeletePageInfoV2
,GetApplianceEnvelopeInfo
,GetTemplateInfo
to envelopes. - Added new method
DeleteConnectSecret
to connect.
- Added support for version v2.1-21.1.01.03 of the DocuSign eSignature API.
- Updated the SDK release version.
- Added support for version v2.1-21.1.01 of the DocuSign eSignature API.
- Updated the SDK release version
- Added support for version v2.1-20.4.01 of the DocuSign eSignature API.
- Updated the SDK release version
- Deprecated update and delete recipients methods in BulkEnvelopesApi.
- Added support for version v2.1-20.4.00.01 of the DocuSign eSignature API.
- Updated the SDK release version
- Expected field name in BrandsResponse model is
brandOptions
instead ofbrands
. (DCM-4463)
- Added support for version v2.1-20.3.01 of the DocuSign eSignature API.
- Updated the SDK release version
- Added support for version v2.1-20.3.01 of the DocuSign eSignature API.
- Updated the SDK release version
- Added support for version v2.1-20.3.00 of the DocuSign eSignature API.
- Updated the SDK release version
- A bug with ApiClient SetBasePath which did not update basePath for RestClient (DCM-4276).
- Added support for version v2.1-20.3.00 of the DocuSign eSignature API.
- Updated the SDK release version
- A bug with ApiClient SetBasePath which did not update basePath for RestClient (DCM-4276).
- Major design changes, resolved an issue with ApiClient and Configuration circular reference (DCM-3979). The initialization of any api object now requires ApiClient passed as a parameter as a parameter.
- Added support for version v2.1-20.2.02.02 of the DocuSign eSignature API.
- Updated the SDK release version
- Major design changes, resolved an issue with ApiClient and Configuration circular reference (DCM-3979). The initialization of any api object now requires ApiClient passed as a parameter as a parameter.
- Added support for version v2.1-20.2.02.02 of the DocuSign eSignature API.
- Updated the SDK release version
- Added support for version v2.1-20.2.00 of the DocuSign eSignature API.
- Updated the SDK release version
- Added properties for Bulk Update call
- Added support for version v2.1-20.1.02 of the DocuSign eSignature API.
- Updated the SDK release version
- Made InterceptRequest and InterceptResponse methods overriable (DCM-4242)
- Added support for version v2.1-20.1.02 of the DocuSign eSignature API.
- Updated the SDK release version
- Added support for version v2.1-20.1.00 of the DocuSign eSignature API.
- Updated the SDK release version.
- Added the new property
CopyRecipientData
to envelopes. When set to true, the information that recipients enter is retained when you clone an envelope. For example, if you resend an envelope that was declined or voided after one or more recipients entered data, that data is retained. Note that this functionality must be enabled for the account. - Added
RecipientIdentityInputOption
andInputOptions
toRecipientIdentityVerification
: Reserved for DocuSign.
- Deleted the GET methods for account seals providers, which returned the seals for an account.
- The SDK now supports API v2.1-20.1.00 of the DocuSign eSignature API.
- SDK Release Version updated.
- The SDK now supports API v2.1-19.4.01 of the DocuSign eSignature API.
- SDK Release Version updated.
- The SDK now supports API v2.1-19.4.01 of the DocuSign eSignature API.
- SDK Release Version updated.
- Added support for WebProxy, integrations can now initialize the ApiClient by providing their proxy details. (DCM-3321)
- SDK Release Version updated.
- Added support for WebProxy, integrations can now initialize the ApiClient by providing their proxy details. (DCM-3321)
- SDK Release Version updated.
- .Net Framework minimum version updated to v4.5.2
- Upgraded the dependencies related to the .net framework v4.5.2
- SDK Release Version updated.
- .Net Framework minimum version updated to v4.5.2
- Upgraded the dependencies related to the .net framework v4.5.2
- SDK Release Version updated.
- The SDK now supports API v2.1-19.2.02 of the DocuSign eSignature API.
- SDK Release Version updated.
- A bug with DocuSign .Net Core SDK which threw an error in a Linux based Docker container (DCM-3073)
- Documentation with 'expiresInHours' parameter fixed (DCM-3319)
- Updated the request claims added when we create the JWT Token by adding 'iat' suppressing the default time added on 'nbf' claim (DCM-3232)
- A bug with DocuSign .Net Core SDK which threw an error in a Linux based Docker container (DCM-3073)
- Documentation with 'expiresInHours' parameter fixed (DCM-3319)
- Updated the request claims added when we create the JWT Token by adding 'iat' suppressing the default time added on 'nbf' claim (DCM-3232)
- SDK Release Version updated.
- A bug with DocuSign .Net Core SDK which threw an error in a Linux based Docker container (DCM-3073)
- SDK Release Version updated.
- The SDK now supports API v2.1-19.1.02 of the DocuSign eSignature API.
- SDK Release Version updated.
- The SDK now supports API v2.1-19.1.02 of the DocuSign eSignature API.
- SDK Release Version updated.
- The SDK now supports version 19.1.02 of the DocuSign eSignature API.
- SDK Release Version updated.
- Added new Cache-Control and Pragma headers to OAuth server request calls. (DCM-2243)
- Added a new TabGroupLabels field to all Tabs models
- Added a new Witnesses field to all Recipients models
- Implemented models for Smart Sections feature
- Implemented initial support of HMAC for DocuSign Connect
- A bug with that could cause the MoveEnvelopes method call to return a response without a Content-Type header. (DCM-3084)
- The SDK now supports version 19.1.02 of the DocuSign eSignature API.
- SDK Release Version updated.
- Added new Cache-Control and Pragma headers to OAuth server request calls. (DCM-2243)
- Added a new TabGroupLabels field to all Tabs models
- Added a new Witnesses field to all Recipients models
- Implemented models for Smart Sections feature
- Implemented initial support of HMAC for DocuSign Connect
- A bug with that could cause the MoveEnvelopes method call to return a response without a Content-Type header. (DCM-3084)
- The SDK now supports version 18.4.02 of the DocuSign eSignature API.
- SDK Release Version updated.
- Fixed a problem with the AccountsApi.UpdateBrandLogoByType method that prevented it from uploading brand logos.
- The SDK now supports version 18.4.02 of the DocuSign eSignature API.
- SDK Release Version updated.
- Fixed a problem with the AccountsApi.UpdateBrandLogoByType method that prevented it from uploading brand logos.
- The SDK now supports version 18.3.02 of the DocuSign eSignature API.
- SDK Release Version updated.
- Net Framework v4.5 Dependencies upgraded to gracefully support framework v4.5 SDK dependency issues with other versions.
- Added the response.Content from server to ApiException.ErrorContent property to avoid parsing error message string. (DCM-3016)
- Fixed a problem with the EnvelopesApi.ListStatus and EnvelopesApi.ListStatusChanges methods that could cause them to ignore sets of envelope IDs passed in to get statuses for specific envelopes. (DCM-2748)
- Fixed a problem with the BulkEnvelopesApi.UpdateRecipients method that could cause it to return a "Value cannot be null.\r\nParameter name: stream" error rather than add bulk recipients to an envelope. (DCM-2862)
- Removed a unnecessary prefix from a line of the Usage Example. (DCM-3005)
- Fixed a dependency issue with other libraries in v4.5 framework that could cause integration problems. (DCM-2999 and DCM-2942)
- The SDK now supports version 18.3.02 of the DocuSign eSignature API.
- SDK Release Version updated.
- Net Framework v4.5 Dependencies upgraded to gracefully support framework v4.5 SDK dependency issues with other versions.
- Fixed a problem with the EnvelopesApi.ListStatus and EnvelopesApi.ListStatusChanges methods that could cause them to ignore sets of envelope IDs passed in to get statuses for specific envelopes. (DCM-2748)
- Fixed a problem with the BulkEnvelopesApi.UpdateRecipients method that could cause it to return a "Value cannot be null.\r\nParameter name: stream" error rather than add bulk recipients to an envelope. (DCM-2862)
- Removed a unnecessary prefix from a line of the Usage Example. (DCM-3005)
- Fixed a dependency issue with other libraries in v4.5 framework that could cause integration problems. (DCM-2999 and DCM-2942)
- SDK Release Version updated.
- The C# .NET Standard SDK can now be implemented by projects in Mac and Linux environments. (DCM-2837)
- The AccountId() method has been removed from the SDK and replaced with by a settable AccountId property in the OAuth.UserInfo.Account object. Existing implementations that use the AccountId() method must be updated to use the AccountId property instead. Attempting to call AccountId() will result in the following error:
CS1955 Non-invocable member 'OAuth.UserInfo.Account.AccountId' cannot be used like a method.
(DCM-2636)
- The base path for OAuth authentication is now a property of the ApiClient object.
- Updated the TLS logic to disable older, unsecure TLS versions. Open Source contribution.
- This release of the C# SDK is Strong-Named. (DCM-2784)
- Updated the format of the response returned GetUserInfo method to now contain information on the user's organization, if they are part of one. (DCM-2385)
- Added a new method, RequestJWTUserToken. This method is passed a user's client id, user id, requested scopes, and their private key in byte array format, performs JWT authentication for the specified user, and returns an access token. (DCM-2762)
- Added a new method, RequestJWTApplicationToken. This is a reserved method that is only enabled by partners and resellers, which obtains an access token that makes requests on behalf of an application rather than a user. It is passed a user's client id, requested scopes, and a private key in byte array format, then returns an access token. (DCM-2762)
- SetOauthBasePath, which can be used to set the OAuth base path for your ApiClient. (DCM-2692)
- The ConfigureJwtAuthorizationFlowByKey method is now deprecated. Please use the RequestJWTUserToken method instead, which improves security by accepting the private key as a byte array or stream. (DCM-2762)
- The GetIsDefault method has been deprecated and replaced with by a settable IsDefault property in the ApiClient object. (DCM-2636)
- The GetBaseUri method has been deprecated and replaced with by a settable BaseUri property in the ApiClient object. (DCM-2636)
- The GetAccounts method has been deprecated and replaced with by a settable Accounts property in the ApiClient object. (DCM-2636)
- Fixed a problem with multi-threaded environments that could intermittently route ConfigureJwtAuthorizationFlowByKey, GetUserInfo, and GenerateAccessToken method calls to the OAuth endpoint rather than the API endpoint.
- Fixed a problem that would cause the ConfigureJwtAuthorizationFlowByKey, GetUserInfo, and GenerateAccessToken methods to return null when encountering errors, rather than an error code.
- The TokenResponse class has been deprecated. Please use the OAuth.OAuthToken class instead.
- Added support for .Net Standard 2.0. Applications built with the DocuSign C# SDK are now compatible with .NET Core 2.0 along with .NET Framework 4.5 or later.
- Fixed a problem with the CreateRSAKeyFromPem method that would cause the ConfigureJwtAuthorizationFlow method to fail with a CryptographicException error when deploying to Azure Web Apps. (DCM-2363)
-
New SDK methods have been implemented that continue to improve the OAuth experience:
-
A new version of the
GetAuthorizationUri
method that allows you to specify the requested scopes and response type. Additionally, the new method returns the authorization URI in Uri rather than string format. -
A new method,
GetUserInfo
, which is passed a valid access token and returns the full set of account information associated with the user specified in the access token, including the base path that a user will call into to perform API operations by an internal call to the OAuth::userInfo API method. Use the following procedure to complete the base path returned by this method, allowing you to make REST eSignature API calls.- Set the base path to either https://demo.docusign.net/restapi for a demo or developer sandbox account or https://www.docusign.net/restapi for production accounts.
- Then authenticate the user and determine the base path by using the new
GetUserInfo
method. - Then reset the base path to the correct value.
-
A new method,
GenerateAccessToken
, which provides support for the Authorization Code Grant OAuth flow. It exchanges a valid authorization code for an access token (and associated information).
Note that, if the base path has not been set prior to calling any of the new SDK methods, they will default to using the demo (rather than production) environment.
-
- Some SDK methods have been deprecated and should be replaced with calls to other, more recently implemented methods:
- The
ConfigureJwtAuthorization
method is now deprecated and should be replaced byConfigureJwtAuthorizationFlowByKey
, which allows you to pass in your private key directly as a string rather than referencing a .pem file containing the key value. If you are storing the private key in a .pem file that is referenced by your solution, you must update your code to read the file's contents to a string and provide that string to the new method. For example:The string passed intoprivateKey = File.ReadAllText(privateKeyFilename);
ConfigureJwtAuthorizationFlowByKey
must contain the same header and footer information contained in the PEM file, including newlines, as shown below.-----BEGIN RSA PRIVATE KEY-----\nYOUR_PRIVATE_KEY\n-----END RSA PRIVATE KEY-----
- The version of
GetAuthorizationUri
that returns a string has been deprecated in favor of the new implementation of the same method that returns a Uri. - The
GetOAuthToken
method has been deprecated and should be replaced byGenerateAccessToken
.
- The
- Added support for TLS 1.2, enabling your applications built with the C# SDK to be compatible with TLS 1.2 by default.
- New SDK methods have been implemented to improve OAuth support:
ConfigureJwtAuthorizationFlowByKey
, which performs JWT Bearer Grant OAuth authentication using the provided values and private key. If successful, it returns an access token and the amount of time that it is valid, in seconds.GetAuthorizationUri
, a helper method which returns a authorization URI. You can redirect the user's browser to this URI to begin the OAuth Authorization Code Grant authentication flow.GenerateAccessToken
, a helper method which can exchange a previously-obtained authorization code for an access token.GetUserInfo
, a helper method which can, using a previously-obtained access token, return a set of basic user data that includes that user's base DocuSign API platform URI
- Updates to the SDK are now being tracked by a change log.
- The SDK has been updated to match version 18.1.02 of the API.
- Fixed a bug that could cause the JWT Bearer Grant OAuth flow to break unexpectedly.