# VPN certificate reset

This guide describes how to reset your VPN certificate and passphrase required to access your lab when you receive your shipments from the VPN certificate reset order.

# 1. Requirements

Shipments from the VPN certificate reset order

1.1 Your new VPN certificate and VPN profile in a compressed 7z-file sent over filesender.no

1.2. Your new VPN passphrase and your 7-ZIP file key sent over Signal.

Required software. The following required software should already be installed during your initial onboarding:

1.3. Working VPN software (if not, head over to our Getting started guide to install the VPN software.

1.4. A working Google authenticator application on your phone that provide time-based VPN verification codes (if not, you can order a Google authenticator key reset in our service desk).

# 2. Download and unpack your new certificate

We will communicate your VPN certificate over your organizational email. You will receive a link to an encrypted file archive (7z-file).

# Windows

2.1 Click on the link in the email to download the file and save this on your local computer.

2.2 Unpack (extract) the file using 7-zip (opens new window)

2.3 Use the key named 7-ZIP file key from your Signal transfer to decrypt the archive folder.

# MacOS

2.1 Click on the link in the email to download the file and save this on your local computer.

2.2 Unpack (extract) the file with compatible archive software

We recommend downloading Keka (opens new window) to successfully unpack your archive folder

alternatively, you can install keka using brew command below

brew install keka

2.3 Use the key named 7-ZIP file key from your Signal transfer to decrypt the archive folder.

OS X and MacOS - Passphrase not working?

Note that the default archive utility on MacOS does not recognize the passphrase of the 7z files. You will need to install the 7z-compatible software from the link above.

# Ubuntu linux

2.1 Click on the link in the email to download the file and save this on your local computer.

2.2 Unpack (extract) the file with compatible archive software

install p7zip

sudo apt update && sudo apt-get install p7zip-full

2.3 Use the key named 7-ZIP file key from your Signal transfer to decrypt the archive folder.

# 3. Remove your old VPN certificate

You will need to remove your old VPN certificate and passwords before you install a new one.

# Windows
  1. Right click on the OpenVPN icon in the task bar in the lower right corner of your screen and select Clear Saved Passwords
  2. Open your file explorer and manually remove the folder with the old OpenVPN configurations. It's usually located here:
C:\Users\<MYUSERNAME>\OpenVPN\config\<folder-with-username-that-you-should-remove>
# MacOS

To remove old VPN configuration on MacOS using Tunnelblick, follow our guide below

  1. Click on running Tunnelblick icon in upper menu bar and select VPN details...

VPNemovalstep1.png

  1. Select your VPN profile on the left side of the window. Then, in the bottom left corner, select expansion window marked with 3 dots in a circle

credentialsremoval1

  1. At the very bottom of the newly opened widow, select Delete configuration's credentials in keychain

credentialsremoval2

  1. Afterwards, select your VPN profile and delete it from Tunnelblick app as described on below picture

profileremoval

  1. You can now continue with next step

# 4. Setup the new VPN profile

# Windows
  1. Start the OpenVPN client (if it is not running already)

OpenVPN-icon

  1. Expand pane on taskbar

OpenVPN-icon

  1. Select Import file...

OpenVPN-icon

  1. Click on Import file and select OpenVPN profile file <username>.ovpn that you collected in Step 1.

OpenVPN-icon

OpenVPN-icon

# MacOS

4.1 If you 'do' get prompted with the Welcome to Tunnelblick message, follow these steps:

  1. Select I have configuration files.
  2. In the Welcome to Tunnelblick prompt, select I have configuration files.
  3. When prompted for which type of configuration you have, select OpenVPN Configurations.
  4. Select the OpenVPN profile named. <username>.ovpn in the collection of credentials given from HUNT Cloud.
  5. Continue with the Connecting to the VPN section below.

4.2 If you 'do not' get prompted with the Welcome to Tunnelblick message, follow these steps:

  1. Find the OpenVPN profile named <username>.ovpn that you collected in Step 1.
  2. Right-click the file OpenVPN profile named <username>.ovpn.
  3. Select Open With -> Tunnelblick.
  4. When prompted for Install Configuration For All Users, select Only Me.
  5. Enter your macOS password to allow Tunnelblick to install the OpenVPN configuration.
  6. Continue with the Connecting to the VPN section below.
# Ubuntu linux
  1. Click on the Network Manager icon in the task bar.
  2. Select Edit Connections....
  3. Click Add.
  4. Choose Import a saved VPN configuration and click Create.
  5. Select the OpenVPN profile named <username>.ovpn that you collected in Step 1.
  6. Enter your user name (same as the OpenVPN profile file name).
  7. Click on the person icon in the Password field and select Ask for this password every time.
  8. Enter the Private Key Password with the VPN passphrase sent to you from HUNT over Signal.
  9. Click on the IPv4 Settings tab.
  10. Click Routes....
  11. Select the Use this connection only for resources on its network and click OK.
  12. Click Apply.

# 5. Connect to the VPN

# Windows
  1. Right-click on the OpenVPN notification icon on the taskbar.

  2. Select Connect.

OpenVPN-icon

  1. Enter your user name (same as the OpenVPN profile file name).

  2. Enter a rotating verification code from Google Authenticator as your password.

    OpenVPN-icon

  3. When prompted for a Private Key Password, insert the VPN passphrase that your collected in Step 1. Your authentication will fail when you complete your passphrase below. This is expected since your verification code timed out while you typed your passphrase.

    OpenVPN-icon

  4. Now try again to connect with a fresh verfication code from Google Authenticator.

You should now be connected to the VPN.

# macOS
  1. Start Tunnelblick and Connect.

  2. Enter your user name (same as the OpenVPN profile file name).

  3. Enter the verification code from Google Authenticator as your password.

    tunnelblick-login

    WARNING

    Make sure that the Save password checkbox is unchecked.

  4. When prompted for a Private Key Password or Passphrase, insert the VPN passphrase that you collected in Step 1.

    TIP

    Save this passphrase.

Your authentication will fail when you complete your passphrase above. This is expected since your verification code timed out while you typed your passphrase.

  1. Now try again to connect with a fresh verfication code from Google Authenticator.

You should now be connected to the VPN.

# Ubuntu Linux
  1. Click on the Network Manager icon in the task bar.
  2. Select VPN Connections > and the name of your profile.
  3. In the Authenticate VPN window, enter the verification code from Google Authenticator in the Password field.
  4. Click OK to connect.

# 6. Verify your VPN connection

# Windows

The OpenVPN notification icon on the taskbar should be green.

OpenVPN-icon

# MacOS

A small Tunnelblick window should state "Connected" in green letters with a timer that count the connection length.

# Ubuntu Linux

If you received the notification VPN connection has been successfully established, then you are good to go.

Access list

We allow connection from known IP addresses only. This means that your VPN connection may be blocked if you connect from a (for us) unknown network outside Norway. Click here to request an opening for your location in our Do science service desk.

Next step

If you successfully completed this step, head over to Step 3 to Configure your SSH connection. If you did not succeed, start with a quick look in our Immediate troubleshooting section below.

# Troubleshooting

Below are a few immediate things to try if your VPN connection did not succeed:

# Authenticate VPN

If the Authenticate VPN prompt pops up again, then try to log in again with a new verification code.

# VPN connection failed

If you received the notification VPN Connection Failed after 60 seconds, please check the following

  • Verify that you have an active internet connection.
  • Verify that the Private Key Password is correct.

# Could not read Private Key error

The error messages below indicates that there is a typo in the Private Key Password (step 2.3.5) and you need to type it in again.

ERROR: could not read Private Key username/password/ok/string from management interface
Cannot load private key file

# Unable to apply changes

If you are unable to click Apply after your changes, try to re-enter your Private Key Password using your VPN passphrase that you collected in Step 1.

TIP

If nothing works, please head over to our main troubleshooting section for more information on how to troubleshoot connections.

# Tunnelblick does not respond

If Tunnelblick stopped responding, you can try following command in your terminal to stop Tunnelblick app

sudo pkill -9 -i 'Tunnelblick|openvpn'
Last Updated: 2/27/2024