权限 快速入门
Util应用框架权限快速入门
本节将引导你运行Util权限管理模块,并对UI按钮和API操作进行访问控制.
准备
拉取 Util.Platform.Single 项目代码.
git clone https://gitee.com/util-core/Util.Platform.Single.git
如果已拉取,请更新到最新代码.
运行项目
打开 Util.Platform.Single.sln 解决方案.
数据迁移
设置 Util.Platform.Api 为启动项目.
打开 appsettings.Development.json 开发配置文件.
DatabaseType 配置项用于指定当前使用的数据库类型,可选值为:
- SqlServer
- PgSql
- MySql
Util.Platform.Single 目前支持以上三种数据库,如果需要支持其它数据库,请告知.
检查你使用的数据库连接字符串是否正确.
按 F5 键,启动 Util.Platform.Api 项目.
启动时,会自动运行 EntityFrameworkCore 迁移命令,创建迁移文件目录.
会同时创建三种数据库项目迁移文件目录.
如果没有配置MySql连接字符串,或 MySql 连接失败, 则无法创建MySql迁移文件目录,并会产生一个异常,不用理会它.
查看数据库,可以看到数据库已创建.
使用 Swagger 测试 Web Api 访问控制
启动完成, 弹出 Swagger 页面.
下面选择一个最简单的操作进行测试,执行 Application 的 /api/Application/enabled 操作.
返回消息 code 为 2.
Code 是 Util 应用框架约定的返回结果代码, 2 代表未授权 .
Util.Platform.Api 项目默认开启了API访问控制,需要先进行登录认证.
Util.Platform.Api 项目的 Swagger 已经配置好 OAuth 认证.
点击 Swagger Authorize 按钮.
弹出 Available authorizations 对话框,点击 Authorize 按钮.
进入登录页面,如下所示.
数据迁移默认创建两个用户: admin 和 test .
admin用户是管理员,test是普通用户.
输入用户 test , 密码 test ,使用普通用户登录.
登录成功,跳回 Swagger 页面,点击 Close 按钮关闭对话框.
重新执行 Application 的 /api/Application/enabled 操作.
可以看到,成功返回数据,说明已经授权成功.
那么是不是只要登录,就能操作所有API接口?
下面执行 Application 的 POST /api/Application 操作,它表示创建应用程序.
返回结果代码为 2,表明未授权