
Cirro 是一个可扩展的安全研究平台,使研究人员和渗透测试人员能够通过图数据库收集、分析和可视化云环境及身份关系。Cirro 采用模块化架构构建,可扩展以支持多种平台和数据源。
你可以查看文档了解更多信息。
有关用法示例和收集覆盖范围,请参阅收集指南。
Cirro 有两个主要功能领域:
cirro collect):从各种平台和 API 收集信息cirro graph):管理图数据库操作,包括数据摄取和导出模块化架构使用功能标志来启用平台特定功能,允许用户仅构建他们需要的组件。
Cirro 使用按功能和平台组织的分层命令结构:
cirro <function> <platform> <command> [options]
Azure(收集 az)
# Available authentication methods:
cirro collect az azcli # Azure CLI authentication
cirro collect az client-secret # Client ID and secret
cirro collect az client-cert # Client certificate
cirro collect az access-token # Pre-obtained access token
cirro collect az user-pass # Username and password
Tailscale(收集 ts)
# Tailscale data collection
cirro collect ts <auth-method> [options]
数据摄取(graph ingest)
# Ingest collected data into graph database
cirro graph ingest --type <platform> --file <data-file> [database options]
数据导出(图导出)
# Export graph data to various formats
cirro graph export --format <format> [options]
从发布页面下载适用于你平台的最新版本。发布版本在构建时已启用所有功能。
git clone https://github.com/bishopfox/cirro.git
cd cirro
cargo build --release
注意:使用 --RELEASE 构建对于图功能非常重要,因为它会将 YAML 配置文件嵌入到二进制文件中!
二进制文件将位于 target/release/cirro。
默认情况下,Cirro 包含所有可用功能。要构建特定功能:
# Build with only collection features
cargo build --release --no-default-features --features collector
# Build with only graph features
cargo build --release --no-default-features --features graph
# Build with specific platform support
cargo build --release --no-default-features --features "azure"
cargo build --release --no-default-features --features "tailscale"
Cirro 使用 Neo4j 作为后端数据库。tools 目录中提供了 docker-compose 文件,用于协助运行容器化数据库。
收集数据后,将其摄取到你的图数据库中:
# Ingest data for specific platforms
cirro graph ingest --type az --file cirro_output.db # Azure data
cirro graph ingest --type ts --file cirro_ts_socket.json # Tailscale data
# Specify custom database connection
cirro graph ingest --type az --file cirro_output.db \
--server bolt://localhost:7687 \
--user neo4j \
--password password
预览将要被摄取和后处理的内容,而不向图数据库写入任何数据:
# Preview Azure ingestion and see which resource types have no implemented specs
cirro graph ingest --type az --file cirro_output.db --dry-run
# Preview Tailscale ingestion
cirro graph ingest --type ts --file cirro_ts_socket.json --dry-run
在试运行模式下,Cirro 将:
CirroDash 可在此处找到:https://github.com/bishopfox/cirrodash
启用调试日志记录以获取详细信息:
# Collection debug mode
cirro collect az azcli --debug
# Ingestion debug mode
cirro graph ingest --type az --file cirro_output.db --debug
注意:Cirro 专为经授权的安全测试与研究而设计。在针对任何云环境或网络环境运行之前,请确保您已获得适当的授权。