Bitzsoft.Integrations.ElectronicSignature.Asign
1.0.0-alpha.7
This is a prerelease version of Bitzsoft.Integrations.ElectronicSignature.Asign.
dotnet add package Bitzsoft.Integrations.ElectronicSignature.Asign --version 1.0.0-alpha.7
NuGet\Install-Package Bitzsoft.Integrations.ElectronicSignature.Asign -Version 1.0.0-alpha.7
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Bitzsoft.Integrations.ElectronicSignature.Asign" Version="1.0.0-alpha.7" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Bitzsoft.Integrations.ElectronicSignature.Asign" Version="1.0.0-alpha.7" />
<PackageReference Include="Bitzsoft.Integrations.ElectronicSignature.Asign" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Bitzsoft.Integrations.ElectronicSignature.Asign --version 1.0.0-alpha.7
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Bitzsoft.Integrations.ElectronicSignature.Asign, 1.0.0-alpha.7"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Bitzsoft.Integrations.ElectronicSignature.Asign@1.0.0-alpha.7
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Bitzsoft.Integrations.ElectronicSignature.Asign&version=1.0.0-alpha.7&prerelease
#tool nuget:?package=Bitzsoft.Integrations.ElectronicSignature.Asign&version=1.0.0-alpha.7&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Bitzsoft.Integrations.ElectronicSignature.Asign
爱签电子签章集成。
功能特性
- 完整实现
IElectronicSignatureProvider接口:覆盖合同发起、详情、下载、签署 URL、撤销、印章、模板、回调验签全部统一方法 - partial class 扩展:通过部分类暴露爱签全部 API(签署、模板、用户、实名认证、证据链)
安装
dotnet add package Bitzsoft.Integrations.ElectronicSignature.Asign
<PackageReference Include="Bitzsoft.Integrations.ElectronicSignature.Asign" Version="*" />
认证方式
RSA2 (SHA256WithRSA) 签名:
- 收集所有非空请求参数(排除 sign)
- 按 key 字典序排序
- 拼接为
key1=value1&key2=value2... - 使用开发者 RSA 私钥 SHA256WithRSA 签名
- Base64 编码为 sign 值
所有请求使用 JSON body 格式。
配置
{
"Asign": {
"AppId": "your-app-id",
"PrivateKey": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----",
"PublicKey": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----",
"BaseUrl": "https://oapi.asign.cn"
}
}
| 配置项 | 说明 | 默认值 |
|---|---|---|
AppId |
应用标识 | — |
PrivateKey |
开发者 RSA 私钥(PKCS#8 PEM) | — |
PublicKey |
平台 RSA 公钥(PKCS#8 PEM) | — |
BaseUrl |
API 基地址 | https://oapi.asign.cn |
Timeout |
请求超时 | 30s |
HttpClientName |
命名 HttpClient | AsignElectronicSignatureProvider |
注册
services.AddBitzsoftAsignElectronicSignature(options =>
{
options.AppId = "your-app-id";
options.PrivateKey = File.ReadAllText("private_key.pem");
options.PublicKey = File.ReadAllText("public_key.pem");
});
第三方请求日志
内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道,默认 NullRequestLogStore 不持久化。
// ① 默认:启用记录管道但不持久化(日志丢弃)
services.AddBitzsoftAsignElectronicSignature(options => { /* ... */ });
// ② 持久化:宿主注册 IRequestLogStore 实现后,所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
opts.MaxBodyLength = 8192;
opts.SensitiveFields.Add("mySecret");
});
services.AddBitzsoftAsignElectronicSignature(options => { /* ... */ });
回调验签
回调使用 JSON body 格式。VerifyCallback 验证 appId 匹配、时间戳新鲜度、RSA 签名(平台公钥验签)。RSA 操作使用 lock 保护线程安全。
扩展方法(partial class)
- Signing — 发起签署(完整版/精简版)、签署 URL、撤销、状态查询等(12 方法)
- Templates — 模板上传、创建、复制、同步、删除、控件查询等(7 方法)
- Users — 个人/企业用户添加、同步、查询等(11 方法)
- Verification — 个人手机/银行卡/人脸认证、企业认证等(8 方法)
- Evidence — 证据链存储、检索、下载(3 方法)
依赖
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. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
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.Asign:
| 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 | 58 | 6/16/2026 |
| 1.0.0-alpha.6 | 56 | 6/16/2026 |
| 1.0.0-alpha.5 | 60 | 6/14/2026 |
| 1.0.0-alpha.3 | 53 | 6/7/2026 |