datadog/threatestCLI и Go-фреймворк для сквозного тестирования правил обнаружения угроз. Запускает техники атак и проверяет оповещения в платформах безопасности, таких как Datadog и Elastic Security.
Threatest — это CLI и Go-фреймворк для сквозного тестирования обнаружения угроз.
Threatest позволяет детонировать технику атаки и проверять, было ли сгенерировано ожидаемое оповещение в вашей любимой платформе безопасности.
Прочитайте анонс в блоге: https://securitylabs.datadoghq.com/articles/threatest-end-to-end-testing-threat-detection/
Детонатор описывает, как и где выполняется техника атаки.
Поддерживаемые детонаторы:
Соответствие оповещений — это интеграция, специфичная для платформы, которая может проверить, было ли вызвано ожидаемое оповещение.
Поддерживаемые соответствия оповещений:
Каждой детонации присваивается UUID. Этот UUID отражается в детонации и используется для обеспечения того, чтобы сопоставленное оповещение точно соответствовало этой детонации.
Способ этого зависит от детонатора; например, Stratus Red Team и AWS Detonator внедряют его в user-agent; SSH-детонатор использует родительский процесс, содержащий UUID.
Threatest поставляется с CLI, который можно использовать для запуска тестовых сценариев, описанных в YAML, согласно определённой схеме. Вы можете настроить эту схему в вашем редакторе, чтобы использовать линтинг и автодополнение в IDE (см. документацию для VSCode с использованием расширения YAML).
Установите CLI, скачав бинарный релиз или с помощью Homebrew:
brew tap datadog/threatest https://github.com/datadog/threatest
brew install datadog/threatest/threatest
Пример использования:
$ threatest lint scenarios.threatest.yaml
All 6 scenarios are syntaxically valid
# Local detonation
$ threatest run local-scenarios.threatest.yaml
# Remote detonation over SSH
$ threatest run scenarios.threatest.yaml --ssh-host test-box --ssh-username vagrant
# Alternatively, specify SSH parameters from environment variables
$ export THREATEST_SSH_HOST=test-box
$ export THREATEST_SSH_USERNAME=vagrant
$ threatest run scenarios.threatest.yaml
Примеры файлов определения сценариев
scenarios:
# Remote detonation over SSH
# Note: SSH configuration is provided using the --ssh-host, --ssh-username and --ssh-keyfile CLI arguments
- name: curl metadata service
detonate:
remoteDetonator:
commands: ["curl http://169.254.169.254 --connect-timeout 1"]
expectations:
- timeout: 1m
datadogSecuritySignal:
name: "Network utility accessed cloud metadata service"
severity: medium
scenarios:
# Stratus Red Team detonation
# Note: You must be authenticated to the relevant cloud provider before running it
# The example below is equivalent to manually running "stratus detonate aws.exfiltration.ec2-security-group-open-port-22-ingress"
- name: opening a security group to the Internet
detonate:
stratusRedTeamDetonator:
attackTechnique: aws.exfiltration.ec2-security-group-open-port-22-ingress
expectations:
- timeout: 15m
datadogSecuritySignal:
name: "Potential administrative port open to the world via AWS security group"
scenarios:
# AWS CLI detonation
# Note: You must be authenticated to AWS before running it and have the AWS CLI installed
- name: opening a security group to the Internet
detonate:
awsCliDetonator:
script: |
set -e
# Setup
vpc=$(aws ec2 create-vpc --cidr-block 10.0.0.0/16 --query Vpc.VpcId --output text)
sg=$(aws ec2 create-security-group --group-name sample-sg --description "Test security group" --vpc-id $vpc --query GroupId --output text)
# Open security group
aws ec2 authorize-security-group-ingress --group-id $sg --protocol tcp --port 22 --cidr 0.0.0.0/0
# Cleanup
aws ec2 delete-security-group --group-id $sg
aws ec2 delete-vpc --vpc-id $vpc
expectations:
- timeout: 15m
datadogSecuritySignal:
name: "Potential administrative port open to the world via AWS security group"
Вы можете вывести результаты тестов в JSON-файл:
$ threatest run scenarios.threatest.yaml --output test-results.json
$ cat test-results.json
[
{
"description": "change user password",
"isSuccess": true,
"errorMessage": "",
"durationSeconds": 22.046627348,
"timeDetonated": "2022-11-15T22:26:14.182844+01:00"
},
{
"description": "adding an SSH key",
"isSuccess": true,
"errorMessage": "",
"durationSeconds": 23.604699625,
"timeDetonated": "2022-11-15T22:26:14.182832+01:00"
},
{
"description": "change user password",
"isSuccess": false,
"errorMessage": "At least one scenario failed:\n\nchange user password returned: change user password: 1 assertions did not pass\n =\u003e Did not find Datadog security signal 'bar'\n",
"durationSeconds": 3.505294235,
"timeDetonated": "2022-11-15T22:26:36.229349+01:00"
}
]
По умолчанию сценарии выполняются с максимальным параллелизмом 5. Вы можете увеличить это значение с помощью аргумента --parallelism.
Обратите внимание, что при использовании удалённых SSH-детонаторов каждый запускаемый сценарий устанавливает новое SSH-соединение.
Смотрите примеры для полного примера программного использования.
threatest := Threatest()
threatest.Scenario("AWS console login").
WhenDetonating(StratusRedTeamTechnique("aws.initial-access.console-login-without-mfa")).
Expect(DatadogSecuritySignal("AWS Console login without MFA", WithSeverity("medium"))).
WithTimeout(15 * time.Minute)
assert.NoError(t, threatest.Run())
ssh, _ := NewSSHCommandExecutor("test-box", "", "")
threatest := Threatest()
threatest.Scenario("curl to metadata service").
WhenDetonating(NewCommandDetonator(ssh, "curl http://169.254.169.254 --connect-timeout 1")).
Expect(DatadogSecuritySignal("EC2 Instance Metadata Service Accessed via Network Utility"))
assert.NoError(t, threatest.Run())