KayandClaude Sonnet 5
dc4557496b
Rekonstruiert aus den bisherigen Git-Tag-Messages (v1.0.0/v1.1.0/v1.2.0) und bugs.md/found.md - jede Version behaelt ihren eigenen Abschnitt, neue Releases werden oben angehaengt statt die Datei zu ueberschreiben. README verlinkt jetzt darauf. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
283 lines
19 KiB
Markdown
283 lines
19 KiB
Markdown
# RouterOS Assistant
|
||
|
||
Native macOS-App (SwiftUI), die Laien und Fortgeschrittene per geführtem
|
||
Interview-Wizard durch die häufigsten Mikrotik-RouterOS-Konfigurationen
|
||
führt — und für alles darüber hinaus generischen, aber sicheren Zugriff
|
||
auf praktisch jedes RouterOS-Menü bietet.
|
||
|
||
## Worum geht's
|
||
|
||
Mikrotik-Router sind mächtig, aber die Konfiguration über Winbox oder die
|
||
CLI ist für Einsteiger:innen nicht immer zugänglich. RouterOS Assistant
|
||
übersetzt die häufigsten Schritte (Internet-Anschluss, Heimnetz/DHCP,
|
||
zusätzliche VLAN-Netzwerke, WLAN, Firewall-Grundschutz) in einen
|
||
geführten Wizard — und bleibt für alles, was darüber hinausgeht, über
|
||
einen generischen "Experte"-Zugriff auf über 300 RouterOS-Menüs
|
||
erweiterbar, ohne für jedes einzelne ein eigenes Formular bauen zu
|
||
müssen.
|
||
|
||
Verbindet sich per REST-API (RouterOS ≥ 7.1) mit SSH-CLI-Fallback für
|
||
ältere Geräte/Firmware. Alle Schreibvorgänge zeigen vorher den exakten
|
||
Befehl, der ausgeführt wird — nichts passiert unangekündigt.
|
||
|
||
## Features
|
||
|
||
- **Verbinden** — REST-zuerst/SSH-Fallback-Verbindung, Zertifikats-/
|
||
SSH-Hostkey-TOFU, Geräte- und Routerboard-Infos (Modell, Seriennummer,
|
||
Firmware), RouterOS-Software-Update-Check inkl. Installation,
|
||
Routerboard-Firmware-Update, Neustart-Button. **Bekannte Router**:
|
||
merkt sich Host/Benutzername nach jeder erfolgreichen Verbindung mit
|
||
editierbarem Namen (Standard: Hardware-Bezeichnung wie "hEX") und
|
||
freiem Standort-Feld (Etage/Raum/Zweck), Liste scrollt ab ca. 4
|
||
Einträgen in sich selbst. Interface-Liste zeigt **Live-Traffic**: Punkt
|
||
grau/grün/pulsierend-grün je nachdem, ob der Port Verkehr führt.
|
||
**Automatisches Wiederverbinden**: fällt die Verbindung während der
|
||
Sitzung weg, versucht die App selbständig, sie wiederherzustellen
|
||
(Herzschlag alle 10s, Retry alle 5s, unbegrenzt), mit Versuchszähler +
|
||
Countdown im Tab.
|
||
- **Einrichten** — geführter Wizard (WAN → LAN → VLAN → WLAN → Firewall
|
||
→ Review/Apply) mit Einfach- und Experte-Modus. Mehrere LAN-Interfaces
|
||
mit eigenem DHCP-Server und optionaler Netzwerk-Isolation
|
||
(Firewall-Drop-Regeln zwischen Netzen).
|
||
- **Übersicht** — grafisches Diagramm des kompletten IST-Zustands
|
||
(Interfaces → IP-Adressen → DHCP/Pools → Routen → Firewall/NAT), mit
|
||
echten, aus RouterOS' eigenen Referenzfeldern abgeleiteten
|
||
Verbindungslinien, nach Verbindungsart eingefärbt, Hover/Klick hebt
|
||
Zusammenhänge hervor, Klick auf eine Verbindungslinie zeigt eine
|
||
verständliche Erklärung samt Sprung zu den verbundenen Elementen.
|
||
Ein Knoten (IP-Adresse, Pool, DHCP-Server/-Netzwerk/-Client, Route,
|
||
Firewall-Filter/-NAT-Regel, WireGuard-Peer) lässt sich direkt über
|
||
denselben Dialog wie im Experte-Tab bearbeiten und ans Gerät
|
||
zurückschreiben. Verbindungslinien laufen animiert in Flussrichtung
|
||
("von → nach"); Kästchen lassen sich frei verschieben (Linien folgen
|
||
live mit), ein Button setzt die Anordnung zurück.
|
||
- **LAN-Scanner** (vormals "Geräte") — DHCP-Leases + ARP + Bridge-Host-
|
||
Tabelle, eine Tabelle pro physischem Port, mit Live-Traffic (↓/↑ +
|
||
10-Sekunden-Sparkline) je Port-Überschrift. Der "Aktionen"-Button
|
||
hinter jedem Gerät (ersetzt den vorherigen, nicht eindeutig
|
||
erkennbaren Rechtsklick) weist eine feste IP-Adresse zu (RouterOS'
|
||
"Make Static") oder entfernt sie wieder — der Warnhinweis dazu
|
||
erklärt auch den Rückweg ("Aktionen" → "Feste Zuweisung entfernen",
|
||
danach Gerät kurz trennen/neu verbinden). **Netzwerk-Tools** (auch im
|
||
"Aktionen"-Menü): Ping/Traceroute/DNS-Auflösung vom Router aus, sowie
|
||
ein **Port-Scan** direkt von diesem Mac (TCP-Verbindungsversuch auf
|
||
~19 gängige Ports, farbig: rot=offen, grün=geschlossen, grau=keine
|
||
Antwort).
|
||
- **Experte** — kuratierte Formulare (mit Tooltips/Warnhinweisen) für
|
||
die wichtigsten RouterOS-Bereiche (Firewall/NAT/Mangle/Raw komplett,
|
||
plus Interfaces/IP/VPN/WLAN/Queues/System/Werkzeuge), plus ein
|
||
generischer "eigener Menüpfad"-Zugriff für alles, was nicht kuratiert
|
||
ist — kein RouterOS-Menü bleibt unerreichbar.
|
||
- **Sicherungen** — Konfiguration exportieren und wieder einspielen
|
||
(SFTP-Upload + RouterOS' dokumentierter Restore-Weg), mit
|
||
Modell-Abgleich als Brick-Schutz, wählbarer Speicherort, "Werksein
|
||
stellungen wiederherstellen"-Notfallschalter.
|
||
- **Deutsch/Englisch** — Umschalt-Button in der Toolbar (persistiert über
|
||
Neustarts). Vollständig übersetzt: kompletter Experte-Tab (alle 9
|
||
Menü-Familien) und der Verbinden-Tab; weitere Tabs folgen
|
||
schrittweise.
|
||
- **Einstellungen** (⌘,, natives macOS-Settings-Fenster) — Sprache,
|
||
automatischer RouterOS-Update-Check beim Verbinden, Farbschema
|
||
(Standard/Kontrastreich, für Übersicht-Diagramm + LAN-Scanner-
|
||
Statusfarben + Experte-Sidebar-Kategorien), Textgröße, Bedienelement-
|
||
Größe, LAN-Scanner-Aktualisierungsrate/Sparkline-Zeitfenster/-Breite.
|
||
Jede Änderung wirkt sofort, ohne Neustart.
|
||
|
||
## Architektur
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
subgraph UI["SwiftUI-Tabs"]
|
||
Connect["Verbinden"]
|
||
Setup["Einrichten-Wizard"]
|
||
Overview["Übersicht"]
|
||
Devices["LAN-Scanner"]
|
||
Expert["Experte"]
|
||
Backup["Sicherungen"]
|
||
end
|
||
|
||
Connect --> CS["ConnectionService<br/>(geteilter State)"]
|
||
Setup --> CS
|
||
Overview --> CS
|
||
Devices --> CS
|
||
Expert --> CS
|
||
|
||
CS --> Decision{"REST-API<br/>verfügbar?"}
|
||
Decision -->|ja| REST["RestTransport"]
|
||
Decision -->|nein, Fallback| SSH["SSHTransport"]
|
||
|
||
Backup -. "eigene SSH-Verbindung<br/>(Backup/Restore/Werksreset/Update)" .-> SSH2["SSHTransport"]
|
||
Connect -. "eigene SSH-Verbindung<br/>(InterfaceTrafficMonitor, 3s-Polling)" .-> SSH3["SSHTransport"]
|
||
Devices -. "eigene SSH-Verbindung<br/>(NetworkToolsService: Ping/Traceroute/DNS)" .-> SSH4["SSHTransport"]
|
||
Devices -. "direkte TCP-Verbindung<br/>(PortScanner, nicht über den Router)" .-> LANDevice[("Gerät im LAN")]
|
||
|
||
Connect --> Saved["SavedRoutersStore<br/>(Bekannte Router)"]
|
||
Saved --> Defaults[("UserDefaults<br/>(lokal, kein Router-Zugriff)")]
|
||
|
||
REST --> Router[("Mikrotik<br/>RouterOS-Router")]
|
||
SSH --> Router
|
||
SSH2 --> Router
|
||
SSH3 --> Router
|
||
SSH4 --> Router
|
||
```
|
||
|
||
`ConnectionService` ist der einzige zwischen den Tabs geteilte State
|
||
(REST-zuerst, SSH-Fallback). Einmalige System-Aktionen (Backup,
|
||
Wiederherstellung, Werksreset, Updates) laufen bewusst über eine jeweils
|
||
eigene, dedizierte SSH-Verbindung statt über den aktiven Live-Transport —
|
||
`InterfaceTrafficMonitor` (3-Sekunden-Polling der Live-Interface-
|
||
Durchsätze) und `NetworkToolsService` (Ping/Traceroute/DNS-Auflösung im
|
||
LAN-Scanner-Tab) folgen demselben Muster, da die zugrundeliegenden
|
||
RouterOS-Befehle (`/interface monitor-traffic`, `/ping`,
|
||
`/tool traceroute`, `/resolve`) reine CLI-Befehle ohne REST-Äquivalent
|
||
sind. `PortScanner` (ebenfalls LAN-Scanner-Tab) geht dagegen gar nicht
|
||
über den Router — ein reiner TCP-Verbindungsversuch direkt von diesem Mac
|
||
zum jeweiligen LAN-Gerät, da RouterOS selbst keinen Portscanner anbietet.
|
||
Ein generischer Menü-Engine (`fetchMenuItems`/`fetchFieldValues`) macht
|
||
praktisch jedes RouterOS-Menü lesbar, auch ohne kuratiertes Schema —
|
||
darauf bauen Übersicht-, LAN-Scanner- und Experte-Tab gemeinsam auf,
|
||
ebenso `ConnectionService.
|
||
checkPortConflict(interfaceName:)` für die LAN-Port-Konflikt-Prüfung im
|
||
Einrichten-Assistenten. `SavedRoutersStore` (Bekannte Router) ist bewusst
|
||
komplett lokal — ein JSON-Array in `UserDefaults`, kein Router-Zugriff;
|
||
nur die zugehörigen Passwörter liegen weiterhin im macOS-Schlüsselbund.
|
||
|
||
## Meilensteine
|
||
|
||
| # | Feature | Status |
|
||
|---|---|---|
|
||
| M1–M4 | Projektgerüst, Connect, Backup, WAN/LAN/DHCP, VLAN | ✅ live verifiziert |
|
||
| M5 | WLAN-Schritt (Legacy-Treiber, `/interface wireless`) | ✅ live verifiziert (hAP lite, Smartphone verbunden) |
|
||
| M6 | Firewall-Grundschutz | ✅ live verifiziert |
|
||
| M7 | Härtung (SSH-Hostkey-TOFU) | ✅ TOFU + REST-Schreibpfad live verifiziert; Verbindungsabbruch-mitten-im-Apply per Code-Review bestätigt (sauberer `do/catch`-Abbruch, kein Absturz/Hänger, `applyLog` zeigt Fortschritt, Backup davor als Netz) — bewusst nicht live erzwungen (Risiko eines halb-konfigurierten Routers unverhältnismäßig zum Erkenntnisgewinn) |
|
||
| M8 | Mehrere LAN-Interfaces + Netzwerk-Isolation | ✅ live verifiziert |
|
||
| M9 | Einfach/Experte-Modusschalter im Wizard | ✅ Modusschalter + Experte-Zweig live verifiziert (Multi-LAN/Isolation-Test 2026-09-15, WLAN-Test 2026-09-17 liefen beide über den App-Wizard im Experte-Modus); Einfach-Zweig selbst nicht separat live geklickt |
|
||
| M10 | Experte-Tab (generischer RouterOS-Zugriff) | ✅ live verifiziert |
|
||
| M11 | Übersicht-Tab (IST-Zustand-Diagramm) | ✅ live verifiziert |
|
||
| M12 | Geräte-Tab (LAN-Scanner + Static-IP) | ✅ live verifiziert |
|
||
| M13 | Backup-Wiederherstellung | ✅ live verifiziert |
|
||
| M14 | Update-Check (Software + Firmware) | ✅ live verifiziert |
|
||
| M15 | Übersicht-Tab: Diagramm-Fixes + Direktes Bearbeiten | ✅ live verifiziert |
|
||
| M16 | Zweisprachigkeit (DE/EN), begonnen im Experte-Tab | ✅ live verifiziert |
|
||
| M17 | Bekannte Router (Verbinden-Tab), Standort-Feld, Scroll-Cap | ✅ live verifiziert |
|
||
| M18 | Live-Traffic-Anzeige an Interfaces (Verbinden-Tab) | ✅ live verifiziert |
|
||
| M19 | Übersicht-Tab: Flussanimation + verschiebbare Knoten | ✅ live verifiziert |
|
||
| M20 | LAN-Scanner: Umbenennung, Netzwerk-Tools (Ping/Traceroute/DNS/Port-Scan) | ✅ live verifiziert |
|
||
| M21 | Zweisprachigkeit (DE/EN) auf alle fünf Tabs ausgerollt (Einrichten/Übersicht/LAN-Scanner/Sicherungen) | ✅ live verifiziert |
|
||
| M22 | REST-Transport (M7) erstmals live gegen Hardware verifiziert, 4 Bugs gefunden+gefixt | ✅ live verifiziert |
|
||
| M23 | Experte-Tab: Sektionsüberschriften prominenter+eingefärbt, einklappbar (Standard: zugeklappt) | ✅ live verifiziert |
|
||
| M24 | LAN-Scanner: "Aktionen"-Button statt Rechtsklick, Traffic-Monitor+Sparkline pro Port, ARP-Bug gefixt | ✅ live verifiziert |
|
||
| M25 | Einrichten-Wizard-Politur: WAN-Zurück-Button, prominente Aktionsbuttons, leere Platzhalter-Felder (LAN/VLAN) | ✅ live verifiziert |
|
||
| M26 | Bekannte Router: Seriennummer hinterlegt, trennt zwei Geräte mit identischem Host+Benutzername | ✅ live verifiziert |
|
||
| M27 | Passwort-Anzeige-Button, Schlüsselbund nach Seriennummer getrennt, `terse`-Fallback verallgemeinert | ✅ live verifiziert |
|
||
| — | LAN-Port-Konflikt-Prüfung + "Fertig"-Button (Einrichten) | 🔶 gebaut, Code-Review bestätigt (dabei 3 echte Alert-Dismiss-Bugs gefunden+gefixt, siehe M34), Live-Klicktest durch Nutzer weiterhin offen |
|
||
| M28 | Übersicht-Tab: Fokus-Modus (Klick auf Knoten → Kette im schwebenden Popup, Rest abgedunkelt); Close-Button-Layout in allen vier Popups vereinheitlicht | ✅ live verifiziert |
|
||
| M29 | Einstellungen-Fenster (⌘,): Sprache, Update-Auto-Check, Farbschema, Textgröße, Bedienelement-Größe, LAN-Scanner-Refreshraten | ✅ live verifiziert |
|
||
| M30 | Experte-Tab: "Mode-Taste"-Menü (`/system routerboard mode-button`), inkl. SSH-Zwangsweg für REST-Deckungslücken | ✅ live verifiziert |
|
||
| M31 | Handbuch in der App (⌘? -Buttons, Textanker, Übersicht/Wizard/45 Experte-Menüs), DE+EN vollständig übersetzt | ✅ live verifiziert |
|
||
| M32 | Automatisches Wiederverbinden bei Verbindungsabbruch (Herzschlag+Retry-Schleife, Versuchszähler+Countdown im Verbinden-Tab) | ✅ live verifiziert |
|
||
| M33 | Dreifacher Tester-/Sicherheits-Deep-Dive (9 Funde: RouterOS-CLI-Injection live exploitiert+gefixt, Parser-Datenverlust, Race Condition, TOFU-Härtung u.a.) | ✅ Build+101 Tests grün, Details in [`bugs.md`](bugs.md) |
|
||
| M34 | README-Nachcheck: 3 Alert-Dismiss-Bugs gefunden+gefixt ("Abbrechen"/OK-Buttons bei Zertifikat-/SSH-Hostkey-/Apply-Fehler-Dialogen ohne Wirkung), wizard_flow-Diagramm korrigiert | ✅ Build+102 Tests grün |
|
||
| M35 | bugs.md #7: Firewall-Isolation trennt jetzt auch bereits bestehende Verbindungen (Connection-Flush, bugs.md #7) | ✅ Build+103 Tests grün, Mechanismus teilweise live verifiziert (Details bugs.md) |
|
||
| M36 | Hänger beim Anlegen eines DHCP-Pools gefixt (SSHTransport ohne Timeout, bugs.md #11) | ✅ live bestätigt, Build+106 Tests grün |
|
||
| M37 | Experte-Tab: Port-Konflikt-Prüfung wie im Einrichten-Assistenten (bugs.md #12) | ✅ live bestätigt, Build+111 Tests grün |
|
||
|
||
Release-Historie (was sich zwischen den Versionen geändert hat): [`CHANGELOG.md`](CHANGELOG.md).
|
||
|
||
Ausführlicher Stand inkl. aller gefundenen Bugs, offener Punkte und
|
||
Session-Verlauf: [`HANDOFF.md`](HANDOFF.md) / [`CHATLOG.md`](CHATLOG.md).
|
||
|
||
## Projektstruktur
|
||
|
||
```
|
||
RouterOS/
|
||
├── RouterOSAssistant/ — App-Quellcode (SwiftUI, macOS 14+)
|
||
│ ├── App/
|
||
│ │ └── RouterOSAssistantApp.swift — Einstiegspunkt, TabView, geteilter ConnectionService
|
||
│ ├── Core/
|
||
│ │ ├── Models/
|
||
│ │ │ ├── RouterOSCommand.swift — eine Änderung, vier Operationen (add/set/remove/action)
|
||
│ │ │ ├── WanConfig.swift, LanDhcpConfig.swift, VlanEntry.swift,
|
||
│ │ │ │ WifiNetworkConfig.swift, FirewallConfig.swift — bauen je RouterOSCommand-Listen
|
||
│ │ │ ├── RouterOSMenuItem.swift — generisches Item für jeden RouterOS-Menüpfad
|
||
│ │ │ ├── RouterOSSchema.swift / RouterOSSchemaCatalog.swift — kuratierte Formular-Schemas (Experte-Tab)
|
||
│ │ │ ├── OverviewGraph.swift — Knoten/Kanten-Modell fürs Übersicht-Diagramm
|
||
│ │ │ ├── LanDevice.swift — ein Gerät im LAN-Scanner-Tab (Lease+ARP+Bridge-Host verschmolzen)
|
||
│ │ │ ├── SavedRouter.swift — ein Eintrag in "Bekannte Router" (Host/Name/Standort)
|
||
│ │ │ ├── PortConflict.swift — LAN-Port-Konflikt-Prüfung (Bridge/Adresse/DHCP-Client/PPPoE)
|
||
│ │ │ ├── InterfaceTraffic.swift — ein Live-Durchsatz-Sample + TrafficSample (10s-Sparkline-Historie, LAN-Scanner)
|
||
│ │ │ ├── NetworkToolResult.swift — Rohausgabe von Ping/Traceroute/DNS-Auflösung
|
||
│ │ │ ├── PortScanResult.swift — Ergebnis eines Port-Scans, ein Eintrag pro Port
|
||
│ │ │ ├── AppPreferences.swift — Settings-Infrastruktur: AppStorage-Keys, ColorTheme/AppTextSize/UIDensity
|
||
│ │ │ └── RouterOSModels.swift — Credentials, DeviceInfo, RouterBoardInfo, PackageUpdateInfo, Fehler
|
||
│ │ ├── Networking/
|
||
│ │ │ ├── RouterOSTransport.swift — Protocol: connect/fetch.../apply/disconnect
|
||
│ │ │ ├── RestTransport.swift — REST-API (RouterOS ≥7.1)
|
||
│ │ │ ├── SSHTransport.swift — SSH-Fallback via Citadel, generischer CLI-Zugriff, SFTP-Upload
|
||
│ │ │ ├── RouterOSCliParser.swift — parst CLI-Ausgaben generisch
|
||
│ │ │ └── CertificateTrustStore.swift / SSHHostKeyTrustStore.swift — TOFU
|
||
│ │ └── Services/
|
||
│ │ ├── ConnectionService.swift — zentraler App-State
|
||
│ │ ├── BackupService.swift — Sicherung erstellen/auflisten/wiederherstellen
|
||
│ │ ├── FactoryResetService.swift — Werksreset ("Gefahrenzone")
|
||
│ │ ├── UpdateService.swift — Software-/Firmware-Update, Neustart
|
||
│ │ ├── KeychainService.swift — Passwort-Speicherung
|
||
│ │ ├── SavedRoutersStore.swift — "Bekannte Router"-Liste (JSON in UserDefaults)
|
||
│ │ ├── InterfaceTrafficMonitor.swift — pollt Live-Durchsatz über eigene SSH-Verbindung
|
||
│ │ ├── NetworkToolsService.swift — Ping/Traceroute/DNS-Auflösung über eigene SSH-Verbindung
|
||
│ │ └── PortScanner.swift — TCP-Port-Scan direkt von diesem Mac (Network.framework)
|
||
│ ├── Core/Localization/
|
||
│ │ └── L10n.swift — DE/EN-Übersetzungshelfer (Dictionary-Lookup, kein String Catalog)
|
||
│ ├── Features/
|
||
│ │ ├── Wizard/Steps/Connect/ — Verbinden-Tab
|
||
│ │ ├── Wizard/Steps/Setup/ — Einrichten-Tab (Mode→Wan→Lan→Vlan→Wifi→Firewall→Review)
|
||
│ │ ├── Overview/ — Übersicht-Tab
|
||
│ │ ├── Devices/ — LAN-Scanner-Tab
|
||
│ │ ├── Expert/ — Experte-Tab
|
||
│ │ ├── Backup/ — Sicherungen-Tab
|
||
│ │ └── Settings/ — Einstellungen-Fenster (⌘,)
|
||
│ └── Resources/Assets.xcassets/ — App-Icon
|
||
├── RouterOSAssistantTests/ — Unit-Tests (Command-Builder, CLI-Parser, ViewModels, Mock-Transport)
|
||
├── project.yml — xcodegen-Projektdefinition (Quelle der Wahrheit, nicht das generierte .xcodeproj editieren)
|
||
├── HANDOFF.md — detaillierter technischer Stand, alle gefundenen Bugs, offene Punkte
|
||
├── CHATLOG.md — chronologischer Session-Verlauf
|
||
├── Manual.md / Manual.pdf — Bedienungsanleitung (DE, Feldreferenz wörtlich aus RouterOSSchemaCatalog.swift extrahiert)
|
||
├── Manual-assets/ — Mermaid-Diagramme fürs Manual (*.mmd Quellen unter diagrams/, gerenderte *.png)
|
||
└── build-manual.py — regeneriert Manual.md-Feldreferenz + Diagramme + Manual.pdf (nach jeder Schema-/Manual-Änderung erneut laufen lassen)
|
||
```
|
||
|
||
## Setup / Bauen
|
||
|
||
```bash
|
||
xcodegen generate # erzeugt RouterOSAssistant.xcodeproj (nicht in git)
|
||
open RouterOSAssistant.xcodeproj # oder direkt per xcodebuild
|
||
|
||
# Debug
|
||
xcodebuild -project RouterOSAssistant.xcodeproj -scheme RouterOSAssistant \
|
||
-destination 'platform=macOS' build
|
||
|
||
# Tests
|
||
xcodebuild -project RouterOSAssistant.xcodeproj -scheme RouterOSAssistant \
|
||
-destination 'platform=macOS' test
|
||
|
||
# Release + Deploy nach /Applications
|
||
xcodebuild -project RouterOSAssistant.xcodeproj -scheme RouterOSAssistant \
|
||
-configuration Release build
|
||
```
|
||
|
||
`xcodegen` ist via Homebrew installiert. `.xcodeproj`, `DerivedData` und
|
||
Router-Backups sind gitignored.
|
||
|
||
## Sicherheit
|
||
|
||
Jede Schreibaktion zeigt vor der Ausführung den exakten RouterOS-Befehl
|
||
in einem Bestätigungsdialog. Destruktive Aktionen (Werksreset, Backup-
|
||
Wiederherstellung) liegen in einer eigenen "Gefahrenzone" mit
|
||
zusätzlichen Warnhinweisen. Zertifikate und SSH-Hostkeys werden per
|
||
Trust-on-First-Use (TOFU) behandelt, nicht blind akzeptiert. Passwörter
|
||
liegen ausschließlich im macOS-Keychain, nie im Klartext. Alle Werte,
|
||
die in RouterOS-CLI-Befehle oder REST-Anfragen eingebettet werden
|
||
(Kommentare, SSID, Freitextfelder im Experte-Tab, …), werden escaped
|
||
bzw. kodiert — live gegen einen echten Testrouter als Schutz gegen
|
||
Befehls-Injection verifiziert (Details: [`bugs.md`](bugs.md) #5, #8).
|