Was der Cloud-Modus sendet
Im Cloud-Modus wird eine Änderung auf einem gehärteten entfernten Endpunkt bewertet. Was das Gerät verlässt, ist fest, minimal und lokal überprüfbar: ein redigierter Diff aus nur hinzugefügten Zeilen und der Dateipfad, nie die volle Datei. Diese Seite ist der genaue Datenvertrag.
Überblick
Der Cloud-Modus sendet eine Projektion der Änderung, nicht die Datei:
- Gesendet: der Dateipfad und ein redigierter Unified-Diff aus nur hinzugefügten Zeilen, über TLS, an eine feste Endpunktmenge.
- Nie gesendet: vollständige Dateiinhalte, der Text entfernter Zeilen, Verzeichnis- oder Prozesslisten, System-Telemetrie.
- Protokolliert: jede ausgehende Anfrage des Daemons wird in ein lokales, menschenlesbares Egress-Ledger geschrieben.
Der Datenvertrag
Die Endpunktmenge ist klein und fest; jede Anfrage trägt eine dokumentierte, minimale Nutzlast. Kein Memory-Datei-Inhalt überschreitet die Grenze, außer als redigierter Diff:
| Endpunkt | Wann | Nutzlast |
|---|---|---|
/enroll | einmal bei der Installation | App-ID und ein Einmal-Enrollment-Code |
/evaluate | bei Änderung einer geschützten Datei | Pfad und redigierter Unified-Diff (keine Volltexte) |
/getConfig | Poll-Intervall | nur Auth-Token |
/reportAudit | wenn neue Audit-Einträge vorliegen | Zeitstempel, Aktion, Pfad, Grund, Scores |
/reportQuarantine | bei einem Quarantäne-Ergebnis | Fall-ID, Pfad, Grund, Scores und der redigierte Diff (größenbegrenzt) |
/ackDecision | einmal je aufgelöstem Fall | Fall-ID und Ergebnis (applied, stale oder discarded) |
Was jedes Feld enthält
Die bewertete Projektion wird auf dem Gerät redigiert, auf hinzugefügte Zeilen beschränkt und in der Größe gekappt, bevor sie gesendet wird. Dies sind die Felder des Quarantäne-Berichts und was jedes trägt:
| Feld | Was es enthält | Redigiert? |
|---|---|---|
path | Der Pfad der geänderten Datei, damit ein Prüfer weiß, welche Datei | Nein: nur der Pfad, nie Inhalt |
redactedDiff | Nur die hinzugefügten Zeilen, mit Geheimnissen und strukturierter PII als Platzhalter, größenbegrenzt | Ja, lokal vor dem Egress |
diffFidelity | Ob der gespeicherte Diff dem beurteilten Text entspricht (exact) oder eine reduzierte Projektion davon ist (projection) | Metadatum, kein Inhalt |
removedLines | Nur die Anzahl entfernter Zeilen; der entfernte Text verlässt das Gerät nie | Ja: nur eine Zahl geht hinaus |
originalHash | SHA-256 der Datei vor der Änderung, für Idempotenz und Supersede | Hash, kein Inhalt |
reason, Scores | Ein kurzer Grund-String und die gerechneten Scores des Falls | Metadatum, kein Inhalt |
Lokale Redaktion vor dem Egress
Bevor ein Byte gesendet wird, durchläuft der Diff eine lokale Redaktionsstufe. Erkennbare Geheimnisse und strukturierte PII werden durch strukturerhaltende Platzhalter ersetzt, sodass der Bewerter weiter über die Änderung urteilen kann, während die sensiblen Werte auf dem Gerät bleiben. Schlüsselnamen bleiben erhalten, nur die Werte werden entfernt:
| Klasse | Beispiel | Platzhalter |
|---|---|---|
| API-Schlüssel | anbietertypische Schlüssel, GitHub, Slack, AWS, Google, Stripe, Webhook-Secrets | [REDACTED:apikey] |
| JWT | drei base64url-Segmente | [REDACTED:jwt] |
| Generische Zuweisungen | key/token/secret/password = Wert (Schlüsselname bleibt, Wert entfernt) | [REDACTED:secret] |
| Adressen nach RFC-Form | [REDACTED:email] | |
| IBAN | Ländercode, Prüfziffern und BBAN | [REDACTED:iban] |
| Kartennummer | gruppierte Kartennummern | [REDACTED:card] |
| IP-Adresse | dotted-quad-IPv4-Adresse | [REDACTED:ip] |
| Telefon | nur internationales Format | [REDACTED:phone] |
Das Egress-Ledger
Jede ausgehende Anfrage wird lokal in einem menschenlesbaren Ledger festgehalten. Jede Zeile trägt den Zeitstempel, den Endpunkt, die Nutzlastgröße, den SHA-256 der Nutzlast (nie ihren Inhalt) und den HTTP-Status. Das ist die überprüfbare "Telefoniert es nach Hause?"-Abrechnung:
2026-06-04T12:00:01Z endpoint=/getConfig bytes=2 sha256=44136f… status=200 2026-06-04T12:03:17Z endpoint=/evaluate bytes=412 sha256=9f86d0… status=200
Weiterlesen
Wie eine unsichere Änderung gehalten und Ihnen vorgelegt wird: der Nutzer-Dialog. Der gesamte Schutz ist fail-closed.
Bewertung in der Cloud, Ihre Inhalte auf dem Gerät.
Ein redigierter Diff aus nur hinzugefügten Zeilen ist alles, was die Maschine verlässt, und das lokale Ledger belegt es. Kostenlos für Linux, macOS und Windows.
Sign me up