将 Alipay 添加为 OAuth 提供商
本指南介绍如何让用户使用其支付宝账户登录 Casdoor。Alipay 提供商使用证书对其请求进行签名。
学习目标
- 获取支付宝应用的 APPID 和证书。
- 在 Casdoor 中存储证书。
- 在 Casdoor 中将 Alipay 添加为 OAuth 提供商。
所需条件
- 在 Alipay Open Platform 上的开发者账户。参见 接入前准备。
- 访问 Casdoor 管理控制台的权限
获取 APPID 和证书
- 在 Alipay Open Platform 的控制台中创建应用并记录其 APPID。参见 查找 APPID。
- Generate an RSA2 key pair as the Alipay documentation describes. 会得到
appPrivateKey.txt和appPublicKey.txt。 - 在支付宝应用中上传应用证书并下载三个文件:
alipayRootCert.crt、appCertPublicKey.crt和alipayCertPublicKey.crt。 - 将支付宝应用的回调 URL 设置为 Casdoor 的回调 URL,即
https://<your-casdoor-host>/callback。参见 重定向 URL 和回调 URL。
在 Casdoor 中存储证书
在 Casdoor 管理控制台中,打开 Certs 页面并添加两个证书。
应用证书:
| Casdoor field | Value |
|---|---|
| Type | x509 |
| Certificate | appCertPublicKey.crt 的内容 |
| Private key | appPrivateKey.txt 的内容 |
根证书:
| 字段 | 值 |
|---|---|
| 项目类型或类别 | x509 |
| 证书 | alipayCertPublicKey.crt 的内容 |
| 私钥 | alipayRootCert.crt 的内容 |
在 Casdoor 中添加提供商
- 转到 Identity > Providers 并添加一个提供商。
- 将 Category 设置为
OAuth,将 Type 设置为Alipay。 - 输入 APPID 作为 Client ID,并选择您创建的应用证书和根证书。
- 保存提供商.
用户 ID
Casdoor 使用 Alipay 的 user_id 作为用户的 ID。在 Alipay OpenID 迁移之后创建的支付宝应用不会返回 user_id,因此 Casdoor 改用 open_id。如果响应中两者都没有,则登录失败并显示 alipay GetUserInfo error: both user_id and open_id are empty。
注意事项
如果您将支付宝应用从 user_id 切换到 open_id,每个用户的 ID 都会发生变化。在此之前登录的用户将不再与其关联的 Casdoor 账户匹配。
故障排除
如果登录失败,例如出现 asn1: syntax error: sequence truncated,请检查以下内容:
- 在应用证书中,Certificate 是
appCertPublicKey.crt,Private key 是appPrivateKey.txt。 - 在根证书中,Certificate 是
alipayCertPublicKey.crt,Private key 是alipayRootCert.crt。 - APPID 属于该支付宝应用。
- 回调 URL 在 Alipay 和 Casdoor 中均设置正确。