ZeusLock CLI-Befehlsreferenz

Alle Befehle der ZeusLock CLI auf einer Seite: Wirkung, Änderungen, Optionen und Standardwerte, Beispiele und Exit-Codes.

Alle Befehle der ZeusLock CLI, mit ihrer Wirkung, den Änderungen und den Rückgabewerten. Die CLI deckt denselben Umfang ab wie das Dashboard — Vorfälle, Agenten, Richtlinien, Benutzer, Schlüssel, Shadow AI, MCP und SIEM — plus zwei Dinge, die das Dashboard nicht kann: Inhalte aus einem Terminal prüfen und einen Git-Commit blockieren, bevor Geheimnisse ein Notebook verlassen.

Installation

Erfordert Node.js 22.12 oder neuer. Das Paket wird als zeuslock-dlp-cli veröffentlicht und installiert eine einzige ausführbare Datei namens zeuslock.

npm install -g zeuslock-dlp-cli@latest
zeuslock --version
zeuslock --help

Einmalige Ausführung ohne Installation: npm exec --package zeuslock-dlp-cli@latest -- zeuslock status.

Zwei Anmeldedaten, mit Absicht

Die CLI verwendet zwei verschiedene Anmeldedaten; die falsche Wahl ist der häufigste Grund für einen fehlgeschlagenen Befehl.

AnmeldedatenPräfixHandelt alsVerwendet von
Persönliches CLI-Zugriffstokenzlu_Sie, mit Ihrer RolleDatenbefehle: Vorfälle, Agenten, Benutzer, Schlüssel, Token, Richtlinien, Shadow AI, MCP, Erweiterungen, deploy
Organisations-API-Schlüsselzl_Die OrganisationInhalts- und Maschinenbefehle: scan, anonymize, hook run, siem pull/tail, Lizenzprüfung in status

Ein persönliches Token wird nie für Inhaltsbefehle akzeptiert und ein Organisationsschlüssel nie für Datenbefehle. Diese Trennung ist beabsichtigt: Inhaltsbefehle laufen unbeaufsichtigt in CI, wo Anmeldedaten einer Person mit deren Weggang unbrauchbar würden.

Ein persönliches CLI-Zugriffstoken erhalten

Die CLI meldet sich nicht mit E-Mail und Passwort an. Das Backend verlangt beim Login eine reCAPTCHA-Prüfung, die ein Terminal nicht lösen kann. Erzeugen Sie ein Token auf der Seite CLI im Dashboard oder auf einem bereits authentifizierten Rechner mit zeuslock tokens create.

zeuslock auth login --token zlu_your_cli_access_token
zeuslock whoami

Den Organisations-API-Schlüssel speichern

zeuslock auth api-key set zl_your_org_api_key
zeuslock auth api-key status

Globale Optionen

OptionWerteStandardWirkung
--token <zlu_…>zlu_…keinerVerwendet dieses Token für einen Aufruf. Muss vor dem Unterbefehl stehen: zeuslock --token zlu_… whoami.
-V, --version——Gibt die installierte Version aus.
-h, --help——Funktioniert bei jedem Befehl und Unterbefehl.

Umgebungsvariablen

VariableWirkung
ZEUSLOCK_API_URLBackend-URL. Standard https://api.zeuslock.ai. Für Staging https://api-staging.zeuslock.ai setzen.
ZEUSLOCK_API_TOKENPersönliches CLI-Zugriffstoken für Benutzerbefehle. Ideal für CI.
ZEUSLOCK_API_KEYOrganisations-API-Schlüssel für Inhalts- und Maschinenbefehle.
ZEUSLOCK_CONFIG_DIRÜberschreibt den Speicherort der CLI-Dateien.

Rangfolge der Anmeldedaten

Sind mehrere vorhanden, verwendet die CLI die erste zutreffende.

#BenutzerbefehleInhaltsbefehle
1--token zlu_…--api-key zl_…
2ZEUSLOCK_API_TOKENZEUSLOCK_API_KEY
3Gespeichertes Token aus auth login --tokenGespeicherter Schlüssel aus auth api-key set

Exit-Codes

Jeder Befehl liefert 0 bei Erfolg und 1 bei Fehler, sodass jeder Befehl einen CI-Schritt steuern kann. Vier Befehle liefern einen aussagekräftigen Code ungleich null, der ein Ergebnis statt eines Fehlers ausdrückt — diese lohnen sich in einer Pipeline.

BefehlUngleich null bedeutet
scanSensible Inhalte erreichten die Schwelle --fail-on.
hook runDer Commit sollte blockiert werden.
rules diffDie lokale Richtliniendatei weicht vom Live-Zustand ab.
deploy agent-verifyKein Agent gefunden oder nicht im erwarteten Zustand.
status --require-licenseHealth-, Readiness- oder Lizenzprüfung fehlgeschlagen.

Ausgabe

Befehle geben standardmäßig ausgerichtete Tabellen aus. Mit --json erhalten Sie maschinenlesbare Ausgabe — alle datenliefernden Befehle unterstützen sie, und das Format ist stabil. siem pull liefert standardmäßig JSONL (ein Ereignis pro Zeile), das Format für SIEM-Collectoren. Die CLI gibt gespeicherte Token oder Schlüssel nur mit --show-secret aus.

Wo die CLI Dateien ablegt

DateiInhalt
auth.jsonIhr CLI-Zugriffstoken, Modus 0600.
api-key.jsonDer gespeicherte Organisations-API-Schlüssel, Modus 0600.
siem-cursors.jsonFortsetzungspositionen für siem tail, eine je Cursorname.

