# CollectiveOAuth

**Repository Path**: neoayi/CollectiveOAuth

## Basic Information

- **Project Name**: CollectiveOAuth
- **Description**: .Net平台 史上最全的整合第三方登录的开源库。目前已支持Github、Gitee、钉钉、百度、支付宝、微信、企业微信、等第三方平台的授权登录。
以下平台正在接入中: 微博、Coding、腾讯云开发者平台、OSChina、QQ、淘宝、Google、Facebook、抖音、领英、小米、微软、今日头条、Teambition、StackOverflow、Pinterest、人人、华为、酷家乐、Gitlab、美团、饿了么和推特
- **Primary Language**: C#
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 312
- **Created**: 2020-01-28
- **Last Updated**: 2020-12-19

## 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>

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

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

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

项目开源地址：[gitee](https://gitee.com/rthinking/CollectiveOAuth) 
项目文档：[参考文档(暂未开放)]

## 特点

废话不多说，就俩字：

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

## 快速开始

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

- 配置授权信息(默认配置在webconfig中, 可以改造存储数据库或者其它任意地方)
```C#
<!--Demo: 微信服务号授权配置-->
<add key="CollectiveOAuth_WECHAT_MP_ClientId" value="wxer6785660834656" />
<add key="CollectiveOAuth_WECHAT_MP_ClientSecret" value="98967867678678678546434345344" />
<add key="CollectiveOAuth_WECHAT_MP_Scope" value="snsapi_userinfo" />
<add key="CollectiveOAuth_WECHAT_MP_RedirectUri" value="https://yours.domain.com/oauth2/callback?authSource=WECHAT_MP" />
```

- 调用api
```C#
// 创建授权request
var clientConfig = new ClientConfig();
clientConfig.clientId = AppSettingUtils.GetStrValue($"CollectiveOAuth_XXXXXX_ClientId");
clientConfig.clientSecret = AppSettingUtils.GetStrValue($"CollectiveOAuth_XXXXXX_ClientSecret");
clientConfig.redirectUri = AppSettingUtils.GetStrValue($"CollectiveOAuth_XXXXXX_RedirectUri");
clientConfig.scope = AppSettingUtils.GetStrValue($"CollectiveOAuth_XXXXXX_Scope");

AuthRequest authRequest = new GiteeAuthRequest(clientConfig);
// 生成授权页面
authRequest.authorize("state");
// 授权登录后会返回code（auth_code（仅限支付宝））、state，可以用AuthCallback类作为回调接口的参数
// 注：CollectiveOAuth默认保存state的时效为5分钟，5分钟内未使用则会自动清除过期的state
authRequest.login(callback);
```

#### API列表
|  :computer: 平台  |  :coffee: API类  |  :page_facing_up: SDK  |
|:------:|:-------:|:-------:|
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/gitee.png" width="20">  |  [GiteeAuthSource](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] |  <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] |  <a href="https://open.coding.net/references/oauth/" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/tencentCloud.png" width="25">  |  [AuthTencentCloudRequest] |  <a href="https://dev.tencent.com/help/doc/faq/b4e5b7aee786/oauth" target="_blank">参考文档</a> |
|  <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/oschina.png" width="20">  |  [OschinaAuthRequest] |  <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">  |  [AuthQqRequest]  |  <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] |  <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]  |  <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]  |  <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]  |  <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]  |  <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]  | <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] | <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] | <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] | <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] | <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] | <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] | <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] | <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]  |  <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] |  <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]  |  <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]  |  <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的授权开放平台已经下线。如果以前申请过的应用，可以继续使用，但是不再支持申请新的应用。

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

另外，期待.Net大牛和我一起完善这个项目！

## 贡献代码

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

## 致谢

在项目立项初期，也对当前开源圈的一些相同类型的项目作过调研，同时本项目也参考过这些项目，再次感谢开源圈内的朋友。

- [JustAuth](https://gitee.com/yadong.zhang/JustAuth): Java 第三方登录授权 SDK
- [YurunOAuthLogin](https://gitee.com/yurunsoft/YurunOAuthLogin): PHP 第三方登录授权 SDK
- [阿里妈妈MUX倾力打造的矢量图标库-iconfont](https://www.iconfont.cn/search/index): 本文档中的图标大部分取自该平台
- 感谢 JetBrains 提供的免费开源 License：
<img src="https://images.gitee.com/uploads/images/2020/0128/143027_d7ce1ac2_696459.png" alt="图片引用自lets-mica" style="float:left;">


## 关于OAuth

- [The OAuth 2.0 Authorization Framework](https://tools.ietf.org/html/rfc6749)
- [OAuth 2.0](https://oauth.net/2/)

## 关注&交流

|  公众号  |  QQ群  |
| :------------: | :------------: |
| <img src="https://gitee.com/rthinking/auth_files/raw/master/wx/wechat_account.jpg" width="200" /> | <img src="https://gitee.com/rthinking/auth_files/raw/master/CollectiveOAuth/qq-group.png" width="170"/> |

 **QQ群** 

- CollectiveOAuth交流群 （836803890）：专业交流该项目

## 请喝咖啡

| 支付宝  | 微信  |
| :------------: | :------------: |
| <img src="https://gitee.com/rthinking/auth_files/raw/master/qrcode/zfb_code.png" width="200"/> | <img src="https://gitee.com/rthinking/auth_files/raw/master/qrcode/wx_code.png" width="200" /> |

开源不求盈利，多少都是心意，生活不易，随缘随缘……