OpenVPN Guide OSX

From CipherSpace Client Wiki
Revision as of 14:14, 16 December 2024 by Client Admin (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


Introduction

This guide will explain how to connect to your virtual machines, which aren’t accessible from the Internet, using the OpenVPN protocol. It will explain how to install Tunnelblick (OpenVPN client for Mac) on your mac as well as how to use it.

This guide assumes that you have some experience with OSX and that you have administrative rights on the computer on which Tunnelblick will be installed.

Installation

Go to https://tunnelblick.net:

Tunnelblick net.png

And click on “Download Latest Stable Release”. The Tunnelblick disk image file (a “.dmg” file) will be stored in your downloads folder.


Open the downloaded disk image file (which mounts the disk image):

Tunnelblick Install 1.png

And double-click the “Tunnelblick” icon (it may be labeled “Tunnelblick.app”):

You may get the following warning:

Tunnelblick Install 2.png

Click on “Open” to continue.

The following screen appears:

Tunnelblick Install 3.png

Type your password and click on “OK”.

Tunnelblick Install 4.png

Click on “Launch”:

Tunnelblick Launch 1.png

Click on “I have configuration files”. You will see the following screen:

Tunnelblick Launch 2.png

Before you can click on “OK”, the following screen appears:

Tunnelblick Launch 3.png

Click on “Do not check for a change”. The next screen appears:

Tunnelblick Launch 4.png

Click on “Check Automatically”.

Now you can click on OK on the previous screen. The Tunnelblick installation is complete.


Configuration

To install the necessary configuration files, open the folder where you have stored the files we sent you:

Tunnelblick Conf 1.png

And double-click on the “.ovpn” file. The following screen appears:

Tunnelblick Conf 2.png

If you have several users on this machine, who need to access the virtual machines, click on “All Users”, otherwise click on “Only Me”:

Tunnelblick Conf 3.png

Type your password and click on OK:

Tunnelblick Conf 4.png

Click on OK. The configuration file has been copied from your folder into Tunnelblick and are not needed anymore.

Running Tunnelblick

If Tunnelblick isn’t already launched, double-click on the “Tunnelblick” app located in your “Applications” folder. The following icon appears on the top right of your screen:

Tunnelblick Run 1.png

Put the mouse pointer on the icon (without clicking). The connection window appears:

Tunnelblick Run 2.png

And click on “Connect”:

  • Enter in the Username & Password provided to you
  • Then type in the encryption passphrase: Type the password we sent you for the corresponding configuration file. If you want, you can store the password in your Keychain by checking the “Save in Keychain” box, so you don’t have to type it each time you use Tunnelblick. Click on OK.

Tunnelblick Run 3.png

You will see the status changing until it says “Connected” and the connection window disappears. The Tunnelblick icon will be as follows:

Tunnelblick Run 4.png

If you cannot get connected, please contact us.


You may get the following warning:

Tunnelblick Run 5.png

If you do, check the “Do not check for IP address changes” box and click on OK.

Another method to connect is to click on the Tunnelblick icon (Tunnelblick Run 1.png ):

Tunnelblick Run 6.png

And in the drop-down menu select “Connect <Customer-User>” (where <Customer-User> corresponds to your VPN configuration).


You should now test the VPN connection by opening a terminal window, (Click on the Tunnelblick Run 7.png icon on the top right of your screen, type “Terminal” and select the application) and type “ping xxx.xxx.xxx.xxx”, where xxx.xxx.xxx.xxx is the IP address of a virtual machine, which is not published on the Internet. If you cannot access the virtual machine, please contact us.


To disconnect from the VPN, put the mouse pointer on the Tunnelblick icon (Tunnelblick Run 4.png) (without clicking). The connection window appears:

Tunnelblick Run 8.png

And click on “Disconnect”.


You can also click on the Tunnelblick icon (Tunnelblick Run 4.png):

Tunnelblick Run 9.png

And select “Disconnect <Customer-User>” (where <Customer-User> corresponds to your VPN configuration).