Setup¶
Prerequisites
- Valid cloud platform credentials (currently Azure)
- Running Neo4j instance
- Appropriate permissions for target cloud environment
Warning
- Neo4j requires APOC plugin
Install Cirro¶
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
cirro graph ingest --type az --file cirro_output.db \
--server bolt://localhost:7687 \
--user neo4j \
--password password
Next Steps¶
After completing the quick start:
- Explore Your Data: Use your graph database's query interface to explore the collected data
- Learn Query Patterns: Explore user and manager queries and service principal relationships
- Set Up Visualization: Configure dashboards and visualizations for your specific use case
- Advanced Features: Explore collection options and application metadata