Wechseln zu:Navigation, Suche
Wiki
















































Download und Installation des Securepoint VPN Clients

Letzte Anpassung zur Version: 3.1.1

Neu:
Zuletzt aktualisiert: 
notempty
Dieser Artikel bezieht sich auf eine Beta-Version

Systemvoraussetzungen

  • Windows 10 x64 oder höher
  • Windows 10 arm64 oder höher (Beta) notempty
    Neu ab v3.3.3
  • 1GB RAM
Betriebssystem:
  • Windows 10 x64 oder höher
  • Windows 10 arm64 oder höher (Beta) notempty
    Neu ab v3.3.3
Laufzeitvoraussetzungen:
  • windowsdesktop-runtime-6.0.12-win-x64.exe Wird ggf. automatisch mit installiert
  • VC_redist.x64.exe Wird ggf. automatisch mit installiert
Hardware:
  • Speicherplatz: Mind. 206 MB (falls die Laufzeitvoraussetzungen mit installiert werden)
  • RAM: Mind. 1024 MB
  • Prozessorkerne: 2, empfohlen: 4
  • Prozessorarchitektur: 64-Bit (x64 oder arm64)

Download

Der Download des VPN-Client Installationsprogrammes erfolgt


Installation

Eine Installation kann auf zwei unterschiedliche Arten durchgeführt werden.

  • Die erste ist die Installation über eine grafische Benutzeroberfläche
  • Die zweite ist eine Quiet-Installation ohne Benutzer-Interaktion

Im Folgenden werden beide Schritte, sowie die Installation mit automatischem Import einer Konfiguration und das Ignorieren von Laufzeitvoraussetzungen erläutert.

GUI-Installation

Die GUI-Installation wird gestartet durch das Ausführen der zuvor heruntergeladene Datei Securepoint-VPN-Client-<Version>.exe.

Installation mit automatischem Import einer Konfiguration

Befindet sich im selben Pfad wie die Installaltionsdatei Securepoint_VPN_Client-<Version>.exe ein Ordner mit der Bezeichnung Config, wird die erste dort enthaltene Konfigurationsdatei während des Installationsprozesses importiert.

Migration alter Verbindungen





























Die Migration von Verbindungen aus dem Dateipfad des alten Securepoint SSL-VPN Clients erfolgt über das GUI entweder beim ersten Start oder, wenn in den Einstellungen die zugehörige Funktion aktiviert wurde, beim nächsten Start.
In beiden Fällen öffnet sich, wenn eine Verbindung des alten Clients gefunden wurde, der Migrations Assistent.

Migration mit Admin-Rechten anzeigen

notempty
Neu ab v3.4.0


Installation über die Befehlszeile (CMD)

Um den Client über die Befehlszeile zu installieren ist folgender Befehl möglich:
.\Securepoint_VPN_Client-<Version>.exe /quiet Genauere Informationen sind im Abschnitt zu den Kommandozeilen Befehlen zu finden.

Installation mit automatischem Import einer Konfiguration

Befindet sich im selben Pfad wie die Installaltionsdatei Securepoint_VPN_Client-<Version>.exe ein Ordner mit der Bezeichnung Config, wird die erste dort enthaltene Konfigurationsdatei während des Installationsprozesses importiert.

Migration per CLI

VPN Konfiguration migrieren: C:\Program Files\Securepoint VPN Client\Securepoint VPN Client.exe" /migrate


Automatisierte Installation