Ort: macOS ~/Library/Application Support/zeuslock/, Windows %APPDATA%\ZeusLock\, Linux ~/.config/zeuslock/. Das Verzeichnis wird mit Modus 0700 angelegt, sofern das Dateisystem dies unterstützt.

zeuslock auth — Anmelden und Anmeldedaten speichern

Speichert Ihr persönliches Token und den Organisations-API-Schlüssel auf diesem Rechner und zeigt an, wer Sie sind.

zeuslock auth login --token

Validiert ein persönliches CLI-Zugriffstoken und speichert es für weitere Befehle.

Anmeldedaten: Keine · Wirkung: Schreibt lokale Dateien

Das Token wird vor dem Speichern gegen das Backend geprüft, ein Tippfehler schlägt also sofort fehl. Es wird in auth.json mit Modus 0600 abgelegt. Es gibt keine Anmeldung mit E-Mail und Passwort — siehe oben.

OptionWerteStandardWirkung
--token <zlu_…>zlu_[object Object]keinerDas Token von der CLI-Seite im Dashboard. Das Format wird lokal vorab geprüft.
--api-url <url>URLZEUSLOCK_API_URLBackend zur Prüfung, wird mit dem Token gespeichert.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock auth login --token zlu_your_cli_access_token
zeuslock auth login --token zlu_… --api-url https://api-staging.zeuslock.ai

Ein widerrufenes oder abgelaufenes Token liefert 401. Token werden nie erneuert — erzeugen Sie ein neues und führen Sie den Befehl erneut aus.

zeuslock auth logout

Entfernt das gespeicherte persönliche Token von diesem Rechner.

Anmeldedaten: Keine · Wirkung: Schreibt lokale Dateien

Löscht nur auth.json. Der Organisations-API-Schlüssel bleibt erhalten, sodass scan, anonymize und SIEM-Befehle weiter funktionieren. Das Token wird serverseitig nicht widerrufen — dafür tokens revoke.

OptionWerteStandardWirkung
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock auth logout

zeuslock auth api-key set [key]

Validiert einen Organisations-API-Schlüssel und speichert ihn für Inhalts- und SIEM-Befehle.

Anmeldedaten: Organisations-API-Schlüssel · Wirkung: Schreibt lokale Dateien

Der Schlüssel wird vor dem Speichern gegen das Backend geprüft, ein ungültiger Schlüssel wird sofort abgelehnt. Ablage in api-key.json mit Modus 0600; der vollständige Wert wird nie ausgegeben.

ArgumentErforderlichBeschreibung
keyNeinDer zl_…-Schlüssel. Fehlt er, liest die CLI ZEUSLOCK_API_KEY oder fragt nach.
OptionWerteStandardWirkung
--api-url <url>URLZEUSLOCK_API_URLBackend, zu dem der Schlüssel gehört; wird mitgespeichert.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock auth api-key set zl_your_org_api_key
zeuslock auth api-key set   # prompts, so the key stays out of shell history

zeuslock auth api-key status

Zeigt, ob ein Organisations-API-Schlüssel konfiguriert ist und welcher.

Anmeldedaten: Keine · Wirkung: Nur lesend

Gibt Quelle, Backend-URL und einen maskierten Schlüssel aus. Der vollständige Wert wird nie angezeigt.

OptionWerteStandardWirkung
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock auth api-key status

zeuslock auth api-key clear

Entfernt den gespeicherten Organisations-API-Schlüssel von diesem Rechner.

Anmeldedaten: Keine · Wirkung: Schreibt lokale Dateien

Löscht api-key.json. Der Schlüssel bleibt im Dashboard gültig — er wird nur lokal vergessen. Inhaltsbefehle benötigen danach --api-key oder ZEUSLOCK_API_KEY.

OptionWerteStandardWirkung
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock auth api-key clear

zeuslock auth whoami

Identisch mit zeuslock whoami, für alle, die es unter auth erwarten.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

OptionWerteStandardWirkung
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock auth whoami

zeuslock whoami / status — Wer bin ich, und stimmt etwas nicht

zeuslock whoami

Zeigt das Konto, unter dem die CLI derzeit handelt.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Liefert E-Mail, Benutzer-ID, Rolle, Organisations-ID, Status und Backend-URL. Der erste Befehl bei einem unerklärten Berechtigungsfehler — er zeigt, welches Konto und welche Umgebung tatsächlich aktiv sind.

OptionWerteStandardWirkung
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock whoami
zeuslock whoami --json
zeuslock --token zlu_… whoami   # check a token without saving it

zeuslock status

Zeigt lokale Konfiguration, Backend-Health und -Readiness sowie Lizenzgültigkeit.

Anmeldedaten: Organisations-API-Schlüssel (für die Lizenzprüfung) · Wirkung: Nur lesend

Ein Befehl für die Frage „liegt es an mir oder am Dienst?“. Health und Readiness werden ohne Anmeldedaten geprüft; die Lizenz nur, wenn ein Organisations-API-Schlüssel vorliegt. Mit --require-license lässt ein gestörtes Backend den CI-Job fehlschlagen.

OptionWerteStandardWirkung
--api-key <key>zl_…ZEUSLOCK_API_KEYSchlüssel für die Lizenzprüfung.
--require-licenseBooleschausExit-Code ungleich null, außer Health, Readiness und Lizenz sind in Ordnung.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock status
zeuslock status --json
zeuslock status --require-license   # CI gate

zeuslock scan — Inhalte prüfen, bevor sie ein KI-Werkzeug erreichen

zeuslock scan [path]

Prüft eine Datei, ein Verzeichnis oder weitergeleiteten Text mit der DLP-Richtlinie Ihrer Organisation.

Anmeldedaten: Organisations-API-Schlüssel · Wirkung: Nur lesend

