Sergey Polzunov
c7246313f7
* Add remote ESQL validation --------- Co-authored-by: Eric Forte <119343520+eric-forte-elastic@users.noreply.github.com> Co-authored-by: eric-forte-elastic <eric.forte@elastic.co> Co-authored-by: Mika Ayenson <mika.ayenson@elastic.co> Co-authored-by: Mika Ayenson, PhD <Mikaayenson@users.noreply.github.com>
64 lines
2.3 KiB
Python
64 lines
2.3 KiB
Python
# Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
|
|
# or more contributor license agreements. Licensed under the Elastic License
|
|
# 2.0; you may not use this file except in compliance with the Elastic License
|
|
# 2.0.
|
|
|
|
import re
|
|
from dataclasses import dataclass, field
|
|
from pathlib import Path
|
|
|
|
# Define the hunting directory path
|
|
HUNTING_DIR = Path(__file__).parent
|
|
|
|
# URLs for MITRE and Elastic documentation
|
|
ATLAS_URL = "https://atlas.mitre.org/techniques/"
|
|
ATTACK_URL = "https://attack.mitre.org/techniques/"
|
|
|
|
# Static mapping for specific integrations
|
|
STATIC_INTEGRATION_LINK_MAP = {"aws_bedrock.invocation": "aws_bedrock"}
|
|
|
|
|
|
@dataclass
|
|
class Hunt:
|
|
"""Dataclass to represent a hunt."""
|
|
|
|
author: str
|
|
description: str
|
|
integration: list[str]
|
|
uuid: str
|
|
name: str
|
|
language: list[str]
|
|
license: str
|
|
query: list[str]
|
|
notes: list[str] | None = field(default_factory=list) # type: ignore[reportUnknownVariableType]
|
|
mitre: list[str] = field(default_factory=list) # type: ignore[reportUnknownVariableType]
|
|
references: list[str] | None = field(default_factory=list) # type: ignore[reportUnknownVariableType]
|
|
|
|
def __post_init__(self) -> None:
|
|
"""Post-initialization to determine which validation to apply."""
|
|
if not self.query:
|
|
raise ValueError(f"Hunt: {self.name} - Query field must be provided.")
|
|
|
|
# Loop through each query in the array
|
|
for q in self.query:
|
|
query_start = q.strip().lower()
|
|
|
|
# Only validate queries that start with "from" (ESQL queries)
|
|
if query_start.startswith("from"):
|
|
self.validate_esql_query(q)
|
|
|
|
def validate_esql_query(self, query: str) -> None:
|
|
"""Validation logic for ESQL."""
|
|
query = query.lower()
|
|
|
|
if self.author == "Elastic":
|
|
# Regex patterns for checking "stats by" and "| keep"
|
|
stats_by_pattern = re.compile(r"\bstats\b.*?\bby\b", re.DOTALL)
|
|
keep_pattern = re.compile(r"\| keep", re.DOTALL)
|
|
|
|
# Check if either "stats by" or "| keep" exists in the query
|
|
if not stats_by_pattern.search(query) and not keep_pattern.search(query):
|
|
raise ValueError(
|
|
f"Hunt: {self.name} contains an ES|QL query that must contain either 'stats by' or 'keep' functions"
|
|
)
|