Beispielhafter Ablauf einer automatisierten Installation:

  1. Benachrichtigung an Benutzerinnen und Benutzer, dass der neue Client installiert wird
  2. Die Installations-Datei Securepoint_VPN_Client_vXYZ.exe per Gruppenrichtlinie (GPO) oder Softwareverteilungssystem auf die Ziel-Geräte kopieren
  3. Ggf.auf die gleiche Weise einen Ordner mit dem Namen Config erstellen, der die jeweilige Konfiguration enthält
  4. Neuen VPN Client installieren über:C:\Securepoint_VPN_Client_vXYZ.exe" /silent
  5. Ggf. alte VPN Konfiguration migrieren:C:\Program Files\Securepoint VPN Client\Securepoint VPN Client.exe" /migrate
  6. Die Benutzerinnen und Benutzer müssen ggf. abschließend den Autostart des alten SSL-VPN-Clients deaktivieren und im neuen VPN-CLient aktivieren.
    Eine Anleitung für Endanwender findet sich dazu hier: https://wiki.securepoint.de/VPN/VPN-Client-Umstellung






























Autostart umstellen

Erfolgt eine Umstellung vom bisherigen SSL-VPN-Client auf den neuen Securepoint VPN Client, sind nur wenige Handgriffe nötig, um die Autostart-Einstellungen zu ändern und damit den Wechsel abzuschließen.


