https://auth.example.com 请换成你的 Casdoor 地址(Casdoor 云上类似 https://acme.casdoor.com),其他 example.com 地址也换成你自己的。用 Casdoor 配置 国密 SM2 证书登录校验
- 1
安装插件
在 Casdoor 组织的“集成市场”里安装 国密 SM2 证书登录校验,需要企业版许可证。
- 2
配置证书登录
打开组织的“企业合规”标签页,在“证书和 UKey 登录”一节开启证书登录,把签发用户证书的 CA 证书(PEM,SM2、RSA、ECDSA 都可以,可依次粘贴多个)填进“受信任的 CA 证书”,选好用哪个证书字段对应哪个用户属性,再在“证书校验插件”里选本插件,保存。
证书校验插件 国密 SM2 证书登录校验 - 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
在应用里加登录方式
在应用的登录方式里加上“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 证书登录校验 是其所有者的商标。
更多提供商
查看全部Authelia
OAuth 提供商让用户通过 Authelia 用 OpenID Connect 登录 Casdoor:包括提供商配置,以及要加到 Authelia 配置里的客户端。
authentik
OAuth 提供商让用户用 authentik 账号通过 OpenID Connect 登录 Casdoor:包括提供商配置,以及要在 authentik 里创建的应用和 OAuth2 提供商。

超星学习通
OAuth 提供商让师生用超星学习通账号登录 Casdoor:按超星微服务开放平台的 OAuth 接口填好了授权、换取 access_token 和获取用户信息的地址。

