blackstork-io / fabric

An open-source command-line tool for cybersecurity reporting automation and a configuration language for reusable templates. Reporting-as-Code
https://blackstork.io/fabric/
Apache License 2.0
36 stars 2 forks source link

`crowdstrike` plugin with multiple data sources #243

Closed traut closed 4 weeks ago

traut commented 2 months ago

Description

Crowdstike is a leading vendor in cyber security. With such a wide customer base, integrating with Crowdstrike APIs will bring massive value to Fabric users.

This issue defines the requirements for 5 data sources.

Requirements

All data sources share the same configuration arguments:

Docs bit for the creds:

Establishing and retrieving OAuth2 API credentials can be performed at https://falcon.crowdstrike.com/support/api-clients-and-keys

falcon_cspm_ioms data source

The data source fetches cloud indicators of misconfigurations (IOMs) from the Falcon security posture management (CSPM) feature.

Example code using CrowdStrike SDK -- https://github.com/crowdstrike/gofalcon/tree/v0.7.0/examples/falcon_cspm_ioms

falcon_detection_details data source

The data source fetches detection details from Falcon API.

Example code using CrowdStrike SDK -- https://github.com/crowdstrike/gofalcon/tree/v0.7.0/examples/falcon_detection_details

falcon_discover_host_details data source

The data source fetches host details from Falcon Discover Host API.

Example code using CrowdStrike SDK -- https://github.com/crowdstrike/gofalcon/tree/v0.7.0/examples/falcon_discover_host_details

falcon_intel_indicators data source

The data source fetches intel indicators from Falcon API.

Example code using CrowdStrike SDK -- https://github.com/crowdstrike/gofalcon/tree/v0.7.0/examples/falcon_intel_indicators

falcon_vulnerabilities data source

The data source fetches environment vulnerabilities from Falcon Spotlight API.

Example code using CrowdStrike SDK -- https://github.com/crowdstrike/gofalcon/tree/v0.7.0/examples/falcon_vulnerabilities

Additional Information

traut commented 2 months ago

@anasmuhmd one thing I missed here -- all data sources that return lists of items must support the size exec attribute to limit the number of queried items.