Autostart für alten Client deaktivieren
  1. Mit einem Klick auf den Pfeil die Tray-Icons einblenden
  2. Mit Rechtsklick das Menü für den SSL-VPN Client öffnen
  3. Mithilfe des Menüs das Fenster des Clients anzeigen lassen
  • Mit einem Klick auf das Zahnrad das Menü öffnen
  • Mithilfe des Menüs zu den Client Einstellungen wechseln
  • Die Option "Beim Starten von Windows ausführen" abwählen
  • Das Fenster wieder schließen
  • Autostart für neuen Client aktivieren
    1. Mit einem Klick auf den Pfeil die Tray-Icons einblenden
    2. Mit Rechtsklick das Menü für den Securepoint VPN Client öffnen , oder falls nicht vorhanden den VPN Client zunächst starten
    3. Mithilfe des Menüs das Fenster des Clients einblenden
  • Mit einem Klick auf das Zahnrad zu den Einstellungen navigieren
  • Die Option "Beim Starten von Windows ausführen" aktivieren

  • Ignorieren von Laufzeitvoraussetzungen

    notempty
    Das Ignorieren der Laufzeitumgebung wird nicht empfohlen.

    Bei der Installation des Clients besteht die Möglichkeit, die erforderlichen Laufzeitvoraussetzungen zu ignorieren

    • In der Benutzeroberfläche (GUI) wird eine Option angezeigt, um die Laufzeitvoraussetzungen nicht zu installieren, falls sie auf dem System fehlen
      Wenn die Laufzeitvoraussetzungen bereits vorhanden sind, wird diese Option nicht angezeigt
    • Für das CLI wird der Parameter /ignore-prereq verwendet
      .\Securepoint_VPN_Client-<Version>.exe /ignore-prereq /s
    Diese Option ist nur dann sinnvoll, wenn die Laufzeitvoraussetzungen
    • windowsdesktop-runtime-6.0.12-win-x64.exe Wird ggf. automatisch mit installiert
    • VC_redist.x64.exe Wird ggf. automatisch mit installiert
    bereits auf dem System vorinstalliert sind oder das Setup beim Herunterladen der Laufzeitvoraussetzungen die Dateien nicht verifizieren konnte.
    Dies kann vorkommen, wenn Microsoft einen Patch für diese erstellt und sich damit die Prüfsumme ändert.
    Folgende Dinge müssen dann jedoch manuell konfiguriert werden:
    1. Die Laufzeitvoraussetzungen müssen manuell heruntergeladen und installiert werden, bevor der Client gestartet werden kann.
    2. Der Dienst wird nicht automatisch gestartet.
      Das bedeutet, er muss manuell gestartet werden und für einen automatischen Start beim Systemstart konfiguriert werden.
      Dies kann wie folgt umgesetzt werden (unter Verwendung von erhöhten Rechten):
      1. Service starten:
        sc.exe start "Securepoint VPN Client Service"
      2. Service für den automatischen Start konfigurieren:
        sc.exe config "Securepoint VPN Client Service" start=auto
        Dadurch wird der Dienst beim nächsten Systemstart automatisch gestartet. Es wird empfohlen, diese Konfigurationen zu testen. Es kann über "Dienste" überprüft werden, ob der Securepoint VPN Client Service gestartet ist.


    Update

    Update Dialog
    • Als Administrator können automatische Updates aktiviert werden (siehe Client-Einstellungen oder per Kommandozeile)
    • Sind automatische Updates nicht aktiviert, wird im Header ein Update Symbol eingeblendet, falls ein Update verfügbar ist
    • Wenn automatische Updates aktiviert sind, wird alle 12 Stunden nach Updates gesucht
    • Ein Benutzer kann ein automatisches Update 5 mal ablehnen, anschließend wird es erzwungen
  • Nach einem Update wird der Dienst neu gestartet.
    Der Client wird beim nächsten Start die neue Version benutzen.
    Verbindungen, die mit Autostart aktiviert eingerichtet sind werden neu gestartet.


  • Tray-Icon

    Tray-icon des Clients in der Taskleiste

    Wenn der Client gestartet ist, erscheint das Symbol des Clients in der Taskleiste als Tray-Icon. Mit einem Rechtsklick auf dieses gibt es folgende Optionen:

    • Das Fenster des Clients einblenden
    • Eine Verbindung aufbauen bzw. trennen (wird ausgeblendet, falls mehrere Verbindungen konfiguriert sind)
    • Die Anwendung beenden


    Import einer VPN-Konfiguration

    Beschriftung Beschreibung
    Import einer VPN-Konfiguration
    Protokoll Wahl des Protokolls (SSL-VPN, WireGuard oder Ordner
    Für den Import von mehreren Konfigurationen
    notempty
    Neu ab: 3.2
    )
    Datei Mithilfe der Schaltfläche   Konfigurationsdatei auswählen
    Verbindungsname Verbindungsnamen bei Bedarf ändern
    Systemverbindung anlegen Wenn der Client als Administrator ausgeführt wurde (erkennbar an dem Hinweis Admin rechts oben in der Titelleiste), kann die Verbindung außerdem als Systemverbindung, also für alle Benutzerkonten des Computers, erstellt werden.
    Importieren Verbindung importieren

    Konfiguration erstellen

    Aufruf des Konfigurations-Wizard im Menü unter Erstellen

    Start der Konfiguration einer neuen VPN-Verbindung mit Weiter.
    Schritt 1
    • gewünschtes Protokoll SSLVPNWireGuard
    • Aussagekräftiger Name für die Verbindung
    • Falls mit Adminrechten ausgeführt: Ggf, BenutzerSystem
      Die Verbindung steht dann in allen Benutzerkonten dieses Computers zur Verfügung

    SSLVPN

    Zur Konfiguration einer SSLVPN-Verbindung folgender Anleitung folgen:

    Schritt 2
    • Es muss mindestens ein VPN-Server mithilfe des Protokolls, der IP-Adresse oder des Hostnamens sowie dem Port hinzugefügt werden.
    Schritt 3
  • Client und Server Schlüssel bzw. Zertifikate auswählen (mit )
    Zuordnung bei typischer Benennung:
    Zertifizierungsstelle(CA)
    …cert.pem
    Privater Schlüssen (RSA)
    …cert.key
    Öffentlicher Schlüssel (CA)
    …ca.pem
  • Mit der Option Serverzertifikate überprüfen kann die Prüfung der Serverzertifikate aktiviert werden
  • Schritt 4
  • Verbindung mit dem VPN-Server übereinstimmend konfigurieren
  • Redirect Gateway
    • Wenn deaktiviert, werden nur Pakete in ein lokales Zielnetzwerk durch den Tunnel geleitet
    • Wenn aktiviert, werden alle Pakete in den Tunnel geleitet und von dort ggf. weiter geroutet
  • Schritt 5
    Zusammenfassung aller Einstellungen zur Überprüfung. Wenn alle Einstellungen korrekt sind kann der Konfigurations-Wizard mit der Schaltfläche Anwenden beendet und die Verbindung hinzugefügt werden.

    WireGuard

    Zur Konfiguration einer WireGuard-Verbindung folgender Anleitung folgen:

    Schritt 2
    • Es muss mindestens ein VPN-Server mithilfe des Protokolls, der IP-Adresse oder des Hostnamens sowie dem Port hinzugefügt werden.
    Schritt 3
  • Client und Server Schlüssel eintragen
  • optional Preshared-Key eintragen
  • Schritt 4
  • Angabe der Client IP-Adresse notwendig
  • Andere Werte können leer gelassen werden, diese Optionen werden dann entweder ignoriert oder einem Standardwert zugewiesen
  • DNS-Adresse(n) können auch als Domain eingetragen werden notempty
    ab v1.0.9
  • Schritt 5
    Zusammenfassung aller Einstellungen zur Überprüfung. Wenn alle Einstellungen korrekt sind kann der Konfigurations-Wizard mit der Schaltfläche Hinzufügen beendet und die Verbindung hinzugefügt werden.



    Verbindungseinstellungen

    System- und Userverbindungen

    Userverbindungen werden in der Windows-Registry unter dem HKEY_CURRENT_USER-Context gespeichert und sind somit nur für denjenigen Windows Benutzer verfügbar, der die Verbindung importiert hat.

    Systemverbindungen werden unter HKEY_LOCAL_MACHINE gespeichert und sind somit für jeden Benutzer der Maschine verfügbar, erfordern jedoch Administrationsrechte für den Import.

    Herstellen einer Verbindung

    Eine Verbindung kann entweder über das Kontextmenü /  Verbinden oder über einen Klick auf die Verbindungs-Schaltfläche hergestellt werden
    Verbindung getrennt
    Verbindung wird aufgebaut
    Verbindung hergestellt
    Ggf. ist bei SSL-VPN Verbindungen noch die Eingabe eines OTP erforderlich



    Verbindungsübersicht

    Beschriftung Wert Beschreibung
    Verbindungsübersicht
    Suche
    Suchzeile, um die Verbindungen zu durchsuchen
  • Wird erst ab sieben Verbindungen angezeigt
  • Status Verbunden Verbindung ist hergestellt
    Verbinde Verbindung wird hergestellt
    Fehlgeschlagen Verbindung konnte nicht hergestellt werden
    Getrennt Keine Verbindung
    Name TTT-Point-1 Name der Verbindung
    Mehr Öffnet das Kontextmenü der jeweiligen Verbindung
    / Wechselt zwischen Standardansicht und Kompaktansicht des Clients


    Erweiterte Ansicht

    Verbindungs-Details in der erweiterten Ansicht

    Über den Eintrag Details Anzeigen im Kontextmenü werden zusätzliche Verbindungsdetails angezeigt:

    • Empfangene Daten
    • Gesendete Daten
    • Verbindungsdauer
    • Gerätename (verwendete Schnittstelle)
    • Wintun Version
    • IPv4 Adresse / IPv6 Adresse

    Kompaktansicht

    Beschreibung
    Kompaktansicht VPN-Client
    Wechselt zwischen Standardansicht und Kompaktansicht des Clients

    - WireGuard
    - SSL-VPN
    - Systemverbindung (steht allen Benutzern zur Verfügung)
    - Es sind Benutzerdaten hinterlegt
    - Bei Verbindungsabbruch neu verbinden
    - Automatisch verbinden
    - PIN zum Verbinden benötigt

    Verbindungsdauer
    Verbindungsschaltfläche
    Volumen Upload und Download sowie Geschwindigkeit


    Kontextmenü

    Aufruf mithilfe der Schaltfläche in der Verbindungsübersicht oder einem rechten Mausklick auf eine Verbindung.

    Menüpunkt Beschreibung [[Datei: ]]
     Verbinden VPN Verbindung aktivieren
     Bearbeiten
    Bei einer Systemverbindung nur als Admin möglich
    Zeigt die dazugehörige Konfiguration und die Zertifikate, welche bearbeitet werden können
     OTP anwenden

    Entfällt ab v3.1.0
    Ab v3.1.0 wird automatisch erkannt, ob ein OTP erforderlich ist. Es ist keine manuelle Einstellung erforderlich.
     Automatisch verbinden Baut automatisch diese Verbindung auf, wenn die App gestartet wird
    Erfordert hinterlegte Benutzerdaten
    .
    notempty
    Neu ab: 3.2
    Nach 15 Versuchen wird der Verbindungsaufbau abgebrochen
     Bei Verbindungsabbruch neu verbinden Falls die Verbindung unerwartet unterbrochen wird, wird automatisch versucht sich neu zu verbinden.
     Benutzerdaten bearbeiten
    Bei einer Systemverbindung nur als Admin möglich
    Nicht bei einer Wireguard Verbindung möglich
    Öffnet ein Fenster, durch den man die Benutzerdaten updaten kann
     Benutzerdaten löschen
    Bei einer Systemverbindung nur als Admin möglich
    Nicht bei einer Wireguard Verbindung möglich
    Löscht die Benutzerdaten für die aktuelle Verbindung
     PIN hinzufügen oder bearbeiten
    Bei einer Systemverbindung nur als Admin möglich
    Nur bei einer Wireguard Verbindung möglich
    Verbindung mit PIN sichern, diese wird anschließend bei jedem Verbindungsversuch benötigt.
     PIN löschen
    Bei einer Systemverbindung nur als Admin möglich
    Nur bei einer Wireguard Verbindung möglich
    PIN der Verbindung löschen
     Ausgeschlossene SSIDs
    Bei einer Systemverbindung nur als Admin möglich
    Netzwerke konfigurieren, für die keine Verbindung hergestellt werden soll
    z.Zt nur per Kontextmenü konfigurierbar

    Dialog für Ausgeschlossene SSIDs
     Exportieren
    Bei einer Systemverbindung nur als Admin möglich
    Öffnet ein Dialog, durch den man die ausgewählte Verbindung als Textdatei exportieren kann
     Log anzeigen Ruft den Log auf für die spezifische Verbindung auf
     Details Anzeigen Öffnet die Verbindung auf die gesamte Breite und Länge und zeigt weitere hilfreiche Informationen an
     Diagnose
    • Wechselt zur Diagnoseansicht
    • Testen der Serverconnectivity (Kann ein angegebener Server erreicht werden?)
    • Analyse des Logs
    • Testen der Public IP-Adresse (via https://checkip.spdyn.de)
     Verbindung löschen
    Bei einer Systemverbindung nur als Admin möglich
    Löscht die aktuelle Verbindung

    Cloud-Verbindung

    In einer kommenden Version wird eine Anbindung zum Securepoint Unified Security Portal (USP) zur Verfügung stehen.
    Damit wird es möglich sein, den VPN-Client aus dem Portal heraus zu steuern und eine Übersicht über den Sicherheitsstatus des Hosts zu erhalten.

    Client-Einstellungen

    Einstellungen zum Anwendungsstart:
    • Beim Starten von Windows ausführen
    • Anwendung minimiert (Tray-Icon) starten
    • Migrationsassistent erneut anzeigen
    Einstellungen bezüglich der Verbindungen:
  • Nach dem Verbinden den Client minimieren
  • Mehrere VPN-Verbindungen gleichzeitig erlauben
  • Herunterfahren während aktiver Verbindung blockieren
  • Einstellungen bezüglich des Aussehens:
  • Pop-Up Fenster anzeigen, wenn Anwendung minimiert
  • Flyout-Informationen innerhalb der Anwendung anzeigen
  • Darkmode aktivieren
  • Sprache wählen
  • notempty
    Diese Einstellungen werden nur angezeigt, wenn die Anwendung als Administrator gestartet wurde, dies ist an dem "Admin" rechts oben zu erkennen.

    Erweiterte Einstellungen für Administratoren:
  • Client-Updates automatisch durchführen
  • DNS erzwingen, alle DNS-Anfragen müssen über den VPN geschehen


  • Log

    Schaltfläche Beschreibung
    Log Übersicht
    Komplett Filtert den Log nach Typ: Kompletter Log, Client, Verbindungen, Täglich, Service
    50 Zeigt maximal die eingestellte Nummer von Log-Nachrichten
    Log kopieren Kopiert den gesamten (auch nicht sichtbaren) Log
    Aktuelles Log kopieren Kopiert den gesamten aktuell sichtbaren Log
    Exportieren Exportiert den gesamten akutell sichtbaren Log


    Kommandozeilen Befehle

    Installation, Upgrade, Deinstallation und Reparatur

    Beschreibung Parameter Beispiel
    Installation oder Upgrade des Clients (startet das GUI) securepoint-vpn-client-<version>.exe
    Installation oder Upgrade ohne Anzeige
    Das Installationsprogramm führt eine Installation aus, ohne eine Benutzeroberfläche anzuzeigen.
    Dem Benutzer werden keine Eingabeaufforderungen, Meldungen oder Dialogfelder angezeigt.
    Der Benutzer kann die Installation nicht abbrechen.

    Kann mit Deinstallation und Reparatur kombiniert werden.
    Dabei muss der Parameter /silent immer als erstes angegeben werden.
    /quiet securepoint-vpn-client-<version>.exe /quiet
    Verteilung des Clients per AD mit Token
    /s
    /enrollment
    securepoint-vpn-client-<version>.exe /s /enrollment <token>
    Deinstallation des Clients /uninstall securepoint-vpn-client-<version>.exe /uninstall
    Reparatur des Clients
  • Der Repair-Befehl muss immer in Kombination mit dem Parameter /silent ausgeführt werden.
    Andernfalls wird ein Benutzerdialog eingeblendet, ohne den das Programm nicht fortgesetzt wird, dessen Bestätigung jedoch das Programm beendet.
  • /repair securepoint-vpn-client-<version>.exe /quiet /repair
    Gibt auf der Konsole aus, was installiert wird und ob erfolgreich beendet wurde oder Fehler aufgetreten sind | more securepoint-vpn-client-<version>.exe /repair | more
    Zu beachten ist das Leerzeichen zwischen Pipe und more


    Befehle zur Laufzeit

    Die Befehle werden jeweils an den Aufruf des bereits installierten Clients angehängt (.\"Securepoint VPN Client.exe")

    Befehl Beschreibung Beispiel
    /migrate
    Kurzform: /m
    Migrieren einer Verbindung aus dem Dateipfad des alten Securepoint SSL-VPN Clients.
  • Das Resultat pro Connection ist entweder ALREADY EXISTS (Verbindung mit dem gleichem Namen existiert bereits in der Registry. Wichtig es wird nur der Name beachtet, nicht ob eine gleiche Kopie einer Config bereits importiert worden ist), SUCCESS oder FAILED.
  • Alle Verbindungen werden als USER-Verbindungen angelegt.
  • .\Securepoint_VPN_Client.exe /migrate
    /log
    Exportiert das vollständige Log .\Securepoint_VPN_Client.exe /log
    /help
    Kurzform: /h
    Hilfe zu den Befehlen .\Securepoint_VPN_Client.exe /help
    /enrollment
    Führt ein Enrollment für eine USC Anbindung aus securepoint-vpn-client-<version>.exe /enrollment <token>