UTM/EXTRAS/CLI: Unterschied zwischen den Versionen

Aktuelle Version vom 18. Juni 2024, 14:17 Uhr

Mögliche Befehle im "Command Line Interface" der Securepoint UTM

Letzte Anpassung zur Version: 12.7.0

Neu:

Die Größe des CLI im Webinterface lässt sich anpassen

notempty

Dieser Artikel bezieht sich auf eine Resellerpreview

06.2023

Einleitung

Das Command Line Interface oder kurz CLI ist die eigentliche Schnittstelle, über die die Konfiguration der Securepoint UTM erfolgt. Alle graphischen Administrationstools wie das Webinterface, das Security Operation Center oder der Security Manager wandeln alle Ihre Einstellungen zu Befehlen um, die auf dem CLI ausgeführt werden können. Zwischen den einzelnen Versionen gibt es natürlich Unterschiede im Aufbau und Umfang der Befehle.
Dieser Artikel soll eine Übersicht über die möglichen Befehle geben und in einigen Beispielen die Arbeitsweise mit dem CLI darstellen.

CLI im Webinterface

Das CLI im Webinterface lässt sich unter Extras CLI aufrufen.

notempty

Neu ab v12.7.0

Oben Rechts befindet sich eine Dropdown Schaltfläche, mit der die Orientierung des CLI Fensters auf Oben, Unten, Rechts, Links oder auch Vollbild eingestellt werden kann, gleichzeitig wird bei jeder der genannten Einstellungen die Höhe bzw. Breite des Fensters standardmäßig auf 50% angepasst. Die Breite bzw. Höhe kann jedoch mithilfe der Maus, an der Kante des Fensters angepasst werden.

Befehle

Die Befehle auf dem CLI lassen sich in verschiedene Ebenen aufteilen. In der v11 wurden diese Ebenen in thematische Punkte gegliedert. So befinden sich z.B. alle für Interface-Konfigurationen relevanten Befehle unterhalb von "interface" wie z.B. der Befehl "interface address get" (zeigt alle vorhandenen IP-Adressen an). Nachfolgend findet sich eine Auflistung aller Befehle auf der ersten Ebene.
Ab Version 11.6 ist bei der Übergabe mehrerer Parameter zu beachten, dass diese in Eckige Klammern gesetzt und mit einem Leerzeichen voneinander getrennt werden.

Beispiel:
user group new name gruppenname permission [ perm1 perm2 ...]

Befehl	Beschreibung
alertingcenter	Management des Alertingcenters
appmgmt	Management der Anwendungen (starten/stoppen)
captiveportal	Einstellungen des Captive Portal
cert	Zertifikatsverwaltung
clear	Löscht den aktuellen Inhalt des Terminals
cli	Einstellungen zum Ausgabeverhalten des CLI
clientlessvpn	Einstellungen für das ClientlessVPN
cluster	Einstellungen über den Cluster
debug	Debug-Routinen
dhcp	Einstellungen für den DHCP-Server
dns	Einstellungen für den DNS-Server
exit	Beendet die aktuelle CLI-Sitzung
extc	Verwaltung von Variablen, sowie Templates für Anwendungen
geolocation	Auflistung von Geolocation
help	Auflistung aller Befehle
interface	Einstellungen bezüglich der Interfaces
ipsec	Einstellungen für IPSec-Verbindungen
logout	Benutzer wird nach Beendigung der CLI-Session abgemeldet
mail	Einstellungen für den Mailfilter/Mailarchive
manager	Freigabe der Administration
node	Konfiguration von Netzwerkobjekten und -Gruppen
object	Auflistung aller Objekte
openvpn	Konfiguration von OpenVPN-Verbindungen
pkey	Einstellungen der öffentlichen Schlüssel
qos	Einstellungen für QoS Profile
quit	Beendet die aktuelle CLI-Sitzung
route	Verwaltung von Netzwerk-Routen
rproxy	Konfiguration des Reverse-Proxy
rsa	Verwaltung der RSA-Keys
rule	Verwaltung des Portfilters (Regelwerk)
server	Verwaltung der Backend-Server für den Reverse-Proxy
service	Verwaltung der Dienste (Regelwerk)
spf2bd	Verwaltung des FailToBan Dienstes
ssh	Erstellen und verwalten der SSH-Schlüssel für das Cluster
syslog	Verwaltung der Syslog-Servers, sowie Ausgabe des Livelogs
system	System-spezifische Konfigurationspunkte
usc_vhost	Management der Unified Security Console (USC)
user	Benutzerverwaltung
view webuser	Informationen des User-WebUI
webfilter	Konfiguration des Webfilters
wireguard	Konfiguration von WireGuard
wlan	Verwaltung der WLAN-Funktionalität
wrapper	Internes Kommando

