FortiGate CLI Spickzettel

Kompakte Sammlung der am häufigsten gebrauchten CLI-Befehle, nach Aufgabe sortiert. Grundkonfiguration und Dashboard-Layout stehen unter FortiGate useful Commands.

Aufgabe Abschnitt
Status prüfen, Fehler suchen Diagnose
Konfiguration sichern und wiederherstellen Backup und Restore
Verwaltung absichern Administrator-Zugriff einschränken
Logs und Cloud-Verwaltung Logging und FortiCloud
Cluster prüfen Hochverfügbarkeit
Konfiguration aufräumen Objekte und Vorlagen bereinigen
Telefonie-Probleme SIP-ALG abschalten
VPN auf Länder beschränken SSL-VPN nur aus Österreich
WLAN-Controller FortiAP
Leitungsausfall erkennen Link-Monitor

Vorsicht: Befehle wie purge, execute restore, execute reboot und diagnose system session clear greifen sofort und ohne Rückfrage in den Betrieb ein. Vorher die Konfiguration sichern und nicht in Geschäftszeiten testen.

Diagnose

System und Leistung

Befehl Zweck
get system status Firmware, Seriennummer, Betriebsmodus
get system performance status CPU, RAM, Sitzungen
diagnose autoupdate status Status der FortiGuard-Updates und Lizenzen
diagnose debug config-error-log read Fehler beim Laden der Konfiguration, z. B. nach einem Firmware-Update

Netzwerk

Befehl Zweck
diagnose sys waninfo Öffentliche IP-Adresse und Provider der WAN-Verbindung
diagnose sys waninfo ipify Öffentliche IP-Adresse über den Dienst ipify abfragen
diagnose system session clear Alle Sitzungen löschen, z. B. nach Policy-Änderungen. Unterbricht kurz alle Verbindungen.

Geräte und Alarme

Befehl Zweck
diagnose user device clear Erkannte Geräte (Device Inventory) zurücksetzen
diagnose log alertmail test Testmail der E-Mail-Alarme senden

Backup und Restore

Konfiguration auf einen FTP-Server sichern bzw. von einem TFTP-Server wiederherstellen:

execute backup config ftp fortigate.conf <FTP-Server> <Benutzer> <Passwort>
execute restore config tftp fortigate.conf <TFTP-Server>

Nach dem Restore startet die FortiGate neu. Das Passwort steht im Klartext in der Befehlszeile (und im CLI-Verlauf), daher ein eigenes Konto mit minimalen Rechten für das Backup verwenden.

Administrator-Zugriff einschränken

Vertrauenswürdige Hosts

Administratorzugriff nur von bestimmten IP-Adressen oder Netzen erlauben:

config system admin
    edit "admin"
        set trusthost1 203.0.113.10 255.255.255.255
        set trusthost2 192.168.1.0 255.255.255.0
    next
end

Unbedingt auch das eigene LAN eintragen, sonst sperrt man sich aus.

Fernwartungs-Zugang auf eine IP beschränken

Einen eigenen Zugang (z. B. readadmin) auf genau eine IP-Adresse festlegen und alle übrigen vertrauenswürdigen Hosts entfernen:

config system admin
    edit "readadmin"
        set trusthost1 203.0.113.10 255.255.255.255
        unset trusthost2
        unset trusthost3
        unset trusthost4
        unset trusthost5
        unset trusthost6
        unset trusthost7
        unset trusthost8
        set accprofile "super_admin"
    next
end

Logging und FortiCloud

Logs in Echtzeit an FortiCloud

Logs an FortiCloud senden und die FortiGate dort verwalten:

config log fortiguard setting
    set status enable
    set upload-option realtime
end
config system central-management
    set type fortiguard
end

Gerät mit einem FortiCloud-Konto verbinden (Region europe):

execute fortiguard-log login <E-Mail> <Passwort> europe

Kleine Modelle entlasten

Modelle mit wenig Flash (z. B. 30E/50E) entlasten, indem das Logging in den Arbeitsspeicher abgeschaltet und alte Logs gelöscht werden. Hintergrund: Flash card space optimization.

config log memory setting
    set status disable
end
execute log delete

Hochverfügbarkeit (HA)

Befehl Zweck
get system ha status Status des Clusters, Primär- und Sekundärgerät
execute ha manage 0 admin Vom Primärgerät auf das Sekundärgerät verbinden
execute ha synchronize start Synchronisation manuell anstoßen
diagnose sys ha checksum recalculate Prüfsummen neu berechnen, wenn das Cluster „out of sync“ meldet (auf dem Primärgerät)

Einrichtung und Hintergründe: FortiGate HA Cluster.

Objekte und Vorlagen bereinigen

Altlasten löschen

Vor dem Einspielen einer Standardkonfiguration lassen sich Altlasten mit purge entfernen. Achtung: purge leert die ganze Tabelle, sobald man die Rückfrage mit y bestätigt. Objekte, die noch in Policies verwendet werden, bleiben erhalten.

config firewall vip
    purge
end
config firewall addrgrp
    purge
end
config firewall address
    purge
end
config firewall service custom
    purge
end
config user group
    purge
end
config system replacemsg-group
    purge
end
config system replacemsg-image
    purge
end

Sperrseiten zurücksetzen

Angepasste Sperrseiten wieder auf den Standard stellen:

config system replacemsg fortiguard-wf "ftgd-block"
    unset buffer
end
config system replacemsg http "url-block"
    unset buffer
end

Keine Ersatz-Sperrseite bei HTTPS-Verbindungen anzeigen (vermeidet Zertifikatswarnungen ohne Deep Inspection):

config webfilter profile
    edit "default"
        set https-replacemsg disable
    next
end

SIP-ALG abschalten

Bei VoIP-Problemen (einseitige Sprache, Telefone verlieren die Registrierung) ist oft der SIP-Helper bzw. das SIP-ALG die Ursache. So wird beides deaktiviert:

1. SIP-Eintrag im Session-Helper löschen (die Nummer variiert):

config system session-helper
    show
    delete <Nummer des Eintrags mit name sip>
end

2. SIP-ALG abschalten:

config system settings
    set default-voip-alg-mode kernel-helper-based
    set sip-expectation disable
    set sip-nat-trace disable
end

Auf älteren Versionen (z. B. FortiOS 6.2) heißt die Einstellung sip-helper:

config system settings
    set sip-helper disable
    set sip-nat-trace disable
end

3. Sitzungen löschen (oder execute reboot), damit sich die Telefone neu registrieren:

diagnose system session clear

SSL-VPN nur aus Österreich

Eine Geo-Adresse für Österreich anlegen und als erlaubte Quelle im SSL-VPN setzen. Mehrere Länder lassen sich in derselben Adresse bzw. einer Adressgruppe kombinieren.

config firewall address
    edit "AT"
        set type geography
        set color 6
        set country "AT"
    next
end
config vpn ssl settings
    set source-address "AT"
end

FortiAP

Direkten Zugriff erlauben

HTTPS-Zugriff direkt auf einen FortiAP freischalten, z. B. zur Fehlersuche:

config wireless-controller wtp
    edit "<Seriennummer>"
        set override-allowaccess enable
        set allowaccess https
    next
end

Land lässt sich nicht ändern

Dann vorher die FAP-C-Kompatibilität deaktivieren und danach wieder aktivieren. Mehr dazu unter FortiAP Land und LLDP.

config wireless-controller setting
    set fapc-compatibility disable
end
config wireless-controller setting
    set country AT
end
config wireless-controller setting
    set fapc-compatibility enable
end

Prüft die Internetverbindung per Ping und deaktiviert bei Ausfall die Routen über diese Leitung, damit eine zweite Leitung übernimmt. Mit update-cascade-interface werden auch abhängige Interfaces (z. B. VPN-Tunnel) als down markiert.

config system link-monitor
    edit "wan1"
        set srcintf "wan1"
        set server "8.8.8.8" "1.1.1.1"
        set interval 20
        set failtime 5
        set recoverytime 5
        set update-cascade-interface enable
    next
end

Für jede Leitung einen eigenen Eintrag anlegen, z. B. zusätzlich wan2 mit denselben Werten.

Für mehrere Leitungen mit automatischem Umschalten und Zurückschalten ist SD-WAN die modernere Lösung.

← Alle Anleitungen