如何将Docusign电子签名API与.NET后端、Angular+Devextreme前端集成？

核心逻辑说明 #

Angular 侧未使用 Node.js 完全不影响集成，DocuSign 核心鉴权、业务逻辑全部放在后端实现，前端仅负责交互跳转和状态展示即可，不需要额外引入 Node.js 依赖。

分步实现指引 #

1. 后端（C#/.NET 侧）实现 #

• 首先通过 NuGet 安装官方 SDK 包 DocuSign.eSign.dll，不需要自己封装底层请求
• 提前在 DocuSign 开发者后台申请集成密钥、API 账户 ID、用户 ID、RSA 密钥对，全部存入服务端安全配置文件，禁止硬编码
• 优先选 JWT 鉴权模式，适合服务端无感知鉴权场景，核心初始化代码参考：

var apiClient = new ApiClient("https://demo.docusign.net/restapi");
// 请求鉴权令牌
var token = apiClient.RequestJWTUserToken(
    clientId: "你的集成密钥",
    userId: "你的用户ID",
    oauthBasePath: "account-d.docusign.com",
    privateKeyBytes: 读取RSA私钥生成的字节数组,
    expiresInHours: 1,
    scopes: new List<string> { "signature", "impersonation" }
);
Configuration.Default.AccessToken = token.access_token;
Configuration.Default.BasePath = "https://demo.docusign.net/restapi";

• 封装创建签名信封的接口，接收前端传入的业务单据信息、签名人列表，生成签名链接和信封 ID 返回给前端
• 新增 webhook 回调接口，接收 DocuSign 推送的签名完成、拒签、过期等状态通知，同步更新你系统内的业务单据状态，注意接口要加签名校验，避免伪造请求

2. 前端（Angular + DevExtreme 侧）实现 #

• 所有敏感逻辑都调用你自己后端的接口，前端不需要调用 DocuSign 公开接口，也不需要引入任何 DocuSign 相关的 npm 包
• 发起签名流程：用户点击页面发起签名按钮时，把当前业务单据 ID、签名人信息传给后端，拿到返回的签名跳转链接
• 签名页加载可以选两种方案，按需使用：
  • 直接跳转至 DocuSign 官方页面，签名完成后按照配置重定向回你系统的指定页面，在重定向地址携带业务单据 ID，返回后调用后端接口刷新状态即可
  • 用 DevExtreme 的 dxPopup 组件内嵌 iframe 加载签名链接，用户不需要离开当前系统，签名完成后通过 iframe 消息通知父页面刷新状态
• 已完成的签名文档可以调用后端接口获取文件流，前端直接提供预览、下载功能即可

注意事项 #

• 开发阶段先用 DocuSign 沙箱环境调试，全流程跑通后再切换生产环境地址
• 所有密钥类配置绝对不能泄露到前端代码中，所有需要调用 DocuSign 接口的操作全部走后端转发
• 签名链接有默认有效期，不要存储到数据库，每次需要签名时实时请求生成新链接即可

内容的提问来源于stack exchange，提问作者Callum Smith