iamlive 项目安装与使用指南

1. 项目目录结构及介绍

iamlive 项目的目录结构如下：

iamlive/
├── iamlivecore/
│   ├── ...
├── vendor/
│   ├── ...
├── .gitignore
├── go.mod
├── go.sum
├── main.go
├── LICENSE
├── NOTICE
├── README.md

目录结构介绍

• iamlivecore/: 包含项目的主要逻辑代码。
• vendor/: 包含项目的依赖库。
• .gitignore: 指定 Git 版本控制系统忽略的文件和目录。
• go.mod: Go 模块文件，定义了项目的依赖关系。
• go.sum: 记录了项目依赖的校验和，确保依赖的完整性。
• main.go: 项目的启动文件。
• LICENSE: 项目的开源许可证。
• NOTICE: 项目相关的通知文件。
• README.md: 项目的说明文档。

2. 项目的启动文件介绍

项目的启动文件是 main.go，它包含了项目的入口函数 main()。该文件负责初始化项目并启动监听器，捕获 AWS、Azure 或 Google Cloud (GCP) 的 API 调用，生成相应的 IAM 策略。

主要功能

• 初始化配置: 读取命令行参数和配置文件，设置监听模式（CSM 或 Proxy）。
• 启动监听器: 根据配置启动相应的监听器，捕获 API 调用。
• 生成 IAM 策略: 根据捕获的 API 调用生成 IAM 策略，并输出到指定文件或控制台。

3. 项目的配置文件介绍

iamlive 项目没有独立的配置文件，但可以通过命令行参数进行配置。以下是一些常用的命令行参数：

常用命令行参数

• --provider: 指定云服务提供商（aws、azure、gcp），默认是 aws。
• --set-ini: 设置时，会更新 aws/config 文件以使用 CSM 监控或 CA 证书，并在退出时移除（仅适用于 AWS）。
• --profile: 与 --set-ini 结合使用时，指定要使用的配置文件（默认是 default）。
• --fails-only: 设置时，仅将失败的 AWS 调用添加到策略中（仅适用于 CSM 模式）。
• --output-file: 指定一个文件，在 SIGHUP 或退出时写入。
• --refresh-rate: 指定刷新策略的频率（以秒为单位）。
• --sort-alphabetical: 按字母顺序排序操作。
• --host: 指定 CSM 监听的主机地址（默认是 127.0.0.1）。
• --background: 设置时，进程将在后台运行，不输出日志。
• --force-wildcard-resource: 设置时，资源将始终为通配符（仅适用于 AWS）。
• --mode: 指定监听模式（csm、proxy），默认是 csm。
• --bind-addr: 指定代理模式的绑定地址（默认是 127.0.0.1:10080）。
• --ca-bundle: 指定代理模式使用的 CA 证书包（PEM 格式）。
• --ca-key: 指定代理模式使用的 CA 证书密钥。
• --account-id: 指定 AWS 账户 ID，用于策略输出（仅适用于 AWS）。
• --debug: 设置时，在代理模式下输出相关的 HTTP 请求。

示例

iamlive --set-ini --profile myprofile --fails-only --output-file policy.json --refresh-rate 1 --sort-alphabetical --host 127.0.0.1 --background

以上命令会启动 iamlive，使用 myprofile 配置文件，仅捕获失败的 AWS 调用，并将生成的策略输出到 policy.json 文件中，每秒刷新一次，按字母顺序排序操作，并在后台运行。