[ABP教程]第五章 授权

合集 - 测试1(73)

1.windwos terminal 主题美化 包括WSL和其他终端命令行2023-03-122.win11+cuda11.2+cudnn+Tensorflow-GPU 环境配置2022-10-223.win11+wls2+ubuntu2004配置cuda+cudnn+pytorch2022-10-144.xshell7 无法打开 提示"要继续使用此程序,您必须应用最新的更新或使用新版本" 解决方案2022-10-085.wls2 ubuntu22 kind k8s 配置记录2022-09-126.wsl2安装与配置2022-09-117.PVE UPS NUT配置 自动关机2022-07-318.centos-stream-9 centos9 配置国内源 阿里云源2022-04-209.群晖gitlab备份迁移2022-01-2810.国内网站recaptcha无法使用的解决办法2022-01-0611.[每日小技巧] vscode配置vue项目基础2021-11-0912.Windows11 AirPods /AirPods Pro 声音小解决方案2021-10-2413.windows端口占用快速查询解决方法2021-05-1414.解决github无法连接错误 OpenSSL SSL_connect: Connection was reset in connection to github.com:4432021-03-1715.[ABP教程]第七章 作者:数据库集成2020-12-2416.[ABP教程]第六章 作者：领域层2020-12-24

17.[ABP教程]第五章 授权2020-12-24

18.[ABP教程]第四章 集成测试2020-12-2419.[ABP教程]第三章 创建、更新和删除图书2020-12-2420.[ABP教程]第二章 图书列表页面2020-12-2421.[ABP教程]第一章 创建服务端2020-12-2422.[Skill] git下载助手2020-12-2323.[Abp]Abp 新手入门随记2020-12-2024.[Skill] 记一次vue项目热更新失败案例2020-12-1525.[Skill]加速npm与yarn还原2020-11-2226.解决黑群晖"抱歉，您所指定的页面不存在"-记一次黑群晖修复案例2020-09-1527.如何下载youtube的视频？2020-09-1328.[新手教程]申请https泛域名解析2020-09-0729.docker frps 内网穿透容器化服务2020-09-0230.docker nginx 自定义配置容器2020-09-0231.asp.net core 学习笔记2020-07-0932.gitlab git仓库地址修改后更新方法2020-05-3133.树莓派(4B)新手入门教程2020-05-3034.Docker-MsSqlServer和安装版本异同2020-04-1135.Win Task 任务管理器 批量杀进程方法2020-04-0936.Win Docker 安装C盘清理方法之一2020-04-0337.中移动ipv6-老毛子固件获取ipv6设置2020-03-2038.win7-win10 禁用IPV6临时地址2020-03-2039.辅助调用函数【call,apply,bind】2020-02-2740.Unraid修改docker镜像地址&默认启动2020-02-2641.docker基本入门知识-小白向2020-02-2642.[不止于代码]Unraid基本使用速记2020-02-2643.Dockerfile文件说明2020-01-1944.Git之pull,fetch差别2019-08-2645.ES6+Webpack+Babel基本环境搭建2019-08-2646.抽象类和接口的异同及实例解析2018-11-2247.KVM与OpenVZ架构的区别2018-08-0248.关闭win10 defender的方法集锦2018-07-1949.ChromeDriver与Chrome版本对应表2018-05-2850.Hexo-Next-多地同步丢失解决(WARN No layout: index.html)2018-04-2651.修改vs模板添加版权注释信息2018-03-2752.Easyui中form表单验证事件不通过处理方法2018-03-2753.最简化版本-Centos7 配置.Net Core 及Jexus服务器2018-03-1254.常用开发中使用到的作图工具(开发向)2018-02-2555.Git 常用指令备注2018-01-3156.记一次 未能加载文件或程序集“”或它的某一个依赖项。试图加载格式不正确的程序 错误解决方案2018-01-3157.截图工具小结2018-01-2958.更优雅的处理数据-linqjs2018-01-2959.解决未安装Sql Server 配置数据库别名2018-01-2860.windows添加右键菜单-此处运行CMD2018-01-2461.记一次微信开发安卓访问阿里云服务器慢处理方案2018-01-1362.Hexo发布到Github丢失readme和CNAME解决方案2018-01-1163.Git之别名配置2018-01-0864.Github博客多地同步文章2018-01-0765.Github博客 自定义域名2018-01-0766.Github 搭建个人博客2018-01-0467.(转载)开源许可证教程2018-01-0268.小米路由mini刷 改华硕[N14U N54U]5G 2G的7620老毛子Padavan固件(私人云储存 aria2 QOS)2017-12-3169.小米路由mini刷不死breed2017-12-3170.小米路由mini开启ssh2017-12-3171.比特币是什么？2017-12-2172.IIS发布网站出现拒绝访问的错误分析2017-11-0773.公众平台服务号、订阅号、企业微信、小程序的相关说明2017-11-07

