DocuSign 强制收件人 - XML 签名答案

【问题标题】：DocuSign Captive Recipient - XML SigningDocuSign 强制收件人 - XML 签名
【发布时间】：2015-03-19 19:01:33
【问题描述】：

我们正在使用基于 DocuSign SOAP 的 API 调用 - .net Web 应用程序中的 CreateAndSendEnvelope 将强制收件人创建到我们客户的 DocuSign 帐户中。

我们可以很好地创建信封，但是在为强制收件人请求令牌时，我们必须要求我们的客户关闭 X509 签名证书。我们必须要求他们从他们的 DocuSign 帐户中启用两个选项。

会议中
不要在会话证书中强制执行

有时，启用这些功能对我们和我们的客户来说变得很麻烦，请购买我们/他们的 DocuSign 客户代表。

为了让我们的强制收件人使用有效的 X.509 签名证书签署文档，我们需要做什么？根据 DocuSign 的文档，如果我们为 DocuSign 提供签名证书公用名 (CN)，DocuSign 可以验证 XML 签名，我们的强制接收者可以在不启用这两个选项的情况下签署文档。

如果我们使用强制收件人创建信封，我们是否需要为我们正在使用的每个 DocuSign 帐户提供 CN？我们需要在请求标头中包含什么内容吗？

请指教..

【问题讨论】：

正在调查这个...
我认为下面大卫回答的最后一部分是最简单的解决方案，您的集成可以免费使用 SOAP 或 REST 进行调用，正如他所提到的，如果您在 REST 中进行此调用，那么证书检查是省略...

标签： docusignapi

【解决方案1】：

果汁科技：

如链接中的 DocuSign 文档所述：https://www.docusign.com/p/APIGuide/Content/Embedding%20Group/Pre-DocuSign%20Operations.htm

这是使用 .NET 使用 X.509 证书签署 xml soap 正文的链接：

https://msdn.microsoft.com/en-us/library/ms819963.aspx

正如其他 StackOverflow 文章链接中提到的，如果可以接受，您可以关闭该要求，但不建议 DocuSign API: "Invalid Signature Credentials" error using Captive (Embedded) Recipients

作为替代方案，您可以对接收者视图进行 REST API 调用，并同时消除对 x.509 和 CN 的需求，因为 REST API 不会观察到需要更改的两个设置支持。该方法是 POST {vx}/accounts/{accountid}/views/{viewtype}，您可以从 REST login_information 调用中获取 accountid，以关联到您在 SOAP 中拥有的 accountGUID。帐户保持不变，因此您只需要按时调用每个帐户并缓存/持久化它。 https://www.docusign.net/restapi/help

【讨论】：

您提供的有关如何在 Microsoft 的 SOAP 标头中包含 X.509 证书的链接是一个旧链接，适用于框架 1.1。正如我在帖子中提到的那样，为了允许俘虏收件人要使用 X.509 签名证书对信封进行签名，我们是否需要将每个客户的 DocuSign 帐户的 CN 提供给 DocuSign？
Juiced Tech，是的，CN 需要针对每个客户，需要相同的支持电话，如果他们已经有电话，可能会导致冲突，因此您和您的客户的 REST 选项将是最有效的途径.这个要求是遗留的，我怀疑由于维持“默认”要求状态所需的“努力”，它可能会被逆转，但我不知道这是事实。其次，我将努力获得一个可行的示例，以便在将来必须使用 SOAP 并且必须满足当前的默认要求的其他人使用这种策略。
感谢您提供详细信息。我将尝试使用基于 REST 的 API 调用来打开收件人视图，这样我就可以消除启用/禁用 X.509 签名证书的需要，