Patronus

Patronus Ark: lokale Security-Scanner für KI-Anwendungen.

Patronus Ark ist der Scanning-Kern hinter Patronus Protect. Die Library untersucht Eingaben wie Prompts, Dokumente, Tool-Aufrufdaten und Tool-Ergebnisse. Daraus erzeugt sie lokale Security-Evidenz für Prompt Injection, Datenabfluss, personenbezogene Daten und Agent-Risiken.

pip install patronus-arkcargo add patronus-ark

Aus Eingaben wird Security-Evidenz.

Ark zerlegt lange Eingaben in Chunks, prüft exakte Signale und klassifiziert komplexere Risiken mit geteilten Modellrepräsentationen. Anwendungen erhalten strukturierte Ergebnisse, auf denen sie Regeln und Entscheidungen aufbauen können.

L1

Strukturierte Signale

Native Detektoren prüfen exakte und kontextgebundene Muster. Dazu gehören Injection-Signale, Secrets, Credentials, Identifikatoren sowie riskante MCP- und Operations-Muster. Treffer enthalten die Fundstelle in der Eingabe.

L2

Non-Transformer Decision Blocks

Ein NTDB nutzt die einmal berechnete mmBERT-Repräsentation. Neuronale Heads, LightGBM, logistische Regression und Klassen-Zentroide werden zu einer günstigen ersten Entscheidung fusioniert.

L3

Lion Warden

Das Promote Gate leitet nur Chunks weiter, bei denen zusätzlicher Kontext voraussichtlich hilft. Lion Warden führt dafür die tieferen mmBERT-Schichten aus und klassifiziert mehrere Security-Aufgaben mit einem gemeinsamen Transformer.

Ein Scan-Interface für Inhalte, Daten und Agents.

Zehn Kategorien, jede kann gezielt aktiviert werden. Das Ergebnis bleibt strukturiert, egal ob eine native Regel oder ein lokales Modell entschieden hat.

Inhalte

Prompt Injection

Manipulierte oder konkurrierende Anweisungen erkennen.

Sensitive Documents

Schützenswerte Dokumentinhalte klassifizieren.

Threat Type

Die Art einer erkannten Bedrohung einordnen.

Daten

DLP

Secrets, Credentials und weitere definierte Datenfamilien finden.

PII

Personenbezogene Daten mit Evidenz-Spans erkennen.

Dynamic PII

Semantische Entitäten wie Personen, Organisationen und Orte erkennen.

Agents

Tool Class

Das verwendete Werkzeug einordnen.

Tool Action

Die beabsichtigte Aktion klassifizieren.

Tool Tags

Tool-Metadaten für nachgelagerte Regeln bestimmen.

Routing Intent

Die Absicht hinter einem Routing-Schritt erkennen.

Rust-Kern. Python ohne Umweg.

Die gleiche Engine steht als Rust-Crate und als abi3-kompatibles Python-Paket bereit. Asynchrone Queues sind der Standard; synchrone Scans bleiben für einfache Integrationen verfügbar.

Python

pip install patronus-ark
from patronus_ark import SecurityGateway

scanner = SecurityGateway(
    categories=["injection", "dlp", "pii"],
    max_level="l2",
)
scanner.warmup()
results = scanner.scan_all(text)

Rust

cargo add patronus-ark
use patronus_ark::{
    SecurityCategory, SecurityGateway, SecurityLevel,
};

let mut scanner = SecurityGateway::with_max_level(
    vec![SecurityCategory::Injection, SecurityCategory::Dlp],
    SecurityLevel::L2, None, true,
);
scanner.warmup()?;
let results = scanner.scan_all(text);

Kontrollierbar bis auf den einzelnen Request.

Modelle und Scanner sind kein starrer Gesamtblock. Deine Anwendung entscheidet, welche Prüfungen für einen konkreten Kontext nötig sind.

Execution Gates

Turn-Level, Scanner, L1-Regeln und Modellgruppen lassen sich pro Request über Metadaten steuern.

Async by default

Eine gemeinsame Ergebnis-Queue liefert fertige Scans aus, während tiefere Prüfungen weiterlaufen.

Offline-fähig

Asset-Synchronisierung und Runtime-Start sind getrennt. L1 benötigt überhaupt keine Downloads.

Messbar

Der integrierte Benchmark erfasst Accuracy, Macro-F1, Latenz, Durchsatz und Peak-RSS auf den mitgelieferten Samples.

Auch die Teile ohne Modell werden gemessen.

Ark Core, der Erkennungskern unter MIT-Lizenz, findet personenbezogene Daten und Secrets mit Regeln, Prüfsummen und Kontextprüfungen, ohne Modell. Gemessen gegen Presidio und die üblichen Secret-Scanner auf denselben Daten.

PII, F1 auf neutralen Korpora
70,0 %
Presidio 40,6 %
Secrets, F1
89,4 %
gitleaks 8.30.1 51,1 %
schneller als Presidio
330×
p95 bei 100 KiB Text
Fehlalarme auf 7.012 schwierigen Negativen
10
gitleaks 974

PII: Ark gegen Presidio

F1 bei exakter Spanne über alle gemeinsamen PII-Typen, je Datenfamilie. Neutral: öffentliche Datensätze (Gretel, OpenPII, TAB). Presidio-nah: Presidios eigene Testdaten. Ark-eigen: deutsche und EU-Testdaten.

Neutral · Ark (ausgewogen)

70,0 %

Neutral · Presidio (abgestimmt)

40,6 %

Presidio-nah · Ark (ausgewogen)

78,1 %

Presidio-nah · Presidio (abgestimmt)

71,3 %

Ark-eigen · Ark (ausgewogen)

88,2 %

Ark-eigen · Presidio (abgestimmt)

