Viscosity Client Konfiguration mit OpenVPN

Compatible Nitrokeys
3A/C/Mini	Passkey	HSM 2	Pro 2	FIDO2	Storage 2	Start	U2F
✓ active	⨯ inactive	⨯ inactive	✓ active	⨯ inactive	✓ active	✓ active	⨯ inactive

This guide will show to configure Viscosity client to connect to an OpenVPN instance, using a Nitrokey Pro 2 (or Nitrokey Storage 2), and PKCS#11 authentication.

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.

To read about how to configure OpenVPN to authenticate with Nitrokey Pro, you might consult the following documentation, as we will just cover the way to configure the Viscosity client in this guide.

Sie benötigen außerdem Folgendes:

• Ein Nitrokey Pro 2 oder Nitrokey Storage 2

• Client’s private key client.key loaded on the Nitrokey

• Client’s certificate client.crt loaded on the Nitrokey

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

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

For more information on PKCS#11 key management with OpenVPN, please consult OpenVPN’s documentation.

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. Add your server’s IP address and configure the port according to your configuration.

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

   

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.

   On macOS, the most common location for modules to be found is in the /usr/lib directory. Please refer to the documentation included with your driver software for the location to use. OpenSC’s module can be found at /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

   

   • 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

• Verwendung von Token/Smartcards (PKCS#11)

• OpenVPN How-To

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.