ASP.NET Core CMS管理后台

.net core MySQL ASP.NET Core CMS EF Core LayUI Cookie Session 登录 验证码 2024-07-09 45  

ASP.NET Core+LayUI+MySql CMS管理后台,主要功能包括 登录、修改密码,账号管理,菜单管理,角色权限管理等 由于工作之外,抽时间写的,用于学习交流,请慎重用于生产环境 ### 项目概要 ### CMS管理后台包含的功能有 登录、修改密码、账号管理(账号列表,添加,修改,删除,禁/启用,解锁)、菜单管理(菜单列表,添加,修改,删除,禁/启用)、角色权限管理(角色列表,添加,修改,删除,禁/启用,分配权限)等后台最基础的功能 CMS管理后台使用的ASP.NET Core MVC模式,LayUI做的前端页面,Mysql做的数据存储,Razor页面引擎 登录加入图片验证码,验证码保存在Session中,Cookie+AES加密保存用户登录状态,密码使用MD5加密保存在数据库 使用 AuthorizationFilter 过滤器判断用户的登录状态和操作权限,权限判断基于Controller和Action 表单数据提交采用ajax提交,页面的展示与数据提交一般共用同一个 Action, 1. 像添加、修改、分配权限等通过 if (!Request.Method.ToUpper().Equals("POST", StringComparison.OrdinalIgnoreCase) || !Request.HasFormContentType) 来区分是显示页面还是提交请求 2. 像账号列表、菜单列表、权限列表等通过 if (id == null || !id.ToUpper().Equals("DATA", StringComparison.OrdinalIgnoreCase)) 来区分是显示页面还是返回数据列表 使用依赖注入,面向切面来实现业务,减少藕合,使代码也易于管理 软件版本 ASP.NET Core:2.1 MySql:5.6 LayUI:2.4.5 jquery:3.3.1 ### 项目结构 ### ![Image](/sitedata/image/asp.net_core_cms_1_1.png) ![Image](/sitedata/image/asp.net_core_cms_1_2.png) Database:数据库脚本,包括建库、建表、数据初始化等脚本 Snai.CMS:代码目录 ⨽wwwroot:js,css,image等静态文件 ⨽Business:业务实现,登录,账号管理,角色管理,菜单管理等实现 ⨽Common:公共基础的方法类库,加解密,AuthorizationFilter过滤器,验证码实现,时间戳,随机数,密码复杂度检查,系统一些常量等 ⨽Controllers:控制器,加入了ControllerBase继承Controller,其他控制器继承ControllerBase,主要是 抽出GetLayoutModel(),再通过泛型ToT<T>(ref T t) 方法,得到子类页面Model,简化控制器取 LayoutModel Model值 ⨽DataAccess:数据库操作 ⨽Entities:实体对象 ⨽Models:模型 ⨽Views:视图 ### 项目介绍 ### **一、CMS数据库 snai_cms** 数据表 管理员表(admins),菜单表(modules),角色表(roles),权限表(role_right) 时间以utc时间戳保存,ORM使用EFCore操作数据库 ![Image](/sitedata/image/asp.net_core_cms_1_3.png) **二、登录** 登录的 用户名、密码、验证码 都正确才能登录成功,登录成功跳转到后台首页 默认的用户名:snai,密码:snai2019 如果在30分钟内,密码错误3次,将锁定账号30分钟,这里的时间和错误次数可以在appsettings.json配置 ``` "LogonSettings": { "ErrorCount": 3, //错误次数 "ErrorTime": 30, //单位时间内错误的时间 "LockMinute": 30 //锁定时间 } ``` 每次登录不管成功还是失败都会刷新验证码,验证码保存在 Session,有效时间15分钟 登录成功后,登录用户 Token(用户名,密码,随机码)通过 AES 加密保存在 Cookie 中,登录 Cookie 的有效期为关掉浏览器过期,AES加密密钥在appsettings.json配置 ``` "WebSettings": { "CipherKey": "wEd5cxs0xUZe6WBCTUFIMJIDRnLZYWG9", //AES加密密钥 "WebTitle": "CMS管理后台" //管理后台名称 } ``` 通过 AuthorizationFilter 过滤器判断登录和权限,除了登录和退出,其他页面和操作都需要登录和相应权限,权限判断是通过用户角色,Controller和Action 对应的菜单来判断 ![Image](/sitedata/image/asp.net_core_cms_1_4.png) ![Image](/sitedata/image/asp.net_core_cms_1_5.png) **三、登录信息和修改密码** 登录信息 主要显示当前登录IP和登录时间 ![Image](/sitedata/image/asp.net_core_cms_1_6.png) 修改密码 可以通过旧密码来修改密码,密码要求 至少6位,且必须是字母与(数字或特殊符号)组合 ![Image](/sitedata/image/asp.net_core_cms_1_7.png) 右上角,包括退出按钮,用于退出后台 ![Image](/sitedata/image/asp.net_core_cms_1_8.png) **四、后台设置** 后台设置包括 管理员管理,管理员管理包括 账号管理、菜单管理、角色管理 ![Image](/sitedata/image/asp.net_core_cms_1_9.png) 1、账号管理 主要包括 账号列表,添加,修改,删除,禁/启用,解锁等操作 ![Image](/sitedata/image/asp.net_core_cms_1_10.png) 2、菜单管理 主要包括 菜单列表,添加,修改,删除,禁/启用等操作 ![Image](/sitedata/image/asp.net_core_cms_1_11.png) 3、角色管理 主要包括 角色列表,添加,修改,删除,禁/启用,分配权限等操作 ![Image](/sitedata/image/asp.net_core_cms_1_12.png) 分配权限 除了登录和退出,其他页面和操作都需要权限 ![Image](/sitedata/image/asp.net_core_cms_1_13.png) **开发时的一些注意** 1. 注册HttpContext,用于在Controller之外的地方使用 services.AddHttpContextAccessor(); 2. appsettings.json 中文乱码,如配置文件里有中文,保存时默认GB2312格式,改为UTF-8 3. View 文件不编译 <MvcRazorCompileOnPublish>false</MvcRazorCompileOnPublish> 4. View 使用Model ``` @{ ViewData.Model = new NoUserRoleModel() { PageTitle = "没有权限访问", WebTitle = "CMS管理后台" }; } ``` 5. Razor里的代码块html标签跨了代码段时,视图会报错 如:下面这种写法就会报错 ``` @if(...){ <li class='layui-nav-item'> } </li> 正确写法 @if(...){ <li class='layui-nav-item'></li> } 或 @if(...){ @Html.Raw("<li class='layui-nav-item'>") } @Html.Raw("</li>") ``` 6. 加基类控制器 ControllerBase : Controller,抽出GetLayoutModel(),再通过泛型 ToT<T>(ref T t) 方法,得到子类页面Model, 简化控制器取 LayoutModel Model值 7. layui重新渲染后的单选按钮,选择后直接用 $("input[name='state']:checked").val() 是取不值的(用layui的表单取值不确定是否能取到)后面用layui监听事件,监听按钮选择修改原单选按钮选中状态,然后再用 $("input[name='state']:checked").val() 取值 ``` MA.layui.form.on('radio(state)', function (data) { if (data.value == 1) { MA.Form.state1.attr("checked", true); MA.Form.state2.attr("checked", false); } else { MA.Form.state1.attr("checked", false); MA.Form.state2.attr("checked", true); } }); ``` 8. 对于checkbox提交,用 jquery 组合成数组提交 ``` var moduleIDs =[]; $("input[name='moduleIDs']:checked").each(function(){ moduleIDs.push($(this).val()); }); //请求参数 var params = { roleID: MRR.Form.roleID.val(), moduleIDs: moduleIDs }; ``` 9. 对于分配权限时checkbox选择与联动选择,也用的是layui监听事件MRR.layui.form.on('checkbox(moduleIDs)', function (data) {}); 来设置原checkbox的值 对于联动后重新渲染checkbox用MRR.layui.form.render('checkbox'),要注意用prop而不用attr,$(this).prop("checked", false),否则已经做过选择复选框联动无效 **菜单层级** 后台配置 --------管理员管理 -----------------账号管理 --------------------------添/删/改等账号 Github源码地址: [https://github.com/Liu-Alan/Snai.CMS](https://github.com/Liu-Alan/Snai.CMS)