Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Expand evidences #1337

Open
wants to merge 10 commits into
base: main
Choose a base branch
from

Conversation

jonrau-at-queryai
Copy link
Contributor

Related Issue:

Description of changes:

  • Adds resource_details to evidences. This allows producers/mappers to account for cloud-based resources and other generic resources that does not fit well within device or network_endpoint. For instance, the amazonResourceEvidence evidence type in the Microsoft Graph Security List Alerts V2 API.
  • Adds name to evidences. In various upstream platforms such as Microsoft Graph and CrowdStrike, there are either naming conventions for the type of evidence (e.g., amazonResourceEvidence) or an actual display name or direct name such as the display_name value within Behaviors associated with Incidents in CrowdStrike Falcon. Microsoft Defender also has an array of evidence associated with their alerts that each contain the entityType key which identities the name of the evidence.
  • Adds uid to evidences much for the same reason as name. Platforms often have a GUID of some sort identifying the specific evidence associated with an alert such as activity_id associated with Crowdstrike Falcon Alerts which is the smallest "unit" of alerting/detection data. Likewise, the Behaviors associated with CrowdStrike Falcon Incidents each have their own behavior_id which ties them to the Incident ID itself.
  • Adds verdict and verdict_id to evidences to normalize similar values in other systems. In every single Evidence type within Microsoft Graph Security Alerts, there is a verdict enumeration. Likewise, Microsoft Defender for Graph Alerts have evidence arrays with each one containing a DetectionStatus to denotes if something was a FP, TP, or otherwise.

@jonrau-at-queryai jonrau-at-queryai changed the title Expand evidences Expand evidences Feb 5, 2025
@jonrau-at-queryai jonrau-at-queryai added enhancement New feature or request findings Issues related to Findings Category non_breaking Non Breaking, backwards compatible changes v1.5.0 Items to be considered for OCSF v1.5.0 labels Feb 20, 2025
Signed-off-by: Jonathan Rau <139361268+jonrau-at-queryai@users.noreply.github.com>
Signed-off-by: Jonathan Rau <139361268+jonrau-at-queryai@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request findings Issues related to Findings Category non_breaking Non Breaking, backwards compatible changes v1.5.0 Items to be considered for OCSF v1.5.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants