Skip to content

HowdoComputer/yaaas

Repository files navigation

Yet Another Attack Automation System (YAAAS)

YAAAS is a repository of prototype Ansible playbooks for building attack infrastructure. I intend to use this during my day job and with side projects.

Disclaimers

  • I made this project partly to learn Ansible. There will certainly be dumb decisions made in here. Use at your own risk.
  • This whole repo is still in very early days. There's still lots of work to do.
  • Everything here was tested on Kali and only Kali. For now.
  • Sliver is the only non-metasploit C2 project installed. For now.
  • The c2-servers doesn't do very much. For now.
  • The redirectors role is just an idea. For now.
  • Have I mentioned this isn't really complete? XD

Please note that the default configuration here will grant the account named in the main_username variable root privileges through the docker installation and group membership process! All these playbooks are written as though main_username has full sudo privileges already, but still.

Setup

Clone this repo to the machine that will be your ansible controller.

Install ansible via the appropriate method for your controller, whatever that may be.

e.g.

sudo apt install ansible

If the full ansible package isn't available (like Kali, just pulled from their repos recently), install ansible-core and then add the docker_image module like so:

ansible-galaxy collection install community.docker

Add your hosts to hosts.ini or hosts.yml. The ansible.cfg file in this repo assumes hosts.yml by default.

Please also note that this repo uses localhost as an attack_host and a c2_server by default. See hosts.yml.

Check that your hosts are listed and organized correctly with something like this:

ansible-inventory --list    # List of hosts in JSON format
ansible-inventory --graph   # List of hosts in text tree format

Configuration

ansible.cfg for global Ansible configuration.

Inventory: hosts.ini or hosts.yml. Set which one in ansible.cfg

Global variables: ./vars/global-vars.yml has useful global variables defining things like your main username, destination directories, etc.

Creation of custom users

TODO. Not yet implemented.

Execution

Do all the things.

ansible-playbook runMe.yml -i inventory/hosts.yml

Other useful snippets

Show all ansible facts on your local host with no SSH server required:

ansible -c local localhost ansible.builtin.setup

Run playbook and exclude any tasks with tag "tested":

ansible-playbook runMe.yml --skip-tags tested

TODOs

See ./TODO.md

About

Yet Another Attack Automation System (YAAAS)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages