https://github.com/crowdstrike/detection-container

https://github.com/crowdstrike/detection-container

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (7.5%) to scientific vocabulary

Keywords from Contributors

scripting crowdstrike falcon sensor powershell security-automation python39 python38 python37 python313
Last synced: 11 months ago · JSON representation

Repository

Basic Info
Statistics
  • Stars: 46
  • Watchers: 12
  • Forks: 23
  • Open Issues: 1
  • Releases: 0
Created almost 6 years ago · Last pushed about 2 years ago
Metadata Files
Readme License

README.md

CrowdStrike Docker Detection Container

Container Repository on Quay

This container will create detections and preventions only on Linux hosts, container platforms (e.g. OpenShift), and containers themselves, which are protected by a CrowdStrike sensor.

Automated detections currently available include:

| Name | Description | |:-----|:------------| | Defense Evasion via Rootkit | This script will change the group owner of /etc/ld.so.preload to 0, indicative of a Jynx Rootkit. | | Execution via Command-Line Interface | Emulate malicious activity related to suspicious CLI commands. Runs the command sh -c whoami '[S];pwd;echo [E]'.| | Exfiltration Over Alternative Protocol | Attempts to exfiltrate data using DNS dig requests that contain system data in the hostname. | | Command & Control via Remote Access Protocol * | Attempts to connect to a remote IP address and will exit at fork. Falcon Prevent will kill the attempt. | | Collection via Automated Collection | Attempts to dump credentials from /etc/passwd to /tmp/passwords. | | Credential Access via Credential Dumping | Runs mimipenguin and tries to dump passwords from inside the container environment. | | Webserver Suspicious Terminal Spawn | Executes a command injection, which writes a file to local webserver then executes that script. | | Webserver Unexpected Child of Web Service |Executes command injection to dump MySQL Server tables of database running inside the detection container. | | Webserver Bash Reverse Shell * | Executes command injection that creates a reverse shell over the web server running in the detection container. | | Webserver Trigger Metasploit Payload ** | Simulates a malicious file upload, which executes a reverse TCP meterpreter to Kali. Please review the script for details on how to trigger this detection. | | Reverse TCP Trojan (inert) * | Inert Trojan, written by CrowdStrike, that will attempt to connect to 192.168.0.1 on TCP port 4444. Tnis will be detected and killed by CrowdStrike's on-sensor machine learning with the aggressive policy settings. |

!NOTE eligible for Prevention if configured in policy

(**) container starting using exposed port (-p 8080:80) required and a Kali attack host ready. Please note that a detection will only occur once you execute commands via meterpreter!

Downloading & Usage

Download via Quay.io

Container images hosted at https://quay.io/repository/crowdstrike/detection-container are automatically rebuilt as mult-architecture images with every merged pull request. Pull this container with the following Docker (or podman!) command:

Using Docker CLI:

shell docker pull quay.io/crowdstrike/detection-container

Using Podman CLI:

shell podman pull quay.io/crowdstrike/detection-container

If a specific architecture is desired to be used, add the --platform flag with the desired architecture(s): linux/arm64,linux/amd64,linux/s390x,linux/ppc64le

Build from Source

Clone this repository and build the container using docker build or podman build:

With Docker CLI:

shell docker build -t <your_repository>/detection-container .

Podman CLI:

shell podman build -t <your_repository>/detection-container .

Multi-architecture Build (requires Docker with BuildKit):

shell make docker-buildx

Generate Sample Detections

The detection-container operates in one of two modes, suitable for both Docker and Kubernetes environments:

Interactive Mode

This mode exposes a text-based user interface (TUI) for selecting pre-canned scripts to generate simple detections (e.g., "hit #1 for credential dumping!").

An example of running in interactive mode is shown below:

detection-container Text User Interface

For Docker, use the following command to run the detection container interactively:

bash sudo docker run --rm -it quay.io/crowdstrike/detection-container

For Kubernetes environments, refer to the vulnapp project for running the detection container interactively.

Non-interactive Mode

In this mode, detections are randomly generated with pauses between each to ensure uniqueness in the Falcon console. The pause duration ranges from 100 to 1800 seconds (approximately 1.5 to 30 minutes).

Output will be sent to the console (via stdout) regarding what detections are being generated. An example of running in non-interactive mode, plus output, is shown below:

non-interactive mode

For Docker, use the following command to run the detection container non-interactively:

bash sudo docker run --rm quay.io/crowdstrike/detection-container

For Kubernetes environments, use the following command to run the detection container non-interactively:

bash kubectl create -f https://raw.githubusercontent.com/CrowdStrike/detection-container/main/detections.example.yaml

Owner

  • Name: CrowdStrike
  • Login: CrowdStrike
  • Kind: organization
  • Email: github@crowdstrike.com
  • Location: United States of America

GitHub Events

Total
  • Watch event: 6
  • Fork event: 3
  • Create event: 1
Last Year
  • Watch event: 6
  • Fork event: 3
  • Create event: 1

Committers

Last synced: about 1 year ago

All Time
  • Total Commits: 59
  • Total Committers: 10
  • Avg Commits per committer: 5.9
  • Development Distribution Score (DDS): 0.746
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Shawn Wells s****n@s****o 15
Gabe Alford r****s@g****m 13
intelwolf “****” 10
Simon Lukasik s****k@c****m 9
Carlos Matos c****s@c****m 7
Joshua Hiller j****r@c****m 1
Sergey Kozlov s****v@c****m 1
Marcel m****n@d****m 1
Aune Mitchell a****l@g****m 1
Dieuwer Hondelink d****k@e****y 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: about 1 year ago

All Time
  • Total issues: 9
  • Total pull requests: 34
  • Average time to close issues: 2 days
  • Average time to close pull requests: about 18 hours
  • Total issue authors: 8
  • Total pull request authors: 8
  • Average comments per issue: 2.11
  • Average comments per pull request: 0.65
  • Merged pull requests: 33
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • carlosmmatos (2)
  • jmckenzie-cs (1)
  • jzs-cs (1)
  • gelim (1)
  • redhatrises (1)
  • serai-nick-chan (1)
  • shawndwells (1)
  • djstachniak (1)
Pull Request Authors
  • redhatrises (14)
  • isimluk (8)
  • shawndwells (7)
  • carlosmmatos (5)
  • auneemitchell (2)
  • DieuwerH (1)
  • jshcodes (1)
  • skozlov-cs (1)
Top Labels
Issue Labels
bug (1)
Pull Request Labels
documentation (4) bugfix (2) enhancement (1)

Dependencies

.github/workflows/build.yml actions
  • actions/checkout v3 composite
  • docker/build-push-action v4 composite
  • docker/login-action v2 composite
  • docker/setup-buildx-action v2 composite
  • docker/setup-qemu-action v2 composite
.github/workflows/container_build.yml actions
  • actions/checkout v3 composite
Dockerfile docker
  • registry.access.redhat.com/ubi9/ubi latest build