Liefert dieselbe Entscheidung wie Agent und Erweiterung — allow, alert oder block — und erfasst einen Vorfall, wenn etwas gefunden wird, sodass Terminalaktivität im Dashboard neben Browseraktivität erscheint. Verzeichnisse werden lokal durchlaufen, .git übersprungen, Dateien in Fünferbündeln gesendet. Der Exit-Code folgt --fail-on, wodurch der Befehl als CI-Gate taugt.

ArgumentErforderlichBeschreibung
pathNeinZu prüfende Datei oder Verzeichnis. Erforderlich außer mit --stdin; beides zusammen ist unzulässig.
OptionWerteStandardWirkung
--stdinBooleschausLiest Text von der Standardeingabe statt aus einem Pfad.
--api-key <key>zl_…[object Object]ZEUSLOCK_API_KEYOrganisations-API-Schlüssel für diesen Aufruf.
--fail-on <decision>alert | block | neverblockWelche Entscheidung zu einem Exit-Code ungleich null führt. alert ist streng (scheitert bei Alarm und Block), never endet immer mit 0 für reine Berichte.
--source <source>Beliebiger TextcliQuellenkennzeichen im Vorfall.
--platform <platform>Beliebiger TextcliPlattformkennzeichen der Anfrage. Die Plattformspalte des Vorfalls wird aus der URL abgeleitet, daher wird dieser Wert dort nicht gespeichert.
--hostname <hostname>Beliebiger Textlokaler HostnameIm Vorfall erfasster Hostname.
--path <path>Beliebiger Text/cli/<file>Zielkennzeichen im Vorfall; wird auf einen führenden Schrägstrich normalisiert.
--user-email <email>Beliebiger TextkeinerOrdnet den Vorfall einer Person zu statt anonym zu bleiben. In CI sinnvoll.
--include-sensitiveBooleschausNimmt die Anonymisierungszuordnung des Backends in die JSON-Ausgabe auf. Sie enthält die Originalwerte — behandeln Sie die Ausgabe als sensibel.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock scan ./secrets.txt
zeuslock scan ./src --fail-on alert
cat prompt.txt | zeuslock scan --stdin --json
zeuslock scan ./build --fail-on never --user-email ci@example.com

Jeder Scan mit Fund erzeugt einen Dashboard-Vorfall. Ein großer Baum wiederholt in CI füllt die Vorfallsliste — grenzen Sie den Pfad ein.

zeuslock anonymize — Sensible Werte aus Text entfernen

zeuslock anonymize <file>

Ersetzt sensible Werte in einer UTF-8-Textdatei durch realistische Platzhalter.

Anmeldedaten: Organisations-API-Schlüssel · Wirkung: Nur lesend

Anders als scan schreibt dieser Befehl den Inhalt um, statt ihn zu bewerten, und erzeugt keinen Vorfall. Die Ersatzwerte haben dieselbe Form — aus einer Kartennummer wird eine andere plausible Nummer — der Text bleibt also als Prompt oder Testdatensatz nutzbar. Geeignet, um ein echtes Dokument mit einem externen LLM zu teilen, ohne die echten Werte preiszugeben.

ArgumentErforderlichBeschreibung
fileJaZu anonymisierende UTF-8-Textdatei.
OptionWerteStandardWirkung
--api-key <key>zl_…[object Object]ZEUSLOCK_API_KEYOrganisations-API-Schlüssel für diesen Aufruf.
--output <path>Beschreibbarer PfadstdoutSchreibt den anonymisierten Text in eine Datei statt ihn auszugeben.
--include-sensitive-mapBooleschausNimmt die Zuordnung Original/Maskiert in die JSON-Ausgabe auf. Das legt die echten Werte offen — entsprechend behandeln.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock anonymize customer-data.txt
zeuslock anonymize customer-data.txt --output customer-data.safe.txt
zeuslock anonymize customer-data.txt --json

zeuslock hook — Geheimnisse beim Commit stoppen, nicht im Review

Installiert einen Git-pre-commit-Hook, der den gestagten Inhalt prüft und den Commit ablehnt, wenn die DLP-Richtlinie es verlangt.

zeuslock hook install

Schreibt den ZeusLock-pre-commit-Hook in ein Repository.

Anmeldedaten: Keine · Wirkung: Schreibt lokale Dateien

Erstellt .git/hooks/pre-commit mit Modus 0755, der zeuslock hook run aufruft. Ohne --force wird ein vorhandener Hook nicht überschrieben, der Hook eines anderen Werkzeugs wird also nicht stillschweigend zerstört. Der Hook gilt nur für diesen Klon — er wird nicht über Git geteilt, jede Person installiert ihn einmal.

OptionWerteStandardWirkung
--repo <path>Pfadaktuelles RepositoryZiel-Repository.
--fail-on <decision>alert | blockalertIn den Hook geschriebene Schwelle. Standard streng: Auch Alarme stoppen den Commit.
--forceBooleschausErsetzt einen vorhandenen pre-commit-Hook.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock hook install
zeuslock hook install --fail-on block --force

zeuslock hook run

Prüft die gestagten Änderungen und entscheidet, ob der Commit fortfahren darf.

Anmeldedaten: Organisations-API-Schlüssel · Wirkung: Nur lesend

Liest die gestagten Blobs, nicht den Arbeitsbaum — geprüft wird also genau das, was committet würde; eine Datei nach dem Stagen zu ändern umgeht die Prüfung nicht. Geprüft werden nur hinzugefügte, kopierte, geänderte und umbenannte Dateien; nicht verfolgte, nicht gestagte und gelöschte Dateien werden ebenso ignoriert wie die Historie. Exit-Code ungleich null stoppt den Commit.

