GCP Scanner是一款针对Google Cloud Platform(GCP)的凭证安全审计工具,该工具可以帮助广大安全工程师对GCP凭证快速执行安全审计分析。该工具本质上是一个针对GCP的资源扫描器,可以确定某些凭证在GCP上拥有怎样级别的访问权限。该工具旨在帮助研究人员评估某个虚拟机/容器的安全态势,以及GCP服务器账户和OAuth2令牌密钥泄漏所产生的安全影响。
当前版本的GCP Scanner支持扫描下列GCP资源:
GCE
GCS
GKE
App Engine
Cloud SQL
BigQuery
Spanner
Pub/Sub
Cloud Functions
BigTable
CloudStore
KMS
Cloud Services
当前版本的GCP Scanner支持提取和使用下列类型的凭证:
1、GCP VM实例元数据;
2、存储在gcloud配置文件中的用户凭证;
3、OAuth2刷新令牌(云平台范围授权);
4、GCP服务账号密钥(JSON格式);
该工具不需要依赖任何第三方工具(例如gcloud等),因此它可以作为一款独立工具进行编译和运行,而且可以在没有安装GCP SDK的设备上使用。但是,当前版本的GCP Scanner仅支持在Linux操作系统上运行。
由于该工具基于Python 3开发,因此我们首先需要在本地设备上安装并配置好Python 3环境。接下来,我们可以直接使用pip工具安装GCP Scanner:
pip install gcp_scanner python3 -m gcp_scanner --help
除此之外,我们也可以使用下列命令将该项目源码克隆至本地,并手动安装工具依赖组件:
git clone https://github.com/google/gcp_scanner cd gcp_scanner pip install . gcp-scanner --help
如果你想要在Docker容器中使用GCP Scanner的话,可以使用下面的Docker构建文件:
docker build -f Dockerfile -t sa_scanner .
usage: python3 scanner.py -o folder_to_save_results -g - GCP Scanner options: -h, --help 显示工具帮助信息和退出 -ls, --light-scan 仅在输出中提供最重要的GCP资源信息 -k KEY_PATH, --sa-key-path KEY_PATH 包含JSON格式SA密钥数据的目录路径 -g GCLOUD_PROFILE_PATH, --gcloud-profile-path GCLOUD_PROFILE_PATH gcloud配置文件目录路径 -m, --use-metadata 从GCE实例元数据中提取凭证信息 -at ACCESS_TOKEN_FILES, --access-token-files ACCESS_TOKEN_FILES 包含访问令牌和OAuth数据的文件列表(JSON格式,逗号分隔) -rt REFRESH_TOKEN_FILES, --refresh-token-files REFRESH_TOKEN_FILES 包含refresh_token、client_id、token_uri和client_secret的文件列表(JSON格式,逗号分隔) -s KEY_NAME, --service-account KEY_NAME 要扫描的单个SA名称 -p TARGET_PROJECT, --project TARGET_PROJECT 要扫描的单个项目名称 -f FORCE_PROJECTS, --force-projects FORCE_PROJECTS 要扫描的项目名称列表(逗号分隔) -c CONFIG_PATH, --config CONFIG_PATH 包含指定待扫描资源目标的配置文件路径 -l {DEBUG,INFO,WARNING,ERROR,CRITICAL}, --logging {DEBUG,INFO,WARNING,ERROR,CRITICAL} 设置日志记录级别 (INFO, WARNING, ERROR) -lf LOG_FILE, --log-file LOG_FILE 存储日志文件路径 -pwc PROJECT_WORKER_COUNT, --project-worker-count PROJECT_WORKER_COUNT 设置并行项目爬虫数量 -rwc RESOURCE_WORKER_COUNT, --resource-worker-count RESOURCE_WORKER_COUNT 设置并行资源爬虫数量 Required parameters: -o OUTPUT, --output-dir OUTPUT 输出目录路径
使用下列内容替换pyproject.toml文件中的“google-api-python-client==2.80.0”:
google-api-python-client==1.8.0
然后切换到工具源代码目录中,并使用PyInstaller编译独立代码:
pyinstaller -F --add-data 'roots.pem:grpc/_cython/_credentials/' scanner.py
GCP Scanner将在扫描完成后生成一个单独的JSON文件,可以使用任意JSON文件查看器或数据库来处理生成的JSON文件。我们也提供了一个基于Web的工具来帮助大家以可视化的形式分析结果数据,运行命令如下:
usage: gcp-scanner-visualizer -p 8080 GCP Scanner Visualizer options: -h, --help 查看工具帮助信息和退出 -p PORT, --port PORT 要监听的端口号,默认为8080
本项目的开发与发布遵循Apache-2.0开源许可证协议。
GCP Scanner:【GitHub传送门】
https://cloud.google.com/policy-intelligence/docs/analyze-iam-policies
https://cloud.google.com/iam/docs/impersonating-service-accounts