Skip to Content
DocumentationCommonStep-up AuthStep 4: Outcome and audit

Step 4: Outcome and audit

⚡ 2 min read

Terminal states

StateSDKMCP / hook
Verifieddecision: 'stepup', status: 'verified' — proceedRetry command; verified sid attached to level-2 API calls
Rejectedstatus: 'rejected' or overlay dismissedPending cleared; agent must start a new session
Denied (RBAC)decision: 'deny'Hard block — no MFA offered
ExpiredPoll timeout (~10 min TTL)Same — create a new session

Audit and webhooks

StageTagSeverityWebhook
Hook blocks, session opened (MFA pending)Session webhook (verify URL)
MFA success on auth page{resource}:{action} or mcp:stepuphighYes
MFA failure / cancelsame taghigh, status: falseYes
Retry after verified sessionguard_gate_decision (allow)lowNo
Step-up session create failedguard_gate_decision (deny-stepup-failure)mediumNo

Metadata on MFA rows includes type: mcp-stepup and method (passkey, totp, email-otp, …).

View in Console Audit Logs or MCP get_security_logs. Notification rules: Webhook.


Custom app events

After step-up succeeds, you can log business actions separately:

await transcodes.trackUserAction({ tag: 'documents:delete', severity: 'high', status: true, metadata: { documentId: 'doc_123' }, });

Last updated on