OptionWerteStandardWirkung
--repo <path>Pfadaktuelles RepositoryZu prüfendes Repository.
--api-key <key>zl_…[object Object]ZEUSLOCK_API_KEYOrganisations-API-Schlüssel für diesen Aufruf.
--fail-on <decision>alert | block | neveralertSchwelle, die den Commit stoppt.
--user-email <email>Beliebiger TextkeinerOrdnet den Vorfall einer Person zu.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock hook run
zeuslock hook run --fail-on block --json
git commit -m 'feature'   # the hook runs automatically

Der Hook benötigt beim Commit einen Organisations-API-Schlüssel. Speichern Sie einen mit `auth api-key set`, damit er auch in einer Git-GUI funktioniert, wo Umgebungsvariablen meist fehlen.

zeuslock incidents — Was erkannt wurde und wie oft

Dieselben Daten wie die Vorfallseite im Dashboard. Filter werden lokal nach Abruf eines Zeitfensters angewandt, daher sind die Tageswerte fest.

zeuslock incidents list

Listet aktuelle Vorfälle mit Dashboard-äquivalenten Filtern.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Unauffällige Prompts werden ausgeblendet, genau wie im Dashboard: Eine Zeile bleibt nur, wenn sie Funde hat, blockiert wurde oder eine Aktion ungleich allowed trägt. --days 90 erfordert Business oder Enterprise.

OptionWerteStandardWirkung
--days <days>7 | 30 | 9030Zeitfenster. Andere Werte werden vor der Anfrage abgelehnt.
--severity <level>critical | warningkeinerDer Schweregrad folgt dem Richtlinienergebnis, nicht dem Detektorwert: critical bedeutet blockiert, warning alles andere. Das entspricht der Dashboard-Anzeige.
--search <text>Beliebiger TextkeinerFiltert nach E-Mail, URL oder Fundtyp.
--jailbreakBooleschausBehält nur Vorfälle mit einem Jailbreak-Versuch.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock incidents list --days 7
zeuslock incidents list --severity critical
zeuslock incidents list --jailbreak --json

zeuslock incidents stats

Zeigt aggregierte Vorfallstatistiken.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Aufschlüsselung nach Schweregrad, erkannte Datentypen, tägliche Zeitleiste und KI-Plattformnutzung — die Zahlen der Dashboard-Übersicht auf einem Bildschirm.

OptionWerteStandardWirkung
--days <days>1 | 7 | 30 | 36530Statistikfenster. 365 erfordert Business oder Enterprise.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock incidents stats
zeuslock incidents stats --days 365 --json

zeuslock incidents export

Schreibt gefilterte Vorfälle in eine CSV- oder JSON-Datei.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Schreibt lokale Dateien

Erzeugt die Nachweisdatei, die ein Auditor verlangt. Die CSV enthält sowohl severity (das im Dashboard gezeigte Richtlinienergebnis) als auch risk_level (den rohen Detektorwert) — sie weichen berechtigt ab, und beides zu behalten verliert nichts. Export erfordert Business oder Enterprise.

OptionWerteStandardWirkung
--days <days>7 | 30 | 9030Zeitfenster.
--severity <level>critical | warningkeinerDer Schweregrad folgt dem Richtlinienergebnis, nicht dem Detektorwert: critical bedeutet blockiert, warning alles andere. Das entspricht der Dashboard-Anzeige.
--search <text>Beliebiger TextkeinerFiltert nach E-Mail, URL oder Fundtyp.
--jailbreakBooleschausBehält nur Vorfälle mit einem Jailbreak-Versuch.
--format <format>csv | jsoncsvAusgabeformat.
--output <path>Beschreibbarer Pfadincidents-<timestamp>.<ext>Zieldatei.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock incidents export --days 7
zeuslock incidents export --days 30 --severity critical --format json --output incidents.json

zeuslock agents / extensions — Ist die Flotte tatsächlich geschützt

zeuslock agents list

Listet registrierte Desktop-Agenten mit ihrem Heartbeat-Status.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Zeigt Hostname, Plattform, Version, Online-Status und letzten Heartbeat sowie eine update_available-Markierung, wenn eine neuere Version veröffentlicht wurde. Ein Agent gilt als online, wenn er sich in den letzten fünf Minuten gemeldet hat. So finden Sie Rechner, die nicht mehr melden.

OptionWerteStandardWirkung
--status <status>all | online | offlineallHeartbeat-Filter.
--search <text>Beliebiger TextkeinerDurchsucht nur Hostname und Plattform.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock agents list
zeuslock agents list --status offline
zeuslock agents list --search windows --json

zeuslock agents revoke <agent_id>

Widerruft einen registrierten Desktop-Agenten.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Ändert den Organisationszustand

Der Agent verliert seine Registrierung und wird vom Backend nicht mehr vertraut. Nutzen Sie das bei verlorenen oder ausgemusterten Geräten. Der Befehl fragt nach, sofern nicht --yes gesetzt ist.

ArgumentErforderlichBeschreibung
agent_idJaExakte ID aus agents list.
OptionWerteStandardWirkung
-y, --yesBooleschausÜberspringt die Bestätigung. In Skripten und CI erforderlich.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock agents revoke AGENT-123
zeuslock agents revoke AGENT-123 --yes --json

zeuslock extensions status

Zeigt derzeit aktive Browser-Erweiterungen.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Zählt Erweiterungen und Nutzer der letzten 30 Minuten. Ein niedriger Wert bei großer Flotte bedeutet meist, dass die erzwungene Installation diese Browser nicht erreicht hat.

OptionWerteStandardWirkung
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock extensions status --json

