# CollectiveOAuth

**Repository Path**: izory/CollectiveOAuth

## Basic Information

- **Project Name**: CollectiveOAuth
- **Description**: .Net平台(C#) 史上最全的整合第三方登录的开源库 => 环境支持 .NET Framework 4.5 ~ 4.6.2 和 .N。目前已包含Github、Gitee、钉钉、百度、支付宝、微信、企业微信、腾讯云开发者平台(Coding)、OSChina、微博、QQ、Google、Facebook、等第三方平台的授权登录
- **Primary Language**: C#
- **License**: AGPL-3.0
- **Default Branch**: net7.0
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 23
- **Forks**: 309
- **Created**: 2022-06-21
- **Last Updated**: 2025-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
	<a href="#"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/logo.png" width="400"></a>
</p>
<p align="center">
	<strong>Login-OAuth2, so easy.</strong>
</p>
<p align="center">
	<a target="_blank" href="https://gitee.com/rthinking/CollectiveOAuth/blob/master/LICENSE">
		<img src="https://img.shields.io/apm/l/vim-mode.svg?color=yellow" ></img>
	</a>
	<a>
		<img src="https://img.shields.io/badge/Api Docs-1.13.2-orange.svg" ></img>
	</a>
	<a>
		<img src="https://img.shields.io/badge/Docs-latest-blueviolet.svg" ></img>
	</a>
	<a href='https://gitee.com/rthinking/CollectiveOAuth/stargazers'>
	  <img src='https://gitee.com/rthinking/CollectiveOAuth/badge/star.svg?theme=white' alt='star'></img>
	</a>
</p>

<center>
    <table>
        <tr>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/gitee.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/github.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/weibo.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/dingtalk.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/baidu.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/coding.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/tencentCloud.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/oschina.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/alipay.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/qq.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/wechat.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/taobao.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/google.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/facebook.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/douyin.png" width="20"></td>
        </tr>
    </table>
    <table>
        <tr>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/linkedin.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/microsoft.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/mi.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/toutiao.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/teambition.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/renren.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/pinterest.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/stackoverflow.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/huawei.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/wechat.png" width="20" title="微信企业版"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/csdn.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/kujiale.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/gitlab.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/meituan.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/eleme.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/twitter.png" width="20"></td>
        </tr>
    </table>
    <center><a href="#" target="_blank">查看更多</a></center>
</center>

-------------------------------------------------------------------------------

## 版本更新
- 2023-4-25  现支持 **.Net7.0** 


## 特别感谢
**JustAuth**：这里特别感谢JustAuth开源项目作者提供架构思路

.Net平台下 **CollectiveOAuth**，它仅仅是一个 **第三方授权登录**的**工具类库**，它可以让我们脱离繁琐的第三方登录SDK，让登录变得**So easy!**

- 项目开源地址：[Gitee(https://gitee.com/izory/CollectiveOAuth)](https://gitee.com/izory/CollectiveOAuth) 

- 项目文档：[参考文档(https://codoc.rthinkingsoft.cn)](https://codoc.rthinkingsoft.cn)

## 特点

废话不多说，就俩字：

1. **全**：已集成二十多家第三方平台（国内外常用的基本都已包含），仍然还在持续扩展中!
2. **简**：API就是奔着最简单去设计的（见后面`快速开始`），尽量让您用起来没有障碍感！

## 快速开始

- 引入依赖
<img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/depend-on.jpg" width="600"></img>

- 配置授权信息(默认配置在`appsettings.json`中, 可以改造存储数据库或者其它任意地方)
```C#
<!--Demo: 微信企业扫码授权配置-->
"OAuthConfig": {
	"WECHAT_ENTERPRISE_SCAN": {
		"ClientId": "xxxxxxxxxxxxxxxxx",
		"AgentId": "xxxxxx",
		"ClientSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
		"RedirectUri": "https://yours.domain.com/oauth2/callback?authSource=WECHAT_ENTERPRISE_SCAN"
	}
}
```

- 调用api
```C#
// 创建授权request
var clientConfig = configuration.GetSection("OAuthConfig:GITEE").Get<ClientConfig>();
var state = AuthStateUtils.createState();
var authRequest = new GiteeAuthRequest(clientConfig);
// 生成授权页面
var authorize = authRequest.authorize(state);
//authRequest.login(authCallback);

// 授权登录后会返回code（auth_code（仅限支付宝））、state，可以用AuthCallback类作为回调接口的参数
// 注：CollectiveOAuth默认保存state的时效为5分钟，5分钟内未使用则会自动清除过期的state
```

#### API列表
|  :computer: 平台  |  :coffee: API类  |  :page_facing_up: SDK  |
|:------:|:-------:|:-------:|
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/gitee.png" width="20">  |  [GiteeAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/GiteeAuthRequest.cs)  | <a href="https://gitee.com/api/v5/oauth_doc#list_1" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/github.png" width="20">  |  [GithubAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/GithubAuthRequest.cs)  |  <a href="https://developer.github.com/apps/building-oauth-apps/authorizing-oauth-apps/" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/weibo.png" width="20">  |  [WeiboAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/WeiboAuthRequest.cs) |  <a href="https://open.weibo.com/wiki/%E6%8E%88%E6%9D%83%E6%9C%BA%E5%88%B6%E8%AF%B4%E6%98%8E" target="_blank">参考文档</a>  |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/dingtalk.png" width="20">  |  [DingTalkScanAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/DingTalkScanAuthRequest.cs)  |  <a href="https://open-doc.dingtalk.com/microapp/serverapi2/kymkv6" target="_blank">参考文档</a>  |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/baidu.png" width="20">  |  [BaiduAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/BaiduAuthRequest.cs)  |  <a href="http://developer.baidu.com/wiki/index.php?title=docs/oauth" target="_blank">参考文档</a>  |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/coding.png" width="25">  |  [CodingAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/CodingAuthRequest.cs) |  <a href="https://open.coding.net/references/oauth/" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/oschina.png" width="20">  |  [OschinaAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/OschinaAuthRequest.cs) |  <a href="https://www.oschina.net/openapi/docs/oauth2_authorize" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/alipay.png" width="20">  |  [AlipayMPAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/AlipayMpAuthRequest.cs)  |  <a href="https://alipay.open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.336d4b70GUKXOl&treeId=193&articleId=105809&docType=1" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/qq.png" width="20">  |  [QQAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/QQAuthRequest.cs)  |  <a href="https://wiki.connect.qq.com/%E4%BD%BF%E7%94%A8authorization_code%E8%8E%B7%E5%8F%96access_token" target="_blank">参考文档</a>  |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/wechat.png" width="20" title="微信开放平台">  |  [WeChatOpenAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/WeChatOpenAuthRequest.cs) |  <a href="https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419316505&token=&lang=zh_CN" target="_blank">参考文档</a>  |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/wechat.png" width="20" title="微信公众平台"> | [WeChatMPAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/WeChatMpAuthRequest.cs) | <a href="https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/wechat.png" width="20" title="企业微信">  | [WeChatEnterpriseAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/WeChatEnterpriseAuthRequest.cs) | <a href="https://open.work.weixin.qq.com/api/doc#90000/90135/90664" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/wechat.png" width="20" title="企业微信扫码">  | [WeChatEnterpriseScanAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/WeChatEnterpriseScanAuthRequest.cs) | <a href="https://open.work.weixin.qq.com/api/doc#90000/90135/90664" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/taobao.png" width="20">  |  [TaobaoAuthRequest]  |  <a href="https://open.taobao.com/doc.htm?spm=a219a.7386797.0.0.4e00669acnkQy6&source=search&docId=105590&docType=1" target="_blank">参考文档</a>  |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/google.png" width="20">  |  [GoogleAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/GoogleAuthRequest.cs)  |  <a href="https://developers.google.com/identity/protocols/OpenIDConnect" target="_blank">参考文档</a>  |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/facebook.png" width="20">  |  [FacebookAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/FackbookAuthRequest.cs)  |  <a href="https://developers.facebook.com/docs/facebook-login/manually-build-a-login-flow" target="_blank">参考文档</a>  |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/douyin.png" width="20">  |  [DouYinAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/DouYinAuthRequest.cs)  |  <a href="https://www.douyin.com/platform/doc/m-2-1-1" target="_blank">参考文档</a>  |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/linkedin.png" width="20">  |  [LinkedInAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/LinkedinAuthRequest.cs)  |  <a href="https://docs.microsoft.com/zh-cn/linkedin/shared/authentication/authorization-code-flow?context=linkedin/context" target="_blank">参考文档</a>  |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/microsoft.png" width="20">  | [MicrosoftAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/MicrosoftAuthRequest.cs)  | <a href="https://docs.microsoft.com/zh-cn/graph/auth/" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/mi.png" width="20">  | [XiaoMiAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/XiaoMiAuthRequest.cs) | <a href="https://dev.mi.com/console/doc/detail?pId=711" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/toutiao.png" width="20">  | [ToutiaoAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/ToutiaoAuthRequest.cs) | <a href="https://open.mp.toutiao.com/#/resource?_k=y7mfgk" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/teambition.png" width="20">  | [TeambitionAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/TeambitionAuthRequest.cs) | <a href="https://docs.teambition.com/" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/renren.png" width="20">  | [RenrenAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/RenrenAuthRequest.cs) | <a href="http://open.renren.com/wiki/OAuth2.0" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/pinterest.png" width="20">  | [PinterestAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/PinterestAuthRequest.cs) | <a href="https://developers.pinterest.com/docs/api/overview/?" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/stackoverflow.png" width="20">  | [StackOverflowAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/StackOverflowAuthRequest.cs) | <a href="https://api.stackexchange.com/docs/authentication" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/huawei.png" width="20">  | [HuaweiAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/HuaweiAuthRequest.cs) | <a href="https://developer.huawei.com/consumer/cn/devservice/doc/30101" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/kujiale.png" width="20">  |  [KujialeAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/KujialeAuthRequest.cs)  |  <a href="https://open.kujiale.com/open/apps/2/docs?doc_id=95" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/gitlab.png" width="20">  |  [GitlabAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/GitlabAuthRequest.cs) |  <a href="https://docs.gitlab.com/ee/api/oauth2.html" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/meituan.png" width="20">  |  [MeituanAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/MeituanAuthRequest.cs)  |  <a href="http://open.waimai.meituan.com/openapi_docs/oauth/" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/eleme.png" width="20">  |  [ElemeAuthRequest](https://gitee.com/rthinking/CollectiveOAuth/blob/master/Come.CollectiveOAuth/Request/AuthRequests/ElemeAuthRequest.cs)  |  <a href="https://open.shop.ele.me/openapi/documents/khd001" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/twitter.png" width="20">  |  [TwitterAuthRequest]  |  <a href="https://developer.twitter.com/en/docs/twitter-for-websites/log-in-with-twitter/guides/implementing-sign-in-with-twitter" target="_blank">参考文档</a> |

_请知悉：经咨询CSDN官方客服得知，CSDN的授权开放平台已经下线。如果以前申请过的应用，可以继续使用，但是不再支持申请新的应用。

## 后续开发计划
正在筹备中

另外，期待有兴趣的你和我一起完善和优化这个项目！

## 贡献代码

1. fork本项目到自己的repo
2. 把fork过去的项目也就是你仓库中的项目clone到你的本地
3. 修改代码
4. commit后push到自己的库
5. 发起PR（pull request） 请求，提交到`dev`分支
6. 等待作者合并