OTScan 3 (12.11.2026) – Linux-Fassung
=============================================
HanselCraft (Jörg Hansel) · hanselcraft.de

Diese Fassung läuft unter Windows UND Linux (dieselben Programmdateien). Neu in OTScan 3.0: siehe Abschnitt 8.

Getestet (Einrichtung, Selbsttest „31 ok, 0 Fehler“, Programmstart, Aktualisierung, Entfernen ohne Rückstände;
jeweils frisch aufgesetztes System in einer Testumgebung, Pakete und pip auch über einen Proxy):
   Distribution                Python   nmap    Besonderheit
   Ubuntu 24.04 LTS (noble)    3.12     7.94    –
   Ubuntu 22.04 LTS (jammy)    3.10     7.80    nmap-Paket ist trotz Name „7.91“ technisch 7.80 (älteste getestete Fassung)
   Ubuntu 26.04 LTS (resolute) 3.14     7.98    sudo ist dort sudo-rs (funktioniert); es gibt kein „sg“ mehr (siehe 1.)
   Debian 12 (bookworm)        3.11     7.93    –
   Fedora 45                   3.15     7.92    kein dpkg: nach einem nmap-Update install_linux.sh erneut ausführen
Nicht in der Testumgebung geprüft: PDF-Druck mit Chromium (dort kein lauffähiger Browser), echtes Umstellen eines
Adapters, Anmeldung an einer echten Desktop-Sitzung. openSUSE: vom Skript unterstützt (zypper), nicht getestet.
Empfohlen: Debian 12 / Ubuntu 22.04 oder neuer, Fedora 39 oder neuer (Python 3.10 oder neuer).
Voraussetzungen: Administratorrechte (sudo) für die Einrichtung, Internetzugang für Pakete und pip,
ca. 700 MB frei im Programmordner, grafische Desktop-Sitzung für das Programm.

Kurzfassung:  entpacken nach /opt/otscan3 → sudo ./install_linux.sh --adapter "<scan-adapter>" <benutzername>
              → ab- und wieder anmelden → /opt/otscan3/otscan3.sh   (Einzelheiten unten)


