.NET 项目集成 OAuth2 登录最全面的、最方便的框架
MrHuo.OAuth
是 .NET 项目集成 OAuth2 登录最全面的、最方便的框架
.NET Core 项目或 .NET Framework 4.6 项目均可使用
体验网址:https://oauthlogin.net/
已支持平台
- [x] 百度(可用)
- [x] 微信公众号(可用)
- [x] Gitlab(可用)
- [x] Gitee(可用)
- [x] Github(可用)
- [x] 华为(可用)
- [x] Coding.net(可用)
- [x] 新浪微博(可用)
- [x] 支付宝(可用)
- [x] OSChina(可用)
- [x] 迅雷(可用)
- [x] 钉钉内登录(可用)
- [x] 钉钉扫码登录(可用)
- [x] QQ(可用)
- [x] 微软(可用)
- [x] 小米(可用)
- [x] StackOverflow(可用)
- [x] Facebook(可用) by Donma Hsu
- [x] Google(可用)
- [x] LinkedIn(可用,待发布 nuget)
- [x] 抖音(可用,待发布 nuget) by feng lui
- [x] 快手(可用,待发布 nuget) by feng lui
- [ ] 微信开放平台(待测试)
- [ ] 美团(待测试)
计划
- 飞书
- 淘宝
- 西瓜
- 今日头条
- 人人网
- Teambition
- 企业微信二维码登录
- 企业微信网页登录
- 酷家乐
- 饿了么
- 京东
- 阿里云
- 喜马拉雅...
使用方法
新建项目web项目,安装
nuget
包即可使用。
现可用的 nuget
包列表如下:https://www.nuget.org/packages\?q=MrHuo.OAuth
Gitlab
Install-Package MrHuo.OAuth.Gitlab -Version 1.1.1
微信公众号
Install-Package MrHuo.OAuth.Wechat -Version 1.1.1
oschina.net
Install-Package MrHuo.OAuth.OSChina -Version 1.1.1
coding.net
Install-Package MrHuo.OAuth.Coding -Version 1.1.1
github.com
Install-Package MrHuo.OAuth.Github -Version 1.1.1
alipay.com
Install-Package MrHuo.OAuth.Alipay -Version 1.1.1
baidu.com
Install-Package MrHuo.OAuth.Baidu -Version 1.1.1
huawei.com
Install-Package MrHuo.OAuth.Huawei -Version 1.1.1
gitee.com
Install-Package MrHuo.OAuth.Gitee -Version 1.1.1
weibo.com
Install-Package MrHuo.OAuth.SinaWeibo -Version 1.1.1
xunlei.com
Install-Package MrHuo.OAuth.XunLei -Version 1.1.1
qq.com
Install-Package MrHuo.OAuth.QQ -Version 1.1.1
microsoft.com
Install-Package MrHuo.OAuth.Microsoft -Version 1.1.1
mi.com
Install-Package MrHuo.OAuth.Mi -Version 1.1.1
stackoverflow.com
Install-Package MrHuo.OAuth.StackOverflow -Version 1.1.1
facebook.com
Install-Package MrHuo.OAuth.Facebook -Version 1.1.1
google.com
Install-Package MrHuo.OAuth.Google -Version 1.0.0
1、Startup.cs
public void ConfigureServices(IServiceCollection services) { //将第三方登录组件注入进去 services.AddSingleton(new Baidu.BaiduOAuth(OAuthConfig.LoadFrom(Configuration, "oauth:baidu"))); services.AddSingleton(new Wechat.WechatOAuth(OAuthConfig.LoadFrom(Configuration, "oauth:wechat"))); services.AddSingleton(new Gitlab.GitlabOAuth(OAuthConfig.LoadFrom(Configuration, "oauth:gitlab"))); services.AddSingleton(new Gitee.GiteeOAuth(OAuthConfig.LoadFrom(Configuration, "oauth:gitee"))); //... 其他登录方式 }
注意:如果用 appsettings.json
方式引入,提供了一个快捷方法从配置中加载。
OAuthConfig.LoadFrom(Configuration, "oauth:baidu")
"oauth:baidu"
这部分是配置前缀,配置格式如下:
{ "oauth": { "qq": { "app_id": "qq_app_id", "app_key": "qq_app_key", "redirect_uri": "https://oauthlogin.net/oauth/qqcallback", "scope": "get_user_info" }, "github": { "app_id": "github_app_id", "app_key": "github_app_key", "redirect_uri": "https://oauthlogin.net/oauth/githubcallback", "scope": "repo" }, "wechat": { "app_id": "wechat_app_id", "app_key": "wechat_app_key", "redirect_uri": "https://oauthlogin.net/oauth/wechatcallback", "scope": "snsapi_userinfo" }, "huawei": { "app_id": "huawei_app_id", "app_key": "huawei_app_key", "redirect_uri": "https://oauthlogin.net/oauth/huaweicallback", "scope": "https://www.huawei.com/auth/account" }, "gitee": { "app_id": "gitee_app_id", "app_key": "gitee_app_key", "redirect_uri": "http://oauthlogin.net/oauth/giteecallback", "scope": "user_info" }, "baidu": { "app_id": "baidu_app_id", "app_key": "baidu_app_key", "redirect_uri": "http://oauthlogin.net/oauth/baiducallback", "scope": "basic" }, "alipay": { "app_id": "alipay_app_id", "app_key": "alipay_app_key", "redirect_uri": "https://oauthlogin.net/oauth/alipaycallback", "scope": "auth_user", "private_key": "private_key", "public_key": "public_key" }, "gitlab": { "app_id": "gitlab_app_id", "app_key": "gitlab_app_key", "redirect_uri": "http://oauthlogin.net/oauth/gitlabcallback", "scope": "read_user" } } }
2、OAuthController.cs
根据实际需要自行命名
public class OAuthController : Controller { [HttpGet("oauth/{type}")] public IActionResult Index( string type, [FromServices] BaiduOAuth baiduOAuth, [FromServices] WechatOAuth wechatOAuth ) { var redirectUrl = ""; switch (type.ToLower()) { case "baidu": { redirectUrl = baiduOAuth.GetAuthorizeUrl(); break; } case "wechat": { redirectUrl = wechatOAuth.GetAuthorizeUrl(); break; } default: return ReturnToError($"没有实现【{type}】登录方式!"); } return Redirect(redirectUrl); } [HttpGet("oauth/{type}callback")] public async TaskLoginCallback( string type, [FromServices] BaiduOAuth baiduOAuth, [FromServices] WechatOAuth wechatOAuth, [FromQuery] string code, [FromQuery] string state) { try { switch (type.ToLower()) { case "baidu": { var authorizeResult = await baiduOAuth.AuthorizeCallback(code, state); if (!authorizeResult.IsSccess) { throw new Exception(authorizeResult.ErrorMessage); } return Json(authorizeResult); } case "wechat": { var authorizeResult = await wechatOAuth.AuthorizeCallback(code, state); if (!authorizeResult.IsSccess) { throw new Exception(authorizeResult.ErrorMessage); } return Json(authorizeResult); } default: throw new Exception($"没有实现【{type}】登录回调!"); } } catch (Exception ex) { return Content(ex.Message); } } }
3、Views
"/oauth/baidu">Baidu 登录 "/oauth/wechat">Wechat 扫码登录
扩展
扩展其他平台非常容易,拿 Gitee
平台的代码来说:https://github.com/mrhuo/MrHuo.OAuth/tree/main/MrHuo.OAuth.Gitee[6]
第一步:找平台对应 OAuth 文档,找到获取用户信息接口返回JSON,转换为 C# 实体类。如下:
根据自己需要和接口标准,扩展用户属性
public class GiteeUserModel : IUserInfoModel { [JsonPropertyName("name")] public string Name { get; set; } [JsonPropertyName("avatar_url")] public string Avatar { get; set; } [JsonPropertyName("message")] public string ErrorMessage { get; set; } [JsonPropertyName("email")] public string Email { get; set; } [JsonPropertyName("blog")] public string Blog { get; set; } //...其他属性类似如上 }
第二步:写对应平台的授权接口
////// https://gitee.com/api/v5/oauth_doc#/ /// public class GiteeOAuth : OAuthLoginBase { public GiteeOAuth(OAuthConfig oauthConfig) : base(oauthConfig) { } protected override string AuthorizeUrl => "https://gitee.com/oauth/authorize"; protected override string AccessTokenUrl => "https://gitee.com/oauth/token"; protected override string UserInfoUrl => "https://gitee.com/api/v5/user"; }
加上注释,总共十行,如你所见,非常方便。如果该平台协议遵循 OAuth2 标准开发,那么就这么几行就好了。就连修改字段的微信登录实现,也不过复杂,只需要定义基本参数就OK。
代码如下:
////// Wechat OAuth 相关文档参考: /// https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html /// public class WechatOAuth : OAuthLoginBase { public WechatOAuth(OAuthConfig oauthConfig) : base(oauthConfig) { } protected override string AuthorizeUrl => "https://open.weixin.qq.com/connect/oauth2/authorize"; protected override string AccessTokenUrl => "https://api.weixin.qq.com/sns/oauth2/access_token"; protected override string UserInfoUrl => "https://api.weixin.qq.com/sns/userinfo"; protected override Dictionary<string, string> BuildAuthorizeParams(string state) { return new Dictionary<string, string>() { ["response_type"] = "code", ["appid"] = oauthConfig.AppId, ["redirect_uri"] = System.Web.HttpUtility.UrlEncode(oauthConfig.RedirectUri), ["scope"] = oauthConfig.Scope, ["state"] = state }; } public override string GetAuthorizeUrl(string state = "") { return $"{base.GetAuthorizeUrl(state)}#wechat_redirect"; } protected override Dictionary<string, string> BuildGetAccessTokenParams(Dictionary<string, string> authorizeCallbackParams) { return new Dictionary<string, string>() { ["grant_type"] = "authorization_code", ["appid"] = $"{oauthConfig.AppId}", ["secret"] = $"{oauthConfig.AppKey}", ["code"] = $"{authorizeCallbackParams["code"]}" }; } protected override Dictionary<string, string> BuildGetUserInfoParams(WechatAccessTokenModel accessTokenModel) { return new Dictionary<string, string>() { ["access_token"] = accessTokenModel.AccessToken, ["openid"] = accessTokenModel.OpenId, ["lang"] = "zh_CN", }; } }
特别贡献
- Carl
- Donma Hsu
- feng lui
为了能让各位朋友能顺利的使用各种平台登录组件,先急求各种平台的 APPID 做测试,有这方面资源的朋友联系我。提供测试的朋友,可以永久出现在项目首页特别贡献列表里,可带链接。邮件:admin@mrhuo.com 备注:OAuth Appid
Contribution
1、欢迎参与开发,贡献其他未完成平台代码。
2、欢迎在 issue 里提交需求平台,带上平台链接地址,我们将加入到计划之中。
3、欢迎提交各种建议,文明交流。
License
Apache-2.0 License
项目地址
- 框架名:
MrHuo.OAuth
- 作者:mrhuo
- Github:https://github.com/mrhuo/MrHuo.OAuth