Casdoor集成市场

国密 SM2 证书登录校验 | 提供商

让 UKey 和数字证书登录认 SM2 证书

Casdoor 自己只校验 RSA 和 ECDSA 证书。装上这个插件后,组织的证书登录改由插件校验:SM2 证书链、有效期、吊销列表,以及 UKey 控件对挑战值的 SM2 签名(SM3 杂凑,默认用户 ID)。RSA 和 ECDSA 证书照样能用,可以和 SM2 CA 混用。

Casdoor 官方核验企业版国密UKey数字证书
你需要一个正在运行的 Casdoor,自己部署或用 Casdoor 云都可以。示例中的 https://auth.example.com 请换成你的 Casdoor 地址(Casdoor 云上类似 https://acme.casdoor.com),其他 example.com 地址也换成你自己的。

用 Casdoor 配置 国密 SM2 证书登录校验

  1. 1

    安装插件

    在 Casdoor 组织的“集成市场”里安装 国密 SM2 证书登录校验,需要企业版许可证。

  2. 2

    配置证书登录

    打开组织的“企业合规”标签页,在“证书和 UKey 登录”一节开启证书登录,把签发用户证书的 CA 证书(PEM,SM2、RSA、ECDSA 都可以,可依次粘贴多个)填进“受信任的 CA 证书”,选好用哪个证书字段对应哪个用户属性,再在“证书校验插件”里选本插件,保存。

    证书校验插件国密 SM2 证书登录校验
  3. 3

    接入 UKey

    两种方式任选:一是 UKey 厂商的浏览器控件,先调 GET /api/get-cert-challenge?application=<应用名> 取随机数,用 UKey 做 SM2 签名后连同证书 POST 到 /api/login(signinMethod 为 Certificate);二是由国密网关(支持 TLCP 的反向代理)终止国密 TLS、要求客户端证书,再把证书放在 X-SSL-Client-Cert 请求头转给 Casdoor,并把网关地址写进 app.conf 的 certLoginTrustedProxies。

  4. 4

    在应用里加登录方式

    在应用的登录方式里加上“UKey 或证书”,然后用插上 UKey 的电脑打开登录页试一次。

注意事项

  • 吊销列表由 Casdoor 按“CRL 地址”下载后交给插件校验,取不到列表时登录失败,不会跳过检查。
  • SM2 签名可以是 ASN.1 DER,也可以是 r、s 各 32 字节拼接的 64 字节,两种格式都认。
  • 用户证书的指纹是 DER 的 SHA-256(十六进制),按指纹绑定时填在用户的属性 certFingerprint 里。

国密 SM2 证书登录校验 的设置取自它的官方文档(核对于 2026年11月:国家标准全文公开系统(可检索 GB/T 32918、GB/T 35276)、emmansun/gmsm:插件使用的 SM2、SM3 和国密证书实现)。国密 SM2 证书登录校验 是其所有者的商标。