权限项与后台菜单入口
应用里“谁能进、谁能点哪个按钮”可以交给 Betly 的角色来管:场馆管理员在熟悉的权限分配页里勾选即可,应用不用自己维护一套权限。
权限项
每个应用有一组权限项,编码格式是 app.<标识>.<后缀>:
| 权限项 | 来源 | 作用 |
|---|---|---|
app.<标识>.access | 登记应用时自动创建,名称为“进入应用” | 员工能否登录应用;没有它,员工在 Betly 授权页就会被拒 |
app.<标识>.<后缀> | 管理员在【权限项】页添加 | 应用自定义的按钮或操作,例如 app.apply.approve 审核申请单 |
后缀只能用小写字母、数字、下划线和连字符。新增权限项的入口:应用详情 →【权限项】,填写【权限码】(后缀)与【名称】。
管理员在【设置】→【商户与权限】→【权限分配】里,把这些权限项勾给对应角色。
按钮级判权
应用需要判断“当前员工能不能点审核”时,用应用凭证调用判权接口(需要 permissions:check 权限范围):
http
GET /api/v1/permissions/check?user_id=<员工 sub>&code=app.apply.approve HTTP/1.1
Host: api.mx5.cn
Authorization: Bearer bt_xxxxxxxxxxxxxxxxxxxxxxxxjson
{ "allowed": true, "store_ids": null }
{ "allowed": false, "reason": "missing_permission" }user_id是/api/v1/me返回的员工sub;省略code时判断“进入应用”。- 只能查询本应用自己的权限项,查询其他编码返回 400。
store_ids是员工角色绑定的门店,null表示不限门店;应用按门店展示数据时可以参考。reason取值:app_not_authorized应用未授权、not_in_org不是本组织员工、not_active_staff已离职、missing_permission没有该权限项。- 判权结果会随角色调整实时变化。可以短时间缓存,但执行写操作前请再判一次。
- 这个接口只接受应用凭证。会员没有权限项,会员能做什么由应用自己决定。
后台菜单入口
把应用挂到 Betly 后台侧栏,员工在后台点一下就能进入应用。入口:应用详情 →【菜单入口】,填写:
| 字段 | 说明 |
|---|---|
| 菜单名称 | 侧栏显示的名字 |
| 挂载分组 | 放在侧栏哪个分组下 |
| 应用内路径 | 点击后打开的应用页面,相对应用地址,例如 /staff |
| 绑定权限项 | 有这个权限项的员工才看得到这个菜单 |
员工点击菜单后,Betly 先判断权限,再在新标签页打开“应用地址 + 应用内路径”。链接里不带任何凭证或身份,应用需要自己识别是谁:
- 把应用内路径指向一个需要登录的页面;
- 该页面发现没有登录时,自动按 员工与会员登录 发起员工登录;
- 员工已经登录 Betly 后台,整个过程不用再输入密码,几秒内就带着员工身份回到这个页面。
不要在应用内路径里放令牌或员工编号,也不要相信链接参数里传来的身份。
