README
¶
Carbon
Infrastructure automation and configuration management
Purpose
Carbon's primary purpose is to provide a consistent execution environment to facilitate offensive security assessments.
It uses:
- Packer to build images.
- Terraform to provision infrastructure.
- Golang project structure.
It is aimed at supporting various services to ensure it can scale with you as your operations become more complex.
| Feature | AWS ✅ | Azure ❌ | GCP ❌ | QEMU ✅ | Multipass ✅ | VirtualBox ✅ | vSphere ❌ |
|---|---|---|---|---|---|---|---|
| Image build templates | ✅ | ❌ | ❌ | ✅ | ❌ N/A | ✅ | ✅ |
| Create Images | ✅ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
| Infrastructure Creation | ❌ | ❌ | ❌ | ❌ | ❌ N/A | ❌ | ❌ |
| VM Management | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ | ❌ |
❌ = Not Right Now, but soon
✅ = Supported
Install
go install github.com/analog-substance/carbon@latest
Usage
Images
Bootstrap Image Build Configuration
carbon image bootstrap -n my-image -t ubuntu-24.04 -s aws
Build Images
carbon image build -n my-image
Manage Images and Image Builds
List image build configs.
carbon image list -b
Infrastructure
Create New Infrastructure
Modify Infrastructure
Teardown Infrastructure
Operating
Starting and Stopping
carbon vm start -i i-afde123ae43
carbon vm stop -i i-afde123ae43
Connecting to VMs
carbon vm ssh -i i-afde123ae43
Things to do
- provision aws env (create files, call terraform)
- create a new vm on infrastructure
- vnc to vm
- point a domain
- list domains
- Jobs / Distributed execution
- Cloud init templates (Base, Operator, Operator Desktop, Implant VM)
- Simple deploy/config of services (Pwndoc, Gophish, modlishka, Guacamole, Sliver, Mythic)
- vSphere provider
- GCP Provider
- Azure Provider
- LXD Provider
- Different OS (CentOS, Arch)
- Self Test to ensure dependencies are met
- Slack Bot
- Discord Bot
- Web GUI
- DNS management
- docsy config
- vhs example gifs
- docs
- tests
Documentation
¶
Overview ¶
Copyright © 2024 defektive
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Source Files
Directories