OTScan 2.0.1 (Linux x86_64) - Kurzanleitung
===========================================

Voraussetzungen
  - 64-bit-Linux (x86_64) mit glibc 2.31 oder neuer (ldd --version).
    Getestet: Debian 11, Ubuntu 22.04, Ubuntu 24.04. Andere Distributionen
    mit glibc >= 2.31 sollten laufen (nicht einzeln getestet).
    NICHT lauffaehig: RHEL/Rocky 8, CentOS 7 (glibc zu alt).
  - Nmap muss installiert sein (wird NICHT mitgeliefert):
      Debian/Ubuntu:  sudo apt install nmap        Fedora:  sudo dnf install nmap
  - Grafische Oberflaeche (X11, oder Wayland mit XWayland).
    Python/Tk sind im Programm enthalten.

Start
  tar xzf OTScan_2.0.1_Linux_x86_64.tar.gz
  cd OTScan_2.0.1_Linux_x86_64
  chmod +x OTScan
  ./OTScan              (Ping-/Connect-Scans, Reports, Inventar)
  sudo ./OTScan         (SYN-/UDP-/OS-Scans und tiefe NSE-Scans brauchen root)

  Wayland (Ubuntu 22.04+ Standard): Grafische Programme duerfen als root
  oft nicht auf den Bildschirm. Dann vorher einmal pro Sitzung:
      xhost +SI:localuser:root
  Erscheint nach "sudo ./OTScan" kein Fenster (Programm endet sofort ohne
  Meldung), fehlt root der Zugriff auf den Bildschirm -> xhost-Zeile oben.
  Achtung: Unter sudo gilt das Home-Verzeichnis von root. Testphase,
  Lizenz und Datenbank liegen dann getrennt vom normalen Benutzer.

Eigene NSE-Skripte (22, davon 20 OT-spezifisch) + Lua-Bibliotheken sind im
Programm enthalten und werden automatisch verwendet. Die Kopie im Ordner
nse_scripts/ dient nur zur Einsicht/Lizenz (NPSL, siehe LICENSE_NPSL_Nmap.txt).

Ablageorte
  Datenbank/Einstellungen: ~/.local/share/OTScan/
  Eigenes Logo im Report:  ~/.local/share/OTScan/branding_config.json, z. B.
      {"logo_report": "mein_logo.png", "company_name": "Muster GmbH"}
    und mein_logo.png in denselben Ordner legen.
  Reports: standardmaessig ~/Documents (im Programm aenderbar).
  Testphase: ~/OTScan/trial.dat und ~/.config/otscan/.tcache

Testphase: 3 Tage. Lizenzschluessel jederzeit ueber "Lizenz eingeben..." in der
Seitenleiste eingeben (nach Ablauf erscheint der Dialog beim Start).
Handbuch: docs/OTScan_Benutzerhandbuch_v2.0.1.pdf

Datenschutz: Scandaten bleiben auf Ihrem Rechner. Nur bei der Lizenz-
aktivierung werden Lizenzschluessel (enthaelt Name + Bestellnummer) und ein
Geraete-Hash an den Lizenzserver (Cloudflare) uebertragen.

Sicherheit: Nur in Netzen scannen, fuer die eine Freigabe vorliegt. Aktive
Scans koennen empfindliche Altgeraete beeintraechtigen - schonende Profile
und Wartungsfenster nutzen. Siehe HAFTUNG_UND_NUTZUNG.txt.

Lizenz: EULA.txt (OTScan), LICENSE_NPSL_Nmap.txt (NSE-Skripte),
THIRD_PARTY_NOTICES.txt (Drittkomponenten).
Pruefsumme: SHA-256 steht in SHA256SUMS.txt neben dem Download.
Bei Fragen: hanselcraft.de
