Lenslet CI 里的 AWS 权限审查

在 PR 里看清 AWS 权限

让测试跑在本地 AWS 模拟器上。Lenslet 记录每次调用,解释失败原因,并在拉取请求里标出新增的 IAM 权限。

macOS 应用尚未公证:第一次打开时,到“系统设置 → 隐私与安全性”里点“仍要打开”。

  • macOS / Linux
  • Apache-2.0
  • 2026年11月15日
一次测试运行后 Lenslet 的权限视图:十七项权限,各自的资源和调用次数;dynamodb:DeleteItem 标为新增。
示例运行后的权限视图,其中一项是新增;界面为英文。 截自 v3.0.0

调用为什么失败

每次调用一行,AWS 错误就写在行里,请求和响应点一下就能看。

Lenslet 的调用视图:每次 AWS 调用的服务、状态和耗时;S3 的 NoSuchKey 和 SQS 的 QueueDoesNotExist 错误直接显示在行里。

为什么失败,需要什么权限

为什么失败

AWS 的错误码和信息,常见的本地失败还附上可能的原因。

需要什么权限

每次调用都对应到资源上的 IAM 操作,隐含的权限也算在内。

提交一份锁文件

lenslet.lock 列出项目需要的权限,一行一项,按顺序排好。

PR 里的权限差异

每个拉取请求一条评论;新增的权限有人认可之前,CI 一直失败。

没用到的也会指出

--check --strict 对这次运行没用到的锁文件条目也会失败。

从锁文件生成策略

lenslet policy 输出 IAM 策略,只有测试需要的条目不计入。

开始使用

先启动模拟器:AWS Emulator、moto 和 LocalStack 都可以。 lenslet init 会写出锁文件和 CI 工作流,两者都要提交。

  1. 安装(Linux、macOS)

    curl -fsSL https://github.com/hxddh/lenslet/releases/latest/download/install.sh | sh
  2. 第一次运行:生成锁文件和 CI 工作流

    lenslet init -- npm test
  3. 代码需要锁文件里没有的权限时,让检查失败

    lenslet run --check -- npm test

数据的去向

常见问题

锁文件等于安全审查吗?

不等于。它是测试实际用到的权限,按规则推算出来。测试没跑到的代码路径不在锁文件里。

能识别哪些 AWS 服务?

会读出具体资源的服务有 11 种,包括 S3、DynamoDB、SQS、Lambda、KMS 和 IAM。其他服务的资源记为 * 。

支持 Windows 吗?

不支持。有 macOS(通用版)和 Linux(x86_64、aarch64)的版本,还有适合 Alpine 和 CI 镜像的静态命令行版。