Bitzsoft.Integrations.ElectronicSignature.ESign
1.0.0-alpha.7
dotnet add package Bitzsoft.Integrations.ElectronicSignature.ESign --version 1.0.0-alpha.7
NuGet\Install-Package Bitzsoft.Integrations.ElectronicSignature.ESign -Version 1.0.0-alpha.7
<PackageReference Include="Bitzsoft.Integrations.ElectronicSignature.ESign" Version="1.0.0-alpha.7" />
<PackageVersion Include="Bitzsoft.Integrations.ElectronicSignature.ESign" Version="1.0.0-alpha.7" />
<PackageReference Include="Bitzsoft.Integrations.ElectronicSignature.ESign" />
paket add Bitzsoft.Integrations.ElectronicSignature.ESign --version 1.0.0-alpha.7
#r "nuget: Bitzsoft.Integrations.ElectronicSignature.ESign, 1.0.0-alpha.7"
#:package Bitzsoft.Integrations.ElectronicSignature.ESign@1.0.0-alpha.7
#addin nuget:?package=Bitzsoft.Integrations.ElectronicSignature.ESign&version=1.0.0-alpha.7&prerelease
#tool nuget:?package=Bitzsoft.Integrations.ElectronicSignature.ESign&version=1.0.0-alpha.7&prerelease
Bitzsoft.Integrations.ElectronicSignature.ESign
e签宝电子签章集成。
功能特性
- 完整实现
IElectronicSignatureProvider接口:覆盖合同发起、详情、下载、签署 URL、撤销、印章、模板、回调验签全部统一方法 - 扩展 API 端点:通过
QueryGetAsync/QueryPostAsync/QueryUploadAsync/QueryDownloadAsync访问 e签宝全部 67+ API 端点
安装
dotnet add package Bitzsoft.Integrations.ElectronicSignature.ESign
<PackageReference Include="Bitzsoft.Integrations.ElectronicSignature.ESign" Version="*" />
认证方式
HMAC-SHA256 签名:使用 AppSecret 对请求内容进行签名,请求 headers 包含 X-Tsign-Open-TIMESTAMP 和签名值。
配置
{
"ESign": {
"AppId": "your-app-id",
"AppSecret": "your-app-secret",
"BaseUrl": "https://openapi.esign.cn"
}
}
| 配置项 | 说明 | 默认值 |
|---|---|---|
AppId |
应用标识 | — |
AppSecret |
应用密钥 | — |
BaseUrl |
API 基地址 | https://openapi.esign.cn |
Timeout |
请求超时 | 30s |
HttpClientName |
命名 HttpClient | ESignElectronicSignatureProvider |
注册
services.AddBitzsoftESignElectronicSignature(options =>
{
options.AppId = "your-app-id";
options.AppSecret = "your-app-secret";
});
第三方请求日志
内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道,默认 NullRequestLogStore 不持久化。
// ① 默认:启用记录管道但不持久化(日志丢弃)
services.AddBitzsoftESignElectronicSignature(options => { /* ... */ });
// ② 持久化:宿主注册 IRequestLogStore 实现后,所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
opts.MaxBodyLength = 8192;
opts.SensitiveFields.Add("mySecret");
});
services.AddBitzsoftESignElectronicSignature(options => { /* ... */ });
回调验签
回调 headers 包含 X-Tsign-Open-TIMESTAMP。VerifyCallback 校验 timestamp + sortedQueryValues + payload 的 HMAC-SHA256 签名,使用 CryptographicOperations.FixedTimeEquals 安全比较。
扩展 API 端点
通过 QueryGetAsync/QueryPostAsync/QueryUploadAsync/QueryDownloadAsync 内部方法可访问 e签宝全部 67+ API 端点:
- 签署流程 — 创建、签署、撤销、归档、批量签署等(15 端点)
- 文件管理 — 上传、下载、模板创建等(5 端点)
- 合同模板 — 创建、编辑、删除、查询等(6 端点)
- 流程模板 — 创建、编辑、删除、查询等(6 端点)
- 印章服务 — 创建、删除、查询、授权等(8 端点)
- 身份认证 — 组织/个人认证(13 端点)
- 组织管理 — 部门、成员管理(8 端点)
依赖
Bitzsoft.Integrations.Compatibility:基础工具库
相关包
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 is compatible. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Bitzsoft.Integrations.Compatibility (>= 1.0.0-alpha.7)
- Bitzsoft.Integrations.ElectronicSignature (>= 1.0.0-alpha.7)
- Bitzsoft.Integrations.RequestLogging (>= 1.0.0-alpha.7)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.9)
- Microsoft.Extensions.Http (>= 10.0.9)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.9)
-
net5.0
- Bitzsoft.Integrations.Compatibility (>= 1.0.0-alpha.7)
- Bitzsoft.Integrations.ElectronicSignature (>= 1.0.0-alpha.7)
- Bitzsoft.Integrations.RequestLogging (>= 1.0.0-alpha.7)
- Microsoft.Extensions.Configuration.Abstractions (>= 5.0.0)
- Microsoft.Extensions.Http (>= 5.0.0)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 5.0.0)
-
net8.0
- Bitzsoft.Integrations.Compatibility (>= 1.0.0-alpha.7)
- Bitzsoft.Integrations.ElectronicSignature (>= 1.0.0-alpha.7)
- Bitzsoft.Integrations.RequestLogging (>= 1.0.0-alpha.7)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.9)
- Microsoft.Extensions.Http (>= 10.0.9)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.9)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on Bitzsoft.Integrations.ElectronicSignature.ESign:
| Package | Downloads |
|---|---|
|
Bitzsoft.Integrations.All
Bitzsoft 第三方集成聚合包 — 包含全部 Integration 模块 |
|
|
Bitzsoft.Integrations.ElectronicSignature.All
电子签章聚合包 — 包含君子签 / 法大大 / 爱签 / 上上签 / e签宝 / 契约锁 / 安证通 / 腾讯电子签全部实现 |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.0-alpha.7 | 61 | 6/16/2026 |
| 1.0.0-alpha.6 | 52 | 6/16/2026 |
| 1.0.0-alpha.5 | 58 | 6/14/2026 |
| 1.0.0-alpha.3 | 58 | 6/7/2026 |