zeuslock users / keys / tokens — Wer hat Zugriff, und womit

Drei getrennte Dinge: Personen, Organisations-API-Schlüssel und persönliche CLI-Token. Eine Person zu entfernen widerruft keinen von ihr erstellten Schlüssel.

zeuslock users list

Listet die Personen Ihrer Organisation.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Zeigt E-Mail, Rolle, Status, Aktivkennzeichen und Erstellungsdatum. Rollen werden gegen die tatsächlich verfügbaren Rollen geprüft, eine ungültige Rolle wird abgelehnt statt stillschweigend nichts zu treffen.

OptionWerteStandardWirkung
--search <text>Beliebiger TextkeinerLokaler Filter über E-Mail, Rolle, Status und Anzeigename.
--role <role>admin, user, viewer…keinerGegen die Rollen Ihres Plans geprüft.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock users list
zeuslock users list --role admin
zeuslock users list --search alice --json

zeuslock users remove <user>

Entfernt eine Person aus der Organisation.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Ändert den Organisationszustand

Zwei serverseitige Sperren, nicht umgehbar: Sie können weder sich selbst noch den letzten aktiven Administrator entfernen. Akzeptiert eine ID oder E-Mail, die zuvor über die Benutzerliste aufgelöst wird.

ArgumentErforderlichBeschreibung
userJaBenutzer-ID oder E-Mail-Adresse.
OptionWerteStandardWirkung
-y, --yesBooleschausÜberspringt die Bestätigung. In Skripten und CI erforderlich.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock users remove departing@example.com
zeuslock users remove user-uuid --yes --json

zeuslock keys list

Listet Organisations-API-Schlüssel auf.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Werte sind standardmäßig maskiert. --show-secret zeigt vollständige Werte nur für Schlüssel, die das Backend noch entschlüsseln kann; ältere bleiben maskiert.

OptionWerteStandardWirkung
--status <status>all | active | revokedallLokaler Statusfilter.
--show-secretBooleschausZeigt verfügbare vollständige Werte.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock keys list
zeuslock keys list --status active
zeuslock keys list --show-secret --json

zeuslock keys create --name <name>

Erstellt einen neuen Organisations-API-Schlüssel.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Ändert den Organisationszustand

Der vollständige Schlüssel wird einmalig in dieser Antwort zurückgegeben. Kopieren Sie ihn sofort — die CLI kann ihn später nicht erneut anzeigen, wenn das Backend ihn nicht mehr liefert.

OptionWerteStandardWirkung
--name <name>Beliebiger TextkeinerErforderlich. Benennen Sie ihn nach dem Einsatzort, damit er später sicher widerrufen werden kann.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock keys create --name ci-pipeline
zeuslock keys create --name fleet-deploy --json

zeuslock keys revoke <key_id>

Widerruft einen aktiven Organisations-API-Schlüssel.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Ändert den Organisationszustand

Alles, was den Schlüssel nutzt, funktioniert sofort nicht mehr: damit konfigurierte Agenten, CI-Jobs, Hooks. Die CLI verweigert bereits widerrufene Schlüssel, da ein zweites Delete den Datensatz endgültig löscht statt ihn zu widerrufen.

ArgumentErforderlichBeschreibung
key_idJaID aus keys list.
OptionWerteStandardWirkung
-y, --yesBooleschausÜberspringt die Bestätigung. In Skripten und CI erforderlich.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock keys revoke key-uuid --yes

zeuslock tokens list

Listet Ihre persönlichen CLI-Zugriffstoken auf.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Zeigt Name, maskierten Wert, Status, Ablauf und letzte Nutzung. Die Spalte der letzten Nutzung ist der schnellste Weg zu gefahrlos widerrufbaren Token.

OptionWerteStandardWirkung
--status <status>all | active | revoked | expiredallLokaler Statusfilter.
--show-secretBooleschausZeigt vollständige Werte, sofern das Backend sie liefert.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock tokens list
zeuslock tokens list --status expired

zeuslock tokens create --name <name>

Erstellt ein persönliches CLI-Zugriffstoken.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Ändert den Organisationszustand

Das vollständige zlu_…-Token wird einmalig zurückgegeben. Das ist die skriptfähige Alternative zur CLI-Seite im Dashboard — nützlich, um von einem bereits authentifizierten Rechner ein kurzlebiges Token für einen CI-Job auszustellen.

OptionWerteStandardWirkung
--name <name>1–255 ZeichenkeinerErforderlich. Identifiziert das Token in der Liste.
--expires-in-days <days>1-365Backend-Standard (90)Kürzere Laufzeiten sind für CI besser. Werte außerhalb des Bereichs werden lokal abgelehnt.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock tokens create --name work-laptop
zeuslock tokens create --name ci-job --expires-in-days 30 --json

zeuslock tokens revoke <token_id>

Widerruft ein persönliches CLI-Zugriffstoken.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Ändert den Organisationszustand

Das Token liefert ab der nächsten Anfrage 401. Der Datensatz bleibt erhalten und in der Liste als widerrufen sichtbar — der richtige Schritt bei einem verlorenen Gerät.

ArgumentErforderlichBeschreibung
token_idJaID aus tokens list.
OptionWerteStandardWirkung
-y, --yesBooleschausÜberspringt die Bestätigung. In Skripten und CI erforderlich.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock tokens revoke token-uuid --yes

zeuslock tokens purge <token_id>

Löscht ein bereits widerrufenes CLI-Token endgültig.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Ändert den Organisationszustand

