Viscosity Client Konfiguration mit OpenVPN

Nitrokey 3

Nitrokey Passkey

Nitrokey FIDO2

Nitrokey U2F

Nitrokey HSM 2

Nitrokey Pro 2

Nitrokey Start

Nitrokey Storage 2

✓

⨯

⨯

⨯

⨯

✓

✓

✓

Diese Anleitung zeigt, wie man den Viscosity-Client konfiguriert, um sich mit einer OpenVPN-Instanz zu verbinden, mit einem Nitrokey Pro 2 (oder Nitrokey Storage 2), und PKCS#11-Authentifizierung.

Voraussetzungen

Für diese Anleitung benötigen Sie einen installierten und für Clients konfigurierten OpenVPN-Remote-Server. Für die Zwecke dieses Dokuments haben wir OpenVPN 2.49 verwendet, das auf einem Debian 10-Server installiert ist.

Wenn Sie wissen möchten, wie Sie OpenVPN für die Authentifizierung mit Nitrokey Pro konfigurieren, lesen Sie bitte die folgende Dokumentation, da wir in diesem Leitfaden nur die Konfiguration des Viscosity-Clients behandeln werden.

Sie benötigen außerdem Folgendes:

  • Ein Nitrokey Pro 2 oder Nitrokey Storage 2

  • Privater Schlüssel des Clients client.key auf den Nitrokey geladen

  • Zertifikat des Clients client.crt auf den Nitrokey geladen

  • The Certificate Authority file, i.e. CA.crt file used for your OpenVPN setup

  • Optional: The shared secret key file, i.e. ta.key

Für weitere Informationen über PKCS#11 Schlüsselverwaltung mit OpenVPN, konsultieren Sie bitte die Dokumentation von OpenVPN.

Verwendung

  1. Starten Sie Viscosity und legen Sie eine neue Verbindung „openVPN“ an (Sie können sie beliebig benennen)

  2. Klicken Sie mit der rechten Maustaste auf die Verbindung und klicken Sie auf Bearbeiten

  3. Fügen Sie die IP-Adresse Ihres Servers hinzu und konfigurieren Sie den Port entsprechend Ihrer Konfiguration.

  4. Unter Typ scrollen Sie unter Authentifizierung nach unten zu SSL/TLS Client (PKCS11)

  5. Wählen Sie die CA-Datei für Ihre Verbindung

    Optional: Wählen Sie den ta.key im Abschnitt TLS-Auth aus

    img3

  6. Klicken Sie auf die Schaltfläche „Hinzufügen“ neben dem Feld „Provider“ und wählen Sie das Modul PKCS#11 für Ihren Nitrokey aus. Es können mehrere Provider angegeben werden, und wir werden zum Beispiel OpenSC verwenden.

    Unter macOS befinden sich die Module in der Regel im Verzeichnis /usr/lib. Bitte lesen Sie in der Dokumentation Ihrer Treibersoftware nach, welchen Ort Sie verwenden müssen. Das Modul von OpenSC finden Sie unter /Library/OpenSC/lib/opensc-pkcs11.so

    On Windows, the most common location for libraries is either in C:\Program Files or C:\Windows\System32. OpenSC libraries are generally located at C:\Program Files\OpenSC Project\OpenSC\pkcs11. There may be more than one library available here, you can try each one or simply add both.

  7. Wählen Sie eine Abrufmethode aus dem Dropdown-Menü Abruf

    img4

    • Wenn nur ein Nitrokey auf diesem Computer verwendet werden soll, wählen Sie Namen des Zertifikats unten verwenden. Wenn der Nitrokey gerade mit dem Computer verbunden ist, klicken Sie auf die Schaltfläche Detect, damit Viscosity das Feld Name automatisch ausfüllt. Andernfalls kann dieses Feld manuell ausgefüllt werden.

    • If in doubt, or if more than one Nitrokey may be used (i.e. multiple users), then select Prompt for certificate name.

    Wenn Prompt for certificate name gewählt wurde, erkennt Viscosity automatisch den benötigten Schlüssel auf dem Nitrokey, unter Verwendung des/der angegebenen PKCS#11-Module/s. Wählen Sie aus einem der gefundenen Geräte aus, oder geben Sie den Namen der serialisierten ID manuell ein. Auch hier sollte der Benutzer nach einem Passwort/PIN gefragt werden, falls erforderlich.

  8. Klicken Sie auf die Schaltfläche „Speichern“ und stellen Sie die Verbindung über die Hauptschnittstelle her

Referenzen

Hinweise

  • Viscosity ist nicht kostenlos, daher können Sie bei der Verwendung der kostenlosen Version auf Probleme stoßen.

  • Wir erwägen die Verwendung von Pritunl als eine freie und offene Alternative.