Tai.Account.Extension.HttpApi 1.0.5

Tai.Account.Extension

ABP 可复用模块，为 OpenIddict 提供微信登录与短信验证码登录的扩展 Grant 类型。

特性

• 微信 PC 扫码登录 (wechat_pc_qr) — 微信开放平台网站应用扫码登录
• 微信公众号 OAuth 登录 (wechat_mp_oauth) — 公众号内 H5 网页授权登录
• 微信小程序登录 (wechat_mini_program) — 小程序 wx.login 获取 code 登录
• 微信公众号扫码事件登录 (wechat_mp_qr_event) — 公众号带参数二维码扫码/关注事件登录
• 手机短信验证码登录 (phone_sms_code) — 通过 ABP ISmsSender 发送验证码登录（服务商无关）
• 手机短信验证码找回密码 — 复用 ABP 默认 /api/account/reset-password，改用手机验证码颁发 reset token
• 可配置的自动注册策略 — 未知微信 openid / 未注册手机号在登录时是否自动创建用户，默认关闭
• 多微信应用 UnionId 打通
• 验证码频率限制与过期控制

项目结构

src/
├── Tai.Account.Extension.Domain.Shared       # 常量、Grant 类型名称、本地化
├── Tai.Account.Extension.Domain              # 微信 API 客户端、短信服务、Setting 定义
├── Tai.Account.Extension.Application.Contracts # 应用服务接口与 DTO
├── Tai.Account.Extension.Application          # 应用服务实现、ExtensionGrant 处理器
├── Tai.Account.Extension.HttpApi              # API 控制器
└── Tai.Account.Extension.HttpApi.Client       # C# HTTP 客户端代理
test/
├── Tai.Account.Extension.TestBase
├── Tai.Account.Extension.Domain.Tests
└── Tai.Account.Extension.Application.Tests

快速开始

1. 安装模块

将以下项目引用添加到宿主应用的对应层：

dotnet add package Tai.Account.Extension.Application

dotnet add package Tai.Account.Extension.HttpApi
# 仅需要客户端代理时
dotnet add package Tai.Account.Extension.HttpApi.Client

在宿主模块中添加 DependsOn：

[DependsOn(typeof(AccountExtensionApplicationModule))]
[DependsOn(typeof(AccountExtensionHttpApiModule))]
public class YourHostModule : AbpModule { }

2. 配置 Settings

通过 ABP Setting 系统（appsettings.json、数据库或 Setting Management UI）配置以下项：

微信配置：

短信配置：

本模块不绑定具体短信服务商，依赖宿主注册的 Volo.Abp.Sms.ISmsSender 实现完成真实发送。发送时会向 SmsMessage.Properties 写入 TemplateCode 与 TemplateParam（JSON 字符串），由具体 ISmsSender 实现读取使用；SignName、AccessKey 等服务商凭据由该实现自行管理，不在本模块职责之内。

自动注册配置：

默认行为（安全优先）：当以上两个开关为 false 时，未注册用户无法通过相应渠道登录， 颁发 Token 会返回 OpenIddict 标准错误 invalid_grant，error_description 分别为 AccountExtension:PhoneNotRegistered / AccountExtension:ExternalLoginNotRegistered。 前端可据此引导用户走标准注册流程。

3. 注册 OpenIddict 允许的 Grant Type

在宿主的 OpenIddict 配置中，确保允许自定义 Grant Type（模块已自动注册，无需额外配置）。

如需限定特定客户端可用的 Grant Type，在 OpenIddict 客户端种子数据中添加：

await CreateClientAsync(
    "your-client-id",
    grantTypes: new[]
    {
        OpenIddictConstants.GrantTypes.Password,
        OpenIddictConstants.GrantTypes.RefreshToken,
        "wechat_pc_qr",
        "wechat_mp_oauth",
        "wechat_mini_program",
        "wechat_mp_qr_event",
        "phone_sms_code"
    }
);

前端集成

短信验证码登录

# 1. 发送验证码
POST /api/account-extension/sms/send-code
{ "phoneNumber": "13800138000" }

# 2. 请求 Token
POST /connect/token
Content-Type: application/x-www-form-urlencoded

grant_type=phone_sms_code
&client_id=your-client-id
&phone_number=13800138000
&code=123456
&scope=openid offline_access

手机短信验证码找回密码

# 1. 发送找回密码验证码（/会校验手机号是否已注册）
POST /api/account-extension/password-reset/send-sms-code
{ "phoneNumber": "13800138000" }

# 2. 验证验证码，换取 ABP 密码重置 token
POST /api/account-extension/password-reset/verify-sms-code
{ "phoneNumber": "13800138000", "code": "123456" }
→ { "userId": "xxx", "resetToken": "xxx" }

# 3. 调用 ABP 默认端点完成密码重置（未做任何改动）
POST /api/account/reset-password
{ "userId": "xxx", "resetToken": "xxx", "password": "NewPass@123" }

说明：短信验证码仅用于换取一次性 resetToken，真正的密码重置仍由 ABP IdentityUserManager.ResetPasswordAsync 执行，token 具备密码学签名与有效期。

微信小程序登录

POST /connect/token
Content-Type: application/x-www-form-urlencoded

grant_type=wechat_mini_program
&client_id=your-client-id
&code=wx.login()返回的code
&scope=openid offline_access

微信 PC 扫码登录

POST /connect/token
Content-Type: application/x-www-form-urlencoded

grant_type=wechat_pc_qr
&client_id=your-client-id
&code=微信回调返回的code
&scope=openid offline_access

微信公众号 OAuth 登录

POST /connect/token
Content-Type: application/x-www-form-urlencoded

grant_type=wechat_mp_oauth
&client_id=your-client-id
&code=网页授权回调的code
&scope=openid offline_access

微信公众号扫码事件登录

# 1. 获取带参数二维码
POST /api/account-extension/wechat/qr-login

# 2. 轮询扫码结果
GET /api/account-extension/wechat/qr-poll?sceneId=xxx

# 3. 扫码成功后请求 Token
POST /connect/token
Content-Type: application/x-www-form-urlencoded

grant_type=wechat_mp_qr_event
&client_id=your-client-id
&scene_id=xxx
&scope=openid offline_access

微信事件回调：需将 GET/POST /api/account-extension/wechat/mp-event 配置为公众号的服务器 URL。

技术栈

• .NET 10 / ABP 10.3
• OpenIddict Extension Grants
• ABP Volo.Abp.Sms.ISmsSender（服务商无关，短信发送由宿主注册的实现负责）
• ABP Distributed Cache（验证码 & 扫码事件状态）

Roadmap

• 微信 UnionId 多应用账号合并策略优化
• 手机号一键登录（运营商本机号校验）
• 登录日志与审计事件
• 微信公众号模板消息通知

Nuget

dotnet pack Tai.Account.Extension.slnx --configuration Release --output nupkgs 

dotnet nuget push "nupkgs/*.nupkg" --api-key YOUR_API_KEY --source https://api.nuget.org/v3/index.json --skip-duplicate
```bash

## License

MIT