收起

原文档

地址：
Web Application Development Tutorial - Part 5: Authorization

关于此教程

在这个教程系列中，您将构建一个基于ABP的Web应用程序。此应用程序用于管理书籍及其作者的列表。 它将使用以下技术开发:Acme.BookStore(译者:您创建项目名称)

• EntityFramework Core 作为ORM提供器
• MVC/Razor Pages 作为UI框架

这个教程全部由下面几个部分构成：

• 第一章：创建服务端
• 第二章：构建书籍列表页面
• 第三章：增删改图书
• 第四章：集成测试
• 第五章：授权（本教程）
• 第六章：领域层
• 第七章：数据库集成
• 第八章：应用层
• 第九章：用户接口
• 第十章：预定作者关系

下载源码#

教程根据您的UI和数据库首选项有多个版本。我们准备了一些可供下载的源码组合：

• MVC(Razor Pages)界面和EFCore版本
• Blazor和EF Core版本
• Angular和MongoDB版本

视频教程#

此教程亦提供视频教程 在YouTube(译者：稍后将转移到Bilibili)

权限

ABP框架提供基于Asp.Net Core权限授权基础的权限系统。在标准授权基础结构上添加一项主要功能就是权限系统，该系统允许定义权限并针对每个角色、用户或用户端启用/禁用。

权限名称#

权限必须有唯一的名称，最好的方法是将其定义为我们可以重复使用的权限名称。

打开项目 *.Application.Contracts 文件夹Permissions 并更新内容如下:

Copy
namespace Acme.BookStore.Permissions
{
    public static class BookStorePermissions
    {
        public const string GroupName = "BookStore";

        public static class Books
        {
            public const string Default = GroupName + ".Books";
            public const string Create = Default + ".Create";
            public const string Edit = Default + ".Edit";
            public const string Delete = Default + ".Delete";
        }
    }
}

这个是定义权限名称的分层方法。举个例子，"create book" 权限名称将定义为创建图书。ABP不会强迫您使用这个规范，但是我们发现这个方法很有用。BookStore.Books.Create

权限定义#

你需要先定义权限后再使用。

项目路径： BookStorePermissionDefinitionProviderAcme.BookStore.Application.ContractsPermissions
打开以上路径类，按照以下修改：

Copy
using Acme.BookStore.Localization;
using Volo.Abp.Authorization.Permissions;
using Volo.Abp.Localization;

namespace Acme.BookStore.Permissions
{
    public class BookStorePermissionDefinitionProvider : PermissionDefinitionProvider
    {
        public override void Define(IPermissionDefinitionContext context)
        {
            var bookStoreGroup = context.AddGroup(BookStorePermissions.GroupName, L("Permission:BookStore"));

            var booksPermission = bookStoreGroup.AddPermission(BookStorePermissions.Books.Default, L("Permission:Books"));
            booksPermission.AddChild(BookStorePermissions.Books.Create, L("Permission:Books.Create"));
            booksPermission.AddChild(BookStorePermissions.Books.Edit, L("Permission:Books.Edit"));
            booksPermission.AddChild(BookStorePermissions.Books.Delete, L("Permission:Books.Delete"));
        }

        private static LocalizableString L(string name)
        {
            return LocalizableString.Create<BookStoreResource>(name);
        }
    }
}

此类定义一个权限组(对UI上权限进行分组，如下所示)和该组的4个权限。同样的，创建，编辑和删除是权限的子集。 一个子权限只能归属于父权限。BookStorePermissions.Books.Default

