Engramma

Security Engine

advanced

Memory-level security: threat detection, fingerprint analysis, countermeasures, and encryption key rotation.

Threat level

GET/v1/memory/security/threat-level

Get current threat level from reverse-engineering detection.

200Response
{
  "threat_level": "LOW",
  "score": 0.12,
  "suspicious_queries": 2,
  "last_assessment": "2026-01-20T14:30:00Z"
}

Threat levels: NONE, LOW, MEDIUM, HIGH, CRITICAL.

Fingerprint report

GET/v1/memory/security/fingerprint-report

Get detailed semantic fingerprinting analysis report.

200Response
{
  "fingerprint_active": true,
  "unique_patterns_detected": 3,
  "queries_analyzed": 500,
  "anomalous_queries": 2,
  "risk_score": 0.08,
  "last_report": "2026-01-20T14:30:00Z"
}

Configure countermeasures

POST/v1/memory/security/countermeasure

Configure security countermeasures (noise, throttle, block).

noise_levelnumberDefault: 0.0

Noise injection level (0.0–1.0). Higher values add more noise to responses.

throttle_afterintegerDefault: 100

Throttle after N suspicious queries (minimum: 1).

block_at_threatstringDefault: CRITICAL

Threat level at which to block requests.

auto_modebooleanDefault: true

If true, system auto-adjusts countermeasures based on threat level.

200Response
{
  "configured": true,
  "noise_level": 0.1,
  "throttle_after": 50,
  "block_at_threat": "HIGH",
  "auto_mode": false
}

Rotate encryption keys

POST/v1/memory/encryption/rotate

Rotate encryption keys with zero-downtime (re-encrypts all patterns).

200Response
{
  "rotated": true,
  "patterns_re_encrypted": 4523,
  "duration_ms": 1234,
  "new_key_id": "key_v3"
}
Warning

Key rotation re-encrypts all stored patterns. This operation may take time for large memory spaces but does not cause downtime.

Encryption status

GET/v1/memory/encryption/status

Get encryption status for this tenant.

200Response
{
  "encrypted": true,
  "algorithm": "AES-256-GCM",
  "key_version": 3,
  "last_rotation": "2026-01-15T03:00:00Z",
  "patterns_encrypted": 4523,
  "patterns_total": 4523
}

Next steps

Advanced InferencePerformance