====== How to connect to our VPN ======

First things first: It´s great that you are here and want to participate in our SNAP workshop.

It was quite a challenge to make this work but after some testing, we think the solution works and we can have people from all around the world participate in our first hybrid workshop and use our on-site hardware. 
We are happy to receive feedback afterward about the things that didn´t work (and of course if it worked, we are happy to hear that as well).

But here is how to connect.

==== Short Version ====

  - Download the OpenVPN Connect App [[https://openvpn.net/vpn-client/|OpenVPN Connect Website]] for your system
  - Install the OpenVPN Connect App
  - Load our configuration file: {{ :snapcon2022:v220220714072319_openvpn_remote_access_l3.ovpn |EOLab.ovpn}}
  - Type in the credentials provided by our on-site team
  - "Connect" to the VPN. "Continue" when asked for a "Missing external certificate"
  - Have fun!

==== Long Version ====

We are using OpenVPN for this. OpenVPN has clients available that make it easy to set it up on any major operating system.
To get the official instructions please visit the [[https://openvpn.net/vpn-client/|OpenVPN Connect Website]]. 
  - You then choose your platform and download the OpenVPN Connect App by clicking "Download OpenVPN Connect for [your Platform]". <imgcaption image1|>{{:snapcon2022:openvpn_choose_os.jpg?direct&400|Choose your platform}}</imgcaption> If you need more instructions on how to install the application, please click "Installation instructions and alternative versions". There you can find some "Frequently Asked Questions" and also more information on how to do "Downloading and installing".If you follow the steps explained on the aforementioned site, please download the application from the OpenVPN site as explained above. We do not host our own version (yet?;-))
  - After you completed the installation you can find the OpenVPN Connect Client in your system tray. At least on Windows, it will open up immediately after the installation finishes. <imgcaption image3|>{{ :snapcon2022:openvpn_drag.jpg?direct&200| Drag and Drop}}</imgcaption> <imgcaption image2|>{{ :snapcon2022:openvpn_start_screen.jpg?direct&200|OpenVPN Start Screen}}</imgcaption> It will show you guide on how to use the app. We will use the "import from file"-feature. To exit the guide, go through the four pages or hit the "Cross"-Icon in the top right corner. You will also need to expect some stuff given by OpenVPN.
  - You should now be at the "Import Profile"-Screen. It consists of two tabs: "URL" and "File". Please select "File". It will then ask you to upload a so-called ".OVPN"-File. This file contains all the necessary information to use our VPN (besides the login information). You can download it right here: {{ :snapcon2022:v220220714072319_openvpn_remote_access_l3.ovpn |EOLab.ovpn}}
  - After you downloaded the file, Drag and Drop it into the OVPN Connect App. Everything besides the username and password will be automagically be filled out for you. You can now fill in the username and password which are provided by our on-site team. To type in the password just check "Save password". After all of that, you can now just click connect.
  - The app will probably prompt you with the message "Missing external certificate". Just click "Continue". We configured everything so that you don´t need something like this. <imgcaption image4|>{{:snapcon2022:openvpn_continue.jpg?direct&200 | Continue}}</imgcaption>
  - You are now connected. Have fun!