Skip to content

Setup

Prerequisites

  • Valid cloud platform credentials (currently Azure)
  • Running Neo4j instance
  • Appropriate permissions for target cloud environment

Warning

Install Cirro

curl -sSL https://github.com/bishopfox/cirro/releases/latest/download/cirro-installer.sh | sh
irm https://github.com/bishopfox/cirro/releases/latest/download/cirro-installer.ps1 | iex

Download pre-built binaries from the releases page.

Collect Data (Azure)

# Using Azure CLI authentication
cirro collect az azcli

# Using client secret
cirro collect az client-secret \
  --client-id <CLIENT_ID> \
  --client-secret <CLIENT_SECRET> \
  --tenant-id <TENANT_ID>

Collect as a restricted guest

cirro collect az azcli --tenant-id <TENANT_ID> --mode graph \
  --restricted-guest --output-path cirro_restricted.db

See restricted guest options to specify application IDs or use the Microsoft application catalog. Ingest cirro_restricted.db with the command below, replacing the input filename.

Ingest into Graph Database

Neo4j is supported as the graph database backend. Set up your database before ingesting cloud data. There is a docker-compose file in the tools directory to assist with containerized database setup.

# For Neo4j
docker-compose up
# For Neo4j
cirro graph ingest --type az --file cirro_output.db \
    --server bolt://localhost:7687 \
  --user neo4j \
  --password password

Next Steps

After completing the quick start:

  1. Explore Your Data: Use your graph database's query interface to explore the collected data
  2. Learn Query Patterns: Explore user and manager queries and service principal relationships
  3. Set Up Visualization: Configure dashboards and visualizations for your specific use case
  4. Advanced Features: Explore collection options and application metadata