SophosFirewall PowerShell
Eine PowerShell-Modulsammlung für Sophos XGS / SFOS. Sie kapselt die XML-Management-API der Firewall in saubere Cmdlets — inzwischen 21 Module mit 745 Cmdlets, die praktisch die gesamte Appliance-Konfiguration abdecken. Konfiguration und Auswertung lassen sich damit skripten statt klicken.
Installation#
Alle Module liegen in der PowerShell Gallery. Einzelne Module ziehen
SophosFirewall.Core automatisch als Abhängigkeit nach:
# Nur das, was du brauchst
Install-Module SophosFirewall.HostsAndServices -Repository PSGallery -Scope CurrentUser
# Oder gleich die komplette Sammlung
Find-Module SophosFirewall.* -Repository PSGallery | Install-Module -Scope CurrentUser
# Aktualisieren und Stand prüfen
Update-Module SophosFirewall.*
Get-InstalledModule SophosFirewall.* | Format-Table Name, Version
Erste Schritte#
Connect-SfosFirewall -Firewall '192.0.2.10' -Port 4444 -Credential (Get-Credential) -SkipCertificateCheck
Get-SfosIPHost
Die Verbindung wird einmal aufgebaut, alle weiteren Cmdlets nutzen sie.
Voraussetzungen#
- PowerShell 5.1 oder 7.x
- HTTPS-Zugriff auf die Firewall (standardmäßig Port 4444)
- Ein Admin-Konto mit freigeschaltetem API-Zugriff
- Die XML-API muss in der Firewall-Administration aktiviert sein
Die Module#
| Bereich | Module |
|---|---|
| Monitor & Analyze | Diagnostics (14), ZeroDayProtection (2) |
| Protect | Email (70), Web (55), IntrusionPrevention (32), Wireless (32), Firewall (23), Applications (22), WebServer (18), ActiveThreatResponse (15) |
| Configure | Network (104), Authentication (99), VPN (51), Routing (34), SystemServices (22) |
| System | HostsAndServices (57), Administration (44), Profiles (20), Certificates (11), SophosCentral (4) |
| Transport | Core (16) |
Alle Namen tragen das Präfix SophosFirewall., die Zahl in Klammern ist die
Anzahl der Cmdlets im jeweiligen Modul.
Sicher arbeiten#
Jede schreibende Operation unterstützt -WhatIf — du siehst also erst, was
passieren würde, bevor etwas an der Firewall geändert wird. Die Moduldokumentation
weist zusätzlich Cmdlets aus, die die eigene Sitzung kappen können: Änderungen an
Netzwerkzugriff, Authentifizierung, Interfaces oder HA-Einstellungen.
Wofür#
Wiederkehrende Aufgaben automatisieren, Konfigurationen dokumentieren und Massenänderungen reproduzierbar ausrollen — statt jede Regel einzeln in der Weboberfläche zu pflegen. Lizenz: MIT.