跳到主内容

将 Alipay 添加为 OAuth 提供商

本指南介绍如何让用户使用其支付宝账户登录 Casdoor。Alipay 提供商使用证书对其请求进行签名。


学习目标​

  • 获取支付宝应用的 APPID 和证书。
  • 在 Casdoor 中存储证书。
  • 在 Casdoor 中将 Alipay 添加为 OAuth 提供商。

所需条件​


获取 APPID 和证书​

  1. 在 Alipay Open Platform 的控制台中创建应用并记录其 APPID。参见 查找 APPID。
  2. Generate an RSA2 key pair as the Alipay documentation describes. 会得到 appPrivateKey.txt 和 appPublicKey.txt。
  3. 在支付宝应用中上传应用证书并下载三个文件:alipayRootCert.crt、appCertPublicKey.crt 和 alipayCertPublicKey.crt。
  4. 将支付宝应用的回调 URL 设置为 Casdoor 的回调 URL,即 https://<your-casdoor-host>/callback。参见 重定向 URL 和回调 URL。

在 Casdoor 中存储证书​

在 Casdoor 管理控制台中,打开 Certs 页面并添加两个证书。

应用证书:

Casdoor fieldValue
Typex509
CertificateappCertPublicKey.crt 的内容
Private keyappPrivateKey.txt 的内容

根证书:

字段值
项目类型或类别x509
证书alipayCertPublicKey.crt 的内容
私钥alipayRootCert.crt 的内容

在 Casdoor 中添加提供商​

  1. 转到 Identity > Providers 并添加一个提供商。
  2. 将 Category 设置为 OAuth,将 Type 设置为 Alipay。
  3. 输入 APPID 作为 Client ID,并选择您创建的应用证书和根证书。
  4. 保存提供商.

用户 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 中均设置正确。

另请参阅​