1. Einrichten (einmalig, als Administrator)
-------------------------------------------
   Das Paket als root nach /opt/otscan3 entpacken (der Programmordner muss root gehören – aus einem
   Benutzerordner wie ~/Downloads bricht die Einrichtung mit einem Hinweis ab):

       sudo mkdir -p /opt/otscan3
       sudo tar -xzf OTScan3_3.0.0_Linux.tar.gz -C /opt/otscan3 --strip-components=1
       cd /opt/otscan3
       sudo ./install_linux.sh --adapter "<scan-adapter>" <benutzername>

   <scan-adapter> = der Netzwerkadapter (oder mehrere, mit Leerzeichen getrennt), den OTScan 3 für Scans
   umstellen darf, z. B. "enx00e04c680001". Ohne --adapter fragt das Skript nach (Liste der vorhandenen Adapter).
   Adapternamen anzeigen:  ip -br link
   <benutzername> = der normale Benutzer, der OTScan 3 später startet (nicht root).
   ACHTUNG: Nur den eigenen Scan-Adapter freigeben (z. B. USB-Netzwerkadapter) – NICHT den Adapter, über den der
   Rechner im Büro-/Firmennetzwerk hängt. Ein freigegebener Adapter kann in OTScan 3 („Adapter einrichten“) auf eine
   feste Adresse ohne Standard-Gateway umgestellt werden; beim Büroadapter wäre die Netzwerkverbindung dann weg.
   Wer nur geroutete Netzwerke scannt (Ziel über Gateway/Firewall erreichbar), braucht keinen freigegebenen Adapter:
   dann --adapter "" angeben und in OTScan 3 mit Adapter (Auto) scannen.
   Hinter einem Proxy reicht sudo die Proxy-Einstellung nicht an pip weiter. Dann so starten:
       sudo env https_proxy=http://<proxy>:<port> ./install_linux.sh --adapter "<scan-adapter>" <benutzername>
   Bricht der Proxy die Verschlüsselung mit einem eigenen Zertifikat auf (pip meldet dann
   „CERTIFICATE_VERIFY_FAILED“), muss dieses Zertifikat im Zertifikatsspeicher des Systems liegen
   (Debian/Ubuntu: nach /usr/local/share/ca-certificates/*.crt und sudo update-ca-certificates;
   Fedora: nach /etc/pki/ca-trust/source/anchors/ und sudo update-ca-trust). So getestet unter allen oben genannten Systemen.
   Das Skript kann beliebig oft wiederholt werden (z. B. nach einem Abbruch wegen fehlendem Internet).

   Das Skript
   - prüft, dass der Programmordner root gehört und der Netzwerk-Helfer zu PRUEFSUMMEN.txt passt,
   - installiert nmap, Python mit Tk, ip/arping/ping, cron, xdg-open, Chromium (PDF-Berichte),
     secret-tool (Kamera-Passwörter) und Schriften,
   - legt eine Python-Umgebung ./venv an (openpyxl, python-pptx, Pillow, fpdf2, lxml, pandas; gehört root),
   - legt die Gruppe „otscan3“ an und nimmt den Benutzer auf,
   - gibt nmap die Rechte für SYN-/UDP-/OS-Scans ohne root – NUR für Mitglieder der Gruppe otscan3
     (nmap gehört dann root:otscan3, Modus 0750, Capability cap_net_raw – bewusst ohne cap_net_admin, damit über
     nmap-Skripte keine Adapter, Routen oder Firewall-Regeln geändert werden können).
     Debian/Ubuntu: dauerhaft über dpkg-statoverride; nach einem nmap-Update setzt ein apt-Haken die
     Capabilities automatisch neu. Andere Systeme: nach einem nmap-Update install_linux.sh erneut ausführen.
     Hinweis: Benutzer außerhalb der Gruppe können nmap danach nicht mehr starten (root weiterhin).
   - richtet die OT-Skripte für nmap ein (Ordner nse/: S7, Modbus, BACnet, PROFINET, OPC UA, CODESYS, Omron,
     Rexroth, Janitza, ONVIF/WS-Discovery …): root-eigen nach /usr/share/nmap/scripts bzw. nselib, danach
     nmap --script-updatedb. Ersetzte Dateien des nmap-Pakets sichert dpkg-divert (*.otscan3-orig); nach einem
     nmap-Update baut der apt-Haken die Skript-Datenbank neu auf. Ohne diese Skripte fehlen Hersteller, Firmware und
     Baugruppen der OT-Geräte im Ergebnis. Liste der eingerichteten Dateien: /etc/otscan3/nse.liste
   - richtet den Netzwerk-Helfer /usr/local/lib/otscan3/otsp-netz und eine sudo-Regel ein: Mitglieder der Gruppe
     otscan3 dürfen NUR diesen Helfer ohne Passwort aufrufen. Er führt nur ip, arping, nmcli, dhclient, dhcpcd und
     networkctl mit fest geprüften Argumenten aus – und nur für die freigegebenen Adapter aus /etc/otscan3/adapter
     (samt deren VLAN-Unterschnittstellen otv<N>). Gebraucht für Adapter einrichten, Netzwerkkette, Direktanschluss.
     Ohne Helfer und sudo-Regel: OTSP_OHNE_SUDOREGEL=1 setzen; dann scannt OTScan 3 normal, das Umstellen des
     Adapters ist aber gesperrt (mit Hinweis),
   - legt einen Startmenü-Eintrag „OTScan 3“ an und prüft Python, nmap-Rechte und den PDF-Browser.

   Danach einmal ab- und wieder anmelden (die Gruppe otscan3 wird erst dann wirksam – vorher startet nmap nicht).
   Für einen ersten Test ohne Abmelden (als der Benutzer, im Terminal):  sg otscan3 -c /opt/otscan3/otscan3.sh
   Ubuntu 26.04 hat kein „sg“ mehr – dort:  su <benutzername> -c /opt/otscan3/otscan3.sh  (fragt das eigene
   Passwort; install_linux.sh und otscan3.sh nennen automatisch den passenden Befehl).

   Weitere Benutzer:            sudo ./install_linux.sh --benutzer-dazu <benutzername>
   Adapter-Freigabe ändern:     sudo ./install_linux.sh --adapter "eth1 enp3s0" <benutzername>


2. Starten
----------
       /opt/otscan3/otscan3.sh          (oder Startmenü „OTScan 3“)

   Als normaler Benutzer in der grafischen Desktop-Sitzung starten, NICHT mit sudo (über SSH nur mit ssh -X).
   Unten links in der Seitenleiste steht „Administratorrechte aktiv“, wenn nmap die Rechte hat. Steht dort
   „Ohne Administratorrechte“ oder meldet OTScan 3 beim Start, dass nmap nur die Gruppe otscan3 starten darf:
   ab- und wieder anmelden (siehe Abschnitt 1).

   Adapter einrichten (Scan-Adapter auf ein OT-Netzwerk umstellen) ist nur nötig, wenn der Scan-PC DIREKT am
   Zielnetzwerk hängt (Dose/Switchport im Ziel-VLAN bzw. registrierte Scan-MAC). Geroutete Netzwerke mit Adapter (Auto) scannen.
   Im Fenster „Adapter einrichten“ fragt OTScan 3 vor jedem Umstellen und Zurücksetzen nach und bietet
   „Zurücksetzen“ an, wenn das Gateway des Zielnetzwerks nach dem Umstellen nicht antwortet.


3. Aktualisieren (neue Fassung von OTScan 3)
--------------------------------------------
   Das neue Paket über den bestehenden Programmordner entpacken und das Skript erneut ausführen:

       sudo tar -xzf OTScan3_3.0.0_Linux.tar.gz -C /opt/otscan3 --strip-components=1
       cd /opt/otscan3
       sudo ./install_linux.sh --adapter "<scan-adapter>" <benutzername>

   - Datenbank, Einstellungen, Scans und Berichte der Benutzer bleiben unverändert (sie liegen im Benutzerordner).
   - Dateien früherer Fassungen in handbuch, hilfe, sprachen, assets, selbsttest, docs und vorlagen, die es im
     neuen Paket nicht mehr gibt, entfernt das Skript (maßgeblich ist PRUEFSUMMEN.txt).
   - Die Python-Umgebung wird neu aufgebaut (Internet/Proxy für pip nötig; ohne Netz bleibt die vorhandene).
   - Die Liste der freigegebenen Adapter (/etc/otscan3/adapter) bleibt bei Aktualisierungen erhalten
     (interaktiv: Eingabe leer = beibehalten).
   - War der Programmordner bisher an einem anderen Ort, dort ebenso vorgehen. Ein Benutzerordner (z. B. ~/OTScan3)
     wird nicht mehr akzeptiert: dann nach /opt/otscan3 umziehen (Abschnitt 1) und alte Startmenü-Einträge
     werden dabei neu geschrieben. Geplante Scans neu speichern, wenn sich der Pfad geändert hat.


4. Entfernen
------------
       cd /opt/otscan3 && sudo ./uninstall_linux.sh

   Entfernt sudo-Regel, Netzwerk-Helfer, /etc/otscan3, den apt-Haken, die OT-Skripte (ersetzte nmap-Skripte
   kommen zurück), die nmap-Sonderrechte (nmap danach wieder root:root 0755 ohne Capabilities), die Gruppe
   otscan3 und die Startmenü-Einträge. Die Daten der Benutzer und die Systempakete bleiben.
   Vorher in OTScan 3 umgestellte Adapter zurücksetzen (ohne den Helfer geht das danach nicht mehr aus OTScan 3);
   uninstall_linux.sh nennt Adapter, die bei einem Benutzer noch umgestellt sind (Scan-IP-Profil, Scan-MAC, VLAN).
   Ohne Terminal (z. B. aus einem Skript) entfernt uninstall_linux.sh ohne Rückfrage.
   Danach den Programmordner löschen:  sudo rm -rf /opt/otscan3


5. Wo liegen die Daten?
-----------------------
   Datenbank, Einstellungen, Sicherungen der Adapter:  ~/.local/share/OTScan3
   Berichte, Inventar, Splunk-Ablage:                   Dokumente-Ordner (z. B. ~/Dokumente) – wie unter Windows
   Zeitplan:                                            crontab des Benutzers (crontab -l)
   Kamera-Passwörter:                                   Schlüsselbund des Benutzers (secret-tool)
   Mail-Entwürfe der Erstinbetriebnahme:                Dokumente/OTScan3_Mailentwuerfe/*.eml
                                                        (öffnen sich in Thunderbird/Evolution, werden nie gesendet)

   Daten von Windows oder einem anderen Rechner übernehmen: OTScan 3 → Datenpflege → „Datensicherung …“
   (Sicherung erstellen auf dem alten Rechner, „Sicherung einspielen …“ hier; Pfade werden angepasst).


6. Unterschiede zu Windows
--------------------------
   - Adapter umstellen: statt PowerShell werden ip, arping und nmcli benutzt (über den Netzwerk-Helfer, nur für die
     freigegebenen Adapter). Ausgabe, Sicherungen (netzadapter/sicherung_*.json, mac_original_*.json) und
     Zurücksetzen sind gleich.
   - Verwaltet NetworkManager den Scan-Adapter, legt OTScan 3 ein eigenes Profil „OTScan 3 <Netzwerk>“ an
     (feste Scan-IP, ohne Standard-Gateway, ohne IPv6, auf Wunsch mit Scan-MAC). Es bleibt auch nach einem
     Neustart erhalten. „Zurücksetzen“ löscht das Profil und aktiviert wieder die vorherige Verbindung.
   - Wird der Adapter von systemd-networkd verwaltet, bricht OTScan 3 das Umstellen mit einem Hinweis ab
     (sonst kämen Adresse und Standard-Gateway per DHCP zurück).
   - Die Netzwerkkette setzt nur dann eine Scan-IP, wenn die Adresskonflikt-Prüfung möglich ist
     (Paket iputils-arping). Trunk-Port: VLAN-Unterschnittstelle otv<N> auf dem freigegebenen Adapter.
   - PDF-Berichte brauchen einen lauffähigen Chromium, Google Chrome oder Microsoft Edge. Ubuntu: das Paket
     chromium-browser ist nur ein Platzhalter für das Snap – „sudo snap install chromium“ oder Google Chrome (.deb)
     installieren. Ohne Browser entstehen die Berichte als HTML (install_linux.sh meldet das im Selbsttest).
   - Splunk-Nachscan: Shell-Skript *_nachscan.sh statt der Windows-.bat.


7. Prüfen, ob alles da ist
--------------------------
       getcap "$(readlink -f "$(command -v nmap)")"    -> cap_net_raw=eip
       stat -c '%U:%G %a' "$(readlink -f "$(command -v nmap)")"     -> root:otscan3 750
       sudo -n /usr/local/lib/otscan3/otsp-netz ip link show lo  -> ohne Passwortabfrage, Ausgabe der Loopback-Zeile
       cat /etc/otscan3/adapter                       -> freigegebene Adapter
       nmap --script-help s7-info,modbus-identity       -> beide Skripte werden beschrieben (OT-Skripte da)
       id                                               -> Gruppe otscan3
       ./selbsttest.sh                                  -> Selbsttest als Benutzer (scannt kein Netzwerk; braucht die
                                                           grafische Sitzung, über SSH: xvfb-run -a ./selbsttest.sh).
                                                           Erwartet am Ende „… ok, 0 Fehler“; das Protokoll liegt
                                                           im Dokumente-Ordner unter OTScan3_Selbsttest.


8. Neu in OTScan 3.0 (Linux)
----------------------------
   - Dieselben Programmdateien wie unter Windows: Schnellscan und Advanced, Stufenlauf, Netzwerkkette,
     Splunk- und CMDB-Abgleich, Herstellermeldungen (CSAF), Erstinbetriebnahme, Berichte in 7 Sprachen.
   - Einrichtung aus einem root-eigenen Programmordner (/opt/otscan3) mit install_linux.sh, Aktualisieren und
     Entfernen (uninstall_linux.sh) ohne Rückstände.
   - nmap-Sonderrechte nur für die Gruppe otscan3 und nur cap_net_raw; der Netzwerk-Helfer arbeitet nur mit den
     freigegebenen Adaptern (/etc/otscan3/adapter). OT-Skripte (NSE) werden eingerichtet und geprüft.
   - Adapter einrichten mit Warnung vor gerouteten Netzwerken und sofortigem Zurücksetzen, wenn das Gateway
     des Zielnetzwerks nicht antwortet; mit NetworkManager eigenes Profil „OTScan 3 <Netzwerk>“.
   - Selbsttest als normaler Benutzer (scannt kein Netzwerk).
   Einzelheiten: docs/OTScan3_Neu_in_3.0.pdf und docs/OTScan3_Installationsanleitung_Linux.pdf


Nutzerhandbuch: Ordner handbuch (index.html, 7 Sprachen). Anleitungen als PDF: Ordner docs (Anwenderhandbuch,
Kurzanleitung, Installationsanleitungen, Berichte lesen, Technik/Sicherheit/Datenschutz, Neu in 3.0 – jeweils auch
auf Englisch „_EN“; Übersicht docs/Dokumente.txt). English: docs/README_EN.txt. CSV-Vorlagen: Ordner vorlagen.
Prüfsummen (SHA-256) siehe PRUEFSUMMEN.txt