Entfernt den Datensatz vollständig; er verschwindet aus der Liste und aus Audit-Ansichten. Das Token muss zuvor widerrufen sein — die CLI verweigert das Löschen eines aktiven Tokens, wodurch die versehentliche Zerstörung einer funktionierenden Anmeldung in einem Schritt ausgeschlossen ist.

ArgumentErforderlichBeschreibung
token_idJaID eines widerrufenen Tokens.
OptionWerteStandardWirkung
-y, --yesBooleschausÜberspringt die Bestätigung. In Skripten und CI erforderlich.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock tokens revoke token-uuid --yes
zeuslock tokens purge token-uuid --yes

zeuslock rules — Richtlinie als Code

Exportiert den Live-Richtlinienzustand in eine prüfbare Datei und erkennt Abweichungen. Nur lesend — die CLI schreibt Richtlinien nie zurück.

zeuslock rules get

Exportiert den aktuellen DLP-Richtlinienzustand als YAML oder JSON.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Die Ausgabe ist normalisiert: deterministische Reihenfolge, flüchtige Felder wie created_at, updated_at und org_id entfallen — zwei Exporte einer unveränderten Richtlinie sind byteidentisch. Das macht die Datei versionier- und vergleichbar.

OptionWerteStandardWirkung
--scope <scope>policies | default | policypoliciespolicies exportiert alle sichtbaren Richtlinien samt Zuweisungsgruppen; default nur die Standardrichtlinie; policy ein einzelnes Dokument.
--policy-id <id>Beliebiger TextkeinerErforderlich mit --scope policy.
--format <format>yaml | jsonyamlExportformat.
--output <path>Beschreibbarer PfadstdoutSchreibt in eine Datei statt auszugeben.
zeuslock rules get --output zeuslock.rules.yaml
zeuslock rules get --scope default --format json
zeuslock rules get --scope policy --policy-id default

zeuslock rules diff [file]

Vergleicht eine lokale Richtliniendatei mit dem Live-Zustand.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Endet mit 0 bei Übereinstimmung und 1 bei Abweichung und zeigt einen pfadgenauen Diff. In CI gegen einen versionierten Export ausgeführt, findet er ungeprüfte Richtlinienänderungen aus dem Dashboard.

ArgumentErforderlichBeschreibung
fileNeinExportiertes YAML oder JSON. Standard zeuslock.rules.yaml, dann .yml, dann .json.
OptionWerteStandardWirkung
--scope <scope>policies | default | policypoliciesMuss dem im Datei-Scope entsprechen.
--policy-id <id>Beliebiger TextkeinerErforderlich mit --scope policy.
--format <format>text | jsontextFormat der Diff-Ausgabe.
zeuslock rules diff zeuslock.rules.yaml
zeuslock rules diff --scope default zeuslock.default.rules.yaml
zeuslock rules diff policy.json --scope policy --policy-id default --format json

zeuslock siem — Ereignisse an Ihr SIEM liefern

Ruft DLP-Ereignisse im OCSF-Format ab. Diese Befehle lesen nur — SIEM-Ziele wie Splunk, Sentinel und Elastic werden im Dashboard konfiguriert.

zeuslock siem pull

Ruft eine Seite OCSF-Ereignisse ab.

Anmeldedaten: Organisations-API-Schlüssel · Wirkung: Nur lesend

Gibt standardmäßig JSONL aus — ein Ereignis pro Zeile — genau das Format für SIEM-Collectoren. Die Antwort enthält einen next_cursor; über --since blättern Sie weiter. Für Nachladungen und einmalige Abfragen.

OptionWerteStandardWirkung
--api-key <key>zl_…[object Object]ZEUSLOCK_API_KEYOrganisations-API-Schlüssel für diesen Aufruf.
--since <cursor>Cursor-ZeichenkettekeinerEin next_cursor aus einer früheren Antwort. Kein Datum.
--from <time>ISO-Datum/Zeit oder EpochkeinerBeginn des Zeitfensters.
--to <time>ISO-Datum/Zeit oder EpochkeinerEnde des Zeitfensters.
--days <n>Positive ganze ZahlkeinerBlickt so viele Tage zurück. Schließt --from aus.
--category <value>dlpkeinerEreigniskategorie. Aktuelle Ereignisse nutzen dlp.
--severity <level>unknown | low | medium | high | criticalkeinerGilt als Mindest-Schweregrad, nicht als exakte Übereinstimmung.
--limit <n>1-500100Seitengröße. Wird vor der Anfrage geprüft.
--format <format>jsonl | jsonjsonljsonl lässt sich an Collectoren weiterleiten; json liefert eine Hülle mit next_cursor.
zeuslock siem pull --limit 100
zeuslock siem pull --days 7 --severity high --category dlp
zeuslock siem pull --format json | jq .next_cursor

zeuslock siem tail

Fragt fortlaufend ab und gibt neue Ereignisse aus, sobald sie eintreffen.

Anmeldedaten: Organisations-API-Schlüssel · Wirkung: Liest fortlaufend bis zum Abbruch

Läuft bis zum Abbruch und speichert die Position nach jedem Durchlauf in siem-cursors.json, sodass ein Neustart ohne Duplikate oder Lücken fortsetzt. Dahinter steht kein Streaming-Endpunkt — es wird gepollt. Geben Sie jedem Konsumenten einen eigenen --cursor-name, damit sich zwei Pipelines nicht um eine Position streiten.

OptionWerteStandardWirkung
--api-key <key>zl_…[object Object]ZEUSLOCK_API_KEYOrganisations-API-Schlüssel für diesen Aufruf.
--since <cursor>Cursor-Zeichenkettegespeicherter CursorÜberschreibt die gespeicherte Position für diesen Lauf.
--category <value>dlpkeinerGehört auch zur Identität des Cursors.
--severity <level>unknown…criticalkeinerMindest-Schweregrad; ebenfalls Teil der Cursor-Identität.
--limit <n>1-500100Seitengröße je Abruf.
--interval <seconds>Positive Zahl5Sekunden zwischen den Abrufen.
--cursor-name <name>Beliebiger TextdefaultNamensraum für die gespeicherte Position dieses Konsumenten.
--reset-cursorBooleschausIgnoriert die gespeicherte Position und beginnt von vorn.
--max-polls <count>Positive ganze ZahlkeinerStoppt nach dieser Anzahl Zyklen statt endlos zu laufen. Nützlich in einem Cronjob.
zeuslock siem tail --category dlp
zeuslock siem tail --cursor-name splunk-prod --interval 10
zeuslock siem tail --max-polls 12 --interval 5   # ~1 minute, then exit

zeuslock shadow-ai — Nicht freigegebene KI-Werkzeuge

Nur-Lese-Ansicht der Shadow-AI-Seite. Nur verfügbar, wenn Shadow AI für Ihre Organisation aktiviert ist; andernfalls melden die Befehle dies ohne Datenabruf.

zeuslock shadow-ai stats

KPI-Summen zur Nutzung nicht freigegebener KI-Werkzeuge.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Summen und Veränderung zum Vorzeitraum, um zu erkennen, ob die Schattennutzung nach einer Richtlinienankündigung zunimmt.

OptionWerteStandardWirkung
--days <days>7 | 30 | 9030Zeitfenster.
--source <source>all | endpoint | browser | bothallWo die Nutzung beobachtet wurde.
--status <status>all | sanctioned | shadowallshadow bedeutet, das Werkzeug ist nicht freigegeben.
--category <category>all | chatbot | coding_assistant | image_gen | agent | otherallWerkzeugkategorie.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock shadow-ai stats
zeuslock shadow-ai stats --days 7 --status shadow --category chatbot

zeuslock shadow-ai tools

Listet die in Ihrer Umgebung erkannten KI-Werkzeuge auf.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Werkzeug, Kategorie, Richtlinienstatus, Quelle, Nutzer- und Verbindungszahl sowie Risikowert — die Liste zur Entscheidung, was freigegeben oder blockiert wird.

OptionWerteStandardWirkung
--days <days>7 | 30 | 9030Zeitfenster.
--source <source>all | endpoint | browser | bothallWo die Nutzung beobachtet wurde.
--status <status>all | sanctioned | shadowallshadow bedeutet, das Werkzeug ist nicht freigegeben.
--category <category>all | chatbot | coding_assistant | image_gen | agent | otherallWerkzeugkategorie.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock shadow-ai tools --status shadow
zeuslock shadow-ai tools --category coding_assistant --json

zeuslock shadow-ai users

Listet die Personen, die Schatten-KI-Werkzeuge nutzen.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Nutzer, Anzahl verschiedener Werkzeuge und meistgenutztes Werkzeug. Gedacht, um Teams zu finden, die eine freigegebene Alternative brauchen, nicht um Einzelne bloßzustellen.

OptionWerteStandardWirkung
--days <days>7 | 30 | 9030Zeitfenster.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock shadow-ai users --days 7 --json

zeuslock mcp — Model-Context-Protocol-Aktivität

Womit sich KI-Agenten verbunden haben und was ihnen erlaubt wurde. Das Backend speichert nur bereinigte Metadaten und nicht umkehrbare Hashes — Prompts und Tool-Daten werden hier nie offengelegt.

zeuslock mcp stats

KPI-Summen der MCP-Aktivität.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Ereignisse, Tool-Aufrufe, Blockierungen und Alarme, aktive Server und betroffene Nutzer, gruppiert nach Transport, Richtung und Methode.

OptionWerteStandardWirkung
--days <days>7 | 30 | 9030Zeitfenster.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock mcp stats --days 7 --json

zeuslock mcp events

Listet einzelne MCP-Audit-Ereignisse auf.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

50 Zeilen pro Seite. Folgen Sie next_cursor über --cursor, um ein größeres Fenster zu durchlaufen.

OptionWerteStandardWirkung
--days <days>7 | 30 | 9030Zeitfenster.
--transport <transport>all | http | sse | stdioallWie sich der Agent verbunden hat.
--direction <direction>all | client_to_server | server_to_clientallNachrichtenrichtung.
--decision <decision>all | allow | alert | blockallWas die Richtlinie entschieden hat.
--method <method>tools/call…keinerExakter MCP-Methodenname.
--search <text>Beliebiger TextkeinerDurchsucht Server, Werkzeug, Nutzer, Methode, Hostname und Pfad.
--cursor <cursor>Cursor-ZeichenkettekeinerSetzt bei einer vorherigen Seite fort.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock mcp events --decision block
zeuslock mcp events --transport stdio --method tools/call --json

zeuslock mcp servers

Listet die in Ihrer Umgebung entdeckten MCP-Server auf.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Ein dedupliziertes Inventar über ein festes 90-Tage-Fenster — die Antwort auf „womit hat jemand einen Agenten verbunden?“.

OptionWerteStandardWirkung
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock mcp servers --json

zeuslock deploy — Auf einer Flotte ausrollen und den Erfolg belegen

zeuslock deploy generate (Alias: gpo-config)

Erzeugt die verwalteten Konfigurationsdateien, die Rechner automatisch registrieren.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Schreibt lokale Dateien

Schreibt nur lokale Dateien — nichts geht an Active Directory, Intune oder Jamf. Verteilen Sie sie mit Ihrem vorhandenen Werkzeug; Rechner sind dann bereits Ihrer Organisation zugeordnet, ohne Einrichtung je Nutzer. Dateien mit dem API-Schlüssel erhalten Modus 0600; der Schlüssel wird nie ausgegeben oder in deployment-summary.json geschrieben.