最后，编辑国际化文件（在项目en.jsonLocalization/BookStoreAcme.BookStore.Domain.Shared 文件夹下）：

Copy
"Permission:BookStore": "Book Store",
"Permission:Books": "Book Management",
"Permission:Books.Create": "Creating new books",
"Permission:Books.Edit": "Editing the books",
"Permission:Books.Delete": "Deleting the books"

Copy
本地化关键字名称是任意的，并没有强制规定。但是我们还是更喜欢上面的约定模式

权限管理界面#

定义权限后，您可以在权限管理模式下看到他们
定位到 Adninistrator -> Indentity -> Role 页面下，为角色“admin”选择编辑权限如下：

授权所需的权限并保存
提示:新权限自动授予如果你运行application.Acme.BookStore.DbMigrator admin角色

授权

现在，您能使用权限授权图书管理。

应用层 和 Http API#

打开类 BookAppService ，然后将策略名称设置为上面定义的权限名称

Copy
using System;
using Acme.BookStore.Permissions;
using Volo.Abp.Application.Dtos;
using Volo.Abp.Application.Services;
using Volo.Abp.Domain.Repositories;

namespace Acme.BookStore.Books
{
    public class BookAppService :
        CrudAppService<
            Book, //The Book entity
            BookDto, //Used to show books
            Guid, //Primary key of the book entity
            PagedAndSortedResultRequestDto, //Used for paging/sorting
            CreateUpdateBookDto>, //Used to create/update a book
        IBookAppService //implement the IBookAppService
    {
        public BookAppService(IRepository<Book, Guid> repository)
            : base(repository)
        {
            GetPolicyName = BookStorePermissions.Books.Default;
            GetListPolicyName = BookStorePermissions.Books.Default;
            CreatePolicyName = BookStorePermissions.Books.Create;
            UpdatePolicyName = BookStorePermissions.Books.Edit;
            DeletePolicyName = BookStorePermissions.Books.Delete;
        }
    }
}

文件：CrudAppService
在构造函数中添加代码。Base 自动都CRUD操作使用这些权限。这将使应用程序更加安全，同时也是HTTP API安全。因为上面所述，该服务自动用于HTTP API(详情见 auto API controllers)

在开发管理功能时候，稍后将该属性用于授权 [Authorize(...)]

Razor Page#

虽然保护HTTP API和应用程序服务可以防止未经授权的用户使用，但他们仍可以导航到图书管理页面。尽管当前页面手机对服务器进行AJAX调用时候，他们将获得授权例外，但是我们也应该对页面进行授权，以提供更好的用户体验和安全性。

打开 BookStoreWebModule ，然后日俺家下面的代码块到ConfigureServices方法:

Copy
Configure<RazorPagesOptions>(options =>
{
    options.Conventions.AuthorizePage("/Books/Index", BookStorePermissions.Books.Default);
    options.Conventions.AuthorizePage("/Books/CreateModal", BookStorePermissions.Books.Create);
    options.Conventions.AuthorizePage("/Books/EditModal", BookStorePermissions.Books.Edit);
});

现在，未授权用户将重定向到登录页面(译者：如果有)。

隐藏新建图书按钮#

图书管理页面有“新建图书”按钮，若当前用户没有“图书创建”权限，则改按钮不可见。

打开 文件 Pages/Books/Index.html ，按以下内容修改：

Copy
  @page
@using Acme.BookStore.Localization
@using Acme.BookStore.Permissions
@using Acme.BookStore.Web.Pages.Books
@using Microsoft.AspNetCore.Authorization
@using Microsoft.Extensions.Localization
@model IndexModel
@inject IStringLocalizer<BookStoreResource> L
@inject IAuthorizationService AuthorizationService
@section scripts
{
    <abp-script src="/Pages/Books/Index.js"/>
}

<abp-card>
    <abp-card-header>
        <abp-row>
            <abp-column size-md="_6">
                <abp-card-title>@L["Books"]</abp-card-title>
            </abp-column>
            <abp-column size-md="_6" class="text-right">
                @if (await AuthorizationService.IsGrantedAsync(BookStorePermissions.Books.Create))
                {
                    <abp-button id="NewBookButton"
                                text="@L["NewBook"].Value"
                                icon="plus"
                                button-type="Primary"/>
                }
            </abp-column>
        </abp-row>
    </abp-card-header>
    <abp-card-body>
        <abp-table striped-rows="true" id="BooksTable"></abp-table>
    </abp-card-body>
