From b402f11979ef78074f4180a221b6cb71dc6d7bc5 Mon Sep 17 00:00:00 2001 From: Adam Mashinchi <78813159+amashinchi-rc@users.noreply.github.com> Date: Mon, 19 Jul 2021 14:15:04 -0700 Subject: [PATCH] Update the README as per Wiki Update (#1550) Co-authored-by: Carrie Roberts --- README.md | 70 ++++++++++++++++++++----------------------------------- 1 file changed, 25 insertions(+), 45 deletions(-) diff --git a/README.md b/README.md index 0a0bc26d..507cc52d 100644 --- a/README.md +++ b/README.md @@ -1,59 +1,39 @@

# Atomic Red Team + [![CircleCI](https://circleci.com/gh/redcanaryco/atomic-red-team.svg?style=svg)](https://circleci.com/gh/redcanaryco/atomic-red-team) -Atomic Red Team allows every security team to test their controls by executing simple -"atomic tests" that exercise the same techniques used by adversaries (all mapped to -[Mitre's ATT&CK](https://attack.mitre.org)). +Atomic Red Team is library of tests mapped to the +[MITRE ATT&CK®](https://attack.mitre.org/) framework. Security teams can use +Atomic Red Team to quickly, portably, and reproducibly test their environments. -## Philosophy +## Get started -Atomic Red Team is a library of simple tests that every security team can execute to test their controls. Tests are -focused, have few dependencies, and are defined in a structured format that can be used by automation frameworks. +You can execute atomic tests directly from the command line, no installation +required. See the [Getting started](https://github.com/redcanaryco/atomic-red-team/wiki/Getting-Started) +page of our wiki. -Three key beliefs made up the Atomic Red Team charter: -- **Teams need to be able to test everything from specific technical controls to outcomes.** - Our security teams do not want to operate with a “hopes and prayers” attitude toward detection. We need to know - what our controls and program can detect, and what it cannot. We don’t have to detect every adversary, but we - do believe in knowing our blind spots. +For a more robust testing experience, consider using an execution framework like +[Invoke-Atomic](https://github.com/redcanaryco/invoke-atomicredteam). -- **We should be able to run a test in less than five minutes.** - Most security tests and automation tools take a tremendous amount of time to install, configure, and execute. - We coined the term "atomic tests" because we felt there was a simple way to decompose tests so most could be - run in a few minutes. +## Learn more - The best test is the one you actually run. +The Atomic Red Team documentation is available as a [wiki](https://github.com/redcanaryco/atomic-red-team/wiki/). -- **We need to keep learning how adversaries are operating.** - Most security teams don’t have the benefit of seeing a wide variety of adversary types and techniques crossing - their desk every day. Even we at Red Canary only come across a fraction of the possible techniques being used, - which makes the community working together essential to making us all better. +For information about the philosophy and development of Atomic Red Team, visit +our website at . -See: https://atomicredteam.io +## Contribute to Atomic Red Team -## Having trouble? +Atomic Red Team is open source and community developed. If you're interested in +becoming a contributor, check out these resources: -Join the community on Slack at [https://atomicredteam.slack.com](https://atomicredteam.slack.com) ([Request Invite](https://docs.google.com/forms/d/e/1FAIpQLSc3oMtugGy--6kcYiY52ZJQQ-iOaEy-UpxfSA37IlA5wCMV0A/viewform?usp=sf_link)) - -## Getting Started - -* [Getting Started With Atomic Red Team](https://github.com/redcanaryco/atomic-red-team/wiki/About-Atomic-Red-Team) -* Automated Test Execution with the [Execution Frameworks](https://github.com/redcanaryco/atomic-red-team/wiki/Executing-Atomic-Tests#execute-an-atomic-test-with-an-execution-framework) -* Peruse the Complete list of Atomic Tests ([md](atomics/Indexes/Indexes-Markdown/index.md), [csv](atomics/Indexes/Indexes-CSV/index.csv)) and the [ATT&CK Matrix](atomics/Indexes/Matrices/matrix.md) - - Windows [Matrix](atomics/Indexes/Matrices/windows-matrix.md) and tests by tactic ([md](atomics/Indexes/Indexes-Markdown/windows-index.md), [csv](atomics/Indexes/Indexes-CSV/windows-index.csv)) - - MacOS [Matrix](atomics/Indexes/Matrices/macos-matrix.md) and tests by tactic ([md](atomics/Indexes/Indexes-Markdown/macos-index.md), [csv](atomics/Indexes/Indexes-CSV/macos-index.csv)) - - Linux [Matrix](atomics/Indexes/Matrices/linux-matrix.md) and tests by tactic ([md](atomics/Indexes/Indexes-Markdown/linux-index.md), [csv](atomics/Indexes/Indexes-CSV/linux-index.csv)) -* Using [ATT&CK Navigator](https://github.com/mitre-attack/attack-navigator)? Check out our coverage layers ([All](atomics/Indexes/Attack-Navigator-Layers/art-navigator-layer.json), [Windows](atomics/Indexes/Attack-Navigator-Layers/art-navigator-layer-windows.json), [MacOS](atomics/Indexes/Attack-Navigator-Layers/art-navigator-layer-macos.json), [Linux](atomics/Indexes/Attack-Navigator-Layers/art-navigator-layer-linux.json)) -* [Fork](https://github.com/redcanaryco/atomic-red-team/fork) and [Contribute](https://github.com/redcanaryco/atomic-red-team/wiki/Contributing) your own modifications -* Have questions? Join the community on Slack at [https://atomicredteam.slack.com](https://atomicredteam.slack.com) - * Need a Slack invitation? Submit an invite request via this [Google Form](https://docs.google.com/forms/d/e/1FAIpQLSc3oMtugGy--6kcYiY52ZJQQ-iOaEy-UpxfSA37IlA5wCMV0A/viewform?usp=sf_link) - -## Code of Conduct - -In order to have a more open and welcoming community, Atomic Red Team adheres to a -[code of conduct](CODE_OF_CONDUCT.md). - -## License - -See the [LICENSE](https://github.com/redcanaryco/atomic-red-team/blob/master/LICENSE.txt) file. +- Join our [Slack workspace](https://slack.atomicredteam.io) and get involved + with the community. Don't forget to review the [code of conduct](CODE_OF_CONDUCT.md) + before you join. +- Report bugs and request new features by [submitting an issue](https://github.com/redcanaryco/atomic-red-team/issues/new/choose). +- Read our [contribution guide](https://github.com/redcanaryco/atomic-red-team/wiki/Contributing) + for more information about contributing directly to this repository. +- Check the [license](LICENSE.txt) for information regarding the distribution + and modification of Atomic Red Team.