Why MagenTrust
MagenTrust adds continuous identity assurance for people, agents and machines to your applications. Instead of a one-time CAPTCHA, MagenTrust evaluates behavioral and entropy signals throughout the session and returns PASS, CHALLENGE or INTERRUPT before consequential actions, without adding user friction.
Integrate MAGEN into your registration flows, checkout processes, or any user interaction where you need to verify authentic human behavior. The API works silently in the background, only escalating to visible challenges when risk levels warrant intervention.
#How It Works
MAGEN integrates seamlessly into your application's existing flow. The verification process happens invisibly in the background, with the SDK collecting behavioral signals while users interact naturally with your interface.
Data Flowing from MAGEN SDK
The SDK passively collects behavioral entropy signals as users interact with your application. This data is compressed and sent to the API during verification.
"sessionId": "uuid",
"challengeToken": "jwt",
"entropy": {
"mouse": [...events],
"keyboard": [...events],
"touch": [...events],
"timing": {
"start": 1704067200000,
"end": 1704067205000
}
}
}
Install the MAGEN SDK and initialize it on page load. The SDK automatically begins collecting behavioral entropy.
Before critical actions (signup, checkout), call verify() to submit entropy and receive a verdict token.
Validate the token via GET /magen-verify-session to confirm the human classification before processing.
#MagenTrust API Capabilities
MAGEN API provides a comprehensive set of capabilities designed to help you keep identity assurance continuous across people, agents and machines while maintaining a seamless experience for legitimate users.
Behavioral Fingerprinting
Analyze mouse movements, keyboard patterns, scroll behavior, and touch gestures to create unique behavioral signatures.
Entropy Signals
Collect and evaluate randomness in user interactions to establish verifiable human presence.
Real-time Scoring
Get instant confidence scores and classifications within milliseconds, without blocking legitimate users.
Adaptive Challenges
Deploy graduated entropy challenges based on risk scores, from passive monitoring to active verification.
Capability → Endpoint Mapping
POST /magen-verify-startPOST /magen-verify-checkPOST /magen-entropy-deployGET /magen-entropy-status/:sessionIdGET /magen-verify-session/:sessionIdDELETE /magen-session-delete/:sessionId#Behavioral Analysis
MAGEN collects behavioral signals from user interactions to build a comprehensive profile of how they engage with your application. These signals include:
- Mouse movement patterns, velocity, and acceleration
- Keyboard timing, dwell time, and typing rhythm
- Touch gestures, pressure sensitivity, and swipe patterns
- Scroll behavior and viewport interactions
- Device orientation and motion sensor data
All behavioral data is collected passively in the background. Users never see a CAPTCHA or interruption unless the risk score triggers an escalation.
#Entropy Challenges
When passive analysis isn't sufficient to make a confident determination, MAGEN can deploy graduated entropy challenges. These challenges raise confidence in verifiable human presence while remaining invisible or minimally intrusive to humans.
| Level | Challenge Type | User Impact |
|---|---|---|
1-2 | Extended observation period | None |
3-4 | Timing jitter, UI randomization | Imperceptible |
5-7 | Proof-of-work, interaction requirements | Minor delay |
8-10 | Visible challenge, manual verification | User action required |
#Real-time Decisions
MAGEN processes behavioral signals and returns a decision in real-time, typically within 50-100ms. Each response includes:
#Session Management
MAGEN uses secure, token-based sessions to track verification state across user interactions. Sessions are ephemeral by design—they expire after 5 minutes of inactivity and cannot be reused once a decision is finalized.
All session tokens are signed JWTs that can be verified client-side or server-side. Tokens include session ID, classification lane, confidence score, and expiration time.
#Easy Integration
MAGEN provides official SDKs for popular platforms, making integration straightforward. A typical implementation requires just a few lines of code.
#Use Cases
MAGEN is designed to protect critical user interactions across your application: