Skip to main content
ALTCHA®

Glossary

Terms used throughout the Sentinel v2 documentation, in alphabetical order.

Terms

TermMeaning
Access levelWhat an API key may call: public (widget endpoints), restricted (server-side endpoints), or full (server-side endpoints, plus the account-management endpoints its security group's role grants). It is set by the key's security group, not the key. See API keys.
AccountTenant that owns API keys, security groups, and training data; users get access to it through roles. See Accounts and users.
Admin sessionA signed-in user's session token (JWT), sent as a Bearer token or jwt cookie; required by the admin endpoints and never accepted where an API key is expected. Account-management endpoints also accept a full API key whose security group has a role. See Sign-in.
AI deciderOptional classification category (ai) that asks a remote decision model yes/no questions about a text; it can only raise the score. See AI decider.
AlertA stored notification Sentinel raises about logins, verifications, API key use, replicas, remote files, storage, or releases, optionally delivered to webhooks or push. See Alerts.
API keyCredential used by the widget or your backend; its access level and rules come from its security group. See API keys.
Base URLThe public URL a listener is reached at. [server] base_url prefixes the URLs handed to widgets (verifyUrl, audio); [auth] base_url or [server.admin_ui] base_url sets the sign-in and passkey URL. See Listeners.
CampaignThe same text, or a near-duplicate, sent by at least min_sources distinct sources within a time window; scored by the CAMPAIGN rule. See Similarity.
CategoryA group of classifier rules scored together, such as device, email, ip, location, text, similarity, his, or ai. See Classifier rules.
ClassificationSee Verdict.
Classification scoreThe top-level score: the mean of the categories that ran, floored to 2 decimals, then raised to minimums by strong signals (floors). Below 1 is GOOD, below 2 NEUTRAL, otherwise BAD. See Scoring.
Code challengeAn image or audio code the user must type, shown when the security group's rules require it. See Code challenge.
DoctorDiagnostic report of config, storage, network, license, and cluster checks, available as altcha-sentinel doctor and through the API. See CLI reference and Troubleshooting.
EDKEphemeral Device Key: a daily device identifier derived from the client IP, User-Agent, and Accept-Language, rolling over at midnight in [edk] time_zone.
FloorA minimum the classification score is raised to when a strong signal fires (for example a triggered injection rule raises it to at least 2, so BAD). See Scoring.
HISHuman Interaction Signature: a bot probability (0.01–1) computed from the pointer, touch, scroll, focus, key, and click samples the widget collects. See Human Interaction Signature.
Instance slotA license-counted lease each running process holds in the database (30-second lease, renewed every 10 seconds); a process over the license's instances limit gets 503 LICENSE_INSTANCE_LIMIT. See Clustering.
KV storeKey-value store for replay protection, rate limits, and penalties: embedded by default, or Redis-compatible via [redis]. See Databases.
ListenerOne HTTP server Sentinel binds: the main API ([server]), and optionally the widget-only public API ([server.public_api]) and the admin UI ([server.admin_ui]). See Listeners.
Monitor modeA rule that is evaluated and logged (in context.monitor) but has no effect on the request. See Security rules.
Near-duplicateA text that matches a stored sample or recent message almost exactly (similarity score 1); scored by the NEAR_DUPLICATE rule. See Similarity.
PasskeyA WebAuthn credential a user registers as a second factor or to sign in. See Sign-in.
PenaltyStateful 0–10 score per account and client IP, raised by misbehavior (failed verifications, rate-limit pressure, penalty.add rules) and expiring [penalty] ttl after its last increase. See Scoring.
PresetAdmin UI template that writes named rules (preset:<id>:<part>) into a security group. See Presets.
Remote fileA list or database (classifier lists, GeoIP .mmdb, threat lists, models) downloaded and refreshed on a schedule. See Remote files.
ReplicaOne running Sentinel process; replicas sharing a database form a cluster. See Clustering.
Request logPer-request record (classification, triggered rules, context) of API keys with logging enabled, stored in the database or ClickHouse. See Request logs.
RiskStateless 0–10 score from the device, IP, and location rules, returned by GET /v2/inspect and usable in the risk rule condition. See Scoring.
Role / membershipA user's permissions within one account. Root can also give a full security group a role, which grants its API keys those permissions in the group's account. See Accounts and users.
RuleOne entry in a security group's ordered rule list, with action allow, deny, accept, or set. See Rules reference.
Security groupAccess level plus an ordered list of rules applied to every request made with its API keys. See Security groups.
SnapshotExport of the whole database as a ZIP file, optionally age-encrypted, restorable with POST /v2/snapshots/_restore. See Snapshots.
Step-up verificationA fresh second-factor check that returns a short-lived step-up token (x-step-up-token), required for sensitive account changes. See Sign-in.
Threat entryA manual or automatic record for an IP or network with a threat verdict. See Threat intelligence.
Threat sourceA remote IP list Sentinel downloads and matches client IPs against. See Threat intelligence.
Threat verdictThe outcome of threat matching for an IP: allow or block. See Threat intelligence.
Training group / sampleLabeled example texts (samples) organized in groups, used for similarity matching. See Similarity.
Training suggestionA text the text rules found spam, queued for review to accept as a training sample. See Similarity.
User / rootAn admin identity that signs in; root is a flag granting full access to every account, not a role. See Accounts and users.
verificationDataThe signed, URL-encoded string POST /v2/verify returns with the classification, score, and signals, for your backend to check and act on. See Verification.
VerdictThe classification of a request: GOOD, NEUTRAL, or BAD. See Scoring.
Web Bot AuthSigned HTTP requests by which AI agents and crawlers identify themselves; matched with the agent rule condition. See Bots and agents.

Start typing to search...

↑ ↓ Navigate ↵ Select