2007nx / v10

Anders als in der v11 sind die Befehle in der 2007nx/v10 nicht thematisch gegliedert, sondern funktionell.

Befehl	Beschreibung
add	Fügt Konfigurationseinstellungen hinzu
change	Ändert Konfigurationseinstellungen
clear	Löscht den aktuellen Inhalt des Terminals
config	Konfigurationsverwaltung
debug	Debug-Routinen
delete	Entfernen von Konfigurationseinstellungen
export	Export-Funktionen
import	Import-Funktionen
load	Laden von Einstellungen
logout	Benutzer wird nach Beendigung der CLI-Session abgemeldet
reboot	Startet die Appliance neu
register	Liest das Lizenzfile ein
restart	Neustart von Anwendungen
run	Ausführen von bestimmten Befehlen (z.B. ping)
show	Ausgabe von Konfigurationseinstellungen
start	Starten von Anwendungen
stop	Stoppen von Anwendungen
update	Befehle für die Aktualisierung
help	Auflistung aller Befehle

@@ Zeile 1: / Zeile 1: @@
-Das Command Line Interface oder kurz CLI ist die eigentliche Schnittstelle, über die die Konfiguration der Securepoint UTM erfolgt. Alle graphischen Administrationstools wie das Webinterface, das Security Operation Center oder der Security Manager wandeln alle Ihre Einstellungen zu Befehlen die auf dem CLI ausgeführt werden können um. Zwischen den einzelnen Versionen gibt es natürlich Unterschiede im Aufbau und Umfang der Befehle. <br>
+<span id=1270></span>{{Set_lang}}
-Dieser Artikel sollen Ihnen eine Übersicht über die möglichen Befehle geben und in einigen Beispielen die Arbeitsweise mit dem CLI darstellen.
+{{#vardefine:headerIcon|spicon-utm}}
+{{:UTM/EXTRAS/CLI.lang}}
-__TOC__
+{{var	| neu--anpassbares Fenster
-=v11=
+		| Die Größe des [[#CLI im Webinterface | CLI im Webinterface]] lässt sich anpassen
-Die Befehle auf dem CLI lassen sich in verschiedene Ebenen aufteilen. In der v11 wurden diese Ebenen thematischen Punkten gegliedert. So befinden sich z.B. alle für Interface-Konfigurationen relevanten Befehle unter halb von "interface" wie der Befehl "interface address get". Nachfolgend finde Sie eine Auflistung aller Befehle auf der ersten Ebene.<br>
+		|  }}
-{| border="0" {{prettytable}}
+</div>{{TOC2}}{{Select_lang}}
+{{Header|12.7.0|
+* {{#var:neu--anpassbares Fenster}}
+|[[UTM/EXTRAS/CLI_06.2023| 06.2023]]
+|{{Menu-UTM|Extras|CLI}}
+}}
+----
+=== {{#var:Einleitung}} ===
+<div class="Einrücken">
+{{#var:Einleitung--desc}}
+<br clear=all></div>
+----
+=== {{#var:CLI im Webinterface}} ===
+<div class="einrücken">
+{{#var:CLI im Webinterface--desc}}
+<br clear=all></div>
+----
+=== {{#var:Befehle}} ===
+<div class="Einrücken">
+{{#var:Befehle--desc}}
+<br>
+<code>user group new name ''gruppenname'' permission [ ''perm1 perm2 ...'']</code>
+<br clear=all></div>
+{| class="sptable2 pd5 zh1 striped Einrücken"
+|-
+! {{#var:Befehl}} !! {{#var:Beschreibung}}
+|-
+| <span id=Alertingcenter></span>[[UTM/CLI/Alertingcenter| alertingcenter ]]  || {{#var:alertingcenter--desc}}
+|-
+| [[UTM/CLI/Appmgmt| appmgmt]] || {{#var:appmgmt--desc}}
+|-
+| [[UTM/CLI/Captiveportal| captiveportal ]] || {{#var:captiveportal--desc}}
 |-
-! Befehl !! Beschreibung
+| [[CLI/Cert| cert ]] || {{#var:cert--desc}}
 |-
-| [[appmgmt_cli_v11| appmgmt]] || Management der Anwendungen (starten/stoppen)
+| clear || {{#var:clear--desc}}
 |-
-| [[cert_cli_v11| cert ]] || Zertifiaktsverwaltung
+| cli || {{#var:cli--desc}}
 |-
-| clear || löscht den aktuellen Inhalt des Terminals
+| [[clientlessvpn_cli_v11| clientlessvpn ]] || {{#var:clientlessvpn--desc}}
 |-
-| cli || Einstellungen zum Ausgabeverhalten des CLI
+| [[UTM/CLI/Cluster| cluster ]] || {{#var:cluster--desc}}
 |-
-| [[clientlessvpn_cli_v11| clientlessvpn ]] || Einstellungen für das Clientlessvpn
+| [[UTM/CLI/Debug | debug ]] || {{#var:debug--desc}}
 |-
-| [[dhcp_cli_v11| dhcp ]] || Einstellungen für den DHCP-Server
+| [[dhcp_cli_v11| dhcp ]] || {{#var:dhcp--desc}}
 |-
-| [[dns_cli_v11| dns ]] || Einstellungen für den DNS-Server
+| [[dns_cli_v11| dns ]] || {{#var:dns--desc}}
 |-
-| [[extc_cli_v11| extc ]] || Verwaltung von Variable sowie Templates für Anwendungen
+| exit || {{#var:exit--desc}}
 |-
-| help || Auflistung alle Befehle
+| [[extc_cli_v11| extc ]] || {{#var:extc--desc}}
 |-
-| [[interface_cli_v11| interface ]] || Einstellungen bezüglich Interface
+| [[UTM/CLI/Geolocation| geolocation ]] || {{#var:geolocation--desc}}
 |-
-| [[ipsec_cli_v11| ipsec ]] || Einstellungen für IPSec-Verbindungen
+| help || {{#var:help--desc}}
 |-
-| [[ldap_cli_v11| ldap ]] || Senden vom LDAP-Anfragen
+| [[UTM/CLI/Interface| interface ]] || {{#var:interface--desc}}
 |-
-| [[mail_cli_v11| mail ]] || Einstellungen für den Mailfilter/Mailarchive
+| [[UTM/CLI/Ipsec| ipsec ]] || {{#var:ipsec--desc}}
+<!--
 |-
-| [[node_cli_v11| node ]] || Konfiguration von Netzwerk-Objekten und -Gruppen
+| [[ldap_cli_v11| ldap ]] || {{#var:ldap--desc}}
+-->
 |-
-| [[object_cli_v11| object ]] || Auflistung aller Objekte
+| logout || {{#var:logout--desc}}
 |-
-| [[openvpn_cli_v11| openvpn ]] || Konfiguration von Openvpn-Verbindungen
+| [[mail_cli_v11| mail ]] || {{#var:mail--desc}}
 |-
-| [[qos_cli_v11| qos ]] || Einstellungen für QoS Profile
+| [[manager_cli_v11| manager ]] || {{#var:manager--desc}}
 |-
-| quit  || Beendet die aktuelle CLI-Sitzung
+| [[node_cli_v11| node ]] || {{#var:node--desc}}
 |-
-| [[route_cli_v11| route ]] || Verwalten von Netzwerk-Routen
+| [[object_cli_v11| object ]] || {{#var:object--desc}}
 |-
-| [[rproxy_cli_v11| rproxy ]] || Konfiguration des Reverse-Proxy
+| [[UTM/CLI/Openvpn| openvpn ]] || {{#var:openvpn--desc}}
 |-
-| [[rsa_cli_v11| rsa ]] || Verwaltung der RSA-Keys
+| [[UTM/CLI/Pkey| pkey ]] || {{#var:pkey--desc}}
 |-
-| [[rule_cli_v11| rule ]] || Verwaltung des Portfilters(Regelwerk)
+| [[qos_cli_v11| qos ]] ||  {{#var:qos--desc}}
 |-
-| [[server_cli_v11| server ]] || Verwaltung der Backend-Server für den Reverse-Proxy
+| quit  || {{#var:quit--desc}}
 |-
-| [[service_cli_v11| service ]] || Verwaltung der Dienste
+| [[route_cli_v11| route ]] || {{#var:route--desc}}
 |-
-| [[syslog_cli_v11| syslog ]] || Verwaltung der Syslog-Server sowie Ausgabe des Livelogs
+| [[rproxy_cli_v11| rproxy ]] || {{#var:rproxy--desc}}
 |-
-| [[system_cli_v11| system ]] || System spezifische Konfigurationspunkte
+| [[rsa_cli_v11| rsa ]] || {{#var:rsa--desc}}
 |-
-| [[user_cli_v11| user ]] || Benutzerverwaltung
+| [[rule_cli_v11| rule ]] || {{#var:rule--desc}}
 |-
-| [[webfilter_cli_v11| webfilter ]] || Konfiguration des Webfilter
+| [[server_cli_v11| server ]] || {{#var:server--desc}}
 |-
-| [[wlan_cli_v11| wlan ]] || Verwaltung der WLAN-Funktionalität
+| [[service_cli_v11| service ]] || {{#var:service--desc}}
 |-
-| wrapper || Internes Kommando
+| [[UTM/CLI/spf2bd | spf2bd ]] || {{#var:spf2bd--desc}}
+|-
+| [[SSH_cli_V11.6| ssh ]] || {{#var:ssh--desc}}
+|-
+| [[syslog_cli_v11| syslog ]] || {{#var:syslog--desc}}
+|-
+| [[UTM/CLI/System| system ]] || {{#var:system--desc}}
+|-
+<!--
+| [[UTM/CLI/Transaction| transaction ]] ||
+|-
+-->
+| [[UTM/CLI/Usc_vhost| usc_vhost ]] || {{#var:usc_vhost--desc}}
+|-
+|[[UTM/CLI/User| user ]] || {{#var:user--desc}}
+|-
+| view webuser || {{#var:view webuser--desc}}
+|-
+| [[webfilter_cli_v11| webfilter ]] || {{#var:webfilter--desc}}
+|-
+| [[UTM/CLI/Wireguard| wireguard ]] || {{#var:wireguard--desc}}
+|-
+| [[wlan_cli_v11| wlan ]] || {{#var:wlan--desc}}
+|-
+| wrapper || {{#var:wrapper--desc}}
 |}
-=2007nx / v10=
+----
-Anders als in der v11 sind die Befehle in der 2007nx/v10 nicht nach thematisch gegliedert sondern funktionell . <br>
-{| border="0" {{prettytable}}
+=== 2007nx / v10 ===
+<div class="Einrücken">
+{{#var:2007--desc}}
+<br clear=all></div>
+{| class="sptable2 pd5 zh1 striped Einrücken"
 |-
-! Befehl !! Beschreibung
+! {{#var:Befehl}} !! {{#var:Beschreibung}}
 |-
-| add || Fügt Konfigurationseinstellungen hinzu
+| add || {{#var:add--desc}}
 |-
-| change || Ändert Konfigurationseinstellungen
+| change || {{#var:change--desc}}
 |-
-| clear || löscht den aktuellen Inhalt des Terminals
+| clear || {{#var:clear--desc}}
 |-
-| config || Konfigurationsverwaltung
+| config || {{#var:config--desc}}
 |-
-| debug || Debug-Routinen
+| debug || {{#var:debug--desc}}
 |-
-| delete || Entfernen von Konfigurationseinstellungen
+| delete || {{#var:delete--desc}}
 |-
-| export || Export-Funktionen
+| export || {{#var:export--desc}}
 |-
-| import || Import-Funktionen
+| import || {{#var:import--desc}}
 |-
-| load || Laden von Einstellungen
+| load || {{#var:load--desc}}
 |-
-| logout || Beendet die aktuell CLI-Sitzung
+| logout || {{#var:logout--desc}}
 |-
-| reboot || Startet die Appliance neu
+| reboot || {{#var:reboot--desc}}
 |-
-| register || Liest das Lizenzfile ein
+| register || {{#var:register--desc}}
 |-
-| restart || Neustart von Anwendungen
+| restart || {{#var:restart--desc}}
 |-
-| run|| Ausführen von bestimmten Befehlen (z.B. ping)
+| run || {{#var:run--desc}}
 |-
-| show || Ausgabe von Konfigurationseinstellungen
+| show || {{#var:show--desc}}
 |-
-| start || Starten von Anwendungen
+| start || {{#var:start--desc}}
 |-
-| stop || Stoppen von Anwendungen
+| stop || {{#var:stop--desc}}
 |-
-| update || Befehle für die Aktualisierung
+| update || {{#var:update--desc}}
 |-
-| help || Anzeige von allen Kommandos
+| help || {{#var:help--desc}}
 |}