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
| Platzhalter | Wert |
|---|---|
{{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:
| Filter | Sprache | Beispiel | wird zu |
|---|---|---|---|
|ps | PowerShell | $k = {{kunde.name|ps}} | $k = 'Müller & Söhne' |
|sh | bash, sh, zsh | K={{kunde.name|sh}} | K='Müller & Söhne' |
|py | Python | k = {{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_KEYlegtupdate.shbzw.install.sheinmalig in.envan. 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
param($Url, $Kunde)
Invoke-WebRequest $Url -OutFile "$env:TEMP\setup.exe"
Start-Process "$env:TEMP\setup.exe" -ArgumentList "/S /CUSTOMER=$Kunde" -WaitArgumente des Scripts:
-Url {{kunde.installer_url}}
-Kunde {{kunde.nummer}}