39,6 %
Präzision, Recall und Fehlalarme je Familie
FamilieSystemPräzisionRecallF1Fehlalarme
NeutralArk (ausgewogen)72,267,970,00
NeutralPresidio (abgestimmt)35,347,740,60
Presidio-nahArk (ausgewogen)99,764,278,10
Presidio-nahPresidio (abgestimmt)92,158,271,30
Ark-eigenArk (ausgewogen)99,979,088,20
Ark-eigenPresidio (abgestimmt)54,031,339,6215

Secrets: Ark gegen Secret-Scanner

F1 bei exakter Spanne auf 1.757 Secrets und 7.012 schwierigen Negativen (Platzhalter, Testschlüssel), Standardprofile.

Patronus Ark L1 · 10 Fehlalarme

89,4 %

gitleaks 8.30.1 · 974 Fehlalarme

51,1 %

TruffleHog 3.97.9 · 326 Fehlalarme

46,2 %

detect-secrets 1.5.0 · 1.731 Fehlalarme

40,9 %
Präzision, Fehlalarme je MB, Durchsatz

Fehlalarme je MB auf 37,8 MB echtem Quellcode aus 8 Repositories und 7,5 MB deutschen und englischen Dokumenten. Durchsatz: 10-MiB-Repository-Scan auf einer CPU. Scoreboard von patronus-security (Ark 0.1.10)

SystemPräzisionRecallF1FehlalarmeCode FP/MBDokumente FP/MBMiB/s
Patronus Ark L199,381,389,4100,050,136,47
gitleaks 8.30.149,153,451,19740,210,005,40
TruffleHog 3.97.963,236,446,23261,430,007,04
detect-secrets 1.5.033,951,640,91.73136,280,000,36

Secrets nach Gruppe

F1 bei exakter Spanne je Gruppe, in Klammern die Zahl der Secrets. Alle Scanner offline mit ihren Standardregeln.

ArkgitleaksTruffleHogdetect-secrets

API_KEY (320)

Ark

100,0 %

gitleaks

46,5 %

TruffleHog

99,5 %

detect-secrets

12,6 %

CLOUD_KEY (200)

Ark

100,0 %

gitleaks

49,1 %

TruffleHog

32,6 %

detect-secrets

32,9 %

PAYMENT_KEY (80)

Ark

100,0 %

gitleaks

39,2 %

TruffleHog

28,0 %

detect-secrets

21,8 %
Alle acht Gruppen

SECRET_TOKEN (360)

Ark

99,2 %

gitleaks

47,6 %

TruffleHog

71,7 %

detect-secrets

45,5 %

CREDENTIAL (320)

Ark

98,8 %

gitleaks

23,7 %

TruffleHog

11,4 %

detect-secrets

11,9 %

PASSWORD_HASH (40)

Ark

91,9 %

gitleaks

0,0 %

TruffleHog

0,0 %

detect-secrets

0,0 %

PRIVATE_KEY (37)

Ark

88,1 %

gitleaks

46,8 %

TruffleHog

45,8 %

detect-secrets

56,1 %

CRYPTO_KEY (80)

Ark

100,0 %

gitleaks

0,0 %

TruffleHog

0,0 %

detect-secrets

0,0 %

PII-Latenz: Ark gegen Presidio

p95 je Aufruf auf deutschem und englischem Text, Intel-Server mit 6 CPUs. Presidio braucht bei 100 KiB Sekunden, Ark Millisekunden.

Ark (nativ)

28,4 ms

Ark (Python)

35,9 ms

Presidio (abgestimmt)

11.978,8 ms

Presidio (Standard)

13.634,6 ms
p50, p95 und p99 je Eingabe
SystemEingabep50 msp95 msp99 ms
Ark (Python)kurz0,30,40,5
Ark (Python)4 KiB1,82,63,0
Ark (Python)100 KiB30,335,939,6
Ark (nativ)kurz0,20,30,4
Ark (nativ)4 KiB1,52,12,3
Ark (nativ)100 KiB23,328,429,1
Presidio (Standard)kurz10,213,916,6
Presidio (Standard)4 KiB212,5338,8390,2
Presidio (Standard)100 KiB10.407,513.634,615.005,9
Presidio (abgestimmt)kurz12,530,833,9
Presidio (abgestimmt)4 KiB200,7259,9290,9
Presidio (abgestimmt)100 KiB9.803,611.978,812.399,7

Eingeschleuste Freigaben

Das Decision Steering Gate legt sich vor jedes Entscheidungsmodell. Es teilt nicht vertrauenswürdige Inhalte in Einheiten, fragt das Modell ohne jede einzelne erneut und behält bei riskanten Optionen das höchste Risiko. Mittlerer Angriffserfolg über sechs Entscheidungsmodelle und fünf Aufgaben, niedriger ist besser.

Ohne Gate

28,1 %

Mit Decision Steering Gate

0,3 %

Je Aufgabe 100 Testfälle mit drei Angriffen aus sechs Claim-Familien. Decision Steering Gate, 17. Oktober 2026

Kostenlos für Community und ausgewählte Projekte.

Der Quellcode von Ark ist öffentlich einsehbar. Für Community-Projekte und ausgewählte Vorhaben stellen wir die Library kostenlos bereit; für proprietäre Produkte gibt es eine kommerzielle Lizenz.

Community-Lizenz

Du arbeitest an einem Community-Projekt, an Forschung oder an einem Vorhaben, das wir unterstützen sollten? Dann kannst du Ark vollständig kostenlos nutzen.

Community-Lizenz anfragen →

Kommerzielle Lizenz

Ark in ein proprietäres Produkt integrieren, ohne dessen Quellcode unter GPL veröffentlichen zu müssen.

Lizenz besprechen →

Häufige Fragen zu Patronus Ark