Review attack protection events in System Log

Use the System Log to review attack protection events in your org.

About this task

Early Access release

The attack protection policy is evaluated during your sign-in, sign-up, and self-service password recovery flows. Whenever a user or agent submits credentials for authentication and clicks Next, Sign up, or Change password, the event is recorded in the System Log.

Before you begin

  • Your org has Identity Threat Protection enabled.
  • You have configured an attack protection policy.

Procedure

  1. In the Admin Console, go to Reports > System Log.
  2. To find when a bot was detected, enter the following query in the search field: securityContext.botProtection.level ne "NONE".
  3. To see bots with medium and/or high bot likeliness, use the following queries:
    • Only medium or high: securityContext.botProtection.level eq "HIGH" or securityContext.botProtection.level eq "MEDIUM"
    • Only high: securityContext.botProtection.level eq "HIGH"
  4. To search for matched rules in your policy, use the following queries:
    • Get requests challenged: target.detailEntry.policyMatchedRuleAction eq "OKTA_CHALLENGE"
    • Get all requests where the policy was evaluated: target.detailEntry.policyType eq "ATTACK_PROTECTION"

    • Get a specific rule's match: target.detailEntry.policyId eq "yourRuleId"
  5. To review requests that attack protection evaluated, or specific challenge outcomes, use one of the following queries:
    • Failed Okta challenges: outcome.reason eq "OKTA_CHALLENGE_FAILED"
    • High likeliness bots: securityContext.botProtection.level eq "HIGH". You can also use LOW or MEDIUM.
  6. To isolate bot activity in a specific user flow, add the corresponding eventType filter to any query using the AND operator:
    • Sign in: eventType eq "user.session.start"
    • Password reset: eventType eq "user.account.reset_password"
    • Sign up: eventType eq "user.lifecycle.create"
  7. Configure the date range, and then click the magnifying glass icon beside the Search field.