3 OPENVAS SECURITY INTELLIGENCE einrichten¶
3.1 OPENVAS SECURITY INTELLIGENCE installieren¶
3.1.1 OPENVAS SECURITY INTELLIGENCE auf OPENVAS OS installieren¶
OPENVAS SECURITY INTELLIGENCE wird von Greenbone als virtuelle Maschine geliefert, welche das OPENVAS Operating System (OPENVAS OS) und ein Zertifikat, das die Benutzer zum Einsatz von OPENVAS SECURITY INTELLIGENCE berechtigt, enthält.
Um OPENVAS SECURITY INTELLIGENCE zu verwenden, müssen Benutzer selbst zuerst OPENVAS OS einrichten.
OPENVAS SECURITY INTELLIGENCE wird dann wie folgt installiert:
Als Admin-Benutzer auf die Shell von OPENVAS OS zugreifen.
Folgenden Befehl ausführen, um OPENVAS SECURITY INTELLIGENCE zu installieren:
os-cli container-management install-product security-intelligence
Bemerkung
Die Adresse der Web-Oberfläche muss explizit festgelegt werden.
Beispiel: Wenn die Web-Oberfläche unter
https://osi.example.neterreichbar sein soll, muss die Adresse aufosi.example.netgesetzt werden.Diese Einstellung muss mit der Netzwerkkonfiguration der virtuellen Maschine übereinstimmen. Der Befehl ändert die Netzwerkkonfiguration nicht.
Folgenden Befehl ausführen, um die Adresse der Web-Oberfläche festzulegen:
os-cli container-management configure-product security-intelligence --product-base-webaddress <WEB_INTERFACE_ADDRESS>
Bemerkung
Wenn eine über die Verbindungsart „ausgehend“ verbundene Appliance Scandaten an OPENVAS SECURITY INTELLIGENCE übermitteln können soll (siehe Kapitel 6), muss das von OPENVAS SECURITY INTELLIGENCE verwendete TLS-Zertifikat die Adresse der Web-Oberfläche als Subject Alternative Name (SAN) enthalten.
Wenn ein Domainname angegeben wird, muss das Zertifikat den entsprechenden DNS-Namen enthalten, zum Beispiel:
X509v3 Subject Alternative Name: DNS:example.local
Wenn eine IP-Adresse angegeben wird, muss das Zertifikat die entsprechende IP-Adresse enthalten, zum Beispiel:
X509v3 Subject Alternative Name: IP Address:192.168.1.50
Wenn das Zertifikat nicht die konfigurierte Adresse der Web-Oberfläche enthält, muss es durch ein geeignetes Zertifikat ersetzt werden, bevor Scandaten gesendet werden können.
Informationen zum Ersetzen des TLS-Zertifikats in OPENVAS OS befinden sich hier im OPENVAS-OS-Benutzerhandbuch.
Um eine einheitliche und korrekte Verarbeitung von Anmeldesitzungen zu gewährleisten, müssen die internen Uhren der Instanz von OPENVAS SECURITY INTELLIGENCE und des Systems, über das auf diese zugegriffen wird, synchronisiert sein oder zumindest nahezu identisch sein. Zu diesem Zweck wird empfohlen, die Zeitsynchronisation auf beiden Systemen zu aktivieren.
Bei OPENVAS SECURITY INTELLIGENCE kann die Zeitsynchronisation über das jeweilige Hostsystem oder durch Ausführen des Befehls
os-cli service update systemd-timesyncd enabled:truein der OPENVAS-OS-CLI aktiviert werden.
3.1.2 OPENVAS SECURITY INTELLIGENCE auf Linux mit Docker installieren¶
3.1.2.1 Das Setup vorbereiten¶
3.1.2.1.1 Voraussetzungen für das Setup¶
Die folgenden Tools werden benötigt:
Docker
Docker Compose, Version 2.40.3 oder höher
oras
openssl
tar
install
grep
sed
sort
tail
ls
curl
cp
less
tar
awk
tr
cat
pwd
zstd
Sicherstellen, dass Docker läuft und dass der aktuelle Benutzer darauf zugreifen kann:
docker ps
Falls dieser Befehl aufgrund fehlender Berechtigungen fehlschlägt, müssen die Docker-Befehle entweder mit den erforderlichen Berechtigungen ausgeführt oder der Benutzer gemäß den Richtlinien des Host-Betriebssystems zur entsprechenden Docker-Gruppe hinzugefügt werden.
3.1.2.1.2 Das Installationsskript herunterladen¶
Greenbone stellt ein Installationsskript für OPENVAS SECURITY INTELLIGENCE zur Verfügung. Es kann wie folgt heruntergeladen und einsatzbereit gemacht werden:
Das neueste Installationsskript von der Release-Seite herunterladen.
Die Datei entpacken:
unzstd openvas-deployment.zst
Das Skript ausführbar machen:
chmod +x openvas-deployment
3.1.2.1.3 Erforderliche Eingabedateien¶
Die folgenden Dateien werden für das Setup benötigt:
- OCI-Client-Zertifikat
Zertifikat zur Authentifizierung bei der Paket-Registry von Greenbone.
- Privater OCI-Client-Schlüssel
Privater Schlüssel des OCI-Client-Zertifikats.
Bemerkung
Alternativ kann eine Lizenzdatei (im Format .toml) verwendet werden, die OCI-Client-Zertifikat und -Schlüssel enthält.
3.1.2.2 Übersicht über Aktionen und Deploymentoptionen¶
Folgenden Befehl ausführen, um eine Liste verfügbarer Aktionen, Deploymentoptionen und Beispiele anzuzeigen:
openvas-deployment --help
Bemerkung
Weitere Informationen befinden sich in der README-Datei von openvas-deployment.
3.1.2.3 OPENVAS SECURITY INTELLIGENCE deployen¶
Bemerkung
Die Adresse der Web-Oberfläche muss explizit festgelegt werden.
Beispiel: Wenn die Web-Oberfläche unter https://osi.example.net erreichbar sein soll, muss die Adresse auf osi.example.net gesetzt werden.
Diese Einstellung muss mit der Netzwerkkonfiguration der virtuellen Maschine übereinstimmen. Der Befehl ändert die Netzwerkkonfiguration nicht.
Deployment mit OCI-Client-Zertifikat und -Schlüssel initiieren:
openvas-deployment --init --product security-intelligence --oci-client-cert <PATH_TO_OCI_CLIENT_CERT> --oci-client-key <PATH_TO_OCI_CLIENT_KEY> --domain-name <WEB_INTERFACE_ADDRESS>
oder
Deployment mit der Lizenzdatei initiieren:
openvas-deployment --init --product security-intelligence --license-file <PATH_TO_LICENSE_FILE> --domain-name <WEB_INTERFACE_ADDRESS>
y drücken, wenn OCI-Client-Zertifikat und -Schlüssel mit
sudoinstalliert werden sollen.sudo-Passwort eingeben.oder
n drücken, wenn OCI-Client-Zertifikat und -Schlüssel nicht mit
sudoinstalliert werden sollen.OCI-Client-Zertifikat und -Schlüssel als root installieren:
mkdir -p /etc/docker/certs.d/packages.greenbone.net install -m 0600 product.crt /etc/docker/certs.d/packages.greenbone.net/client.cert install -m 0600 product.key /etc/docker/certs.d/packages.greenbone.net/client.key
→ Die Initialisierung ist abgeschlossen.
Das neueste Produkt-Artefakt herunterladen:
openvas-deployment --update
Das Deployment starten:
openvas-deployment --run
Die laufenden Dienste prüfen:
openvas-deployment --ps
Fall nötig, die Logs prüfen:
openvas-deployment --logs
Die Logs für einen bestimmten Dienst prüfen:
openvas-deployment --logs --service-name '<SERVICE_NAME>'
Bemerkung
Der Name des Dienstes ist in der Spalte SERVICE in der Ausgabe des Befehls
openvas-deployment --pszu finden.
Bemerkung
Es muss sichergestellt werden, dass auf der vom Container-Orchestrator genutzten Partition mindestens 15 Millionen Inodes verfügbar sind. Dadurch wird ein langfristig zuverlässiger Betrieb des Systems gewährleistet.
Bei Dateisystemen, die nicht auf Inodes basieren, muss Metadatenspeicher für etwa 4 Millionen Dateien zur Verfügung stehen.
Wenn eine über die Verbindungsart „ausgehend“ verbundene Appliance Scandaten an OPENVAS SECURITY INTELLIGENCE übermitteln können soll (siehe Kapitel 6), muss das von OPENVAS SECURITY INTELLIGENCE verwendete TLS-Zertifikat die Adresse der Web-Oberfläche als Subject Alternative Name (SAN) enthalten.
Wenn ein Domainname angegeben wird, muss das Zertifikat den entsprechenden DNS-Namen enthalten, zum Beispiel:
X509v3 Subject Alternative Name: DNS:example.local
Wenn eine IP-Adresse angegeben wird, muss das Zertifikat die entsprechende IP-Adresse enthalten, zum Beispiel:
X509v3 Subject Alternative Name: IP Address:192.168.1.50
Wenn das Zertifikat nicht die konfigurierte Adresse der Web-Oberfläche enthält, muss es durch ein geeignetes Zertifikat ersetzt werden, bevor Scandaten gesendet werden können.
Informationen zum Ersetzen des TLS-Zertifikats in OPENVAS OS befinden sich hier im OPENVAS-OS-Benutzerhandbuch.
Um eine einheitliche und korrekte Verarbeitung von Anmeldesitzungen zu gewährleisten, müssen die internen Uhren der Instanz von OPENVAS SECURITY INTELLIGENCE und des Systems, über das auf diese zugegriffen wird, synchronisiert sein oder zumindest nahezu identisch sein. Zu diesem Zweck wird empfohlen, die Zeitsynchronisation auf beiden Systemen zu aktivieren.
Bei OPENVAS SECURITY INTELLIGENCE kann die Zeitsynchronisation über das jeweilige Hostsystem oder durch Ausführen des Befehls
os-cli service update systemd-timesyncd enabled:truein der OPENVAS-OS-CLI aktiviert werden.
3.2 Erstmalig als Super-Admin anmelden¶
Als Super-Admin kann initial wie folgt auf OPENVAS SECURITY INTELLIGENCE zugegriffen werden:
Webbrowser öffnen.
Konfigurierte Adresse der Web-Oberfläche von OPENVAS SECURITY INTELLIGENCE eingeben.
Mit dem Benutzernamen
openvasund dem initialen Passwortopenvas#useranmelden.Bei der ersten Anmeldung muss ein neues Passwort festgelegt werden.
Bemerkung
Das Passwort muss die folgenden Kriterien erfüllen:
Mindestens 10 Zeichen lang
Anders als der Benutzername
Anders als die E-Mail-Adresse
Anders als die letzten drei Passwörter
Kein gebräuchliches Wort, das in einem englischen oder deutschen Wörterbuch zu finden wäre
Der Benutzername kann nicht geändert werden.
Neues Passwort eingeben und wiederholen.
Auf Absenden klicken.
Abb. 3.1 Erstmalige Anmeldung bei OPENVAS SECURITY INTELLIGENCE als Super-Admin¶
→ Der Super-Admin kann nun weitere Benutzer für OPENVAS SECURITY INTELLIGENCE anlegen.
Bemerkung
Nach der ersten Anmeldung muss der Meta-Feed einmalig manuell aktualisiert werden, damit die relevanten Daten in OPENVAS SECURITY INTELLIGENCE geladen werden.
Datenverwaltung > Feed im Menü wählen.
Auf Feed aktualisieren klicken.
→ Die Aktualisierung des Feeds wird ausgeführt. Es kann bis zu drei bis vier Stunden dauern, bis der Vorgang abgeschlossen ist.
Bemerkung
Um die E-Mail-Adressen von Benutzern zu verifizieren, Passwörter zurückzusetzen oder Benachrichtigungen über Serverereignisse an Administratoren zu senden, muss das System in der Lage sein, E-Mails zu versenden. Dazu muss ein Mailserver verbunden sein. Der Mailserver muss das Simple Mail Transfer Protocol (SMTP) unterstützen.
Einstellungen > Benutzerverwaltung im Menü wählen.
→ Die Benutzerverwaltung wird in einem neuen Browsertab geöffnet.
Realm-Einstellungen im Menü wählen.
Tab E-Mail wählen.
Die Eingabefelder ausfüllen.
Die folgenden Einstellungen sind erforderlich:
- Von
E-Mail-Adresse, die als Absender für E-Mails verwendet wird.
- Host
Hostname des Mailservers, der zum Versenden von E-Mails verwendet wird.
Bemerkung
Weitere Informationen befinden sich in der Keycloak-Dokumentation.
Auf Verbindung testen klicken.
→ Das Testergebnis wird in der rechten oberen Ecke angezeigt.
Auf Speichern klicken.