{"id":19260568,"url":"https://github.com/mitre/emu","last_synced_at":"2025-04-21T16:31:59.126Z","repository":{"id":37867653,"uuid":"298634403","full_name":"mitre/emu","owner":"mitre","description":"This CALDERA Plugin converts Adversary Emulation Plans from the Center for Threat Informed Defense","archived":false,"fork":false,"pushed_at":"2025-03-11T18:42:05.000Z","size":81,"stargazers_count":30,"open_issues_count":3,"forks_count":13,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-04-01T14:38:05.652Z","etag":null,"topics":["adversary-emulation","caldera","caldera-plugin"],"latest_commit_sha":null,"homepage":"https://caldera.mitre.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mitre.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-09-25T17:10:19.000Z","updated_at":"2025-03-11T18:42:09.000Z","dependencies_parsed_at":"2024-02-13T22:43:45.268Z","dependency_job_id":null,"html_url":"https://github.com/mitre/emu","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mitre%2Femu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mitre%2Femu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mitre%2Femu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mitre%2Femu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mitre","download_url":"https://codeload.github.com/mitre/emu/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250090962,"owners_count":21373291,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adversary-emulation","caldera","caldera-plugin"],"created_at":"2024-11-09T19:21:44.462Z","updated_at":"2025-04-21T16:31:57.976Z","avatar_url":"https://github.com/mitre.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MITRE Caldera Plugin: Emu\n\nA plugin supplying Caldera with TTPs from the Center for Threat Informed Defense (CTID) Adversary Emulation Plans.\n\n# Installation\n\nUsing the Emu plugin with Caldera will enable users to access the adversary profiles contained in the [CTID Adversary Emulation Library](https://github.com/center-for-threat-informed-defense/adversary_emulation_library). \n\nTo run Caldera along with the Emu plugin:\n1. Download Caldera as detailed in the [Installation Guide](https://github.com/mitre/Caldera)\n2. Enable the Emu plugin by adding `- emu` to the list of enabled plugins in `conf/local.yml` or `conf/default.yml` (if running Caldera in insecure mode)\n3. Start Caldera to automatically download the Adversary Emulation Library to the `data` folder of the Emu plugin. \n4. Stop Caldera. \n5. Some adversaries may require additional payloads and executables to be downloaded. Run the `download_payloads.sh` script to download these binaries to the `payloads` directory.\n6. Start Caldera again. You will see the Emu plugin shown on the left sidebar of the Caldera server, and you will be able to access the Adversary Emulation Library adversary profiles from the Adversary tab of the Caldera server.\n\n# Additional setup\nEach emulation plan will have an adversary and a set of facts. Please ensure to select the related facts to the \nadversary when starting an operation. \n\nBecause some payloads within the Adversary Emulation Library are encrypted, a Python script is used to automate\nthe decryption which requires installation of some dependencies. Depending on the host OS, `pyminizip`\ncan be installed using the following:\n\n- Ubuntu: `apt-get install zlib1g`\n- MacOS: `brew install zlib`\n- All OS's: `pip3 install -r requirements.txt`\n\nSee URL for more information regarding `pyminizip`: https://github.com/smihica/pyminizip\n\n## Acknowledgements\n\n- [Adversary Emulation Library](https://github.com/center-for-threat-informed-defense/adversary_emulation_library)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmitre%2Femu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmitre%2Femu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmitre%2Femu/lists"}