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'deny-rbac-denied — no MFA offered
ExpiredPoll timeout (~10 min TTL)Same — create a new session

Audit: always before and after step-up

StageTagSeverityWebhook
Hook blocks, session openedguard_gate_decisionmediumYes (verify URL)
MFA success on auth page{resource}:{action} or mcp:stepuphighYes
MFA failure / cancelsame taghigh, status: falseYes
Retry after verifiedguard_gate_decision (allow)lowNo

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