OAuth2.0授权验证-gitee授权码模式

本文主要介绍如何笔者自己是如何使用gitee提供的OAuth2.0协议完成授权验证并登录到自己的系统，完整模式如图

1、创建应用

打开gitee个人中心->第三方应用->创建应用

创建应用后在我的应用界面，查看已创建应用的Client ID和Client Secret

2、对接

如何对接呢？gitee提供了开放文档，打开任意一个gitee页面，到页脚部分，找到OpenAPI，这里就是gitee提供的开放文档了，下面开始根据文档进行对接

• 1、回调地址

根据协议，我们必须设置一个回调地址，来接收认证中心反馈给我们的信息，由于我是使用了vue+.net前后端分离的架构。所以需要再vue项目中创建一个页面，配置路由，并放开访问权限,这个页面的主要作用是为了让用户感知授权过程、授权成功后，回调页面会接收到state和code并转发给callback接口，页面显示授权成功，并随后关闭页面

{
    path: "/oauth-callback",
    name: "Callback",
    component: () => import("@/views/login/Callback.vue"),
    meta: {
      title: "认证中心回调页面",
      showLink: false,
      rank: 101
    }
  }

• 2、callback接口

接收由步骤1传递过来的参数，并根据规则解析state，根据code参数，调用官方提供的api获取token，当拿到token后，就可以调用其他api了,也可以对token进行保存等其他操作。

var giteeTokenResult = await "https://gitee.com/oauth/token"
    .SetQueryParams(new { grant_type = "authorization_code", code = input.Code, client_id = authorizationCenter.ClientId, redirect_uri = authorizationCenter.RedirectUri, client_secret = authorizationCenter.ClientSecret })
    .PostAsync()
    .ReceiveJson<GiteeTokenResult>();

我们这里调用了获取用户信息的接口,根据反馈的用户信息，去后面的逻辑

oAuth2UserInfo = await "https://gitee.com/api/v5/user"
    .WithHeader("User-Agent", "purest-admin")
    .SetQueryParams(new { access_token = giteeTokenResult.AccessToken })
    .GetJsonAsync<OAuth2UserInfo>();
oAuth2UserInfo.Type = OAuth2TypeConst.GITEE;

• 3 用户注册以及绑定

当检测到系统中存在此认证用户后，检查是否有绑定本项目的用户，如果有直接返回token。登录到首页，如果没有则去绑定或注册

  var oAuth2User = await _oAuth2UserManager.GetOAuth2UserPersistenceIdAsync(oAuth2UserInfo);
  if (oAuth2User.UserId.HasValue)
  {
      var (accessToken, userInfo) = await GetTokenAndUserInfoAsync(oAuth2User.UserId.Value);
      await _hubContext.Clients.Client(stateInfo.ConnectionId).NoticeRedirect(accessToken, userInfo);
  }
  else
      await _hubContext.Clients.Client(stateInfo.ConnectionId).NoticeRegister(oAuth2User.PersistenceId);

3、测试

4、总结

gitee接入没遇到什么特别的问题，按部就班就完成了。接口如果调用异常，基本都是因为访问权限的问题，酌情处理吧

最后附上项目地址，如果您觉得还行，麻烦给个star吧。您的鼓励是我坚持更新的动力！

gitee：https://gitee.com/dymproject/purest-admin

github： https://github.com/dymproject/purest-admin