pySigma CrowdStrike Logscale backend and processing pipelines for the Falcon data model.
Project description
pySigma CrowdStrike Backend
This is the CrowdStrike backend for pySigma. It provides the package sigma.backends.crowdstrike with the LogScaleBackend class.
Further it contains the following processing pipelines under sigma.pipelines.crowdstrike:
crowdstrike_fdr_pipelinewhich was mainly written for the Falcon Data Replicator data but Splunk queries should work in the legacy CrowdStrike Splunk. The pipeline can also be used with other backends in case you ingest Falcon data to a different SIEM.crowdstrike_falcon_pipelinewhich was written for data collected by the CrowdStrike Falcon Agent stored natively in CrowdStrike Logscale. It effectively translates rules to the CrowdStrike Query Language used by LogScale. This is designed to be used with theLogScaleBackend.
Supported Rules
Falcon Pipeline
The following categories and products are supported by the pipelines:
| category | product | CrowdStrike event_simpleName |
|---|---|---|
process_creation |
windows, linux |
ProcessRollup2, SyntheticProcessRollup2 |
network_connection |
windows |
NetworkConnectIP4, NetworkReceiveAcceptIP4 |
dns_query |
windows |
DnsRequest |
image_load |
windows |
ClassifiedModuleLoad |
driver_load |
windows |
DriverLoad |
ps_script |
windows |
CommandHistory, ScriptControlScanTelemetry |
There's likely more windows categories that can be supported by the pipelines; We will be adding support gradually as availability allows.
Limitations and caveats:
-
Full Paths: Falcon agents do not capture drive names when logging paths. Instead, when drive letters are expected the device path is used. For example,
C:\Windowsresults to\Device\HarddiskVolume3\Windowsin the logs. To account for this, the pipeline replaces any drive letters in fields containing full path with\Device\HarddiskVolume?\(where '?' can be any single character). -
Parent Name: Falcon
process_creationevents do not capture the full path of the parent. Hence, in such cases the transformation is configured to fail. -
DNS Query Results: Falcon
dns_queryevents return the IP records of a successful query in semicolon-separated string. The pipeline handles this by enforcing a "contains" expression on theQueryResultsfield -
Unsupported fields: Falcon does not always capture the same fields as sysmon for the categories supported. In cases where the rule requires unsupported fields, the transformation fails.
-
PS Script Logging: There is not a clean equivelant between the events Falcon generates and PowerShell Script Logging. Our transformation is a best-effort approach that contains multiple fields that might contain the value in the field.
References
This backend is currently maintained by:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pysigma_backend_crowdstrike-2.1.0rc1.tar.gz.
File metadata
- Download URL: pysigma_backend_crowdstrike-2.1.0rc1.tar.gz
- Upload date:
- Size: 19.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0e96921d62a467be943b51622f92da623e0bf52d038403ee9e2311e9967f1e64
|
|
| MD5 |
85a91c8f71c9a98cd2f71ce25093ef0f
|
|
| BLAKE2b-256 |
ecdf929fe9aa08b5fbe7845f294245b77a411d1a14a1e5b81ced3f564c7d283b
|
Provenance
The following attestation bundles were made for pysigma_backend_crowdstrike-2.1.0rc1.tar.gz:
Publisher:
release.yml on SigmaHQ/pySigma-backend-crowdstrike
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pysigma_backend_crowdstrike-2.1.0rc1.tar.gz -
Subject digest:
0e96921d62a467be943b51622f92da623e0bf52d038403ee9e2311e9967f1e64 - Sigstore transparency entry: 404440702
- Sigstore integration time:
-
Permalink:
SigmaHQ/pySigma-backend-crowdstrike@7f895364ba335362b559923594e53ad6b7f64236 -
Branch / Tag:
refs/tags/v2.1.0rc1 - Owner: https://github.com/SigmaHQ
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@7f895364ba335362b559923594e53ad6b7f64236 -
Trigger Event:
release
-
Statement type:
File details
Details for the file pysigma_backend_crowdstrike-2.1.0rc1-py3-none-any.whl.
File metadata
- Download URL: pysigma_backend_crowdstrike-2.1.0rc1-py3-none-any.whl
- Upload date:
- Size: 19.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8e7b6af6c5687d9798add2ceeee4f8dab3dd2094dacd7fe10990f69e4efb2cd9
|
|
| MD5 |
6b28a0fc86bba5be647b69a98ce48383
|
|
| BLAKE2b-256 |
c0ac673caf7954a95b00041072f3ac0e77df889863a5ec00d124c5c1e7c38351
|
Provenance
The following attestation bundles were made for pysigma_backend_crowdstrike-2.1.0rc1-py3-none-any.whl:
Publisher:
release.yml on SigmaHQ/pySigma-backend-crowdstrike
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pysigma_backend_crowdstrike-2.1.0rc1-py3-none-any.whl -
Subject digest:
8e7b6af6c5687d9798add2ceeee4f8dab3dd2094dacd7fe10990f69e4efb2cd9 - Sigstore transparency entry: 404440703
- Sigstore integration time:
-
Permalink:
SigmaHQ/pySigma-backend-crowdstrike@7f895364ba335362b559923594e53ad6b7f64236 -
Branch / Tag:
refs/tags/v2.1.0rc1 - Owner: https://github.com/SigmaHQ
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@7f895364ba335362b559923594e53ad6b7f64236 -
Trigger Event:
release
-
Statement type: