How orange-cyberdefense/goad works
GOAD is a command-line orchestrator for building vulnerable Active Directory practice labs. A user selects a lab, provider, provisioner, network range, and extensions; the manager creates or loads an instance, renders provider configuration, deploys infrastructure, and runs Ansible playbooks to reach a provisioned lab. Lifecycle commands then start, stop, inspect, reset, or destroy it. The tree supports multiple lab families and provider integrations; detailed lab definitions and some provider implementations were not sampled.
Main entry points: lab_manager.py Lab manager · instance.py Lab instance · provider_factory.py Provider factory · cmd.py Command runtime
Components 19
CLI orchestration
- GOAD CLI
goad.py - Lab manager
goad/lab_manager.py
Lab lifecycle
- Lab catalog
goad/labs.py - Instance registry
goad/instances.py - Lab instance
goad/instance.py - Lab extensions
goad/extension.py
Infrastructure providers
- Provider factory
goad/provider/provider_factory.py - Vagrant providers
goad/provider/vagrant/vagrant.py - Terraform providers
goad/provider/terraform/terraform.py - Ludus provider
goad/provider/ludus/ludus.py - Command runtime
goad/command/cmd.py
Configuration provisioning
- Provisioner factory
goad/provisioner/provisioner_factory.py - Ansible orchestration
goad/provisioner/ansible/ansible.py - Provisioner modes
goad/provisioner/ansible/runner.py - Jumpbox access
goad/jumpbox.py
Other components
- Pentester
- Lab VMs
- Cloud platforms
- Ansible engine
Connections 22
- Pentester → GOAD CLI: issues commands
- GOAD CLI → Lab manager: dispatches tasks
- Lab manager → Lab catalog: loads labs
- Lab manager → Instance registry: manages instances
- Lab manager → Lab instance: creates instance
- Lab manager → Lab extensions: selects extensions
- Lab instance → Provider factory: selects provider
- Lab instance → Provisioner factory: selects provisioner
- Provider factory → Vagrant providers: creates Vagrant
- Provider factory → Terraform providers: creates Terraform
- Provider factory → Ludus provider: creates Ludus
- Vagrant providers → Command runtime: runs Vagrant
- Terraform providers → Command runtime: runs Terraform
- Ludus provider → Command runtime: runs Ludus
- Terraform providers → Cloud platforms: manages resources
- Command runtime → Lab VMs: controls VMs
- Provisioner factory → Provisioner modes: creates mode
- Provisioner modes → Ansible orchestration: runs provisioning
- Ansible orchestration → Ansible engine: executes playbooks
- Ansible orchestration → Lab VMs: configures VMs
- Lab instance → Jumpbox access: prepares access
- Jumpbox access → Lab VMs: connects remotely