Skip to content

Script-Variablen ​

Ab v3.34.0 setzt Control Werte je Host in Scripts, Pre-/Post-Hooks und Argumente ein. So laeuft ein Script fuer alle Kunden, und Download-Adressen, Lizenzschluessel oder API-Schluessel stehen nicht im Script.

Platzhalter ​

PlatzhalterWert
{{host.name}}, {{host.hostname}}, {{host.ip}}, {{host.id}}Felder des Hosts
{{host.FELD}}Custom Field FELD des Hosts (sonst sein Standardwert)
{{kunde.name}}, {{kunde.nummer}}, {{kunde.ort}}Felder des Kunden
{{kunde.NAME}}Kunden-Variable NAME, sonst globale Variable gleichen Namens
{{global.NAME}}globale Variable NAME
{{standort.name}}, {{standort.adresse}}, {{standort.NAME}}Standort des Hosts bzw. Standort-Variable (ab v3.38.0)
{{wazuh.manager}}, {{wazuh.version}}, {{wazuh.gruppe}}, {{wazuh.passwort}}Werte fuer die Wazuh-Installation aus Einstellungen > Wazuh, Passwort als Geheimnis (ab v3.44.0); {{wazuh.neu_anmelden}} = ja, wenn der Host die Kennung eines anderen Hosts meldet (ab v3.48.5)

Die Schreibweise aus Tactical RMM geht ebenfalls: {{agent.x}} = {{host.x}}, {{client.x}} = {{kunde.x}}, {{site.name}} (Standort), {{global.x}}. Gross- und Kleinschreibung des Namens ist egal, solange sie eindeutig ist. Andere doppelte geschweifte Klammern, etwa docker ps --format '{{.Names}}', bleiben unveraendert.

Sonderzeichen und Filter (ab v3.65.15) ​

Mit einem Filter setzt Control den Wert als fertigen String der Script-Sprache ein, samt Anfuehrungszeichen:

FilterSpracheBeispielwird zu
|psPowerShell$k = {{kunde.name|ps}}$k = 'Müller & Söhne'
|shbash, sh, zshK={{kunde.name|sh}}K='Müller & Söhne'
|pyPythonk = {{kunde.name|py}}k = "Müller & Söhne"

Der Filter setzt die Anfuehrungszeichen selbst, schreib also keine eigenen darum.

Wann der Filter Pflicht ist: Felder vom Host, Custom Fields sowie Kunden- und Standortfelder ({{host.*}}, {{kunde.name}}, {{kunde.ort}}, {{standort.name}}, {{standort.adresse}} ...) koennen auch Benutzer aendern, die keine Scripts schreiben duerfen. Enthaelt so ein Wert ohne Filter eines der Zeichen ` $ " ' \ ; & | < > ( ) { } % ^, einen Zeilenumbruch oder typografische Anfuehrungszeichen, startet das Script nicht (Exit-Code 3). Die Meldung nennt den Platzhalter und die Zeichen. In PowerShell ist \ erlaubt (Pfade). Sonst koennte so ein Wert eigene Befehle in das Script schreiben, die als SYSTEM bzw. root laufen.

Script-Variablen und Geheimnisse ({{kunde.NAME}}, {{global.NAME}}, {{standort.NAME}}) und die {{wazuh.*}}-Werte gehen weiter ohne Filter, etwa ein Passwort in einem Here-String. Sie aendert nur, wer auch Scripts verwalten darf. In Argumenten setzt Control die Anfuehrungszeichen ohnehin selbst, ein Filter wirkt dort nicht.

Variablen verwalten ​

Automatisierung > Script-Variablen (nur Administratoren):

  • Reiter Global: gilt fuer alle Kunden.
  • Reiter Kunde: gilt nur fuer Hosts dieses Kunden und ersetzt eine globale Variable gleichen Namens.
  • Klick auf den Platzhalter kopiert ihn.

Im Script-Editor zeigt der Bereich Variablen die Platzhalter, die das Script verwendet, und eine Uebersicht aller verfuegbaren.

Geheimnisse ​

Mit dem Schalter Geheimnis wird der Wert verschluesselt gespeichert und ist danach in der Oberflaeche nicht mehr lesbar. Beim Bearbeiten bleibt er erhalten, solange das Feld leer bleibt.

  • Der Wert geht nur in der Kopie des Scripts an den Agent, die Control beim Abholen erzeugt. Im gespeicherten Task, in den Logs und im Audit-Log steht weiter der Platzhalter.
  • Taucht der Wert in der Ausgabe des Scripts auf, ersetzt Control ihn durch ••••••.
  • Den Schluessel SCRIPT_VAULT_KEY legt update.sh bzw. install.sh einmalig in .env an. Er darf sich nie aendern, sonst sind gespeicherte Geheimnisse nicht mehr lesbar.

Wenn ein Wert fehlt ​

Fehlt ein Wert, startet das Script auf diesem Host nicht. Der Lauf endet mit Exit-Code 3 und der Meldung DATAZONE: Script nicht gestartet - Kein Wert fuer {{kunde.x}} (Kunde ...). Bei Checks bedeutet Exit-Code 3 unbekannt. Ein leerer Wert wird also nie still eingesetzt.

Beispiel ​

powershell
param($Url, $Kunde)
Invoke-WebRequest $Url -OutFile "$env:TEMP\setup.exe"
Start-Process "$env:TEMP\setup.exe" -ArgumentList "/S /CUSTOMER=$Kunde" -Wait

Argumente des Scripts:

-Url {{kunde.installer_url}}
-Kunde {{kunde.nummer}}

DATAZONE Control Documentation