Bitzsoft.Integrations.LegalDatabase.Jianwei 1.0.0-alpha.10

Bitzsoft.Integrations.LegalDatabase.Jianwei

见微数据法规案例库 SSO 跳转集成 — 基于 RSA 加密 → API 调用 → 可选 MD5 签名的管道模式生成单点登录访问链接。

功能特性

• Pipeline 管道模式：RSA 加密用户身份 → 调用见微 API 获取重定向 URL → 可选 MD5 签名，由 SsoRedirect 管道编排
• RSA 公钥加密：使用见微提供的 RSA 公钥（Base64 SPKI）加密 {userId, timestamp, platform} 明文
• 可选 MD5 签名：配置 SignSecret 后对最终 URL 进行 MD5 签名追加
• 统一接口：实现 ILegalDatabaseProvider，与其他法律数据库供应商无缝替换

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.LegalDatabase.Jianwei

PackageReference

<PackageReference Include="Bitzsoft.Integrations.LegalDatabase.Jianwei" Version="1.0.0" />

配置

appsettings.json

{
  "LegalDatabase": {
    "Jianwei": {
      "BaseUrl": "https://jianweidata.com/",
      "PublicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...",
      "ApiUrl": "https://api.jianweidata.com/getUserInstValidate",
      "SignSecret": "your-md5-sign-secret"
    }
  }
}

注册服务

从 IConfiguration 绑定（推荐）

using Bitzsoft.Integrations.LegalDatabase.Jianwei;

builder.Services.AddBitzsoftJianweiLegalDatabase(
    builder.Configuration.GetSection("LegalDatabase:Jianwei"));

委托配置

builder.Services.AddBitzsoftJianweiLegalDatabase(options =>
{
    options.PublicKey = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...";
    options.ApiUrl = "https://api.jianweidata.com/getUserInstValidate";
    // options.SignSecret = "your-md5-sign-secret";   // 可选 MD5 签名
});

使用示例

using Bitzsoft.Integrations.LegalDatabase;

public class LoginController : ControllerBase
{
    private readonly ILegalDatabaseProvider _provider;

    public LoginController(ILegalDatabaseProvider provider) => _provider = provider;

    [HttpGet("login/jianwei")]
    public async Task<IActionResult> Login(string userId)
    {
        // 内部执行：RSA 加密身份 → 调用见微 API → 取回重定向 URL
        var access = await _provider.GenerateAccessUrlAsync(userId);
        return Redirect(access.Url);
    }
}

管道流程（SsoRedirect Pipeline 模式）：

1. template — 构造 RSA 加密明文 {"userId":"{userId}","timestamp":"{timestamp}","platform":"web_common"}
2. rsa — 使用 PublicKey RSA 加密明文，写入 {cipher}
3. template:requestBody — 构造 API 请求体 {"codestr":"{cipher}","codeType":"jy","redirect":0}
4. apiCall — POST 调用 ApiUrl，从响应 location 字段提取重定向 URL（成功码 code=0）
5. （可选）template:url → sign → appendSignature — 配置 SignSecret 时对 URL 做 MD5 签名

见微数据仅支持 SSO 跳转（AccessUrl），调用 SearchAsync / GetDocumentAsync 会抛出 NotSupportedException。

请求审计

内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，记录每次调用见微 API 的请求与响应，默认使用 NullRequestLogStore 不持久化。

// 默认：启用记录管道但不持久化（日志丢弃）
services.AddBitzsoftJianweiLegalDatabase(options => { /* ... */ });

// 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxInMemoryBodyBytes = 64 * 1024; // 仅控制内存/加密临时文件切换，不截断正文
    opts.SensitiveFields.Add("PublicKey");
});
services.AddBitzsoftJianweiLegalDatabase(options => { /* ... */ });

依赖

相关包

• Bitzsoft.Integrations.LegalDatabase -- 法规案例库抽象层
• Bitzsoft.Integrations.LegalDatabase.All -- 全部 12 家供应商聚合包
• Bitzsoft.Integrations.SsoRedirect -- SSO 跳转配置驱动管道