01 Konfiguration mittels config.yaml

Zuletzt geändert von jm Mahl am 2024/08/08 14:25

Contents

Was ist die conf.yaml-Datei?
Wie ist die conf.yaml-Datei aufgebaut?
- Welche Parameter können verändert werden?

Was ist die conf.yaml-Datei?

Die conf.yaml-Datei ist eine Datei im App-Data Verzeichnis von Maltego Evidence und ermöglicht Expertennutzern eine Vielzahl an Einstellungsmöglichkeiten. Sie finden die Datei unter dem folgenden Pfad:

%APPDATA%/Maltego Evidence/conf.yaml

Bitte seien Sie bei der Anpassung der Datei sehr vorsichtig und fragen Sie ggf. bei unserem Support-Team nach, bevor Sie Änderungen vornehmen. Die vorgenommenen Änderungen sollten nur von Experten, oder auf Anweisung des Support-Teams vorgenommen werden und können das Verhalten von Maltego Evidence maßgeblich verändern.

Wie ist die conf.yaml-Datei aufgebaut?

Die conf.yaml-Datei ist im YML-Format aufgebaut. Es ist daher sinnvoll, wenn Sie sich grob mit den Eigenheiten von YAML-Dateien betraut machen, bevor Sie Einstellungen in der config-Datei ändern.

Welche Parameter können verändert werden?

Prinzipiell können alle Parameter geändert werden, die folgenden werden von Expertennutzern jedoch am ehesten gebraucht. Falls in der Spalte "Neu anzulegen" ein "Ja" steht, dann ist der Parameter an der Stelle nicht standardmäßig vorhanden, kann jedoch eingefügt werden, um den spezifischen Standardwert zu überschreiben.

Pfad	Neu anzulegen?	Erklärung
services -> backend -> port	Nein	Der Port auf dem das Backend gestartet wird. Wichtig ist, dass der entsprechende Wert auch unter services -> frontend -> env -> apiUrl nach dem Doppelpunkt angepasst wird.
services -> frontend -> port	Nein	Der Port auf dem das Frontend gestartet wird.
environment -> mariaDB -> port	Nein	Der Port auf dem die MySQL-Datenbank gestartet werden soll. Bitte auch unter services -> backend -> settings -> database -> PORT anpassen.
services -> backend -> settings -> database	Nein	Hier kann eine alternative Datenbank an den Maltego Evidence Desktop angebunden werden. Supported sind neben MySQL auch Postgres und sqlite. Sie können weitere Informationen zur Konfiguration von Datenbanken im Django Handbuch nachlesen.
environment -> enableLog	Nein	Sie können diesen Wert auf "true" ändern. Dann wird beim Start jede Lognachricht in die darüberliegend-spezifizierte Datei geschrieben. Dies verlangsamt Maltego Evidence jedoch merklich.
services -> runners -> settings -> chrome_options -> user_agent	Ja	In diesem Wert können Sie den User-Agent überschreiben, den die Runner im Browser spezifizieren. Dies kann das Erhebungsverhalten massiv beeinflussen.
environment -> backup_interval	Nein	Hier können Sie festlegen in was für einem Zeitabstand Backups erstellt werden sollen (in Minuten).
environment -> max_number_of_backups	Nein	Hier können Sie festlegen, wieviele Backups standardmäßig behalten werden sollen.
environment -> backup_dir	Nein	Hier können Sie den Pfad angeben, in den Maltego Evidence die Backups speichern soll.
environment -> proxy	Ja	Standardmäßig überprüft Maltego Evidence beim Start, ob Updates vorliegen und installiert bei Bedarf die signierten Update-Pakete. Soll dieser Vorgang über einen separaten Proxy durchgeführt werden, können Sie den entsprechenden Proxy in dieser Konfiguration festlegen. Bspw. "https://username:password@my-proxy-server.com:12345"