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