</abp-card>

添加 注入方法 @inject IAuthorizationService AuthorizationService
使用 @if (await AuthorizationService.IsGrantedAsync(BookStorePermissions.Books.Create)) 检查权限，是否渲染新建按钮

JavaScript端#

在图书管理页面中每一行都有动作按钮。动作按钮包括编辑和删除动作：

如果当前用户没有操作权限我们将隐藏此按钮。表格行动作需要一个是否显示的选项，通过设置false来达到隐藏的目的。

在项目*.BookStore.Web中 打开文件 Pages/Books/Index.js ，添加一个visibe选项来设置Edit是否显示。

Copy
{
    text: l('Edit'),
    visible: abp.auth.isGranted('BookStore.Books.Edit'), //CHECK for the PERMISSION
    action: function (data) {
        editModal.open({ id: data.record.id });
    }
}

Delete 删除同上

Copy
visible: abp.auth.isGranted('BookStore.Books.Delete')

• abp.auth.isGranted(...) 被用于定义前的权限检查
• visible 能够基于一些条件计算后返回一个bool类型的值用于控制是否显示

菜单项#

即使我们已经保护了图书管理页面的所有层，但是它仍然在应用程序的主菜单上可见。如果当前用户没有权限，我们也应该隐藏菜单项。

打开类文件 BookStoreMenuContributor 找到下面的代码：

Copy
context.Menu.AddItem(
    new ApplicationMenuItem(
        "BooksStore",
        l["Menu:BookStore"],
        icon: "fa fa-book"
    ).AddItem(
        new ApplicationMenuItem(
            "BooksStore.Books",
            l["Menu:Books"],
            url: "/Books"
        )
    )
);

用下面的代码替代：

Copy
var bookStoreMenu = new ApplicationMenuItem(
    "BooksStore",
    l["Menu:BookStore"],
    icon: "fa fa-book"
);

context.Menu.AddItem(bookStoreMenu);

//CHECK the PERMISSION
if (await context.IsGrantedAsync(BookStorePermissions.Books.Default))
{
    bookStoreMenu.AddItem(new ApplicationMenuItem(
        "BooksStore.Books",
        l["Menu:Books"],
        url: "/Books"
    ));
}

你也需要对方法ConfigureMenuAsync添加关键字 async ,然后重新排列返回值。最终BookStoreMenuContributor类应该如下：

Copy
using System.Threading.Tasks;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Localization;
using Acme.BookStore.Localization;
using Acme.BookStore.MultiTenancy;
using Acme.BookStore.Permissions;
using Volo.Abp.TenantManagement.Web.Navigation;
using Volo.Abp.UI.Navigation;

namespace Acme.BookStore.Web.Menus
{
    public class BookStoreMenuContributor : IMenuContributor
    {
        public async Task ConfigureMenuAsync(MenuConfigurationContext context)
        {
            if (context.Menu.Name == StandardMenus.Main)
            {
                await ConfigureMainMenuAsync(context);
            }
        }

        private async Task ConfigureMainMenuAsync(MenuConfigurationContext context)
        {
            if (!MultiTenancyConsts.IsEnabled)
            {
                var administration = context.Menu.GetAdministration();
                administration.TryRemoveMenuItem(TenantManagementMenuNames.GroupName);
            }

            var l = context.GetLocalizer<BookStoreResource>();

            context.Menu.Items.Insert(0, new ApplicationMenuItem("BookStore.Home", l["Menu:Home"], "~/"));

            var bookStoreMenu = new ApplicationMenuItem(
                "BooksStore",
                l["Menu:BookStore"],
                icon: "fa fa-book"
            );

            context.Menu.AddItem(bookStoreMenu);

            //CHECK the PERMISSION
            if (await context.IsGrantedAsync(BookStorePermissions.Books.Default))
            {
                bookStoreMenu.AddItem(new ApplicationMenuItem(
                    "BooksStore.Books",
                    l["Menu:Books"],
                    url: "/Books"
                ));
            }
        }
    }
}