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

[Rule Tuning] Adjusting Microsoft Entra ID Rare Authentication Requirement for Principal User #4562

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

Conversation

terrancedejesus
Copy link
Contributor

@terrancedejesus terrancedejesus commented Mar 25, 2025

Pull Request

Issue link(s):

Summary - What I changed

Tunes the Microsoft Entra ID Rare Authentication Requirement for Principal User rule for the following reasons...

  • Rule capturing MFA workflows; the botnet behavior observed was SFA only. While we could limit the authentication requirement to SFA, I added an exclusion for MFA to catch other anomalous requirements that may exist.
  • Added exclusion not azure.signinlogs.properties.device_detail.browser: * - Before we were ignoring what was suspected to be browser activity, but azure.signinlogs.properties.device_detail.browser is more accurate for determining if this were browser based or not without relying solely on user agents
  • Added inclusion azure.signinlogs.properties.authentication_details.authentication_method: "Password" - The SFA attempts by the botnet were specifically via Password-only attempts. There were plenty of FPs generated from other methods such as OTPs, device-based, etc.
  • Adjusted tags to be accurately correct for service terminology

How To Test

  • Query can be used in TRADE cloud stack or alert telemetry

Checklist

  • Added a label for the type of pr: bug, enhancement, schema, maintenance, Rule: New, Rule: Deprecation, Rule: Tuning, Hunt: New, or Hunt: Tuning so guidelines can be generated
  • Added the meta:rapid-merge label if planning to merge within 24 hours
  • Secret and sensitive material has been managed correctly
  • Automated testing was updated or added to match the most common scenarios
  • Documentation and comments were added for features that require explanation

Contributor checklist

@terrancedejesus terrancedejesus self-assigned this Mar 25, 2025
Copy link
Contributor

Rule: Tuning - Guidelines

These guidelines serve as a reminder set of considerations when tuning an existing rule.

Documentation and Context

  • Detailed description of the suggested changes.
  • Provide example JSON data or screenshots.
  • Provide evidence of reducing benign events mistakenly identified as threats (False Positives).
  • Provide evidence of enhancing detection of true threats that were previously missed (False Negatives).
  • Provide evidence of optimizing resource consumption and execution time of detection rules (Performance).
  • Provide evidence of specific environment factors influencing customized rule tuning (Contextual Tuning).
  • Provide evidence of improvements made by modifying sensitivity by changing alert triggering thresholds (Threshold Adjustments).
  • Provide evidence of refining rules to better detect deviations from typical behavior (Behavioral Tuning).
  • Provide evidence of improvements of adjusting rules based on time-based patterns (Temporal Tuning).
  • Provide reasoning of adjusting priority or severity levels of alerts (Severity Tuning).
  • Provide evidence of improving quality integrity of our data used by detection rules (Data Quality).
  • Ensure the tuning includes necessary updates to the release documentation and versioning.

Rule Metadata Checks

  • updated_date matches the date of tuning PR merged.
  • min_stack_version should support the widest stack versions.
  • name and description should be descriptive and not include typos.
  • query should be inclusive, not overly exclusive. Review to ensure the original intent of the rule is maintained.

Testing and Validation

  • Validate that the tuned rule's performance is satisfactory and does not negatively impact the stack.
  • Ensure that the tuned rule has a low false positive rate.

@@ -172,7 +172,8 @@
},
"logs-azure.signinlogs-*": {
"azure.signinlogs.properties.conditional_access_audiences.application_id": "keyword",
"azure.signinlogs.properties.original_transfer_method": "keyword"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just checking for these do we know if they are present in the azure integration 1.0? Current backports for azure can use 1.0 through 1.22, just making sure we do not need to minstack the rule for the integration version. Thanks!

Copy link
Contributor

@eric-forte-elastic eric-forte-elastic Apr 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But authentication_method does not appear to be 👀 See PR. for more details.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport: auto Domain: Cloud Integration: Azure azure related rules patch Rule: Tuning tweaking or tuning an existing rule
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants