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 --helpEinmalige 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.
| Anmeldedaten | Präfix | Handelt als | Verwendet von |
|---|---|---|---|
| Persönliches CLI-Zugriffstoken | zlu_ | Sie, mit Ihrer Rolle | Datenbefehle: Vorfälle, Agenten, Benutzer, Schlüssel, Token, Richtlinien, Shadow AI, MCP, Erweiterungen, deploy |
| Organisations-API-Schlüssel | zl_ | Die Organisation | Inhalts- 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 whoamiDen Organisations-API-Schlüssel speichern
zeuslock auth api-key set zl_your_org_api_key
zeuslock auth api-key statusGlobale Optionen
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--token <zlu_…> | zlu_… | keiner | Verwendet 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
| Variable | Wirkung |
|---|---|
ZEUSLOCK_API_URL | Backend-URL. Standard https://api.zeuslock.ai. Für Staging https://api-staging.zeuslock.ai setzen. |
ZEUSLOCK_API_TOKEN | Persönliches CLI-Zugriffstoken für Benutzerbefehle. Ideal für CI. |
ZEUSLOCK_API_KEY | Organisations-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.
| # | Benutzerbefehle | Inhaltsbefehle |
|---|---|---|
| 1 | --token zlu_… | --api-key zl_… |
| 2 | ZEUSLOCK_API_TOKEN | ZEUSLOCK_API_KEY |
| 3 | Gespeichertes Token aus auth login --token | Gespeicherter 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.
| Befehl | Ungleich null bedeutet |
|---|---|
scan | Sensible Inhalte erreichten die Schwelle --fail-on. |
hook run | Der Commit sollte blockiert werden. |
rules diff | Die lokale Richtliniendatei weicht vom Live-Zustand ab. |
deploy agent-verify | Kein Agent gefunden oder nicht im erwarteten Zustand. |
status --require-license | Health-, 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
| Datei | Inhalt |
|---|---|
auth.json | Ihr CLI-Zugriffstoken, Modus 0600. |
api-key.json | Der gespeicherte Organisations-API-Schlüssel, Modus 0600. |
siem-cursors.json | Fortsetzungspositionen 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--token <zlu_…> | zlu_[object Object] | keiner | Das Token von der CLI-Seite im Dashboard. Das Format wird lokal vorab geprüft. |
--api-url <url> | URL | ZEUSLOCK_API_URL | Backend zur Prüfung, wird mit dem Token gespeichert. |
--json | Boolesch | aus | Gibt 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.aiEin 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock auth logoutzeuslock 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.
| Argument | Erforderlich | Beschreibung |
|---|---|---|
key | Nein | Der zl_…-Schlüssel. Fehlt er, liest die CLI ZEUSLOCK_API_KEY oder fragt nach. |
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--api-url <url> | URL | ZEUSLOCK_API_URL | Backend, zu dem der Schlüssel gehört; wird mitgespeichert. |
--json | Boolesch | aus | Gibt 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 historyzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock auth api-key statuszeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock auth api-key clearzeuslock auth whoami
Identisch mit zeuslock whoami, für alle, die es unter auth erwarten.
Anmeldedaten: Persönliches CLI-Zugriffstoken · Wirkung: Nur lesend
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock auth whoamizeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock whoami
zeuslock whoami --json
zeuslock --token zlu_… whoami # check a token without saving itzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--api-key <key> | zl_… | ZEUSLOCK_API_KEY | Schlüssel für die Lizenzprüfung. |
--require-license | Boolesch | aus | Exit-Code ungleich null, außer Health, Readiness und Lizenz sind in Ordnung. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock status
zeuslock status --json
zeuslock status --require-license # CI gatezeuslock 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.
| Argument | Erforderlich | Beschreibung |
|---|---|---|
path | Nein | Zu prüfende Datei oder Verzeichnis. Erforderlich außer mit --stdin; beides zusammen ist unzulässig. |
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--stdin | Boolesch | aus | Liest Text von der Standardeingabe statt aus einem Pfad. |
--api-key <key> | zl_… | [object Object]ZEUSLOCK_API_KEY | Organisations-API-Schlüssel für diesen Aufruf. |
--fail-on <decision> | alert | block | never | block | Welche 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 Text | cli | Quellenkennzeichen im Vorfall. |
--platform <platform> | Beliebiger Text | cli | Plattformkennzeichen der Anfrage. Die Plattformspalte des Vorfalls wird aus der URL abgeleitet, daher wird dieser Wert dort nicht gespeichert. |
--hostname <hostname> | Beliebiger Text | lokaler Hostname | Im Vorfall erfasster Hostname. |
--path <path> | Beliebiger Text | /cli/<file> | Zielkennzeichen im Vorfall; wird auf einen führenden Schrägstrich normalisiert. |
--user-email <email> | Beliebiger Text | keiner | Ordnet den Vorfall einer Person zu statt anonym zu bleiben. In CI sinnvoll. |
--include-sensitive | Boolesch | aus | Nimmt die Anonymisierungszuordnung des Backends in die JSON-Ausgabe auf. Sie enthält die Originalwerte — behandeln Sie die Ausgabe als sensibel. |
--json | Boolesch | aus | Gibt 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.comJeder 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.
| Argument | Erforderlich | Beschreibung |
|---|---|---|
file | Ja | Zu anonymisierende UTF-8-Textdatei. |
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--api-key <key> | zl_… | [object Object]ZEUSLOCK_API_KEY | Organisations-API-Schlüssel für diesen Aufruf. |
--output <path> | Beschreibbarer Pfad | stdout | Schreibt den anonymisierten Text in eine Datei statt ihn auszugeben. |
--include-sensitive-map | Boolesch | aus | Nimmt die Zuordnung Original/Maskiert in die JSON-Ausgabe auf. Das legt die echten Werte offen — entsprechend behandeln. |
--json | Boolesch | aus | Gibt 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 --jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--repo <path> | Pfad | aktuelles Repository | Ziel-Repository. |
--fail-on <decision> | alert | block | alert | In den Hook geschriebene Schwelle. Standard streng: Auch Alarme stoppen den Commit. |
--force | Boolesch | aus | Ersetzt einen vorhandenen pre-commit-Hook. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock hook install
zeuslock hook install --fail-on block --forcezeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--repo <path> | Pfad | aktuelles Repository | Zu prüfendes Repository. |
--api-key <key> | zl_… | [object Object]ZEUSLOCK_API_KEY | Organisations-API-Schlüssel für diesen Aufruf. |
--fail-on <decision> | alert | block | never | alert | Schwelle, die den Commit stoppt. |
--user-email <email> | Beliebiger Text | keiner | Ordnet den Vorfall einer Person zu. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock hook run
zeuslock hook run --fail-on block --json
git commit -m 'feature' # the hook runs automaticallyDer 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--days <days> | 7 | 30 | 90 | 30 | Zeitfenster. Andere Werte werden vor der Anfrage abgelehnt. |
--severity <level> | critical | warning | keiner | Der Schweregrad folgt dem Richtlinienergebnis, nicht dem Detektorwert: critical bedeutet blockiert, warning alles andere. Das entspricht der Dashboard-Anzeige. |
--search <text> | Beliebiger Text | keiner | Filtert nach E-Mail, URL oder Fundtyp. |
--jailbreak | Boolesch | aus | Behält nur Vorfälle mit einem Jailbreak-Versuch. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock incidents list --days 7
zeuslock incidents list --severity critical
zeuslock incidents list --jailbreak --jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--days <days> | 1 | 7 | 30 | 365 | 30 | Statistikfenster. 365 erfordert Business oder Enterprise. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock incidents stats
zeuslock incidents stats --days 365 --jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--days <days> | 7 | 30 | 90 | 30 | Zeitfenster. |
--severity <level> | critical | warning | keiner | Der Schweregrad folgt dem Richtlinienergebnis, nicht dem Detektorwert: critical bedeutet blockiert, warning alles andere. Das entspricht der Dashboard-Anzeige. |
--search <text> | Beliebiger Text | keiner | Filtert nach E-Mail, URL oder Fundtyp. |
--jailbreak | Boolesch | aus | Behält nur Vorfälle mit einem Jailbreak-Versuch. |
--format <format> | csv | json | csv | Ausgabeformat. |
--output <path> | Beschreibbarer Pfad | incidents-<timestamp>.<ext> | Zieldatei. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock incidents export --days 7
zeuslock incidents export --days 30 --severity critical --format json --output incidents.jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--status <status> | all | online | offline | all | Heartbeat-Filter. |
--search <text> | Beliebiger Text | keiner | Durchsucht nur Hostname und Plattform. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock agents list
zeuslock agents list --status offline
zeuslock agents list --search windows --jsonzeuslock 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.
| Argument | Erforderlich | Beschreibung |
|---|---|---|
agent_id | Ja | Exakte ID aus agents list. |
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
-y, --yes | Boolesch | aus | Überspringt die Bestätigung. In Skripten und CI erforderlich. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock agents revoke AGENT-123
zeuslock agents revoke AGENT-123 --yes --jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock extensions status --jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--search <text> | Beliebiger Text | keiner | Lokaler Filter über E-Mail, Rolle, Status und Anzeigename. |
--role <role> | admin, user, viewer… | keiner | Gegen die Rollen Ihres Plans geprüft. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock users list
zeuslock users list --role admin
zeuslock users list --search alice --jsonzeuslock 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.
| Argument | Erforderlich | Beschreibung |
|---|---|---|
user | Ja | Benutzer-ID oder E-Mail-Adresse. |
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
-y, --yes | Boolesch | aus | Überspringt die Bestätigung. In Skripten und CI erforderlich. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock users remove departing@example.com
zeuslock users remove user-uuid --yes --jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--status <status> | all | active | revoked | all | Lokaler Statusfilter. |
--show-secret | Boolesch | aus | Zeigt verfügbare vollständige Werte. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock keys list
zeuslock keys list --status active
zeuslock keys list --show-secret --jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--name <name> | Beliebiger Text | keiner | Erforderlich. Benennen Sie ihn nach dem Einsatzort, damit er später sicher widerrufen werden kann. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock keys create --name ci-pipeline
zeuslock keys create --name fleet-deploy --jsonzeuslock 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.
| Argument | Erforderlich | Beschreibung |
|---|---|---|
key_id | Ja | ID aus keys list. |
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
-y, --yes | Boolesch | aus | Überspringt die Bestätigung. In Skripten und CI erforderlich. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock keys revoke key-uuid --yeszeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--status <status> | all | active | revoked | expired | all | Lokaler Statusfilter. |
--show-secret | Boolesch | aus | Zeigt vollständige Werte, sofern das Backend sie liefert. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock tokens list
zeuslock tokens list --status expiredzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--name <name> | 1–255 Zeichen | keiner | Erforderlich. Identifiziert das Token in der Liste. |
--expires-in-days <days> | 1-365 | Backend-Standard (90) | Kürzere Laufzeiten sind für CI besser. Werte außerhalb des Bereichs werden lokal abgelehnt. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock tokens create --name work-laptop
zeuslock tokens create --name ci-job --expires-in-days 30 --jsonzeuslock 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.
| Argument | Erforderlich | Beschreibung |
|---|---|---|
token_id | Ja | ID aus tokens list. |
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
-y, --yes | Boolesch | aus | Überspringt die Bestätigung. In Skripten und CI erforderlich. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock tokens revoke token-uuid --yeszeuslock 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.
| Argument | Erforderlich | Beschreibung |
|---|---|---|
token_id | Ja | ID eines widerrufenen Tokens. |
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
-y, --yes | Boolesch | aus | Überspringt die Bestätigung. In Skripten und CI erforderlich. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock tokens revoke token-uuid --yes
zeuslock tokens purge token-uuid --yeszeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--scope <scope> | policies | default | policy | policies | policies exportiert alle sichtbaren Richtlinien samt Zuweisungsgruppen; default nur die Standardrichtlinie; policy ein einzelnes Dokument. |
--policy-id <id> | Beliebiger Text | keiner | Erforderlich mit --scope policy. |
--format <format> | yaml | json | yaml | Exportformat. |
--output <path> | Beschreibbarer Pfad | stdout | Schreibt 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 defaultzeuslock 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.
| Argument | Erforderlich | Beschreibung |
|---|---|---|
file | Nein | Exportiertes YAML oder JSON. Standard zeuslock.rules.yaml, dann .yml, dann .json. |
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--scope <scope> | policies | default | policy | policies | Muss dem im Datei-Scope entsprechen. |
--policy-id <id> | Beliebiger Text | keiner | Erforderlich mit --scope policy. |
--format <format> | text | json | text | Format 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 jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--api-key <key> | zl_… | [object Object]ZEUSLOCK_API_KEY | Organisations-API-Schlüssel für diesen Aufruf. |
--since <cursor> | Cursor-Zeichenkette | keiner | Ein next_cursor aus einer früheren Antwort. Kein Datum. |
--from <time> | ISO-Datum/Zeit oder Epoch | keiner | Beginn des Zeitfensters. |
--to <time> | ISO-Datum/Zeit oder Epoch | keiner | Ende des Zeitfensters. |
--days <n> | Positive ganze Zahl | keiner | Blickt so viele Tage zurück. Schließt --from aus. |
--category <value> | dlp | keiner | Ereigniskategorie. Aktuelle Ereignisse nutzen dlp. |
--severity <level> | unknown | low | medium | high | critical | keiner | Gilt als Mindest-Schweregrad, nicht als exakte Übereinstimmung. |
--limit <n> | 1-500 | 100 | Seitengröße. Wird vor der Anfrage geprüft. |
--format <format> | jsonl | json | jsonl | jsonl 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_cursorzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--api-key <key> | zl_… | [object Object]ZEUSLOCK_API_KEY | Organisations-API-Schlüssel für diesen Aufruf. |
--since <cursor> | Cursor-Zeichenkette | gespeicherter Cursor | Überschreibt die gespeicherte Position für diesen Lauf. |
--category <value> | dlp | keiner | Gehört auch zur Identität des Cursors. |
--severity <level> | unknown…critical | keiner | Mindest-Schweregrad; ebenfalls Teil der Cursor-Identität. |
--limit <n> | 1-500 | 100 | Seitengröße je Abruf. |
--interval <seconds> | Positive Zahl | 5 | Sekunden zwischen den Abrufen. |
--cursor-name <name> | Beliebiger Text | default | Namensraum für die gespeicherte Position dieses Konsumenten. |
--reset-cursor | Boolesch | aus | Ignoriert die gespeicherte Position und beginnt von vorn. |
--max-polls <count> | Positive ganze Zahl | keiner | Stoppt 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 exitzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--days <days> | 7 | 30 | 90 | 30 | Zeitfenster. |
--source <source> | all | endpoint | browser | both | all | Wo die Nutzung beobachtet wurde. |
--status <status> | all | sanctioned | shadow | all | shadow bedeutet, das Werkzeug ist nicht freigegeben. |
--category <category> | all | chatbot | coding_assistant | image_gen | agent | other | all | Werkzeugkategorie. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock shadow-ai stats
zeuslock shadow-ai stats --days 7 --status shadow --category chatbotzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--days <days> | 7 | 30 | 90 | 30 | Zeitfenster. |
--source <source> | all | endpoint | browser | both | all | Wo die Nutzung beobachtet wurde. |
--status <status> | all | sanctioned | shadow | all | shadow bedeutet, das Werkzeug ist nicht freigegeben. |
--category <category> | all | chatbot | coding_assistant | image_gen | agent | other | all | Werkzeugkategorie. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock shadow-ai tools --status shadow
zeuslock shadow-ai tools --category coding_assistant --jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--days <days> | 7 | 30 | 90 | 30 | Zeitfenster. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock shadow-ai users --days 7 --jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--days <days> | 7 | 30 | 90 | 30 | Zeitfenster. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock mcp stats --days 7 --jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--days <days> | 7 | 30 | 90 | 30 | Zeitfenster. |
--transport <transport> | all | http | sse | stdio | all | Wie sich der Agent verbunden hat. |
--direction <direction> | all | client_to_server | server_to_client | all | Nachrichtenrichtung. |
--decision <decision> | all | allow | alert | block | all | Was die Richtlinie entschieden hat. |
--method <method> | tools/call… | keiner | Exakter MCP-Methodenname. |
--search <text> | Beliebiger Text | keiner | Durchsucht Server, Werkzeug, Nutzer, Methode, Hostname und Pfad. |
--cursor <cursor> | Cursor-Zeichenkette | keiner | Setzt bei einer vorherigen Seite fort. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock mcp events --decision block
zeuslock mcp events --transport stdio --method tools/call --jsonzeuslock 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?“.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock mcp servers --jsonzeuslock 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--artifact <set> | all | extension | agent | all | Welche Dateien erzeugt werden. Erweiterungsdateien erfordern Business oder Enterprise. |
--browser <browser> | all | chrome | edge | all | Gilt nur für Erweiterungsdateien. |
--output <dir> | Pfad | zeuslock-deploy | Ausgabeverzeichnis. Gleichnamige Dateien werden überschrieben. |
--api-key <key> | zl_… | keiner | Einzubettender Schlüssel. Höchste Priorität. |
--key-id <id> | Beliebiger Text | keiner | Verwendet einen vorhandenen Schlüssel aus keys list. |
--create-key-name <name> | Beliebiger Text | keiner | Erstellt einen neuen Schlüssel und bettet ihn ein. Ändert den Organisationszustand. |
--json | Boolesch | aus | Gibt 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-2026Hat 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.
| Option | Werte | Standard | Wirkung |
|---|---|---|---|
--agent-id <id> | Beliebiger Text | keiner | Exakte Agent-ID. |
--hostname <name> | Beliebiger Text | keiner | Exakter Hostname, Groß-/Kleinschreibung egal. |
--platform <platform> | windows | macos | linux | keiner | Plattformfilter. |
--status <status> | online | offline | any | online | Erwarteter Zustand. Mit any prüfen Sie die Registrierung ohne aktiven Heartbeat. |
--json | Boolesch | aus | Gibt maschinenlesbares JSON statt einer Tabelle aus. |
zeuslock deploy agent-verify --hostname LAPTOP-01
zeuslock deploy agent-verify --platform windows --status any --jsonFehlerbehebung
| Meldung | Bedeutung | Vorgehen |
|---|---|---|
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 token | Das 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 statusWas 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ügbar | Grund |
|---|---|
| Anmeldung mit E-Mail und Passwort | Der Login-Endpunkt verlangt ein reCAPTCHA, das ein Terminal nicht lösen kann. |
| Richtlinien anwenden oder bearbeiten | rules bietet nur Export und Diff; Richtlinienänderungen bleiben im Dashboard, wo sie geprüft werden. |
| SIEM-Ziele konfigurieren | Splunk-, Sentinel- und Elastic-Verbindungen werden im Dashboard verwaltet. Die CLI liest nur Ereignisse. |
| Schlüssel oder Token in einem Schritt rotieren | Es gibt keinen atomaren Rotationsendpunkt. Erstellen Sie den Ersatz, leiten Sie den Verkehr um und widerrufen Sie dann den alten. |
| Massenweises Entfernen von Benutzern | Das Backend entfernt einen Benutzer nach dem anderen, die Sperren gelten jeweils. |
| Erstellen von Installationspaketen | deploy generate erzeugt Konfigurationsdateien. Installationspakete laden Sie im Dashboard herunter. |