Viscosity-clientconfiguratie met 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.

Vereisten

Voor deze gids hebt u een OpenVPN remote server nodig die geïnstalleerd en geconfigureerd is voor clients. Voor het doel van dit document hebben we OpenVPN 2.49 gebruikt, geïnstalleerd op een Debian 10 server.

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.

U heeft ook het volgende nodig:

• Een Nitrokey Pro 2 of 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.

Gebruik

1. Start Viscosity en maak een nieuwe verbinding “openVPN” (u kunt het een naam geven zoals u wilt)

   

2. Klik met de rechtermuisknop op de verbinding en klik op bewerken

   

3. Add your server’s IP address and configure the port according to your configuration.

4. Onder authentificatie, in Type scroll naar beneden naar SSL/TLS Client (PKCS11)

5. Selecteer het CA-bestand voor uw verbinding

   Optioneel: Selecteer de ta.key in de TLS-Auth sectie

   

6. Klik op de knop Toevoegen naast het veld Providers en selecteer de PKCS#11 module voor uw Nitrokey. U kunt meerdere providers opgeven, en wij zullen bijvoorbeeld OpenSC gebruiken.

   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. Kies een ophaalmethode uit het keuzemenu Ophalen

   

   • Als er ooit maar één Nitrokey op deze computer zal worden gebruikt, selecteer dan Use certificate name below. Als de Nitrokey momenteel op de computer is aangesloten, klikt u op de knop Detect voor Viscosity om het veld Naam automatisch in te vullen. Anders kan dit veld handmatig worden ingevuld.

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

   Als Prompt for certificate name is geselecteerd, zal Viscosity automatisch de vereiste sleutel op de Nitrokey detecteren, met gebruikmaking van de opgegeven PKCS#11-module(s). Kies uit een van de gevonden apparaten, of voer de naam in van de serialized id die u handmatig wilt gebruiken. Ook hier moet de gebruiker om een wachtwoord/PIN worden gevraagd, indien nodig.

8. Klik op de knop Opslaan en maak verbinding vanuit de hoofdinterface

Referenties

• Tokens/Smartcards gebruiken (PKCS#11)

• OpenVPN HOWTO

Opmerkingen

• Viscosity is niet gratis, en u kunt dus tegen problemen aanlopen bij het gebruik van de gratis versie.

• Wij overwegen het gebruik van Pritunl als een vrij en open alternatief.