Cotool + Okta
Connect Okta to Cotool so agents search the System Log, run MFA fatigue and session detections, look up users, and revoke sessions in identity response.
The short answer
With Okta connected, Cotool searches the Okta System Log, runs detections such as MFA push fatigue and session reuse on Okta logs, and gives identity response agents tools to retrieve Okta users and revoke their sessions.[1][2][3]
How it connects: Cotool connects to Okta's management APIs and supports private key JWT authentication. Okta service apps that request Okta scopes must authenticate with private_key_jwt: the app signs a JWT with a private key whose public key is registered in Okta.[1][6]
What Cotool uses from Okta
Response actions
These change state in Okta, so they are the steps teams usually gate behind approval.
- Revoke user sessions
- Identity response agents in Cotool can use a Revoke Okta User Sessions tool alongside Retrieve Okta User.[3]
Detections, hunts, and triage
- MFA push fatigueDetection
- Cotool's example detection counts denied Okta Verify pushes per user over 10 minutes and flags users with 5 or more denials. Okta notes that
deny_pushis a classic-API event; Identity Engine orgs loguser.authentication.auth_via_mfawith reason INVALID_CREDENTIALS instead.[2][8] - Terminated but still activeDetection
- A detection compares terminated workers in Rippling against active Okta users and sends any match to triage.[2]
- Session replay to sensitive dataDetection
- Cotool's detection library example correlates Okta session replay with Google Workspace Drive access and runs every 15 minutes on both sources.[2]
- Identity alert responseResponse
- An Identity Alert Responder triages Okta Identity Protection alerts, retrieves the user, and can revoke their sessions when compromise is confirmed.[3]
Example query
SELECT actor_id, COUNT(*) AS denies
FROM cotool_logs.okta
WHERE event_type = 'user.mfa.okta_verify.deny_push'
AND ts > now() - INTERVAL 10 MINUTE
GROUP BY actor_id
HAVING denies >= 5Adapted from the detection on Cotool's Detect page. On Identity Engine orgs, match user.authentication.auth_via_mfa failures instead.[2][8]
Setup and permissions
Create an API service app in Okta, register its public key, grant the Okta scopes it needs, and assign it an admin role that allows those operations.[6]
| Permission | Access | Why |
|---|---|---|
| System Log read scopeThe read scope in Okta's `okta.logs` family. It lets the app read System Log entries.[7] | Read | The read scope in Okta's `okta.logs` family. It lets the app read System Log entries.[7] |
okta.users.readRead existing users' profiles and credentials.[7] | Read | Read existing users' profiles and credentials.[7] |
okta.groups.readRead groups and their members.[7] | Read | Read groups and their members.[7] |
okta.sessions.readRead sessions in the org.[7] | Read | Read sessions in the org.[7] |
okta.users.manageManage users' profile and credentials information. Grant it only if agents should act on users.[7] | Write | Manage users' profile and credentials information. Grant it only if agents should act on users.[7] |
How Cotool works with Okta
FAQ
- Is this the same as Okta SSO for Cotool?
- No. Okta SSO and SCIM provisioning for signing in to Cotool are configured separately with SAML 2.0 and SCIM 2.0. This page covers Okta as a security data source and response target.[5]
- Why does my MFA fatigue rule find nothing?
- Identity Engine orgs do not log
user.mfa.okta_verify.deny_push; they loguser.authentication.auth_via_mfawith reason INVALID_CREDENTIALS. Match the event your org emits.[8]
Sources
- Changelog (Cotool docs) · accessed November 16, 2026
- Detections are code (Cotool Detect) · accessed November 16, 2026
- Respond to every signal (Cotool Respond) · accessed November 16, 2026
- SIEM (Cotool) · accessed November 16, 2026
- Okta integration (Cotool docs) · accessed November 16, 2026
- Implement OAuth for Okta with a service app (Okta Developer) · accessed November 16, 2026
- OAuth 2.0 scopes (Okta Developer) · accessed November 16, 2026
- Event types (Okta Developer) · accessed November 16, 2026
