1 changed files with 99 additions and 0 deletions
@ -0,0 +1,99 @@ |
|||||
|
# LINGYUN.Abp.Authentication 认证模块 |
||||
|
|
||||
|
本模块提供第三方社交登录认证功能,目前支持 QQ 和微信公众号登录,并与 ABP 身份系统深度集成。 |
||||
|
|
||||
|
## 模块概述 |
||||
|
|
||||
|
认证模块包含两个主要子模块: |
||||
|
|
||||
|
1. **QQ 互联认证模块** |
||||
|
|
||||
|
- 支持 QQ OAuth2.0 认证 |
||||
|
- 适用于移动端和 PC 端登录 |
||||
|
- 获取用户基本信息(昵称、性别、头像等) |
||||
|
|
||||
|
2. **微信公众号认证模块** |
||||
|
- 支持微信公众号 OAuth2.0 认证 |
||||
|
- 获取用户详细信息(昵称、性别、地区、头像等) |
||||
|
- 支持 UnionId 机制,打通公众号与小程序账号体系 |
||||
|
|
||||
|
## 功能特性 |
||||
|
|
||||
|
- 第三方社交账号登录 |
||||
|
- 获取用户基本信息 |
||||
|
- 与 ABP 身份系统无缝集成 |
||||
|
- 灵活的配置选项 |
||||
|
- 支持多种登录场景(移动端、PC 端) |
||||
|
|
||||
|
## 快速开始 |
||||
|
|
||||
|
### 模块引用 |
||||
|
|
||||
|
```csharp |
||||
|
[DependsOn( |
||||
|
typeof(AbpAuthenticationQQModule), |
||||
|
typeof(AbpAuthenticationWeChatModule) |
||||
|
)] |
||||
|
public class YourProjectModule : AbpModule |
||||
|
{ |
||||
|
// 其他配置 |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
### 配置示例 |
||||
|
|
||||
|
在 `appsettings.json` 中配置第三方登录参数: |
||||
|
|
||||
|
```json |
||||
|
{ |
||||
|
"Authentication": { |
||||
|
"QQ": { |
||||
|
"AppId": "你的QQ互联AppId", |
||||
|
"AppKey": "你的QQ互联AppKey" |
||||
|
}, |
||||
|
"WeChat": { |
||||
|
"AppId": "你的微信公众号AppId", |
||||
|
"AppSecret": "你的微信公众号AppSecret" |
||||
|
} |
||||
|
} |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
### 添加登录支持 |
||||
|
|
||||
|
```csharp |
||||
|
public override void ConfigureServices(ServiceConfigurationContext context) |
||||
|
{ |
||||
|
context.Services.AddAuthentication() |
||||
|
.AddQQConnect() // 添加QQ登录 |
||||
|
.AddWeChat(); // 添加微信登录 |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
## 支持的用户信息 |
||||
|
|
||||
|
### QQ 登录获取信息 |
||||
|
|
||||
|
- OpenId - QQ 用户唯一标识 |
||||
|
- NickName - 用户昵称 |
||||
|
- Gender - 用户性别 |
||||
|
- AvatarUrl - 用户头像 URL |
||||
|
|
||||
|
### 微信登录获取信息 |
||||
|
|
||||
|
- OpenId - 微信用户唯一标识 |
||||
|
- UnionId - 微信开放平台唯一标识 |
||||
|
- NickName - 用户昵称 |
||||
|
- Sex - 用户性别 |
||||
|
- Country, Province, City - 地理信息 |
||||
|
- AvatarUrl - 用户头像 URL |
||||
|
|
||||
|
## 参考文档 |
||||
|
|
||||
|
- [QQ 互联文档](https://wiki.connect.qq.com/) |
||||
|
- [微信公众平台开发文档](https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Overview.html) |
||||
|
- [ABP 认证文档](https://docs.abp.io/en/abp/latest/Authentication) |
||||
|
|
||||
|
## 许可证 |
||||
|
|
||||
|
遵循项目的开源许可证 |
||||
Loading…
Reference in new issue