v1.0.0

Policy Engine

HCS is a score, not a decision. Call GET /v1/session/:id?critical=true before a high-stakes action, and the policy engine maps the score plus that critical flag to a BotAction — what actually happens. See Policy Rules for how to use this.

Allow

Let the request through normally. Used for high-HCS sessions.

SilentTarpit

Deliberately slow the response without telling the caller — wastes an automated attacker's time without alerting them.

StepUpChallenge

Ask for additional verification (WebAuthn) before proceeding. For borderline HCS scores on critical actions.

HoneypotRedirect

Route the request to a decoy flow that looks real but does nothing — useful for observing attacker behavior safely.

RateLimit

Drop the session's request rate to a fixed ceiling via Redis. Applied alongside the primary action, not instead of it.

TerminateSession

End the session immediately by revoking it. Used for confidently synthetic traffic attempting a critical action.

Example configuration

Policy rule
{
  "min_hcs": 0.30,
  "max_hcs": 0.35,
  "action": "StepUpChallenge",
  "tarpit_delay_ms": null
}
ℹ️
Policies are configured per organization, not per session — every session that falls in a given HCS range gets the same action, applied consistently.