OptionWerteStandardWirkung
--artifact <set>all | extension | agentallWelche Dateien erzeugt werden. Erweiterungsdateien erfordern Business oder Enterprise.
--browser <browser>all | chrome | edgeallGilt nur für Erweiterungsdateien.
--output <dir>Pfadzeuslock-deployAusgabeverzeichnis. Gleichnamige Dateien werden überschrieben.
--api-key <key>zl_…keinerEinzubettender Schlüssel. Höchste Priorität.
--key-id <id>Beliebiger TextkeinerVerwendet einen vorhandenen Schlüssel aus keys list.
--create-key-name <name>Beliebiger TextkeinerErstellt einen neuen Schlüssel und bettet ihn ein. Ändert den Organisationszustand.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock deploy generate --key-id key-uuid
zeuslock deploy generate --artifact agent --output ./rollout
zeuslock deploy generate --artifact extension --browser chrome --create-key-name fleet-2026

Hat Ihre Organisation mehrere aktive Schlüssel, rät der Befehl nicht — geben Sie --key-id, --api-key oder --create-key-name an.

Die Erweiterungskonfiguration kommt bewusst in zwei Dateien: Die Browser-Richtlinie steuert die Installation, der API-Schlüssel liegt in der Datei für die verwaltete Konfiguration. Verteilen Sie beide, sonst installiert sich die Erweiterung und fragt danach jeden Nutzer nach der Konfiguration.

zeuslock deploy agent-verify

Bestätigt, dass Rechner tatsächlich registriert sind und sich melden.

Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend

Endet mit Code ungleich null, wenn kein passender Agent im erwarteten Zustand existiert — geeignet als Gate in einem Rollout-Skript. Liefert verified, offline, online oder not_found — die Unterscheidung zwischen „nie angekommen“ und „angekommen und verstummt“ zeigt, ob Rollout oder Rechner das Problem ist.

OptionWerteStandardWirkung
--agent-id <id>Beliebiger TextkeinerExakte Agent-ID.
--hostname <name>Beliebiger TextkeinerExakter Hostname, Groß-/Kleinschreibung egal.
--platform <platform>windows | macos | linuxkeinerPlattformfilter.
--status <status>online | offline | anyonlineErwarteter Zustand. Mit any prüfen Sie die Registrierung ohne aktiven Heartbeat.
--jsonBooleschausGibt maschinenlesbares JSON statt einer Tabelle aus.
zeuslock deploy agent-verify --hostname LAPTOP-01
zeuslock deploy agent-verify --platform windows --status any --json

Fehlerbehebung

MeldungBedeutungVorgehen
Not logged in. Run `zeuslock auth login` first.Auf diesem Rechner ist kein persönliches Token gespeichert.Erzeugen Sie eines auf der CLI-Seite und führen Sie zeuslock auth login --token zlu_… aus.
invalid CLI tokenDas Token ist widerrufen, abgelaufen oder gehört zu einer anderen Umgebung.Token sind umgebungsspezifisch: Ein Staging-Token liefert in der Produktion 401. Prüfen Sie ZEUSLOCK_API_URL und erzeugen Sie ein neues Token.
API key is required.Ein Inhaltsbefehl lief ohne Organisations-API-Schlüssel.Ein persönliches Token funktioniert nicht für scan, anonymize, hook run oder SIEM. Führen Sie zeuslock auth api-key set aus.
Multiple active API keys are available.deploy generate rät nicht, welcher Schlüssel eingebettet wird.Geben Sie --key-id, --api-key oder --create-key-name an.
Ein Befehl verlangt 90 oder 365 Tage und verweigert.Lange Zeitfenster und Export sind planabhängig.Business oder Enterprise erforderlich. Kürzere Fenster funktionieren weiter.
Ein Befehl bleibt hängen.siem tail pollt bis zum Abbruch; das ist erwartet.Strg-C drücken oder --max-polls für einen begrenzten Lauf nutzen.

Gegen Staging arbeiten

Anmeldedaten sind umgebungsspezifisch und nicht übertragbar. Richten Sie die CLI auf Staging aus und authentifizieren Sie sich mit einem Staging-Token.

export ZEUSLOCK_API_URL="https://api-staging.zeuslock.ai"
zeuslock auth login --token zlu_your_staging_token
zeuslock status

Was die CLI bewusst nicht tut

Die CLI bildet Dashboard und Backend ab, statt Funktionen zu erfinden. Folgendes fehlt bewusst, damit Sie nicht danach suchen:

Nicht verfügbarGrund
Anmeldung mit E-Mail und PasswortDer Login-Endpunkt verlangt ein reCAPTCHA, das ein Terminal nicht lösen kann.
Richtlinien anwenden oder bearbeitenrules bietet nur Export und Diff; Richtlinienänderungen bleiben im Dashboard, wo sie geprüft werden.
SIEM-Ziele konfigurierenSplunk-, Sentinel- und Elastic-Verbindungen werden im Dashboard verwaltet. Die CLI liest nur Ereignisse.
Schlüssel oder Token in einem Schritt rotierenEs gibt keinen atomaren Rotationsendpunkt. Erstellen Sie den Ersatz, leiten Sie den Verkehr um und widerrufen Sie dann den alten.
Massenweises Entfernen von BenutzernDas Backend entfernt einen Benutzer nach dem anderen, die Sperren gelten jeweils.
Erstellen von Installationspaketendeploy generate erzeugt Konfigurationsdateien. Installationspakete laden Sie im Dashboard herunter.