当前位置: 首页 热点

impire 实操:从零搭建可用的内部权限审批流

栏目:热点 作者:yihan 时间:2026-11-20 17:40:29

学完这篇,你能用 impire 在 30 分钟内搭出一套可运行的角色审批流程,并避开最常见的配置陷阱。

准备

  • 安装 impire 本体:从官方仓库下载对应系统的二进制包,解压后把可执行文件加入 PATH。
  • 确认依赖:impire 需要 SQLite(默认)或 PostgreSQL,两者选一即可;首次运行会自动建库,无需手工初始化。
  • 准备一个测试目录:`mkdir impire-demo && cd impire-demo`,后续所有配置文件都放这里。
  • 验证安装:执行 `impire --version`,看到版本号即通过;若提示缺库,先装对应驱动。

判断标准:命令行能返回版本号,且当前目录下出现 `impire.db` 文件,说明基础环境就绪。

第一步:初始化项目与首个角色

  • 运行 `impire init`,会在当前目录生成 `impire.yaml` 主配置和 `policies/` 目录。
  • 编辑 `impire.yaml`,把 `storage.path` 改为 `./impire.db`(默认已指向该路径,无需改)。
  • 在 `policies/roles.yaml` 中定义第一个角色:

roles:

  • name: viewer

permissions: [read]

  • name: editor

permissions: [read, write, approve]

  • 保存后执行 `impire apply`,让角色定义写入数据库。

判断标准:`impire apply` 输出 `Applied 2 roles`,且 `impire role list` 能看到 viewer 和 editor。

第二步:配置审批流与绑定用户

  • 在 `policies/flows.yaml` 中定义一条审批流:

flows:

  • name: content-edit

trigger: editor.write

steps:

  • approver: role:manager
  • approver: role:admin
  • 意思是:当 editor 用户发起 write 操作时,先由 manager 角色审批,再由 admin 角色终审。
  • 创建用户并绑定角色:执行 `impire user add alice --role editor`,再 `impire user add bob --role manager`,`impire user add carol --role admin`。
  • 重新 `impire apply` 加载 flow 配置,因为 flow 与用户绑定需同步。

判断标准:`impire flow list` 显示 content-edit 且状态为 active;`impire user list` 能看到三个用户及对应角色。

第三步:发起请求并走通全流程

  • 以 alice 身份发起写操作:`impire request create alice --action write --resource /docs/plan.md`。
  • 系统自动创建一条审批单,状态为 `pending`,并推送给第一个审批人(manager 角色用户)。
  • 用 bob 审批:`impire request approve --id <request-id> --as bob`,状态变为 `waiting-admin`。
  • 再用 carol 终审:`impire request approve --id <request-id> --as carol`,状态变为 `approved`。
  • 最后确认生效:`impire request status --id <request-id>` 应返回 `approved`,且 alice 对 `/docs/plan.md` 的 write 权限已解锁。

判断标准:每一步命令都有明确输出,且最终状态为 approved;若任一环节报错,看下一条的常见坑。

验证与常见坑

  • 验证权限隔离:用 viewer 角色的用户执行 `impire request create --action write`,应被拒绝并提示 `permission denied`。
  • 常见坑 1:角色名大小写敏感,`editor` 与 `Editor` 是两个角色,配置时务必统一。
  • 常见坑 2:审批顺序必须严格匹配 flow 定义,跳步或反序会报 `invalid step`;若需并行审批,在 flow 中把多个 approver 写在同一行数组里。
  • 常见坑 3:修改 roles.yaml 后忘记 `impire apply`,导致新角色不生效;每次改配置都要执行 apply。
  • 常见坑 4:SQLite 文件被占用(比如用 Navicat 打开),会导致写入锁死;关闭外部连接再操作。

判断标准:上述测试全部通过,且无锁死、无大小写报错,即算真正跑通。

最终建议:先按默认 SQLite 跑通单条审批流,再迁移到 PostgreSQL 并扩展多级审批;日常维护只需记住「改配置必 apply,查状态用 request status」。

阅读:14次

分类栏目