Detection rules › Panther

Okta API Key Revoked

Severity
informational
Log types
Okta.SystemLog
Tags
Identity & Access Management, Okta
Reference
https://help.okta.com/en/prod/Content/Topics/Security/API.htm
Source
github.com/panther-labs/panther-analysis

A user has revoked an API Key in Okta

Rules detecting the same action

Other rules on this platform that filter on the same API call or operation.

Rule body yaml

AnalysisType: rule
Filename: okta_api_key_revoked.py
RuleID: "Okta.APIKeyRevoked"
DisplayName: "Okta API Key Revoked"
Enabled: true
LogTypes:
  - Okta.SystemLog
Tags:
  - Identity & Access Management
  - Okta
Severity: Info
Description: A user has revoked an API Key in Okta
Reference: https://help.okta.com/en/prod/Content/Topics/Security/API.htm
Runbook: Validate this action was authorized.
SummaryAttributes:
  - eventType
  - severity
  - displayMessage
  - p_any_ip_addresses
Tests:
  - Name: API Key Revoked
    ExpectedResult: true
    Log:
      {
        "uuid": "2a992f80-d1ad-4f62-900e-8c68bb72a21b",
        "published": "2021-01-08 21:28:34.875",
        "eventType": "system.api_token.revoke",
        "version": "0",
        "severity": "INFO",
        "legacyEventType": "api.token.revoke",
        "displayMessage": "Revoke API token",
        "actor":
          {
            "alternateId": "user@example.com",
            "displayName": "Test User",
            "id": "00u3q14ei6KUOm4Xi2p4",
            "type": "User",
          },
        "outcome": { "result": "SUCCESS" },
        "request": {},
        "debugContext": {},
        "target":
          [
            {
              "id": "00Tpki36zlWjhjQ1u2p4",
              "type": "Token",
              "alternateId": "unknown",
              "displayName": "test_key",
              "details": null,
            },
          ],
      }

Detection logic

Condition

eventType eq "system.api_token.revoke"
outcome.result eq "SUCCESS"

Indicators

Each row is a field, operator, and value that the rule matches. The corpus column counts how many other rules in the catalog look for the same combination: high numbers point to widely-used, community-vetted indicators. Blank or 1 shows that the indicator is specific to this rule.

FieldKindValues
eventTypeeq
  • system.api_token.revoke
outcome.resulteq
  • SUCCESS

Output fields

Fields the rule emits when it matches. Chronicle authors list these in the outcome block; they appear on the detection and $risk_score drives alerting. Sentinel / Defender XDR rules build them up through project / summarize / extend stages. Sentinel maps these into alert fields via entityMappings and customDetails; Defender XDR custom detections surface them as alert fields directly.

FieldSource
event_typeeventtype
severity
actor
client
request
outcome
target
debug_contextdebugcontext
authentication_contextauthenticationcontext
security_contextsecuritycontext
ipsp_any_ip_addresses
displayNameactor.displayName
alternateIdactor.alternateId