1．權限管理
權限管理的基本定義：百度百科。
基於《Asp.Net Core 2.0 項目實戰（10） 基於cookie登陸受權認證並實現前臺會員、後臺管理員同時登陸》咱們作過了登陸認證，登陸是權限的最基礎的認證，沒有登陸就沒有接下來的各類操做權限管理，以及數據權限管理（暫不探討），這裏咱們把登陸看成全局權限，進入系統後再根據不一樣的角色或者人員，固定基本功能的展現，當不一樣的角色要對功能操做時，就須要驗證操做權限，如：查看/添加/修改/刪除，也就是咱們常說的控制到按鈕級。下面讓咱們一步一步來操做實現一下,本篇提供一種權限過濾思路，歡迎討論指正，全局過濾代碼基類已經實現，相關控制頁面還在緊急編碼中，時間少任務重，但願你們多體諒。
內容略長：請耐心瀏覽。
2.約定大於配置
約定優於配置，也稱做按約定編程，是一種軟件設計範式，旨在減小軟件開發人員需作決定的數量，得到簡單的好處，而又不失靈活性。與之對應的就是mvc下控制器和視圖的關係。
本質是說，開發人員僅需規定應用中不符約定的部分。例如，若是模型中有個名爲Sale的類，那麼數據庫中對應的表就會默認命名爲sales。只有在偏離這一約定時，例如將該表命名爲」products_sold」，才需寫有關這個名字的配置。
爲了方便項目快速構建，數據庫咱們這裏先使用dtcms 5.0的數據庫相關表navigation。EF Core生成Model備用。
a) 首先約定後臺Controller和Action命名約定，以及屬性Attribute類定義
##菜單約定##
1.nav_name儘可能使用controller
2.全部英文小寫
3.最後一級url不能爲空
##方法定義約定##
1.屬性全nav_name,action_type
2.屬性只有nav_name，判斷Action和參數是否爲空
3.屬性只有action_type，控制器名作nav_name
4.根據控制器+Action判斷
5.不是標準方法必須加屬性nav_name
6.控制器標準，保存Action方法不標準，須要傳標準參數
b) 定義操做枚舉Enum
using System;
using System.Collections.Generic;
using System.Text;
namespace NC.Common
{
public class JHEnums
{
/// <summary>
/// 統一管理操做枚舉
/// </summary>
public enum ActionEnum
{
/// <summary>
/// 全部
/// </summary>
All,
/// <summary>
/// 顯示
/// </summary>
Show,
/// <summary>
/// 查看
/// </summary>
View,
/// <summary>
/// 添加
/// </summary>
Add,
/// <summary>
/// 修改
/// </summary>
Edit,
/// <summary>
/// 刪除
/// </summary>
Delete,
/// <summary>
/// 審覈
/// </summary>
Audit,
/// <summary>
/// 回覆
/// </summary>
Reply,
/// <summary>
/// 確認
/// </summary>
Confirm,
/// <summary>
/// 取消
/// </summary>
Cancel,
/// <summary>
/// 做廢
/// </summary>
Invalid,
/// <summary>
/// 生成
/// </summary>
Build,
/// <summary>
/// 安裝
/// </summary>
Instal,
/// <summary>
/// 卸載
/// </summary>
UnLoad,
/// <summary>
/// 登陸
/// </summary>
Login,
/// <summary>
/// 備份
/// </summary>
Back,
/// <summary>
/// 還原
/// </summary>
Restore,
/// <summary>
/// 替換
/// </summary>
Replace,
/// <summary>
/// 複製
/// </summary>
Copy
}
}
JHEnums
c) 獲取操做權限
#region 操做權限菜單
/// <summary>
/// 獲取操做權限
/// </summary>
/// <returns>Dictionary</returns>
public static Dictionary<string, string> ActionType()
{
Dictionary<string, string> dic = new Dictionary<string, string>();
dic.Add("Show", "顯示");
dic.Add("View", "查看");
dic.Add("Add", "添加");
dic.Add("Edit", "修改");
dic.Add("Delete", "刪除");
dic.Add("Audit", "審覈");
dic.Add("Reply", "回覆");
dic.Add("Confirm", "確認");
dic.Add("Cancel", "取消");
dic.Add("Invalid", "做廢");
dic.Add("Build", "生成");
dic.Add("Instal", "安裝");
dic.Add("Unload", "卸載");
dic.Add("Back", "備份");
dic.Add("Restore", "還原");
dic.Add("Replace", "替換");
return dic;
}
#endregion
Utils.ActionType()
d) Action屬性類定義
using Microsoft.AspNetCore.Mvc.Filters;
using System;
namespace NC.Lib
{
/// <summary>
/// nav_name
/// </summary>
public class NavAttr : Attribute, IFilterMetadata
{
public NavAttr() { }
public NavAttr(string navName, string actionType)
{
this.NavName = navName;
this.ActionType = actionType;
}
public string NavName { set; get; }//菜單名稱
public string ActionType { set; get; } //操做類型
}
}
3. 全局過濾實現
3.1 首先定義一個基Controller
定義好基AdminBase控制器後，全部的後臺域Controller都繼承此類
3.2 首先驗證用戶是否登陸
Session相關參考3.5 Session操做
/// <summary>
/// 判斷管理員是否已經登陸
/// </summary>
public bool IsAdminLogin()
{
var bSession = HttpContext.Session.Get(AdminAuthorizeAttribute.AdminAuthenticationScheme);
if (bSession == null)
{
return false;
}
siteAdminInfo = ByteConvertHelper.Bytes2Object<JhManager>(bSession);
//若是Session爲Null
if (siteAdminInfo != null)
{
return true;
}
else
{
//檢查Cookies
var cookieAdmin = HttpContext.AuthenticateAsync(AdminAuthorizeAttribute.AdminAuthenticationScheme);
cookieAdmin.Wait();
var adminname = cookieAdmin.Result.Principal.Claims.FirstOrDefault(x => x.Type == "AdminName")?.Value;
var adminpwd = cookieAdmin.Result.Principal.Claims.FirstOrDefault(x => x.Type == "AdminPwd")?.Value;
if (adminname != "" && adminpwd != "")
{
JhManager model = dblEf.JhManager.Where(m => m.UserName == adminname && m.Password == adminpwd).FirstOrDefault();
if (model != null)
{
HttpContext.Session.Set(AdminAuthorizeAttribute.AdminAuthenticationScheme, ByteConvertHelper.Object2Bytes(model));//存儲session
bSession = HttpContext.Session.Get(AdminAuthorizeAttribute.AdminAuthenticationScheme);
siteAdminInfo = ByteConvertHelper.Bytes2Object<JhManager>(bSession);
return true;
}
}
}
return false;
}
3.3 OnActionExecuting重載方法實現過濾
首先驗證登陸，而後判斷須要過濾的area，判斷是否有跳過屬性（SkipAdminAuthorizeAttribute，作登陸的時候定義過），最後判斷菜單和按鈕的權限。
這裏須要注意的是，OnActionExecuting和AdminAuthorizeAttribute. OnAuthorization的執行順序，有的網友博客看到的是OnActionExcuting先執行，我這裏測試的是先驗證屬性OnAuthorization，再執行OnActionExecuting；可能附加條件不一樣，這裏不作過多探討，調試的時候你們可試試。
/// <summary>
/// 建立過濾器：***全局過濾器*** 過濾除登陸登出等操做權限驗證
/// </summary>
/// <param name="context"></param>
public override void OnActionExecuting(ActionExecutingContext filterContext)
{
base.OnActionExecuting(filterContext);
//1.驗證是否登陸
//2.驗證菜單權限
//3.驗證按鈕權限
//在action執行以前
//判斷是否加有SkipAdmin標籤
var skipAuthorize = filterContext.ActionDescriptor.FilterDescriptors.Where(a => a.Filter is SkipAdminAuthorizeAttribute).Any();
if (!skipAuthorize)
{
//是否系統管理文件夾裏文件,Areas》ad_min
var isPermission = false;
//獲取controller和action
var route = filterContext.RouteData.Values;
string strArea = route["area"].ToString();//獲取區域的名字,ad_min區域下的都須要權限驗證
if (strArea != null && strArea.Equals("ad_min"))
{
isPermission = true;
}
//須要驗證權限
if (isPermission)
{
var currController = route["controller"].ToString();
var curraction = route["action"].ToString();
var exceptCtr = UtilConf.Configuration["Site:exceptCtr"].Replace("，", ",");//防止中文逗號
var exceptAction = UtilConf.Configuration["Site:exceptAction"].Replace("，", ",");//防止中文逗號
//判斷是否有例外控制器或Action校驗是否例外，跳過驗證
if (!exceptCtr.Contains(currController.ToLower()) && !exceptAction.Contains(curraction.ToLower()))
{
//驗證是否登陸
if (!IsAdminLogin())
{
string msg = string.Format("未登陸或登陸超時，請從新登陸！");
filterContext.Result = new RedirectResult("~/ad_min/login?msg=" + WebUtility.UrlEncode(msg));
return;
}
//驗證菜單權限
//驗證按鈕權限
//自定義方法屬性
try
{
//獲取屬性
NavAttr actionAttr = filterContext.ActionDescriptor.FilterDescriptors.Where(a => a.Filter is NavAttr).Select(a => a.Filter).FirstOrDefault() as NavAttr;
string strNavName = string.Empty;
string strActionType = string.Empty;
if (actionAttr == null)
{
actionAttr = filterContext.ActionDescriptor.FilterDescriptors.GetType().GetCustomAttributes<NavAttr>().FirstOrDefault() as NavAttr;
}
if (actionAttr != null)
{
strNavName = actionAttr.NavName;
strActionType = actionAttr.ActionType;
}
//獲取參數,因爲action在mvc中屬於關鍵詞，因此使用act看成操做方式參數
string paramAction = "";
//paramAction = Request.Query["action"].ToString();
if (string.IsNullOrEmpty(paramAction))
{
if (route["act"] != null)
{
paramAction = route["act"].ToString();
}
}
if (siteAdminInfo.RoleType != 1)//超管擁有全部權限
{
if (!ChkPermission(siteAdminInfo.RoleId, currController, curraction, strNavName, strActionType, paramAction))
{
TempData["Permission"] = "您沒有管理該頁面的權限，請聯繫管理員！";
filterContext.Result = new RedirectResult("~/ad_min/Home/Index");
return;
//返回固定錯誤json
}
else
{
TempData["Permission"] = null;
}
}
}
catch (System.Exception ex)
{
throw ex;
}
}
}
}
}
頁面權限驗證，首先獲取到頁面的Controller和Action以及Action上面是否包含相關屬性NavAttr,校驗數據庫中是否包含對此屬性的定義。
/// <summary>
/// 判斷頁面
/// </summary>
/// <param name="role_id">角色id</param>
/// <param name="currController">當前控制器</param>
/// <param name="currAction">當前</param>
/// <param name="navName">方法上的屬性</param>
/// <param name="actionType">操做類型</param>
/// <param name="paramAction">當爲操做方法是傳遞的參數</param>
/// <returns>沒有權限返回false</returns>
public bool ChkPermission(int? role_id, string currController, string currAction, string navName, string actionType, string paramAction)
{
//1.未配置頁面，在方法上加屬性/ad_min/Settings/SysConfigSave
//2.控制器+Action /admin/sys_config/index,/admin/sys_config/add,/admin/sys_config/edit
//3.先判斷已配置頁面/admin/settings/sys_config
bool result = true;
var url = HttpContext.Request.Path.Value;
if (url.Contains("/ad_min/home/index"))//後臺首頁不驗證
{
return result;
}
DataTable dt = chkPermission(role_id);
var action_type = actionType;
//屬性不爲空
if (!string.IsNullOrEmpty(navName) && !string.IsNullOrEmpty(actionType))//屬性全
{
DataRow[] dr = dt.Select("nav_name='" + navName + "' and action_type='" + action_type + "'");
result = (dr.Count() > 0);
}
else if (!string.IsNullOrEmpty(navName) && string.IsNullOrEmpty(actionType))//屬性只有nav_name
{
action_type = getActionType(currAction, paramAction);
DataRow[] dr = dt.Select("nav_name='" + navName + "' and action_type='" + action_type + "'");
result = (dr.Count() > 0);
}
else if (string.IsNullOrEmpty(currController) && !string.IsNullOrEmpty(actionType))//控制器名：nav_name,屬性只有action_type
{
DataRow[] dr = dt.Select("nav_name='" + currController + "' and action_type='" + action_type + "'");
result = (dr.Count() > 0);
}
else
{
//約定大於配置
//控制器名：nav_name
//Action：action_type
if (!string.IsNullOrEmpty(currController) && !string.IsNullOrEmpty(currAction))
{
//控制器+action
if (currAction.ToLower() == "index")//首頁爲展現
{
currAction = "View";
}
DataRow[] dr = dt.Select("nav_name='" + currController + "' and (action_type='" + currAction + "')");
result = (dr.Count() > 0);
}
//屬性全空，控制器+Action驗證不經過，參數不空
if (!result && !string.IsNullOrEmpty(currController) && !string.IsNullOrEmpty(paramAction))//（控制器）+參數判斷
{
//參數可爲Edit,Add,Del...
DataRow[] dr = dt.Select("nav_name='" + currController + "' and action_type='" + paramAction + "'");
result = (dr.Count() > 0);
}
if (!result)//控制器+Action驗證未經過
{
//配置頁面處理
DataTable dtNav = GetNavCacheList("link_url='" + url + "'");//根據菜單URL,從緩存中檢索調用ID
if (dtNav.Rows.Count > 0)
{
DataRow drNav = dtNav.Rows[0];
string nav_name = drNav["name"].ToString();//nav_name
action_type = getActionType(currAction, paramAction);
DataRow[] dr = dt.Select("nav_name='" + nav_name + "' and action_type='" + action_type + "'");
result = (dr.Count() > 0);
}
}
}
return result;
}
/// <summary>
/// 判斷是否有權限
/// </summary>
private DataTable chkPermission(int? role_id)
{
DataTable dt = CacheHelper.Get("permisson" + role_id) as DataTable;
if (dt == null)
{
string strSql = "SELECT mrv.nav_name,mrv.action_type FROM manager_role mr LEFT JOIN manager_role_value mrv ON mr.id=mrv.role_id WHERE mr.id=@role_id";
DbParameters p = new DbParameters();
p.Add("@role_id", role_id);
dt = Dbl.JHCMS.CreateSqlDataTable(strSql, p);
CacheHelper.Set("permisson" + role_id, dt);
}
return dt;
}
/// <summary>
/// 1.驗證action是否標準約定
/// 2.根據action=''參數獲取操做類型
/// </summary>
private string getActionType(string currAction, string paramAction)
{
if (currAction.ToLower().Contains("index") || currAction.ToLower().Contains("list"))//首先判斷是否首頁/列表等展現
{
return "View";
}
if (currAction.ToLower().Contains("save"))//若是包含保存save關鍵字，默認返回add
{
return string.IsNullOrEmpty(paramAction) ? "Add" : paramAction;
}
else if (currAction.ToLower().Contains("edit") || currAction.ToLower().Contains("update"))
{
return string.IsNullOrEmpty(paramAction) ? "Edit" : paramAction;
}
else if (currAction.ToLower().Contains("del"))
{
return string.IsNullOrEmpty(paramAction) ? "Delete" : paramAction;
}
//判斷Action
if (!string.IsNullOrEmpty(currAction))
{
if (Utils.ActionType().ContainsKey(currAction))//首字母要大寫，約定
return currAction;
}
return string.IsNullOrEmpty(paramAction) ? "View" : paramAction;
}
3.4 Controller中的約定
1.NavAttr屬性所有定義
/// <summary>
/// 更新字典排序
/// </summary>
[NavAttr(NavName = "sys_navigation", ActionType = "Edit")]
public JsonResult UpdateNav(string id, string nav)
{}
2.NavAttr屬性之定義NavName(對應數據庫中的name)
[NavAttr(NavName = "sys_navigation"]
public JsonResult UpdateNav_Edit(string id, string nav)
{}
3.未定義Action屬性，必須傳遞一個參數以肯定操做類型
//（控制器）+參數判斷
public class sys_navigationController : AdminBase
{
public JsonResult UpdateNav_Edit(string id, string nav)
{}
}
3.5 Session相關操做
Session使用須要先在startup.cs中進行配置注入，找到方法ConfigureServices注入Session
Configure中啓用
在控制器中的操做，存儲：
JhManager bUser = getUserInfoByNameAndPwd(AdminName, adminpwd, true);
HttpContext.Session.Set(AdminAuthorizeAttribute.AdminAuthenticationScheme, ByteConvertHelper.Object2Bytes(bUser));//存儲session
讀取：
var bSession =
HttpContext.Session.Get(AdminAuthorizeAttribute.AdminAuthenticationScheme);
if (bSession == null)
{
return false;
}
bUser= ByteConvertHelper.Bytes2Object<JhManager>(bSession);
ByteConvertHelper是byte轉換幫助類
using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Text;
namespace NC.Common
{
/// <summary>
/// byte轉換操做類，主要用於Session存儲
/// </summary>
public class ByteConvertHelper
{
/// <summary>
/// 將對象轉換爲byte數組
/// </summary>
/// <param name="obj">被轉換對象</param>
/// <returns>轉換後byte數組</returns>
public static byte[] Object2Bytes(object obj)
{
byte[] serializedResult = Encoding.UTF8.GetBytes(JsonConvert.SerializeObject(obj));
return serializedResult;
}
/// <summary>
/// 將byte數組轉換成對象
/// </summary>
/// <param name="buff">被轉換byte數組</param>
/// <returns>轉換完成後的對象</returns>
public static object Bytes2Object(byte[] buff)
{
return JsonConvert.DeserializeObject<object>(Encoding.UTF8.GetString(buff));
}
/// <summary>
/// 將byte數組轉換成對象
/// </summary>
/// <param name="buff">被轉換byte數組</param>
/// <returns>轉換完成後的對象</returns>
public static T Bytes2Object<T>(byte[] buff)
{
return JsonConvert.DeserializeObject<T>(Encoding.UTF8.GetString(buff));
}
}
}
View Code
4.總結
實戰項目還在一點點開發中，碰到不少坑點，時間也頗有限。工做愈來愈忙，老是抽時間兼顧學習聯繫，很累。NET技術更新換代很快，公司裏還在沿用比較老的技術，可能大多數公司都是這樣，程序不得不學新技術，企業不得不用成熟的技術。
雖然不知道會作到哪一步，碰到的問題積累的點，在這裏先記錄下來，備查。項目若是成型或可以運行起來看到效果，到時候開源出來。有時候畢竟代碼片斷或者寫博的時候有些地方不容易連貫起來，如今讓咱們先一塊兒學習吧。