I needed a really simple enclosed and fully functional work environment that wasn’t on my work laptop so I could do work on another station, without having to mess that environment up with work stuff.
So Docker was of course the logical choice.
- Docker installed
- your work ssh-keys
- your office AD login details
- copy of Fortinet Linux ssl cli client (see below for link) packed in a .xz file
what did I want my work container to do?
- fire up and connect the work Fortinet VPN client with no user input.
- have my authorised ssh-keys set up for all work environments I needed to be able to access
- have my bash alises loaded (cos I like convenience)
I’m going to go through each block and try and explain what’s happening. I’ll have a link at the end with all the files in full so you can skip to that to see everything in its’ entirety.
So, what’s it doing?
- sets up base image and installs desired packages (add as needed).
- install PPP & PPTP packages are a must for VPN to work.
- sets up ‘utmp’ and ‘root’ user, sets password
FROM centos:7 RUN \ yum -y update && yum -y install epel-release && \ yum -y install openssl openssh-clients openssh-server && \ yum -y install bind-utils net-utils ppp pptp curl wget git which less \ vim expect ansible python-pip bash-completion net-tools zip unzip && \ yum -y clean all && \ touch /run/utmp && \ echo "root:root" | chpasswd
- it creates a (work) user
- creates our .ssh directory and
- sets the user’s passwd (loginid = your AD login at the office)
RUN \ useradd loginid && \ mkdir ~loginid/.ssh && \ echo "loginid:loginid" | chpasswd
Next it’s adding our vpn client package, and copying the vpn runtime script.
When you add this (or any package for that matter of this type) .xz file, Docker will automagically unpack the contents in your destination directory (in this case /usr/local/bin):
ADD ["bin/forticlientsslvpn.xz", "/usr/local/bin"] COPY ["bin/forticlientvpn.sh", "/usr/bin"]
Then, copy ALL my keys and my ssh config file to $HOME/.ssh:
COPY ["keys", "/home/loginid/.ssh"] COPY ["conf/ssh.config", "/home/loginid/.ssh/config"]
Also copy my bash aliases to ~/.alias, and add a line to my ~/.bashrc so that it automagically sources my aliases everytime I login
COPY ["conf/bash_aliases", "/home/loginid/.alias"] RUN echo " . ~/.alias " >> /home/loginid/.bashrc
set the right owners and permissions or my keys wont work
RUN chown -R loginid:loginid /home/loginid/.ssh RUN chmod -R 600 /home/loginid/.ssh/* RUN chown loginid:loginid /home/loginid/.alias
Next, this script is needed by forticlient to inialise and accept the license:
- copy our entrypoint.sh (see further down for setting this script up)
- and chmod 755 entrypoint and forticlientvpn** scripts:
COPY ["entrypoint.sh", "/"] RUN chmod 755 /entrypoint.sh RUN chmod 755 /usr/bin/forticlientvpn.sh
Next, we have to prep the forticlient setup so that it doesn’t have to wait for us to input anything and it just goes ahead and
- installs without us needing to accept the license
- runs without us needing to type ‘Y’ to start the VPN tunnel
Setting up the forticlient SSL VPN
When you first download the forticlient package on Linux and run it, you’ll get an error saying you need to run the following script:
and this will show you the license you have to scroll through and accept the license.
This is a problem if you just want the container to fire up, set itself up and run without any user input. So we need to remove this section of the script before we can run the container successfully
Remove Section from ‘setup.linux.sh’
This section is the one where you need to scroll through the ‘more’ output to the bottom, and say ‘yes’ or whatever to get it to go to the next step. We don’t want to do this, we want things to work automagically.
So, remove this section from the script:
... if [ "$1" != "2" ]; then echo "begin setup at $base..." >> "$inlog" more "$base/License.txt" echo -n "Do you agree with this license ?[Yes/No]" read ans yn=`echo $ans|sed ' s/y/Y/ s/e/E/ s/s/S/ '` if [ "$yn" != "YES" -a "$yn" != "Y" ]; then touch "$base/.nolicense" chmod a+w "$base/.nolicense" echo "Do not agree with this license, aborting..." exit 0 fi fi ...
Just delete everything in this ‘if’ statement. Save your file. It’s done.
Forticlient Expect Script
For the 2nd part, every time you fire up forticlient vpn it asks you if you want to start the VPN tunnel. Yes. Yes you do. and No, no you don’t want to have to type ‘Y’ every time.
So, we want our entrypoint for the container to be an ‘expect’ bash script that answers that question for us. Big thanks and full credit for script goes to mgeeky/github.com.
Just include your own VPN details and save this as ‘entrypoint.sh’
#!/usr/bin/env bash FORTICLIENT_PATH="/usr/local/bin/forticlientsslvpn/64bit/forticlientsslvpn_cli" VPN_HOST="host:port" VPN_USER="" VPN_PASS=""
Right, time to build our image.
Build Work VPN Container Image
(make sure you’re in the same folder as your Dockerfile file)
docker build --rm -t companyname/vpn:centos7 .
Run the container, then ‘exec’ into it and you should find it connects to your work VPN and is ready for you to remote to all your work environments (well, mine anyway).
note: you need to run container as ‘privileged’ for pppd kernel support the vpn inside docker would complain about kernel not supporting pppd if you don’t run privileged.
docker run -dP --name=workvpn --privileged companyname/vpn:centos7 docker exec -u loginid -ti <name_of_container> /bin/bash
Example of output success
$ docker logs <name_of_container> and see if you can see the following
cloudbuilder@hx0:~/vpn $ docker logs workvpn Killing previous instances of Forticlient SSL VPN client... spawn /usr/local/bin/forticlientsslvpn/64bit/forticlientsslvpn_cli --server remote.site.com:443 --vpnuser loginid --keepalive Password for VPN: STATUS::Setting up the tunnel STATUS::Connecting... Certificate:Certificate: Data: Version: 3 (0x2) Serial Number: ... ... //certificate output ... //certificate output ... //certificate output ... The certificate for the SSLVPN server is invalid. You are connecting to an untrusted server. which could put your confidential information at risk. Would you like to connect to this server? (Y/N) Y STATUS::Login succeed STATUS::Starting PPPd STATUS::Initializing tunnel STATUS::Connecting to server STATUS::Connected Press Ctrl-C to quit STATUS::Tunnel running
When you see ‘Tunnel running’ you should be good to go!
Feel free to contact me if you have any questions!