跟我一起學.NetCore之熟悉的接口權限驗證不能少(Jwt)


前言

權限管控對於一個系統來說是非常重要的,最熟悉不過的是菜單權限和數據權限,上一節通過Jwt實現了認證,接下來用它實現接口權限的驗證,為什么不是菜單權限呢?對於前后端分離而言,稱其為接口權限感覺比較符合場景(我是這么理解的);數據權限牽涉到具體業務,這里就不說啦!

正文

對於一些比較簡單的系統,訪問角色可能只有固定的幾種,比如一些產品管理系統,通常只有管理員、維護員、用戶三種權限,管理員擁有整個系統的權限,維護員只能訪問產品維護相關頁面和操作,用戶只能訪問產品的一些信息,如果類似這種情況,可以直接指定角色的方式進行權限管控,如下:

案例代碼直接使用上一節的項目,借用上次認證那塊代碼(偷懶太明顯),如果沒看上一篇的小伙伴,去瞅瞅認證那塊內容([跟我一起學.NetCore之WebApi接口裸奔有風險(Jwt)](http://mp.weixin.qq.com/s?__biz=MzU1MzYwMjQ5MQ==&mid=2247484105&idx=1&sn=9322333e9fc39a0a0daf2c4901cf1efd&chksm=fbf11e1dcc86970be6a815b946d43b0f6753f89d3fb6b447b21a1e10373be44cbc59e0ebfe15&scene=21#wechat_redirect)),隨便敲敲代碼,這節要用(別說我,我是有苦衷的,想讓小伙伴多擼代碼~~);如果只是想熟悉知識點,也可以繼續往下看的,不廢話,直接開始:

img

注:[Authorize]加在控制器上時,該控制器下所有的接口都受保護;

為了方便測試,如上圖所示,增加一個產品控制器,針對不同人員模擬了三個接口,因為接口受到保護,只能通過獲取到的Token才能正常訪問,這里就不截圖演示了。Token調用User中的Login接口獲取,詳細請參考(跟我一起學.NetCore之WebApi接口裸奔有風險(Jwt))。哎呀,還是上個生成Token的代碼圖:

img

下面將三個接口指定為不同角色訪問,然后運行訪問如下:

img

img

通過運行測試可知,當增加了對應角色要求之后,盡快Token驗證正確,也不能正常調用接口,返回403禁止訪問。已經為接口指定了角色,那要如何才能正常調用呢?其實只要在生成Token的時候指定對應角色即可正常訪問對應角色的接口,如下代碼優化:

img

img

如上運行所示,在生成Token時指定了角色為Admin,則這個Token只能訪問指定角色為Admin的接口,其他接口是不能訪問的。如需要訪問其他接口,同樣需要在生成Token的時候添加對應的角色,如下:

img

運行效果這里就不截圖演示了,小伙伴們自己試試。

看到這,小伙伴們肯定會問,管理員角色肯定是所有接口都能訪問,拿到了Token接下來該咋辦,每個接口都加管理員角色對應的特性嗎?對於多個角色訪問同一個接口的情況,一般會為授權定義策略來實現,如下:

img

運行效果如下:

img

小注意點:

  • 多個角色或運算:多個角色只要有其中一個就可以訪問;

  • 多個角色且運算:同時得有多個角色才能訪問接口;

    img

到這,相信小伙伴已經忍不住要問:不管是角色還是策略的方式,角色都寫死了,如果角色動態分配權限咋搞? 是的,上面的方式只適合對權限管控比較簡單的項目,絕大數的項目權限肯定是動態分配的,即根據需求,可以針對用戶進行訪問權限配置,所以接下來就說說這塊咋搞。

這次增加的代碼稍微有點多,代碼都有注釋,另外跟着我標注的步驟走,絕對No Problem:

img

img

img

通過以上步驟就完成動態權限的驗證了,是不是很給力,這里需要注意一下幾個點:

  • 后續用到IHttpContextAccessor需要進行注冊;

    img

  • 用戶ID在登錄的時候要放入Payload中,后續權限驗證時要用;

    img

  • API中使用的策略名稱要和定義的一致;

    img

以上案例演示中,在登錄的時候模擬權限數據存入內存,對於一些用戶數據不大的項目,這種方式還不錯,但是對於用戶數量比較大或者分布式部署的項目,建議將權限數據存入Redis等緩存數據庫中,存取統一的同時也能減少對數據庫的訪問壓力,總不能每次請求過來都從數據庫中獲取權限數據進行校驗。

小知識點:

  • 通過獲取用戶時,訪問的接口必須要有Authorize特性,否則只能通過自己解析Token獲取;
  • 如果在統一受保護的控制器中,有個別接口不需要權限驗證,可以為其標注AllowAnonymous特性即可;

校驗權限邏輯的完整代碼如下:

using Microsoft.AspNetCore.Authentication;
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Http;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace SwaggerDemo.Permission
{
    /// <summary>
    /// 權限處理的關鍵類
    /// </summary>
    public class PermissionHandler : AuthorizationHandler<PermissionRequirement>
    {
        /// <summary>
        /// 通過IHttpContextAccessor可以獲取HttpContext相關信息,但一定要注冊服務
        /// </summary>
        private readonly IHttpContextAccessor _accessor;
        /// <summary>
        /// 用於判斷請求是否帶有憑據和是否登錄
        /// </summary>
        public IAuthenticationSchemeProvider Scheme { get; set; }
        /// <summary>
        ///  構造函數注入
        /// </summary>
        public PermissionHandler(IHttpContextAccessor accessor,IAuthenticationSchemeProvider scheme)
        {
            this._accessor = accessor;
            Scheme = scheme;
        }
        protected override async Task HandleRequirementAsync(AuthorizationHandlerContext context, PermissionRequirement requirement)
        {
            try
            {
                //拿到HttpContext就無所不能啦
                var httpContext = _accessor.HttpContext;
                //判斷資源數據中權限列表中是否有權限
                if (!requirement.Permissions.Any())
                {
                    //沒有直接返回無權限,也可以重新獲取權限,實現不退出重新登錄就可獲取最新權限
                    context.Fail();
                }
                //判讀請求是否擁有憑據,即是否登錄
                var defaultAuthenticate = await Scheme.GetDefaultAuthenticateSchemeAsync();
                if (defaultAuthenticate == null)
                {
                    context.Fail();
                }
                var result = await httpContext.AuthenticateAsync(defaultAuthenticate.Name);
                //不為空代表登錄成功,為空登錄失敗
                if (result?.Principal != null)
                {
                    // 獲取生成Token時放在payload里的userId
                    string userId = _accessor.HttpContext.User.FindFirst("userId").Value;
                    // 獲取當前請求的地址
                    string requestUrl = httpContext.Request.Path.Value.ToLower();
                    // 從權限表中查找當前用戶是否有當前請求地址的權限
                    var permission = requirement.Permissions.FirstOrDefault(a => a.Url.ToLower() == requestUrl && a.UserId == userId);
                    // 如果沒找到,代表沒有權限
                    if (permission == null)
                    {
                        context.Fail();
                    }
                    // 如果找到,就繼續往下執行
                    context.Succeed(requirement);
                }
                else
                {
                    // 獲取不到對應值就返回無權限
          context.Fail();
                }
            }
            catch (Exception ex)
            {
                context.Fail();
            }
        }
    }
}

總結

關於權限驗證這塊之前大多都是在MVC的授權過濾器中進行完成的, 本來想在說過濾器那塊一起說說權限驗證的,但感覺關於Jwt的放在一塊比較合適。關於Jwt其實還有一個比較關鍵的點,就是對於Token的處理問題,比如刷新Token、手動失效Token等,這塊后續單獨整理一篇內容分享。下次先說說過濾器的執行順序。

關於代碼,其實現在在寫案例的時候感覺已經開始復雜了,后面整理整理會放在github上,如果急需的可以私下找我,我單獨發給小伙伴。

一個被程序搞丑的帥小伙,關注"Code綜藝圈",識別關注跟我一起學~~~

擼文不易,莫要白瞟,三連走起~~~~


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM