Duo User Action Reported as Fraudulent

AnalysisType: rule
Filename: duo_user_action_fraudulent.py
RuleID: "DUO.User.Action.Fraudulent"
DisplayName: "Duo User Action Reported as Fraudulent"
Enabled: true
DedupPeriodMinutes: 15
LogTypes:
  - Duo.Authentication
Tags:
  - Duo
Severity: Medium
Description: >
  Alert when a user reports a Duo action as fraudulent.
Reference: https://duo.com/docs/adminapi#authentication-logs
Runbook: Follow up with the user to confirm.
Tests:
  - Name: user_marked_fraud
    ExpectedResult: true
    Log:
      {
        "access_device": { "ip": "12.12.112.25", "os": "Mac OS X" },
        "auth_device": { "ip": "12.12.12.12" },
        "application": { "key": "D12345", "name": "Slack" },
        "event_type": "authentication",
        "factor": "duo_push",
        "reason": "user_marked_fraud",
        "result": "fraud",
        "user": { "name": "example@example.io" },
      }


# ------ paired body: duo_user_action_fraudulent.py ------

def rule(event):
    return event.get("result") == "fraud"


def title(event):
    user = event.deep_get("user", "name", default="Unknown")
    return f"A Duo action was marked as fraudulent by [{user}]"


def alert_context(event):
    return {
        "factor": event.get("factor"),
        "reason": event.get("reason"),
        "user": event.deep_get("user", "name", default=""),
        "os": event.deep_get("access_device", "os", default=""),
        "ip_access": event.deep_get("access_device", "ip", default=""),
        "ip_auth": event.deep_get("auth_device", "ip", default=""),
        "application": event.deep_get("application", "name", default=""),
    }