From d17d381049dac5245e3f107bb75f95cbce5414ef Mon Sep 17 00:00:00 2001 From: Orazio Date: Fri, 27 Dec 2019 15:48:42 +0100 Subject: [PATCH 01/10] - When suggesting to use Pi-hole, use the VPN server IP instead of the LAN IP to allow DNS resolution even if the user does not route the local network through the tunnel. - Format listCONF in a similar way as listOVPN - Specifically look for a free octet in the last word of clients.txt and not just any word. Necessary otherwhise public keys starting with a number will match against an octet. Example: if line is 'name 5abcdefgh 4', then looking for ' 5' will match but '5$' will not (correctly). - 'pivpn -c' will show the Connected Clients List for WireGuard too --- auto_install/install.sh | 2 +- scripts/wireguard/clientSTAT.sh | 39 +++++++++++++++++++++++++++++++++ scripts/wireguard/listCONF.sh | 13 +++++++---- scripts/wireguard/makeCONF.sh | 4 ++-- scripts/wireguard/pivpn | 2 +- scripts/wireguard/removeCONF.sh | 10 +++++---- 6 files changed, 58 insertions(+), 12 deletions(-) create mode 100755 scripts/wireguard/clientSTAT.sh diff --git a/auto_install/install.sh b/auto_install/install.sh index cdbd8f5..34a72f5 100755 --- a/auto_install/install.sh +++ b/auto_install/install.sh @@ -978,7 +978,7 @@ askClientDNS(){ # Detect and offer to use Pi-hole if command -v pihole &>/dev/null; then if (whiptail --backtitle "Setup PiVPN" --title "Pi-hole" --yesno "We have detected a Pi-hole installation, do you want to use it as the DNS server for the VPN, so you get ad blocking on the go?" ${r} ${c}); then - pivpnDNS1="$IPv4addr" + pivpnDNS1="$vpnGw" echo "interface=$pivpnDEV" | $SUDO tee /etc/dnsmasq.d/02-pivpn.conf > /dev/null $SUDO pihole restartdns echo "pivpnDNS1=${pivpnDNS1}" >> /tmp/setupVars.conf diff --git a/scripts/wireguard/clientSTAT.sh b/scripts/wireguard/clientSTAT.sh new file mode 100755 index 0000000..d8c94cd --- /dev/null +++ b/scripts/wireguard/clientSTAT.sh @@ -0,0 +1,39 @@ +#!/bin/bash + +cd /etc/wireguard/configs +if [ ! -s clients.txt ]; then + echo "::: There are no clients to list" + exit 1 +fi + +hr(){ + numfmt --to=iec-i --suffix=B "$1" +} + +DUMP="$(wg show wg0 dump | tail -n +2)" + +printf "\e[1m::: Connected Clients List :::\e[0m\n" + +{ +printf "\e[4mName\e[0m \t \e[4mRemote IP\e[0m \t \e[4mVirtual IP\e[0m \t \e[4mBytes Received\e[0m \t \e[4mBytes Sent\e[0m \t \e[4mLast Seen\e[0m\n" + +while IFS= read -r LINE; do + + PUBLIC_KEY="$(awk '{ print $1 }' <<< "$LINE")" + REMOTE_IP="$(awk '{ print $3 }' <<< "$LINE")" + VIRTUAL_IP="$(awk '{ print $4 }' <<< "$LINE")" + BYTES_RECEIVED="$(awk '{ print $6 }' <<< "$LINE")" + BYTES_SENT="$(awk '{ print $7 }' <<< "$LINE")" + LAST_SEEN="$(awk '{ print $5 }' <<< "$LINE")" + CLIENT_NAME="$(grep "$PUBLIC_KEY" clients.txt | awk '{ print $1 }')" + + if [ "$LAST_SEEN" -ne 0 ]; then + printf "%s \t %s \t %s \t %s \t %s \t %s\n" "$CLIENT_NAME" "$REMOTE_IP" "${VIRTUAL_IP/\/32/}" "$(hr "$BYTES_RECEIVED")" "$(hr "$BYTES_SENT")" "$(date -d @"$LAST_SEEN" '+%b %m %Y - %T')" + else + printf "%s \t %s \t %s \t %s \t %s \t %s\n" "$CLIENT_NAME" "$REMOTE_IP" "${VIRTUAL_IP/\/32/}" "$(hr "$BYTES_RECEIVED")" "$(hr "$BYTES_SENT")" "(not yet)" + fi + +done <<< "$DUMP" + +printf "\n" +} | column -t -s $'\t' \ No newline at end of file diff --git a/scripts/wireguard/listCONF.sh b/scripts/wireguard/listCONF.sh index 02e5224..6f8e198 100755 --- a/scripts/wireguard/listCONF.sh +++ b/scripts/wireguard/listCONF.sh @@ -6,18 +6,23 @@ if [ ! -s clients.txt ]; then exit 1 fi +printf "\e[1m::: Clients Summary :::\e[0m\n" + # Present the user with a summary of the clients, fetching info from dates. -FORMATTED+=": \e[4mClient\e[0m&\e[4mCreation date\e[0m :\n" +{ +echo -e "\e[4mClient\e[0m \t \e[4mPublic key\e[0m \t \e[4mCreation date\e[0m" while read -r LINE; do CLIENT_NAME="$(awk '{print $1}' <<< "$LINE")" - CREATION_DATE="$(awk '{print $2}' <<< "$LINE")" + PUBLIC_KEY="$(awk '{print $2}' <<< "$LINE")" + + CREATION_DATE="$(awk '{print $3}' <<< "$LINE")" # Dates are converted from UNIX time to human readable. CD_FORMAT="$(date -d @"$CREATION_DATE" +'%d %b %Y, %H:%M, %Z')" - FORMATTED+="• $CLIENT_NAME&$CD_FORMAT\n" + echo -e "$CLIENT_NAME \t $PUBLIC_KEY \t $CD_FORMAT" done < clients.txt -echo -e "$FORMATTED" | column -t -s '&' \ No newline at end of file +} | column -t -s $'\t' \ No newline at end of file diff --git a/scripts/wireguard/makeCONF.sh b/scripts/wireguard/makeCONF.sh index e0378cd..561aa69 100755 --- a/scripts/wireguard/makeCONF.sh +++ b/scripts/wireguard/makeCONF.sh @@ -79,9 +79,9 @@ echo "::: Client Keys generated" # Find an unused number for the last octet of the client IP for i in {2..254}; do - if ! grep -q " $i" configs/clients.txt; then + if ! grep -q " $i$" configs/clients.txt; then COUNT="$i" - echo "${CLIENT_NAME} $(date +%s) ${COUNT}" >> configs/clients.txt + echo "${CLIENT_NAME} $(> configs/clients.txt break fi done diff --git a/scripts/wireguard/pivpn b/scripts/wireguard/pivpn index bd89d43..3f96004 100755 --- a/scripts/wireguard/pivpn +++ b/scripts/wireguard/pivpn @@ -17,7 +17,7 @@ makeConf(){ } listConnected(){ - $SUDO wg show + $SUDO /opt/pivpn/clientSTAT.sh exit 0 } diff --git a/scripts/wireguard/removeCONF.sh b/scripts/wireguard/removeCONF.sh index 263fde3..b00deb6 100755 --- a/scripts/wireguard/removeCONF.sh +++ b/scripts/wireguard/removeCONF.sh @@ -73,12 +73,14 @@ for CLIENT_NAME in "${CLIENTS_TO_REMOVE[@]}"; do if [[ $REPLY =~ ^[Yy]$ ]]; then # Grab the least significant octed of the client IP address - COUNT=$(grep "${CLIENT_NAME}" configs/clients.txt | awk '{print $3}') - # And the creation date of the client - CREATION_DATE="$(grep "${CLIENT_NAME}" configs/clients.txt | awk '{print $2}')" + COUNT=$(grep "${CLIENT_NAME}" configs/clients.txt | awk '{print $4}') + # The creation date of the client + CREATION_DATE="$(grep "${CLIENT_NAME}" configs/clients.txt | awk '{print $3}')" + # And its public key + PUBLIC_KEY="$(grep "${CLIENT_NAME}" configs/clients.txt | awk '{print $2}')" # Then remove the client matching the variables above - sed "/${CLIENT_NAME} ${CREATION_DATE} ${COUNT}/d" -i configs/clients.txt + sed "\#${CLIENT_NAME} ${PUBLIC_KEY} ${CREATION_DATE} ${COUNT}#d" -i configs/clients.txt # Remove the peer section from the server config sed "/# begin ${CLIENT_NAME}/,/# end ${CLIENT_NAME}/d" -i wg0.conf From a561607272226ac50cd9bc687d37f5701e0b3550 Mon Sep 17 00:00:00 2001 From: Orazio Date: Sun, 29 Dec 2019 18:25:35 +0100 Subject: [PATCH 02/10] Mostly changes to the install script, see below Handle running the install script over an existing installation (as the script already did before branching to test-wireguard), providing: - Update, downloads latest scripts from git repo - Repair, reinstall PiVPN while keeping existing settings - Reconfigure, start over overwriting the existing settings Tag iptables rules as an attempt to make sure that the uninstall script only removes PiVPN rules Change the armv6l installation to reflect the split of WireGuard snapshots into wireguard-linux-compat and wireguard-tools --- auto_install/install.sh | 534 +++++++++++++++++++------------- scripts/openvpn/pivpnDebug.sh | 20 +- scripts/uninstall.sh | 24 +- scripts/wireguard/pivpnDEBUG.sh | 41 ++- 4 files changed, 371 insertions(+), 248 deletions(-) diff --git a/auto_install/install.sh b/auto_install/install.sh index 34a72f5..4d37ddf 100755 --- a/auto_install/install.sh +++ b/auto_install/install.sh @@ -11,11 +11,10 @@ # Make sure you have `curl` installed ######## VARIABLES ######### -setupVars=/etc/pivpn/setupVars.conf +pivpnGitUrl="https://github.com/pivpn/pivpn.git" +setupVars="/etc/pivpn/setupVars.conf" pivpnFilesDir="/etc/.pivpn" -debianOvpnUserGroup="openvpn:openvpn" - ### PKG Vars ### PKG_MANAGER="apt-get" PKG_CACHE="/var/lib/apt/lists/" @@ -25,21 +24,22 @@ PKG_INSTALL="${PKG_MANAGER} --yes --no-install-recommends install" PKG_COUNT="${PKG_MANAGER} -s -o Debug::NoLocking=true upgrade | grep -c ^Inst || true" # Dependencies that are required by the script, regardless of the VPN protocol chosen -BASE_DEPS=(git tar wget grep iptables-persistent dnsutils whiptail net-tools bsdmainutils) +BASE_DEPS=(git tar wget grep dnsutils whiptail net-tools bsdmainutils) # Dependencies that where actually installed by the script. For example if the script requires # grep and dnsutils but dnsutils is already installed, we save grep here. This way when uninstalling # PiVPN we won't prompt to remove packages that may have been installed by the user for other reasons TO_INSTALL=() -pivpnGitUrl="https://github.com/pivpn/pivpn.git" easyrsaVer="3.0.6" easyrsaRel="https://github.com/OpenVPN/easy-rsa/releases/download/v${easyrsaVer}/EasyRSA-unix-v${easyrsaVer}.tgz" subnetClass="24" +dhcpcdFile="/etc/dhcpcd.conf" +debianOvpnUserGroup="openvpn:openvpn" # Raspbian's unattended-upgrades package downloads Debian's config, so this is the link for the proper config -UNATTUPG_RELEASE="1.14" +UNATTUPG_RELEASE="1.16" UNATTUPG_CONFIG="https://github.com/mvo5/unattended-upgrades/archive/${UNATTUPG_RELEASE}.tar.gz" # Find the rows and columns. Will default to 80x24 if it can not be detected. @@ -47,7 +47,10 @@ screen_size=$(stty size 2>/dev/null || echo 24 80) rows=$(echo "$screen_size" | awk '{print $1}') columns=$(echo "$screen_size" | awk '{print $2}') +######## Undocumented Flags. Shhh ######## runUnattended=false +skipSpaceCheck=false +reconfigure=false # Divide by two so the dialogs take up half of the screen, which looks nice. r=$(( rows / 2 )) @@ -57,11 +60,170 @@ r=$(( r < 20 ? 20 : r )) c=$(( c < 70 ? 70 : c )) # Find IP used to route to outside world -IPv4addr=$(ip route get 8.8.8.8| awk '{print $7}') +IPv4addr=$(ip route get 8.8.8.8 | awk '{print $7}') IPv4gw=$(ip route get 8.8.8.8 | awk '{print $3}') - availableInterfaces=$(ip -o link | grep "state UP" | awk '{print $2}' | cut -d':' -f1 | cut -d'@' -f1) -dhcpcdFile=/etc/dhcpcd.conf + +######## SCRIPT ############ + +main(){ + + ######## FIRST CHECK ######## + # Must be root to install + echo ":::" + if [[ $EUID -eq 0 ]];then + echo "::: You are root." + else + echo "::: sudo will be used for the install." + # Check if it is actually installed + # If it isn't, exit because the install cannot complete + if [[ $(dpkg-query -s sudo) ]];then + export SUDO="sudo" + export SUDOE="sudo -E" + else + echo "::: Please install sudo or run this as root." + exit 1 + fi + fi + + # Check arguments for the undocumented flags + for var in "$@"; do + case "$var" in + "--i_do_not_follow_recommendations" ) skipSpaceCheck=false;; + "--unattended" ) runUnattended=true;; + "--reconfigure" ) reconfigure=true;; + esac + done + + if [[ "${runUnattended}" == true ]]; then + echo "::: --unattended passed to install script, no whiptail dialogs will be displayed" + if [ -z "$2" ]; then + echo "::: No configuration file passed, using default settings..." + else + if [ -r "$2" ]; then + # shellcheck disable=SC1090 + source "$2" + else + echo "::: Can't open $2" + exit 1 + fi + fi + fi + + if [ -r "$setupVars" ]; then + if [[ "${reconfigure}" == true ]]; then + echo "::: --reconfigure passed to install script, will reinstall PiVPN overwriting existing settings" + UpdateCmd="Reconfigure" + elif [[ "${runUnattended}" == true ]]; then + ### What should the script do when passing --unattended to an existing installation? + UpdateCmd="Reconfigure" + else + askAboutExistingInstall + fi + fi + + if [ -z "$UpdateCmd" ] || [ "$UpdateCmd" = "Reconfigure" ]; then + : + elif [ "$UpdateCmd" = "Update" ]; then + ### To do: test the update script and implement update for WireGuard as well + $SUDO /opt/pivpn/update.sh + elif [ "$UpdateCmd" = "Repair" ]; then + source "$setupVars" + runUnattended=true + fi + + # Check for supported distribution + distroCheck + + # Checks for hostname Length + checkHostname + + # Start the installer + # Verify there is enough disk space for the install + if [[ "${skipSpaceCheck}" == true ]]; then + echo "::: --i_do_not_follow_recommendations passed to script, skipping free disk space verification!" + else + verifyFreeDiskSpace + fi + + updatePackageCache + + # Notify user of package availability + notifyPackageUpdatesAvailable + + # Install packages used by this installation script + preconfigurePackages + installDependentPackages BASE_DEPS[@] + + # Display welcome dialogs + welcomeDialogs + + # Find interfaces and let the user choose one + chooseInterface + + if [ "$PLAT" != "Raspbian" ]; then + avoidStaticIPv4Ubuntu + else + getStaticIPv4Settings + setStaticIPv4 + fi + + # Choose the user for the ovpns + chooseUser + + # Clone/Update the repos + cloneOrUpdateRepos + + # Install + if installPiVPN; then + echo "::: Install Complete..." + else + exit 1 + fi + + # Start services + restartServices + + # Ask if unattended-upgrades will be enabled + askUnattendedUpgrades + + if [ "$UNATTUPG" -eq 1 ]; then + confUnattendedUpgrades + fi + + # Save installation setting to the final location + echo "TO_INSTALL=(${TO_INSTALL[*]})" >> /tmp/setupVars.conf + $SUDO cp /tmp/setupVars.conf "$setupVars" + + installScripts + + # Ensure that cached writes reach persistent storage + echo "::: Flushing writes to disk..." + sync + echo "::: done." + + displayFinalMessage + echo ":::" +} + +askAboutExistingInstall(){ + opt1a="Update" + opt1b="Get the latest PiVPN scripts" + + opt2a="Repair" + opt2b="Reinstall PiVPN using existing settings" + + opt3a="Reconfigure" + opt3b="Reinstall PiVPN with new settings" + + UpdateCmd=$(whiptail --title "Existing Install Detected!" --menu "\nWe have detected an existing install.\n\nPlease choose from the following options:" ${r} ${c} 3 \ + "${opt1a}" "${opt1b}" \ + "${opt2a}" "${opt2b}" \ + "${opt3a}" "${opt3b}" 3>&2 2>&1 1>&3) || \ + { echo "::: Cancel selected. Exiting"; exit 1; } + + echo "::: ${opt1a} option selected." +} # Next see if we are on a tested and supported OS noOSSupport(){ @@ -253,9 +415,9 @@ notifyPackageUpdatesAvailable(){ preconfigurePackages(){ # Add support for https repositories if there are any that use it otherwise the installation will silently fail if [[ -f /etc/apt/sources.list ]]; then - if grep -q https /etc/apt/sources.list; then - BASE_DEPS+=("apt-transport-https") - fi + if grep -q https /etc/apt/sources.list; then + BASE_DEPS+=("apt-transport-https") + fi fi if [[ ${OSCN} == "buster" ]]; then @@ -263,8 +425,24 @@ preconfigurePackages(){ $SUDO update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy fi - echo iptables-persistent iptables-persistent/autosave_v4 boolean true | $SUDO debconf-set-selections - echo iptables-persistent iptables-persistent/autosave_v6 boolean false | $SUDO debconf-set-selections + # if ufw is enabled, configure that (running as root because sometimes the executable is not in the user's $PATH, on Debian for example) + if $SUDO bash -c 'hash ufw' 2>/dev/null; then + if LANG=en_US.UTF-8 $SUDO ufw status | grep -q inactive; then + USING_UFW=0 + else + USING_UFW=1 + fi + else + USING_UFW=0 + fi + + if [ "$USING_UFW" -eq 0 ]; then + BASE_DEPS+=(iptables-persistent) + echo iptables-persistent iptables-persistent/autosave_v4 boolean true | $SUDO debconf-set-selections + echo iptables-persistent iptables-persistent/autosave_v6 boolean false | $SUDO debconf-set-selections + fi + + echo "USING_UFW=${USING_UFW}" >> /tmp/setupVars.conf } installDependentPackages(){ @@ -389,7 +567,7 @@ validIP(){ if [[ $ip =~ ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$ ]]; then OIFS=$IFS IFS='.' - read -r -a ip <<< "$ip" + read -r -a ip <<< "$ip" IFS=$OIFS [[ ${ip[0]} -le 255 && ${ip[1]} -le 255 \ && ${ip[2]} -le 255 && ${ip[3]} -le 255 ]] @@ -613,20 +791,24 @@ isRepo(){ } updateRepo(){ - # Pull the latest commits - echo -n "::: Updating repo in $1..." - $SUDO rm -rf "${1}" - # Go back to /etc otherwise git will complain when the current working - # directory has just been deleted (/etc/.pivpn). - cd /etc && \ - $SUDO git clone -q --depth 1 --no-single-branch "${2}" "${1}" > /dev/null & spinner $! - cd "${1}" || exit 1 - if [ -z "${TESTING+x}" ]; then - : + if [ "${UpdateCmd}" = "Repair" ]; then + echo "::: Repairing an existing installation, not downloading/updating local repos" else - ${SUDOE} git checkout test + # Pull the latest commits + echo -n "::: Updating repo in $1..." + $SUDO rm -rf "${1}" + # Go back to /etc otherwise git will complain when the current working + # directory has just been deleted (/etc/.pivpn). + cd /etc && \ + $SUDO git clone -q --depth 1 --no-single-branch "${2}" "${1}" > /dev/null & spinner $! + cd "${1}" || exit 1 + if [ -z "${TESTING+x}" ]; then + : + else + ${SUDOE} git checkout test + fi + echo " done!" fi - echo " done!" } makeRepo(){ @@ -640,7 +822,7 @@ makeRepo(){ # Go back to /etc otherwhise git will complain when the current working # directory has just been deleted (/etc/.pivpn). cd /etc && \ - $SUDO git clone -q --depth 1 --no-single-branch "${2}" "${1}" > /dev/null & spinner $! + $SUDO git clone -q --depth 1 --no-single-branch "${2}" "${1}" > /dev/null & spinner $! cd "${1}" || exit 1 if [ -z "${TESTING+x}" ]; then : @@ -744,29 +926,25 @@ installWireGuard(){ elif [ "$(uname -m)" = "armv6l" ]; then echo "::: Installing WireGuard from source... " - PIVPN_DEPS=(checkinstall dkms libmnl-dev libelf-dev raspberrypi-kernel-headers build-essential pkg-config qrencode jq) + PIVPN_DEPS=(checkinstall dkms libmnl-dev libelf-dev raspberrypi-kernel-headers build-essential pkg-config qrencode jq bc) installDependentPackages PIVPN_DEPS[@] - WG_SNAPSHOT="$(curl -s https://build.wireguard.com/distros.json | jq -r '."upstream-kmodtools"."version"')" - WG_SOURCE="https://git.zx2c4.com/WireGuard/snapshot/WireGuard-${WG_SNAPSHOT}.tar.xz" - # Delete any leftover code $SUDO rm -rf /usr/src/wireguard-* - echo "::: Downloading source code... " - wget -qO- "${WG_SOURCE}" | $SUDO tar Jxf - --directory /usr/src + WG_TOOLS_SNAPSHOT="$(curl -s https://build.wireguard.com/distros.json | jq -r '."upstream-tools"."version"')" + WG_TOOLS_SOURCE="https://git.zx2c4.com/wireguard-tools/snapshot/wireguard-tools-${WG_TOOLS_SNAPSHOT}.tar.xz" + + echo "::: Downloading wireguard-tools source code... " + wget -qO- "${WG_TOOLS_SOURCE}" | $SUDO tar Jxf - --directory /usr/src echo "done!" - cd /usr/src && \ - $SUDO mv WireGuard-"${WG_SNAPSHOT}" wireguard-"${WG_SNAPSHOT}" - cd wireguard-"${WG_SNAPSHOT}" && \ - $SUDO mv src/* . && \ - $SUDO rmdir src + cd /usr/src/wireguard-tools-"${WG_TOOLS_SNAPSHOT}/src" # We install the userspace tools manually since DKMS only compiles and # installs the kernel module echo "::: Compiling WireGuard tools... " - if $SUDO make tools; then + if $SUDO make; then echo "done!" else echo "failed!" @@ -777,7 +955,7 @@ installWireGuard(){ # PiVPN we can just do apt remove wireguard-tools, instead of manually removing # files from the file system echo "::: Installing WireGuard tools... " - if $SUDO checkinstall --pkgname wireguard-tools --pkgversion "${WG_SNAPSHOT}" -y make tools-install; then + if $SUDO checkinstall --pkgname wireguard-tools --pkgversion "${WG_TOOLS_SNAPSHOT}" -y; then TO_INSTALL+=("wireguard-tools") echo "done!" else @@ -785,35 +963,52 @@ installWireGuard(){ exit 1 fi + echo "WG_TOOLS_SNAPSHOT=${WG_TOOLS_SNAPSHOT}" >> /tmp/setupVars.conf + + WG_MODULE_SNAPSHOT="$(curl -s https://build.wireguard.com/distros.json | jq -r '."upstream-linuxcompat"."version"')" + WG_MODULE_SOURCE="https://git.zx2c4.com/wireguard-linux-compat/snapshot/wireguard-linux-compat-${WG_MODULE_SNAPSHOT}.tar.xz" + + echo "::: Downloading wireguard-linux-compat source code... " + wget -qO- "${WG_MODULE_SOURCE}" | $SUDO tar Jxf - --directory /usr/src + echo "done!" + + # Rename wireguard-linux-compat folder and move the source code to the parent folder + # such that dkms picks up the module when referencing wireguard/"${WG_MODULE_SNAPSHOT}" + cd /usr/src && \ + $SUDO mv wireguard-linux-compat-"${WG_MODULE_SNAPSHOT}" wireguard-"${WG_MODULE_SNAPSHOT}" + cd wireguard-"${WG_MODULE_SNAPSHOT}" && \ + $SUDO mv src/* . && \ + $SUDO rmdir src + echo "::: Adding WireGuard modules via DKMS... " - if $SUDO dkms add wireguard/"${WG_SNAPSHOT}"; then + if $SUDO dkms add wireguard/"${WG_MODULE_SNAPSHOT}"; then echo "done!" else echo "failed!" - $SUDO dkms remove wireguard/"${WG_SNAPSHOT}" --all + $SUDO dkms remove wireguard/"${WG_MODULE_SNAPSHOT}" --all exit 1 fi echo "::: Compiling WireGuard modules via DKMS... " - if $SUDO dkms build wireguard/"${WG_SNAPSHOT}"; then + if $SUDO dkms build wireguard/"${WG_MODULE_SNAPSHOT}"; then echo "done!" else echo "failed!" - $SUDO dkms remove wireguard/"${WG_SNAPSHOT}" --all + $SUDO dkms remove wireguard/"${WG_MODULE_SNAPSHOT}" --all exit 1 fi echo "::: Installing WireGuard modules via DKMS... " - if $SUDO dkms install wireguard/"${WG_SNAPSHOT}"; then + if $SUDO dkms install wireguard/"${WG_MODULE_SNAPSHOT}"; then TO_INSTALL+=("wireguard-dkms") echo "done!" else echo "failed!" - $SUDO dkms remove wireguard/"${WG_SNAPSHOT}" --all + $SUDO dkms remove wireguard/"${WG_MODULE_SNAPSHOT}" --all exit 1 fi - echo "WG_SNAPSHOT=${WG_SNAPSHOT}" >> /tmp/setupVars.conf + echo "WG_MODULE_SNAPSHOT=${WG_MODULE_SNAPSHOT}" >> /tmp/setupVars.conf fi @@ -989,9 +1184,9 @@ askClientDNS(){ DNSChoseCmd=(whiptail --separate-output --radiolist "Select the DNS Provider for your VPN Clients (press space to select). To use your own, select - Custom.\\n\\nIn case you have a local resolver running, i.e. unbound, select - \"PiVPN-is-local-DNS\" and make sure your resolver is listening on - \"$vpnGw\", allowing requests from \"${pivpnNET}/${subnetClass}\"." ${r} ${c} 6) + Custom.\\n\\nIn case you have a local resolver running, i.e. unbound, select + \"PiVPN-is-local-DNS\" and make sure your resolver is listening on + \"$vpnGw\", allowing requests from \"${pivpnNET}/${subnetClass}\"." ${r} ${c} 6) DNSChooseOptions=(Google "" on OpenDNS "" off Level3 "" off @@ -1075,7 +1270,7 @@ validDomain(){ local stat=1 if [[ $domain =~ ^(([a-zA-Z0-9]{1,63}|([a-zA-Z0-9]{1,60}[-a-zA-Z0-9()]{0,2}[a-zA-Z0-9]{1,60}))\.){1,6}([a-zA-Z]{2,})$ ]]; then - stat=$? + stat=$? fi return $stat } @@ -1309,7 +1504,7 @@ set_var EASYRSA_KEY_SIZE ${pivpnENCRYPT}" | $SUDO tee vars >/dev/null ${SUDOE} ./easyrsa gen-crl ${SUDOE} cp pki/crl.pem /etc/openvpn/crl.pem if ! getent passwd openvpn; then - ${SUDOE} adduser --system --home /var/lib/openvpn/ --group --disabled-login ${debianOvpnUserGroup%:*} + ${SUDOE} adduser --system --home /var/lib/openvpn/ --group --disabled-login ${debianOvpnUserGroup%:*} fi ${SUDOE} chown "$debianOvpnUserGroup" /etc/openvpn/crl.pem @@ -1390,6 +1585,12 @@ confWireGuard(){ else whiptail --title "Server Information" --msgbox "The Server Keys and Pre-Shared key will now be generated." "${r}" "${c}" fi + + # Remove configs and keys folders to make space for a new server when using 'Repair' or 'Reconfigure' + # over an existing installation + $SUDO rm -rf /etc/wireguard/configs + $SUDO rm -rf /etc/wireguard/keys + $SUDO mkdir -p /etc/wireguard/configs $SUDO touch /etc/wireguard/configs/clients.txt $SUDO mkdir -p /etc/wireguard/keys @@ -1413,45 +1614,42 @@ confNetwork(){ $SUDO sed -i '/net.ipv4.ip_forward=1/s/^#//g' /etc/sysctl.conf $SUDO sysctl -p > /dev/null - # if ufw enabled, configure that (running as root because sometimes the executable is not in the user's $PATH, on Debian for example) - if $SUDO bash -c 'hash ufw' 2>/dev/null; then - if LANG=en_US.UTF-8 $SUDO ufw status | grep -q inactive - then - USING_UFW=0 - else - USING_UFW=1 - echo "::: Detected UFW is enabled." - echo "::: Adding UFW rules..." - ### Basic safeguard: if file is empty, there's been something weird going on. - ### Note: no safeguard against imcomplete content as a result of previous failures. - if test -s /etc/ufw/before.rules; then - $SUDO cp -f /etc/ufw/before.rules /etc/ufw/before.rules.pre-pivpn - else - echo "$0: ERR: Sorry, won't touch empty file \"/etc/ufw/before.rules\"."; - exit 1; - fi - ### If there is already a "*nat" section just add our POSTROUTING MASQUERADE - if $SUDO grep -q "*nat" /etc/ufw/before.rules; then - $SUDO sed "/^*nat/{n;s/\(:POSTROUTING ACCEPT .*\)/\1\n-I POSTROUTING -s ${pivpnNET}\/${subnetClass} -o ${IPv4dev} -j MASQUERADE/}" -i /etc/ufw/before.rules - else - $SUDO sed "/delete these required/i *nat\n:POSTROUTING ACCEPT [0:0]\n-I POSTROUTING -s ${pivpnNET}\/${subnetClass} -o ${IPv4dev} -j MASQUERADE\nCOMMIT\n" -i /etc/ufw/before.rules - fi - # Insert rules at the beginning of the chain (in case there are other rules that may drop the traffic) - $SUDO ufw insert 1 allow "${pivpnPORT}"/"${pivpnPROTO}" >/dev/null - $SUDO ufw route insert 1 allow in on "${pivpnDEV}" from "${pivpnNET}/${subnetClass}" out on "${IPv4dev}" to any >/dev/null + if [ "$USING_UFW" -eq 1 ]; then - $SUDO ufw reload >/dev/null - echo "::: UFW configuration completed." + echo "::: Detected UFW is enabled." + echo "::: Adding UFW rules..." + ### Basic safeguard: if file is empty, there's been something weird going on. + ### Note: no safeguard against imcomplete content as a result of previous failures. + if test -s /etc/ufw/before.rules; then + $SUDO cp -f /etc/ufw/before.rules /etc/ufw/before.rules.pre-pivpn + else + echo "$0: ERR: Sorry, won't touch empty file \"/etc/ufw/before.rules\"."; + exit 1; fi - else - USING_UFW=0 - fi - # else configure iptables - if [[ $USING_UFW -eq 0 ]]; then + ### If there is already a "*nat" section just add our POSTROUTING MASQUERADE + if $SUDO grep -q "*nat" /etc/ufw/before.rules; then + ### Onyl add the NAT rule if it isn't already there + if ! $SUDO grep -q "${VPN}-nat-rule" /etc/ufw/before.rules; then + $SUDO sed "/^*nat/{n;s/\(:POSTROUTING ACCEPT .*\)/\1\n-I POSTROUTING -s ${pivpnNET}\/${subnetClass} -o ${IPv4dev} -j MASQUERADE -m comment --comment ${VPN}-nat-rule/}" -i /etc/ufw/before.rules + fi + else + $SUDO sed "/delete these required/i *nat\n:POSTROUTING ACCEPT [0:0]\n-I POSTROUTING -s ${pivpnNET}\/${subnetClass} -o ${IPv4dev} -j MASQUERADE -m comment --comment ${VPN}-nat-rule\nCOMMIT\n" -i /etc/ufw/before.rules + fi + # Insert rules at the beginning of the chain (in case there are other rules that may drop the traffic) + $SUDO ufw insert 1 allow "${pivpnPORT}"/"${pivpnPROTO}" >/dev/null + $SUDO ufw route insert 1 allow in on "${pivpnDEV}" from "${pivpnNET}/${subnetClass}" out on "${IPv4dev}" to any >/dev/null + + $SUDO ufw reload >/dev/null + echo "::: UFW configuration completed." + + elif [ "$USING_UFW" -eq 0 ]; then + # Now some checks to detect which rules we need to add. On a newly installed system all policies # should be ACCEPT, so the only required rule would be the MASQUERADE one. - $SUDO iptables -t nat -I POSTROUTING -s "${pivpnNET}/${subnetClass}" -o "${IPv4dev}" -j MASQUERADE + if ! $SUDO iptables -t nat -S | grep -q "${VPN}-nat-rule"; then + $SUDO iptables -t nat -I POSTROUTING -s "${pivpnNET}/${subnetClass}" -o "${IPv4dev}" -j MASQUERADE -m comment --comment "${VPN}-nat-rule" + fi # Count how many rules are in the INPUT and FORWARD chain. When parsing input from # iptables -S, '^-P' skips the policies and 'ufw-' skips ufw chains (in case ufw was found @@ -1470,15 +1668,23 @@ confNetwork(){ # chain (using -I). if [ "$INPUT_RULES_COUNT" -ne 0 ] || [ "$INPUT_POLICY" != "ACCEPT" ]; then - $SUDO iptables -I INPUT 1 -i "${IPv4dev}" -p "${pivpnPROTO}" --dport "${pivpnPORT}" -j ACCEPT + if $SUDO iptables -t nat -S | grep -q "${VPN}-input-rule"; then + INPUT_CHAIN_EDITED=0 + else + $SUDO iptables -I INPUT 1 -i "${IPv4dev}" -p "${pivpnPROTO}" --dport "${pivpnPORT}" -j ACCEPT -m comment --comment "${VPN}-input-rule" + fi INPUT_CHAIN_EDITED=1 else INPUT_CHAIN_EDITED=0 fi if [ "$FORWARD_RULES_COUNT" -ne 0 ] || [ "$FORWARD_POLICY" != "ACCEPT" ]; then - $SUDO iptables -I FORWARD 1 -d "${pivpnNET}/${subnetClass}" -i "${IPv4dev}" -o "${pivpnDEV}" -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT - $SUDO iptables -I FORWARD 2 -s "${pivpnNET}/${subnetClass}" -i "${pivpnDEV}" -o "${IPv4dev}" -j ACCEPT + if $SUDO iptables -t nat -S | grep -q "${VPN}-forward-rule"; then + FORWARD_CHAIN_EDITED=0 + else + $SUDO iptables -I FORWARD 1 -d "${pivpnNET}/${subnetClass}" -i "${IPv4dev}" -o "${pivpnDEV}" -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT -m comment --comment "${VPN}-forward-rule" + $SUDO iptables -I FORWARD 2 -s "${pivpnNET}/${subnetClass}" -i "${pivpnDEV}" -o "${IPv4dev}" -j ACCEPT -m comment --comment "${VPN}-forward-rule" + fi FORWARD_CHAIN_EDITED=1 else FORWARD_CHAIN_EDITED=0 @@ -1492,9 +1698,8 @@ confNetwork(){ echo "INPUT_CHAIN_EDITED=${INPUT_CHAIN_EDITED}" >> /tmp/setupVars.conf echo "FORWARD_CHAIN_EDITED=${FORWARD_CHAIN_EDITED}" >> /tmp/setupVars.conf - fi - echo "USING_UFW=${USING_UFW}" >> /tmp/setupVars.conf + fi } confLogging() { @@ -1549,6 +1754,21 @@ installPiVPN(){ fi } +restartServices(){ + echo "::: Restarting services..." + case ${PLAT} in + Debian|Raspbian|Ubuntu) + if [ "$VPN" = "openvpn" ]; then + $SUDO systemctl enable openvpn.service &> /dev/null + $SUDO systemctl restart openvpn.service + elif [ "$VPN" = "wireguard" ]; then + $SUDO systemctl enable wg-quick@wg0.service &> /dev/null + $SUDO systemctl restart wg-quick@wg0.service + fi + ;; + esac +} + askUnattendedUpgrades(){ if [ "${runUnattended}" = 'true' ]; then if [ -z "$UNATTUPG" ]; then @@ -1667,134 +1887,4 @@ All incomplete posts or bug reports will be ignored or deleted.\\n\\nThank you f fi } -######## SCRIPT ############ - -main(){ - - ######## FIRST CHECK ######## - # Must be root to install - echo ":::" - if [[ $EUID -eq 0 ]];then - echo "::: You are root." - else - echo "::: sudo will be used for the install." - # Check if it is actually installed - # If it isn't, exit because the install cannot complete - if [[ $(dpkg-query -s sudo) ]];then - export SUDO="sudo" - export SUDOE="sudo -E" - else - echo "::: Please install sudo or run this as root." - exit 1 - fi - fi - - # Check arguments for the undocumented flags - for var in "$@"; do - case "$var" in - "--i_do_not_follow_recommendations" ) skipSpaceCheck=false;; - "--unattended" ) runUnattended=true;; - esac - done - - # Check for supported distribution - distroCheck - - # Checks for hostname Length - checkHostname - - if [[ "${runUnattended}" == true ]]; then - echo "::: --unattended passed to install script, no whiptail dialogs will be displayed" - if [ -z "$2" ]; then - echo "::: No configuration file passed, using default settings..." - else - if [ -r "$2" ]; then - # shellcheck disable=SC1090 - source "$2" - else - echo "::: Can't open $2" - exit 1 - fi - fi - fi - - # Start the installer - # Verify there is enough disk space for the install - if [[ "${skipSpaceCheck}" == true ]]; then - echo "::: --i_do_not_follow_recommendations passed to script, skipping free disk space verification!" - else - verifyFreeDiskSpace - fi - - updatePackageCache - - # Notify user of package availability - notifyPackageUpdatesAvailable - - # Install packages used by this installation script - preconfigurePackages - installDependentPackages BASE_DEPS[@] - - # Display welcome dialogs - welcomeDialogs - - # Find interfaces and let the user choose one - chooseInterface - - if [ "$PLAT" != "Raspbian" ]; then - avoidStaticIPv4Ubuntu - else - getStaticIPv4Settings - setStaticIPv4 - fi - - # Choose the user for the ovpns - chooseUser - - # Clone/Update the repos - cloneOrUpdateRepos - - # Install - if installPiVPN; then - echo "::: Install Complete..." - else - exit 1 - fi - - echo "::: Restarting services..." - # Start services - case ${PLAT} in - Debian|Raspbian|Ubuntu) - if [ "$VPN" = "openvpn" ]; then - $SUDO systemctl enable openvpn.service &> /dev/null - $SUDO systemctl start openvpn.service - elif [ "$VPN" = "wireguard" ]; then - $SUDO systemctl enable wg-quick@wg0.service &> /dev/null - $SUDO systemctl start wg-quick@wg0.service - fi - ;; - esac - - # Ask if unattended-upgrades will be enabled - askUnattendedUpgrades - - if [ "$UNATTUPG" -eq 1 ]; then - confUnattendedUpgrades - fi - - # Save installation setting to the final location - echo "TO_INSTALL=(${TO_INSTALL[*]})" >> /tmp/setupVars.conf - $SUDO cp /tmp/setupVars.conf "$setupVars" - - installScripts - - # Ensure that cached writes reach persistent storage - echo "::: Flushing writes to disk..." - sync - echo "::: done." - - displayFinalMessage - echo ":::" -} - main "$@" diff --git a/scripts/openvpn/pivpnDebug.sh b/scripts/openvpn/pivpnDebug.sh index bc14f8f..df4e938 100755 --- a/scripts/openvpn/pivpnDebug.sh +++ b/scripts/openvpn/pivpnDebug.sh @@ -52,29 +52,27 @@ fi if [ "$USING_UFW" -eq 0 ]; then - if iptables -t nat -C POSTROUTING -s 10.8.0.0/24 -o "${IPv4dev}" -j MASQUERADE &> /dev/null; then + if iptables -t nat -C POSTROUTING -s 10.8.0.0/24 -o "${IPv4dev}" -j MASQUERADE -m comment --comment "${VPN}-nat-rule" &> /dev/null; then echo ":: [OK] Iptables MASQUERADE rule set" else ERR=1 read -r -p ":: [ERR] Iptables MASQUERADE rule is not set, attempt fix now? [Y/n] " REPLY if [[ ${REPLY} =~ ^[Yy]$ ]] || [[ -z ${REPLY} ]]; then - iptables -t nat -F - iptables -t nat -I POSTROUTING -s 10.8.0.0/24 -o "${IPv4dev}" -j MASQUERADE + iptables -t nat -I POSTROUTING -s 10.8.0.0/24 -o "${IPv4dev}" -j MASQUERADE -m comment --comment "${VPN}-nat-rule" iptables-save > /etc/iptables/rules.v4 echo "Done" fi fi - if [ "$INPUT_CHAIN_EDITED" -eq 1 ]; then - if iptables -C INPUT -i "$IPv4dev" -p "$pivpnPROTO" --dport "$pivpnPORT" -j ACCEPT &> /dev/null; then + if iptables -C INPUT -i "$IPv4dev" -p "$pivpnPROTO" --dport "$pivpnPORT" -j ACCEPT -m comment --comment "${VPN}-input-rule" &> /dev/null; then echo ":: [OK] Iptables INPUT rule set" else ERR=1 read -r -p ":: [ERR] Iptables INPUT rule is not set, attempt fix now? [Y/n] " REPLY if [[ ${REPLY} =~ ^[Yy]$ ]] || [[ -z ${REPLY} ]]; then - iptables -I INPUT 1 -i "$IPv4dev" -p "$pivpnPROTO" --dport "$pivpnPORT" -j ACCEPT + iptables -I INPUT 1 -i "$IPv4dev" -p "$pivpnPROTO" --dport "$pivpnPORT" -j ACCEPT -m comment --comment "${VPN}-input-rule" iptables-save > /etc/iptables/rules.v4 echo "Done" fi @@ -83,14 +81,14 @@ if [ "$USING_UFW" -eq 0 ]; then if [ "$FORWARD_CHAIN_EDITED" -eq 1 ]; then - if iptables -C FORWARD -s 10.8.0.0/24 -i tun0 -o "$IPv4dev" -j ACCEPT &> /dev/null; then + if iptables -C FORWARD -s 10.8.0.0/24 -i tun0 -o "$IPv4dev" -j ACCEPT -m comment --comment "${VPN}-forward-rule" &> /dev/null; then echo ":: [OK] Iptables FORWARD rule set" else ERR=1 read -r -p ":: [ERR] Iptables FORWARD rule is not set, attempt fix now? [Y/n] " REPLY if [[ ${REPLY} =~ ^[Yy]$ ]] || [[ -z ${REPLY} ]]; then - iptables -I FORWARD 1 -d 10.8.0.0/24 -i "$IPv4dev" -o tun0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT - iptables -I FORWARD 2 -s 10.8.0.0/24 -i tun0 -o "$IPv4dev" -j ACCEPT + iptables -I FORWARD 1 -d 10.8.0.0/24 -i "$IPv4dev" -o tun0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT -m comment --comment "${VPN}-forward-rule" + iptables -I FORWARD 2 -s 10.8.0.0/24 -i tun0 -o "$IPv4dev" -j ACCEPT -m comment --comment "${VPN}-forward-rule" iptables-save > /etc/iptables/rules.v4 echo "Done" fi @@ -109,13 +107,13 @@ else fi fi - if iptables -t nat -C POSTROUTING -s 10.8.0.0/24 -o "${IPv4dev}" -j MASQUERADE &> /dev/null; then + if iptables -t nat -C POSTROUTING -s 10.8.0.0/24 -o "${IPv4dev}" -j MASQUERADE -m comment --comment "${VPN}-nat-rule" &> /dev/null; then echo ":: [OK] Iptables MASQUERADE rule set" else ERR=1 read -r -p ":: [ERR] Iptables MASQUERADE rule is not set, attempt fix now? [Y/n] " REPLY if [[ ${REPLY} =~ ^[Yy]$ ]] || [[ -z ${REPLY} ]]; then - sed "/delete these required/i *nat\n:POSTROUTING ACCEPT [0:0]\n-I POSTROUTING -s 10.8.0.0/24 -o $IPv4dev -j MASQUERADE\nCOMMIT\n" -i /etc/ufw/before.rules + sed "/delete these required/i *nat\n:POSTROUTING ACCEPT [0:0]\n-I POSTROUTING -s 10.8.0.0/24 -o $IPv4dev -j MASQUERADE -m comment --comment ${VPN}-nat-rule\nCOMMIT\n" -i /etc/ufw/before.rules ufw reload echo "Done" fi diff --git a/scripts/uninstall.sh b/scripts/uninstall.sh index 552fecc..203aaa0 100755 --- a/scripts/uninstall.sh +++ b/scripts/uninstall.sh @@ -74,22 +74,22 @@ removeAll(){ ufw delete allow "${pivpnPORT}"/"${pivpnPROTO}" > /dev/null ### FIXME: SC2154 ufw route delete allow in on "${pivpnDEV}" from "${pivpnNET}/${subnetClass}" out on "${IPv4dev}" to any > /dev/null - sed -z "s/*nat\\n:POSTROUTING ACCEPT \\[0:0\\]\\n-I POSTROUTING -s ${pivpnNET}\\/${subnetClass} -o ${IPv4dev} -j MASQUERADE\\nCOMMIT\\n\\n//" -i /etc/ufw/before.rules - iptables -t nat -D POSTROUTING -s "${pivpnNET}/${subnetClass}" -o "${IPv4dev}" -j MASQUERADE + sed -z "s/*nat\\n:POSTROUTING ACCEPT \\[0:0\\]\\n-I POSTROUTING -s ${pivpnNET}\\/${subnetClass} -o ${IPv4dev} -j MASQUERADE -m comment --comment ${VPN}-nat-rule\\nCOMMIT\\n\\n//" -i /etc/ufw/before.rules + iptables -t nat -D POSTROUTING -s "${pivpnNET}/${subnetClass}" -o "${IPv4dev}" -j MASQUERADE -m comment --comment "${VPN}-nat-rule" ufw reload &> /dev/null elif [ "$USING_UFW" -eq 0 ]; then if [ "$INPUT_CHAIN_EDITED" -eq 1 ]; then - iptables -D INPUT -i "${IPv4dev}" -p "${pivpnPROTO}" --dport "${pivpnPORT}" -j ACCEPT + iptables -D INPUT -i "${IPv4dev}" -p "${pivpnPROTO}" --dport "${pivpnPORT}" -j ACCEPT -m comment --comment "${VPN}-input-rule" fi if [ "$FORWARD_CHAIN_EDITED" -eq 1 ]; then - iptables -D FORWARD -d "${pivpnNET}/${subnetClass}" -i "${IPv4dev}" -o "${pivpnDEV}" -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT - iptables -D FORWARD -s "${pivpnNET}/${subnetClass}" -i "${pivpnDEV}" -o "${IPv4dev}" -j ACCEPT + iptables -D FORWARD -d "${pivpnNET}/${subnetClass}" -i "${IPv4dev}" -o "${pivpnDEV}" -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT -m comment --comment "${VPN}-forward-rule" + iptables -D FORWARD -s "${pivpnNET}/${subnetClass}" -i "${pivpnDEV}" -o "${IPv4dev}" -j ACCEPT -m comment --comment "${VPN}-forward-rule" fi - iptables -t nat -D POSTROUTING -s "${pivpnNET}/${subnetClass}" -o "${IPv4dev}" -j MASQUERADE + iptables -t nat -D POSTROUTING -s "${pivpnNET}/${subnetClass}" -o "${IPv4dev}" -j MASQUERADE -m comment --comment "${VPN}-nat-rule" iptables-save > /etc/iptables/rules.v4 fi @@ -123,11 +123,17 @@ removeAll(){ # On armv6l Raspbian we manually remove the kernel module and skip the apt # uninstallation (since it's not an actual package). if [ "$PLAT" = "Raspbian" ] && [ "$(uname -m)" = "armv6l" ]; then - dkms remove wireguard/"${WG_SNAPSHOT}" --all - rm -rf /usr/src/wireguard-* + dkms remove wireguard/"${WG_MODULE_SNAPSHOT}" --all + rm -rf /usr/src/wireguard-"${WG_MODULE_SNAPSHOT}" break fi + elif [ "${i}" = "wireguard-tools" ]; then + + if [ "$PLAT" = "Raspbian" ] && [ "$(uname -m)" = "armv6l" ]; then + rm -rf /usr/src/wireguard-tools-"${WG_TOOLS_SNAPSHOT}" + fi + elif [ "${i}" = "dirmngr" ]; then # If dirmngr was installed, then we had previously installed wireguard on armv7l Raspbian @@ -187,7 +193,7 @@ removeAll(){ ### FIXME SC2154 rm -rf "$install_home/configs" elif [ "$VPN" = "openvpn" ]; then - rm -f /var/log/*openvpn* + rm -rf /var/log/*openvpn* rm -f /etc/openvpn/server.conf rm -f /etc/openvpn/crl.pem rm -rf /etc/openvpn/easy-rsa diff --git a/scripts/wireguard/pivpnDEBUG.sh b/scripts/wireguard/pivpnDEBUG.sh index 682dd98..56d9bd5 100755 --- a/scripts/wireguard/pivpnDEBUG.sh +++ b/scripts/wireguard/pivpnDEBUG.sh @@ -63,20 +63,49 @@ fi if [ "$USING_UFW" -eq 0 ]; then - if iptables -t nat -C POSTROUTING -s 10.6.0.0/24 -o "${IPv4dev}" -j MASQUERADE &> /dev/null; then + if iptables -t nat -C POSTROUTING -s 10.6.0.0/24 -o "${IPv4dev}" -j MASQUERADE -m comment --comment "${VPN}-nat-rule" &> /dev/null; then echo ":: [OK] Iptables MASQUERADE rule set" else ERR=1 read -r -p ":: [ERR] Iptables MASQUERADE rule is not set, attempt fix now? [Y/n] " REPLY if [[ ${REPLY} =~ ^[Yy]$ ]] || [[ -z ${REPLY} ]]; then - iptables -t nat -F - iptables -t nat -I POSTROUTING -s 10.6.0.0/24 -o "${IPv4dev}" -j MASQUERADE + iptables -t nat -I POSTROUTING -s 10.6.0.0/24 -o "${IPv4dev}" -j MASQUERADE -m comment --comment "${VPN}-nat-rule" iptables-save > /etc/iptables/rules.v4 - iptables-restore < /etc/iptables/rules.v4 echo "Done" fi fi + if [ "$INPUT_CHAIN_EDITED" -eq 1 ]; then + + if iptables -C INPUT -i "$IPv4dev" -p udp --dport "$pivpnPORT" -j ACCEPT -m comment --comment "${VPN}-input-rule" &> /dev/null; then + echo ":: [OK] Iptables INPUT rule set" + else + ERR=1 + read -r -p ":: [ERR] Iptables INPUT rule is not set, attempt fix now? [Y/n] " REPLY + if [[ ${REPLY} =~ ^[Yy]$ ]] || [[ -z ${REPLY} ]]; then + iptables -I INPUT 1 -i "$IPv4dev" -p udp --dport "$pivpnPORT" -j ACCEPT -m comment --comment "${VPN}-input-rule" + iptables-save > /etc/iptables/rules.v4 + echo "Done" + fi + fi + fi + + if [ "$FORWARD_CHAIN_EDITED" -eq 1 ]; then + + if iptables -C FORWARD -s 10.6.0.0/24 -i wg0 -o "$IPv4dev" -j ACCEPT -m comment --comment "${VPN}-forward-rule" &> /dev/null; then + echo ":: [OK] Iptables FORWARD rule set" + else + ERR=1 + read -r -p ":: [ERR] Iptables FORWARD rule is not set, attempt fix now? [Y/n] " REPLY + if [[ ${REPLY} =~ ^[Yy]$ ]] || [[ -z ${REPLY} ]]; then + iptables -I FORWARD 1 -d 10.6.0.0/24 -i "$IPv4dev" -o wg0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT -m comment --comment "${VPN}-forward-rule" + iptables -I FORWARD 2 -s 10.6.0.0/24 -i wg0 -o "$IPv4dev" -j ACCEPT -m comment --comment "${VPN}-forward-rule" + iptables-save > /etc/iptables/rules.v4 + echo "Done" + fi + fi + fi + else if LANG="en_US.UTF-8" ufw status | grep -qw 'active'; then @@ -89,13 +118,13 @@ else fi fi - if iptables -t nat -C POSTROUTING -s 10.6.0.0/24 -o "${IPv4dev}" -j MASQUERADE &> /dev/null; then + if iptables -t nat -C POSTROUTING -s 10.6.0.0/24 -o "${IPv4dev}" -j MASQUERADE -m comment --comment "${VPN}-nat-rule" &> /dev/null; then echo ":: [OK] Iptables MASQUERADE rule set" else ERR=1 read -r -p ":: [ERR] Iptables MASQUERADE rule is not set, attempt fix now? [Y/n] " REPLY if [[ ${REPLY} =~ ^[Yy]$ ]] || [[ -z ${REPLY} ]]; then - sed "/delete these required/i *nat\n:POSTROUTING ACCEPT [0:0]\n-I POSTROUTING -s 10.6.0.0/24 -o $IPv4dev -j MASQUERADE\nCOMMIT\n" -i /etc/ufw/before.rules + sed "/delete these required/i *nat\n:POSTROUTING ACCEPT [0:0]\n-I POSTROUTING -s 10.6.0.0/24 -o $IPv4dev -j MASQUERADE -m comment --comment ${VPN}-nat-rule\nCOMMIT\n" -i /etc/ufw/before.rules ufw reload echo "Done" fi From a6087f8bda4429d02f5f6189a63568b8296bb28d Mon Sep 17 00:00:00 2001 From: Orazio Date: Sun, 29 Dec 2019 18:35:37 +0100 Subject: [PATCH 03/10] bc is not actually required when installing via DKMS --- auto_install/install.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/auto_install/install.sh b/auto_install/install.sh index 4d37ddf..0379e82 100755 --- a/auto_install/install.sh +++ b/auto_install/install.sh @@ -926,7 +926,7 @@ installWireGuard(){ elif [ "$(uname -m)" = "armv6l" ]; then echo "::: Installing WireGuard from source... " - PIVPN_DEPS=(checkinstall dkms libmnl-dev libelf-dev raspberrypi-kernel-headers build-essential pkg-config qrencode jq bc) + PIVPN_DEPS=(checkinstall dkms libmnl-dev libelf-dev raspberrypi-kernel-headers build-essential pkg-config qrencode jq) installDependentPackages PIVPN_DEPS[@] # Delete any leftover code From 41984e5f40e076feb3a896209ee3c1ac23c398a4 Mon Sep 17 00:00:00 2001 From: Orazio Date: Mon, 30 Dec 2019 11:44:33 +0100 Subject: [PATCH 04/10] Fix update scripts from test branch --- auto_install/install.sh | 4 ++-- scripts/{openvpn => }/update.sh | 32 +++++++++++++++++++------------ scripts/wireguard/bash-completion | 4 ++-- scripts/wireguard/pivpn | 8 ++++++++ 4 files changed, 32 insertions(+), 16 deletions(-) rename scripts/{openvpn => }/update.sh (68%) diff --git a/auto_install/install.sh b/auto_install/install.sh index 0379e82..166b501 100755 --- a/auto_install/install.sh +++ b/auto_install/install.sh @@ -125,8 +125,8 @@ main(){ if [ -z "$UpdateCmd" ] || [ "$UpdateCmd" = "Reconfigure" ]; then : elif [ "$UpdateCmd" = "Update" ]; then - ### To do: test the update script and implement update for WireGuard as well - $SUDO /opt/pivpn/update.sh + $SUDO /opt/pivpn/update.sh "$@" + exit 0 elif [ "$UpdateCmd" = "Repair" ]; then source "$setupVars" runUnattended=true diff --git a/scripts/openvpn/update.sh b/scripts/update.sh similarity index 68% rename from scripts/openvpn/update.sh rename to scripts/update.sh index 5203b65..3f63c2a 100755 --- a/scripts/openvpn/update.sh +++ b/scripts/update.sh @@ -6,7 +6,14 @@ pivpnrepo="https://github.com/pivpn/pivpn.git" pivpnlocalpath="/etc/.pivpn" pivpnscripts="/opt/pivpn/" bashcompletiondir="/etc/bash_completion.d/" +setupVars="/etc/pivpn/setupVars.conf" +if [ ! -f "${setupVars}" ]; then + echo "::: Missing setup vars file!" + exit 1 +fi + +source "${setupVars}" ###Functions ##Updates scripts @@ -16,7 +23,7 @@ updatepivpnscripts(){ echo "going do update PiVPN Scripts" if [[ -d "$pivpnlocalpath" ]]; then if [[ -n "$pivpnlocalpath" ]]; then - sudo rm -rf "${pivpnlocalpath}/../.pivpn" + rm -rf "${pivpnlocalpath}/../.pivpn" cloneandupdate fi else @@ -32,7 +39,7 @@ updatefromtest(){ echo "PiVPN Scripts updating from test branch" if [[ -d "$pivpnlocalpath" ]]; then if [[ -n "$pivpnlocalpath" ]]; then - rm -rf "{$pivpnlocalpath}/../.pivpn" + rm -rf "${pivpnlocalpath}/../.pivpn" cloneupdttest fi else @@ -41,22 +48,23 @@ updatefromtest(){ echo "PiVPN Scripts updated have been updated from test branch" } -##Clone and copy pivpn scripts to /op/ +##Clone and copy pivpn scripts to /opt/pivpn cloneandupdate(){ - sudo git clone "$pivpnrepo" "$pivpnlocalpath" - sudo cp "${pivpnlocalpath}"/scripts/*.sh "$pivpnscripts" - sudo cp "${pivpnlocalpath}"/scripts/bash-completion "$bashcompletiondir" + git clone "$pivpnrepo" "$pivpnlocalpath" + cp "${pivpnlocalpath}"/scripts/*.sh "$pivpnscripts" + cp "${pivpnlocalpath}"/scripts/bash-completion "$bashcompletiondir" } ##same as cloneandupdate() but from test branch ##and falls back to master branch again after updating cloneupdttest(){ - sudo git clone "$pivpnrepo" "$pivpnlocalpath" - sudo git -C "$pivpnlocalpath" checkout test - sudo git -C "$pivpnlocalpath" pull origin test - sudo cp "${pivpnlocalpath}"/scripts/*.sh "$pivpnscripts" - sudo cp "${pivpnlocalpath}"/scripts/bash-completion "$bashcompletiondir" - sudo git -C "$pivpnlocalpath" checkout master + git clone "$pivpnrepo" "$pivpnlocalpath" + git -C "$pivpnlocalpath" checkout test + git -C "$pivpnlocalpath" pull origin test + cp "${pivpnlocalpath}"/scripts/*.sh "$pivpnscripts" + cp "${pivpnlocalpath}"/scripts/$VPN/*.sh "$pivpnscripts" + cp "${pivpnlocalpath}"/scripts/$VPN/bash-completion "$bashcompletiondir" + git -C "$pivpnlocalpath" checkout master } scriptusage(){ diff --git a/scripts/wireguard/bash-completion b/scripts/wireguard/bash-completion index 9eb591e..ff434c3 100644 --- a/scripts/wireguard/bash-completion +++ b/scripts/wireguard/bash-completion @@ -4,8 +4,8 @@ _pivpn() COMPREPLY=() cur="${COMP_WORDS[COMP_CWORD]}" prev="${COMP_WORDS[COMP_CWORD-1]}" - dashopts="-a -c -d -l -qr -r -h -u" - opts="add clients debug list qrcode remove help uninstall" + dashopts="-a -c -d -l -qr -r -h -u -up" + opts="add clients debug list qrcode remove help uninstall update" if [ "${#COMP_WORDS[@]}" -eq 2 ] then if [[ ${cur} == -* ]] ; then diff --git a/scripts/wireguard/pivpn b/scripts/wireguard/pivpn index 3f96004..f3a14c9 100755 --- a/scripts/wireguard/pivpn +++ b/scripts/wireguard/pivpn @@ -48,6 +48,12 @@ uninstallServer(){ exit 0 } +updateScripts(){ + shift + $SUDO /opt/pivpn/update.sh "$@" + exit 0 +} + showHelp(){ echo "::: Control all PiVPN specific functions!" echo ":::" @@ -62,6 +68,7 @@ showHelp(){ echo "::: -r, remove Remove a client" echo "::: -h, help Show this help dialog" echo "::: -u, uninstall Uninstall pivpn from your system!" + echo "::: -up, update Updates PiVPN Scripts" exit 0 } @@ -79,5 +86,6 @@ case "$1" in "-r" | "remove" ) removeClient "$@";; "-h" | "help" ) showHelp;; "-u" | "uninstall" ) uninstallServer;; +"-up" | "update" ) updateScripts "$@" ;; * ) showHelp;; esac From fdb512d7d6f79ce12494e3912429e14ccf08be80 Mon Sep 17 00:00:00 2001 From: Orazio Date: Mon, 30 Dec 2019 21:55:37 +0100 Subject: [PATCH 05/10] Update README.md --- README.md | 153 ++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 98 insertions(+), 55 deletions(-) diff --git a/README.md b/README.md index 0df15c2..e70a8c7 100644 --- a/README.md +++ b/README.md @@ -4,14 +4,14 @@ About Visit the [PiVPN](https://pivpn.dev) site for more information. This is a set of shell scripts initially developed by **@0-kaladin** that serve to easily turn your Raspberry Pi (TM) into a VPN server using two free, open-source protocols: - * [Wireguard](https://www.wireguard.com/) + * [WireGuard](https://www.wireguard.com/) * [OpenVPN](https://openvpn.net) -Have you been looking for a good guide or tutorial for installing openvpn on a raspberry pi or ubuntu based server? +Have you been looking for a good guide or tutorial for setting up a VPN server on a Raspberry Pi or Ubuntu based server? Run this script and you don't need a guide or tutorial, this will do it all for you, in a fraction of the time and with hardened security settings in place by default. -The master branch of this script installs and configures either Wireguard or OpenVPN on Raspbian, Debian or Ubuntu and it as been tested to run not only on Raspberry pi but also in any Cloud Provider VPS. -We recommend using the Latest Raspbian lite image on a raspberry pi in your home so you can VPN into your home from a unsecure remote locations and safely use the internet. +The master branch of this script installs and configures either WireGuard or OpenVPN on Raspbian, Debian or Ubuntu and it as been tested to run not only on Raspberry Pi but also in any Cloud Provider VPS. +We recommend using the latest Raspbian Lite image on a Raspberry Pi in your home so you can VPN into your home from a unsecure remote locations and safely use the internet. However, the scripts do try to detect different distributions and make adjustments accordingly. They should work on the majority of Ubuntu and Debian based distributions including those using UFW by default instead of raw iptables. @@ -21,7 +21,7 @@ Followed by easy management of the VPN thereafter with the 'pivpn' command. That being said... > This will also work on a free-tier Amazon AWS server using Ubuntu or Debian. I don't want to support every scenario there but getting it to run and install successfully on a free server in the cloud was also important. -Many people have untrustworthy ISP's so running on a server elsewhere means you can connect to the VPN from home and your ISP will just see encrypted traffic as your traffic will now be leaving out the amazon infrastructure. +Many people have untrustworthy ISP's so running on a server elsewhere means you can connect to the VPN from home and your ISP will just see encrypted traffic as your traffic will now be leaving out the Amazon infrastructure. Prerequisites ------------- @@ -66,51 +66,57 @@ sudo sh pivpn/auto_install/install.sh ``` **OBS:** -in alternative to install.pivpn.dev you can use the raw github link: +In alternative to install.pivpn.dev you can use the raw github link: https://raw.githubusercontent.com/pivpn/pivpn/master/auto_install/install.sh **To install from Test/Development branch** Check our [Wiki Page](https://github.com/pivpn/pivpn/wiki#testing) +**How it works** -The script will first update your APT repositories, upgrade packages, and install OpenVPN, -which will take some time. -It will ask which authentication method you wish the guts of your server to use, 1024-bit, 2048-bit, or 4096-bit. -If you're unsure or don't have a convincing reason one way or the other I'd use 2048 today. From the OpenVPN site: +The script will first update your APT repositories, upgrade packages, and install WireGuard (default) or OpenVPN, which will take some time. + +It will ask which authentication method you wish the guts of your server to use. If you go for WireGuard, you don't get to choose: you will use a Curve25519 public key, which provides 128-bit security. On the other end, if you prefer OpenVPN, you can choose between a 2048-bit, 3072-bit, or 4096-bit RSA certificate. If you're unsure or don't have a convincing reason one way or the other I'd use 2048 today (provides 112-bit security). + +From the OpenVPN site: > For asymmetric keys, general wisdom is that 1024-bit keys are no longer sufficient to protect against well-equipped adversaries. Use of 2048-bit is a good minimum. It is wise to ensure all keys across your active PKI (including the CA root keypair) are using at least 2048-bit keys. > Up to 4096-bit is accepted by nearly all RSA systems (including OpenVPN), but use of keys this large will dramatically increase generation time, TLS handshake delays, and CPU usage for TLS operations; the benefit beyond 2048-bit keys is small enough not to be of great use at the current time. It is often a larger benefit to consider lower validity times than more bits past 2048, but that is for you to decide. -Luckily, OpenVPN 2.4 supports ECDSA certificates, which are based on Elliptic Curves, allowing much smaller keys while providing an equivalent security level (256 bit long, equivalent to 3072 bit RSA). For this reason, PiVPN now uses ECDSA certs if you choose to enable OpenVPN 2.4 features. If not, the usual RSA certificates are generated in case the user has clients running an older version of OpenVPN. +After this, the script will go back to the command line as it builds the server's own certificate authority (OpenVPN only). The script will ask you if you'd like to change the default port, protocol, client's DNS server, etc. If you know you want to change these things, feel free, and the script will put all the information where it needs to go in the various config files. -After this, the script will go back to the command line as it builds the server's own -certificate authority. The script will ask you if you'd like to change the certificate fields, -the default port, client's DNS server, etc. If you know you want to change these things, feel free, -and the script will put all the information where it needs to go in the various config files. -If you aren't sure, it has been designed that you can simply hit 'Enter' through all the questions -and have a working configuration at the end. +If you aren't sure, it has been designed that you can simply hit 'Enter' through all the questions and have a working configuration at the end. -Finally, the script will take some time to build the server's Diffie-Hellman key -exchange. If you chose 1024-bit encryption, this will just take a few minutes, but if you -chose 2048-bit, it will take much longer (anywhere from 40 minutes to several hours on a -Model B+). +Finally, the script will take some time to build the server's Diffie-Hellman key exchange (OpenVPN only). If you chose 2048-bit encryption, it will take about 40 minutes on a Model B+, and several hours if you choose a larger size. -**NOTE: Diffie-Hellman parameters are NOT generated if you choose not to use OpenVPN 2.4.** +The script will also make some changes to your system to allow it to forward internet traffic and allow VPN connections through the Pi's firewall. When the script informs you that it has finished configuring PiVPN, it will ask if you want to reboot. I have it where you do not need to reboot when done but it also can't hurt. -The script will also make some changes to your system to allow it to forward -internet traffic and allow VPN connections through the Pi's firewall. When the script -informs you that it has finished configuring OpenVPN, it will ask if you want to reboot. -I have it where you do not need to reboot when done but it also can't hurt. +After the installation is complete you can use the command `pivpn` to manage the server. The commands below are just to get started, run `pivpn -h` to see the full list of options. - -Managing the PiVPN +Managing the PiVPN (WireGuard) ---------------------- -After the installation is complete you can use the command 'pivpn' to manage the server. +`pivpn add` +You will be prompted to enter a name for your client. Pick anything you like and hit 'enter'. +The script will assemble the client .conf file and place it in the directory 'configs' within your +home directory. -"pivpn add" +`pivpn remove` +Asks you for the name of the client to remove. Once you remove a client, it will no longer allow you to use +the given client config (specifically its public key) to connect. This is useful for many reasons but some ex: +You have a profile on a mobile phone and it was lost or stolen. Remove its key and generate a new +one for your new phone. Or even if you suspect that a key may have been compromised in any way, +just revoke it and generate a new one. + +`pivpn list` +If you add more than a few clients, this gives you a nice list of their names and associated keys. + +Managing the PiVPN (OpenVPN) +---------------------- + +`pivpn add` You will be prompted to enter a name for your client. Pick anything you like and hit 'enter'. You will be asked to enter a pass phrase for the client key; make sure it's one you'll remember. The script will assemble the client .ovpn file and place it in the directory 'ovpns' within your @@ -119,48 +125,82 @@ home directory. If you need to create a client certificate that is not password protected (IE for use on a router), then you can use the 'pivpn add nopass' option to generate that. -"pivpn revoke" +`pivpn revoke` Asks you for the name of the client to revoke. Once you revoke a client, it will no longer allow you to use the given client certificate (ovpn config) to connect. This is useful for many reasons but some ex: You have a profile on a mobile phone and it was lost or stolen. Revoke its cert and generate a new one for your new phone. Or even if you suspect that a cert may have been compromised in any way, just revoke it and generate a new one. -"pivpn list" +`pivpn list` If you add more than a few clients, this gives you a nice list of their names and whether their certificate is still valid or has been revoked. Great way to keep track of what you did with 'pivpn add' and 'pivpn revoke'. -You can run just 'pivpn' to see all the options. - -Importing .ovpn Profiles on Client Machines +Importing Profiles on Client Machines -------------------------------------------- -To move a client .ovpn profile to Windows, use a program like WinSCP or Cyberduck. Note that -you may need administrator permission to move files to some folders on your Windows machine, -so if you have trouble transferring the profile to a particular folder with your chosen file -transfer program, try moving it to your desktop. To move a profile to Android, you can either -retrieve it on PC and then move it to your device via USB, or you can use an app like Turbo -FTP & SFTP client to retrieve it directly from your Android device. +**Windows**: Use a program like WinSCP or Cyberduck. Note that you may need administrator permission to move files to some folders on your Windows machine, so if you have trouble transferring the profile to a particular folder with your chosen file transfer program, try moving it to your desktop. -To import the profile to OpenVPN on Windows, download the OpenVPN GUI from the community downloads -section of openvpn.net, install it, and place the profile in the 'config' folder of your OpenVPN -directory, i.e., in 'C:\Program Files\OpenVPN\config'. To import the profile on Android, install -the OpenVPN Connect app, select 'Import' from the drop-down menu in the upper right corner of the -main screen, choose the directory on your device where you stored the .ovpn file, and select the -file. +**Mac/Linux**: Open the Terminal app and connect to the Raspberry Pi using `sftp your-user@ip-of-your-raspberry`. Download the config using `get /home/your-user/configs/whatever.conf` (if using WireGuard) or `get /home/your-user/ovpns/whatever.ovpn` (if using OpenVPN). The file will be downloaded in the current working directory, which usually is the home folder of your PC. -After importing, connect to the VPN server on Windows by running the OpenVPN GUI with -administrator permissions, right-clicking on the icon in the system tray, and clicking 'Connect', -or on Android by selecting the profile under 'OpenVPN Profile' and pressing 'Connect'. You'll be -asked to enter the pass phrase you chose. Do so, and you're in! Enjoy your ~$50 USD private VPN. +**Android/iOS** (WireGuard only): Just skip to _Connecting to the PiVPN server (WireGuard)_ + +**Android**: You can either retrieve it on PC and then move it to your device via USB, or you can use an app like Turbo FTP & SFTP client to retrieve it directly from your Android device. + +**iOS**: You can use an app that supports SFTP like Documents by Readdle to retrieve it directly from your iOS device. + +Connecting to the PiVPN server (WireGuard) +-------------------------------------------- + +**Windows/Mac**: Download the [WireGuard GUI app](https://www.wireguard.com/install/), import the configuration and activate the tunnel. + +**Linux**: Install [WireGuard](https://www.wireguard.com/install/) following the instructions for your distribution. Now, create the /etc/wireguard folder and prevent anyone but root to enter it (you only need to do this the first time): +``` +# mkdir /etc/wireguard +# chown root:root /etc/wireguard +# chmod 700 /etc/wireguard +``` +Move the config and activate the tunnel: +``` +# mv whatever.conf /etc/wireguard/ +# wg-quick up whatever +[...] +# +``` +Use `wg-quick down whatever` to deactivate the tunnel. + +**Android/iOS:** Run `pivpn -qr` to generate a QR code of your config, download the Wireguard app [Android link](https://play.google.com/store/apps/details?id=com.wireguard.android) / [iOS link](https://apps.apple.com/it/app/wireguard/id1441195209), click the '+' sign and scan the QR code with your phone's camera. Flip the switch to activate the tunnel. + +Connecting to the PiVPN server (OpenVPN) +-------------------------------------------- + +**Windows**: Download the [OpenVPN GUI](https://openvpn.net/community-downloads/), install it, and place the profile in the 'config' folder of your OpenVPN directory, i.e., in 'C:\Program Files\OpenVPN\config'. After importing, connect to the VPN server on Windows by running the OpenVPN GUI with administrator permissions, right-clicking on the icon in the system tray, and clicking 'Connect'. + +**Android**: Install the [OpenVPN Connect app](https://play.google.com/store/apps/details?id=net.openvpn.openvpn), select 'Import' from the drop-down menu in the upper right corner of the main screen, choose the directory on your device where you stored the .ovpn file, and select the file. Connect by selecting the profile under 'OpenVPN Profile' and pressing 'Connect'. + +**Linux**: Install OpenVPN using your package manager (APT in this example). Now, create the /etc/openvpn/client folder and prevent anyone but root to enter it (you only need to do this the first time): +``` +# apt install openvpn +# mkdir -p /etc/openvpn/client +# chown root:root /etc/openvpn/client +# chmod 700 /etc/openvpn/client +``` +Move the config and connect: +``` +# mv whatever.ovpn /etc/openvpn/client/ +# openvpn /etc/openvpn/client/whatever.ovpn +[...] +``` +Press CTRL-C to disconnect. + +**iOS**: Install the [OpenVPN Connect app](https://apps.apple.com/it/app/openvpn-connect/id590379981). Then go to the app where you copied the .ovpn file to, select the file, find an icon or button to 'Share' or 'Open with', and choose to open with the OpenVPN app. + +**Mac**: You can use an OpenVPN client like [Tunnelblick](https://tunnelblick.net/downloads.html). Here's a [guide](https://tunnelblick.net/czUsing.html) to import the configuration. Removing PiVPN ---------------- -If at any point you wish to remove OpenVPN from your Pi and revert it to a -pre-installation state, such as if you want to undo a failed installation to try again or -you want to remove OpenVPN without installing a fresh Raspbian image, just run -'pivpn uninstall' +If at any point you wish to remove PiVPN from your Pi and revert it to a pre-installation state, such as if you want to undo a failed installation to try again or you want to remove PiVPN without installing a fresh Raspbian image, just run `pivpn uninstall`. Feedback & Support -------- @@ -189,6 +229,9 @@ A secure docker container that sets up PiVPN and SSH. [OpenVPN](https://openvpn.net) The foundation for all open-source VPN projects. +[WireGuard](https://www.wireguard.com/) +*An extremely simple yet fast and modern VPN that utilizes state-of-the-art cryptography.* + Contributions ------------- From 66e4156fb1148e65b4a6f81638989bce71ae966e Mon Sep 17 00:00:00 2001 From: Orazio Date: Mon, 30 Dec 2019 22:00:41 +0100 Subject: [PATCH 06/10] Add logo --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index e70a8c7..84a36ba 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,5 @@ +![WireGuard + OpenVPN logo](logos.jpg) + About ----- From 3e1126ac1aedba8b6a934d57075141205a8c7185 Mon Sep 17 00:00:00 2001 From: Orazio Date: Mon, 30 Dec 2019 22:02:23 +0100 Subject: [PATCH 07/10] Add logo (2) --- logos.jpg | Bin 0 -> 74614 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 logos.jpg diff --git a/logos.jpg b/logos.jpg new file mode 100644 index 0000000000000000000000000000000000000000..890fec994bc3af8d6a6f4c15e45419e69341c042 GIT binary patch literal 74614 zcmeFYc{tSX-#0v>l#*1EEK?yORFVjjgbG!+t>-v4a*YzC7b3e~<|8d{Xbso++jyXS{Ii2tGe6O$f`{WLA zYazlrdG_x-&C7EfvQ3zWSD1&}0D(dvJllEx(IEfUc((EKZQsGabCl8Mt8>n^E>>CV`p~k*EQ$A^W?zsvmrYVUXIHss@o;4dV?x**RxaLkj%MpS=t}c{z2LQGr~gu zUs3k&g#8Cy!w@~lwtqC8%{6`b`x3=dWZSS8Z^zV%e zPQnAu!NUVygVQ?@d`s=5H>3_N*?mx{lE7Bl)wDf7|X85BA@jfF4WV3SJH}Mq97ne3qU3&i{`f*EtCc%p4 zvV>=z1++)Sxe#$X$Di+ZT;z*iob(;p|8<6j-_r{l%YpH@6>cw#$zDhpLI@Tf@6$I4KC}ob^Vb0(hEv~=k}^!oSi`B@<^=$ z=cencpr=g<=Ir7P6`_oj1}3 zS8R%iP|cFKknIxeH06(nhK3&w@om-1E`>S6iSb?5)&3^*Y<4=!!(2;yqUO92;&7BJ zx`}#@f|eRhy0)1Mb_k&glVc))Pe$Hgx1B2w;T~y?kA7$?Z0ZIka>RbhvnCL zKAvWK?8k+1m7ye#;YBEOM>7|a_3`}!0P9d)Wm1evXemEd{z7jbvp8+Ia%PmU#*Rl{ zK&ERs7}h!}e+ycI8$GihcF-7+DH{&eY#SLAOWNaUqptN57ox@~a9m^V!?fP-gDq}< z!i8j8l`49%YGi05mP)I?s;#MlMpBy_bxzUb zVoIxU!a%Wk%FUj_fszEXsR8Dmb>1%$0<@y7YFFl$UR(|p8?jMTWb@Ku@*{nj3uz6& zWg-q^#nFept{*MVmajad4X%q_vO>sdZGv)mElB z{(kT#aO(BgDSA0IAg&T?F#d{}Co)Ga#x~&vP-3);^XW=d2W+&GvOs9R!V#p0=G$^- z)eUG2Mi;tAg}{$O0T`DF6+!V3f%wDo)_Kk%VA5iZ1;d>COn=etQb23X*K)=8U)4^Dmw5P~SH zhx4uPeIL}n&>W(5GT;Ah$9NA49z?mCeccJ!iw(qX#@$TC-Xc-Sb?|5D`+A6FTB_rM zs%8ZK;}6`NY(?39O@`x9>kI};X_sygo%kkltXePCyn)0{Gcsg$7_rju?pCCOKpImE z1qG^HWQj2-4Ywy3_bBx|IQ~s-u#Mn820^y__AUB_b5!jtZvwl9;O3f4RNvKO}Er=*6d)=zP&W2x4JiC)yZ5cUU>+0i%%_BB3j&^RXbC#+mOB-X=+4{PGaux>3hli3h2lp{%;y0%wVP*ntTM_ zP*I@8LvyBdRU4gzS#C99Y^J_&Z4#G|g$Y(zNKehv)QRPD7el~OJinx&3x%}m!zYpae(Gl-wlm?L& zb-57P6dNw&i%2sk@m7Brl6|XYhJKU_iSPJ~84#G@LW~O@TFvMUux&D<6k>1xm!4Z@ zy1&w$_~~i=h{Laot6qKjq#=_~%iBlrq2ZU*#t?!fZvyuPqiK6#p1yWr55xDXyI zsg23$ExHhokZbg(_tl%|Xunm%{MVEI)!yv%{V55ngMl?k9XP{onKu`%x2irf?6j*0LM7yP^NH*jZRI znQ|I)yw{L(fD7Ssai?!2vAGa94c|g6C9&5Ghh{iicpNTP4Zl3zKgxx)Y-Ww6i6ft5 zJYlyBSl}#~+slfbPinuRoW&gNt&%9Z7JAiQQ!3m{m!*$B9bAZ6N$&2}GNA|_ve3ci z{^$X50^eh5yvAL$x~Ayw2#z|U8- zQM42D(Y`6*YlLpC#gKudHos2dhRc!$t=kOXr50bOp;DZCPwXI@gCxk~9YvHHUuFa0Xl2ld$&Gh2=`I>BaX*b<-M_3~q)bb71YLMc>S3vmZN%hl z{4i$!c8uP_ZK*8eC7$~F+j#Bgl1%*mA3u!lJGIKB8>vYiv~GoV=50S{eo3l;iW|#m zz{Ug){^Cf@u09kJlk(<5JVzlxt;e>k2Yj@{F}k=SQY~DBLqZ7RwT@9bjLFy2=^J=U zxB5qss0T0KJ+3bF3PHrc__+`_E+h)E9d*oY47Y18`D*vli$|puw)gJOuWFXrV)Gc* zBe3GlB{GdjA-%|;GFTTJJh!#Ued`{i*zmvthORa3(5QQq-n%Y#lS*|RSyQEv_MIMV zQg}@nKm042*ig9CTaFA=X<$2Lz7tn%DqJXf&R6IaHkTY6tP2RQ^*7*#vc}-w9UdYC z0dfOvaQ>G<)zF6<9mgZZ>=$qBFud#KsFa7P(!)Bt}F{Oy?9z)iT9CR>Y*8cQqyPB?>P#SH1UiVE_2f?2q$Dv{?+t z0yo*Tsr%!-03>(3^#C%O65H&Y1R$N z=Z784j@6yzS-r-;d5>48`8WYD_d}w;IDM8AKvN9M3di+-Y5SGX>l@65jJYePOuGBuHm&<-I$0U*J-!!-P() zwT=SuYgiiIX=r>g!>P#Qd&TOSIgdppVD`b z{>0Ev&I+liTRr%$KIHVzp(uI$72xR~E%ou-b6jxfOb-Qz2;)MiH?Yx_u{pHZ=Gt3_ zGL&kF;Y*^VRp)yh9epxKm!y|J{v?#Pzid=EJ>&ArgCs;!Z9H{O)=k_!NEQriTiC;E zV_Zmj^j6dx;;URO1f?n<>sz!@2w26SODUUz87qDdweEyJ*13`D_lq zbz0jB(l&Sn^Q$*AO7WM@x&QgdkKhNaFwIaZ08dUpx)R~QeDN`4u;#WS)9}mIfGGPT zOVwO6E^0dAtER_W&C+>=n|G(=I-ysrdoUn6x{dYg!???3FMNW|zCMxh`rxw`q!~$Z^d}UKX;iyhlfnx{8M{e{D z#o&zrqj*2E0iRyyYHH86K1szMFh6;BUOqqxF-ufs*!98ONP}VeiSJXI&zCEwp*tkH z@nbFF@G)c>md=H+lVpN%)Yp~F($q1`tO#qU(_TdZABoaigEo$=ZDy5lV`we?OO z?WZj{kU|M3P?rENR3$cqr5lv_BL_CSc2*iw{cfm!Ak40dL>|We4)Etf_%o2>$SQg~ z+jN?SBj|uGFW`VEM3h`D_k=?^I01IW;(2L6lg>fSug-QhL6&b3~SWc z-g~Fld#iSf;{HyYSy*Ek>0y8zs&{hjb)0}HlKkz&lZ*%6x^@;=Y=MlGo&Hh?@w*U(*7vWZ1tOlJPx&{GkF=#7T5P{(cht_H0E%-f&bo$Wev&Nl`RLW&+hnh?JYin znto*!<+o|A;v(L6euZl6AYK|55UQ_`)&UlcOh=izdE5* zP-kDHpfLQL-9T3J#qT3SLnT&Exe$>aE~M%idXKJ7ZO_k#CtKImzmLz{`rxYT(E6dq z7I?u#v)nLI2r*@p+DG{GgY^AMF8eGJgPvkgT*zjBJ7E3YQmvz5({KOC?}~WWcWHwa zr+#=EZJx-$lV~DoMiqn{x(@t}9)EaFL{5n%AsEpSe$d<|{gt^sC{y2sLU6*I3rONX z`nGPVS%XXIQv^GIo)zhI{_ec|XA-zmmV*&;B4#n_Rwb|RmOok**ue9n{DDR)(@+XZ zg-7Gp9WJQC;@ni;q@?84N}8f8QA%7$=pB?+=Tb&BkeB}(+5cf1o&MRapl4G&az%V0 z5noV(A7Ij5I>+pS+#`qXWf-W##m#1<3Xa_c71Cty=JXUyxr1fahFGpi`BWo9gs#HG zb+&WJP*IMA|7)X(jvEt=48dWZCxXK($;a4${i@KXbfHr83QGwn8pFJF6b)-k-`;bB z(RH0KYOicKt?g=>Wh8OjQJn%CNTA=PDHYejLY5xcRvO*wveU$wPkn)g9H!$_v5OWo z-Z9v7aS&Dgx*08Nl)y$~^Cas14o^1y_+~{v#UmLL`1YZHl%~lj;ssS>R8{r|dw%zT z<(f$xW7uWJ-C}*3aG9MAb0SCLN(5h4zKiijh%~*8G!HkpC!P5-YXwgUEBFPg471yr1fjKm2BWRdGLm9L>72eh29PB{JJ~I)AseIqe+s?pK!KIq{bh z!;E71vdd~P4Kvmp3xfBb5CQcV05O(Q!uBn<;sqc{cV3n*c#OEZSg z!T(}o*@V}&zH(#!G^CD>?LIE#%&%BM%o(Bx`Uns?4#lb=AV9KqdGft%y^z&*u_+nE zeTn{-XxxUKO49 zGVpw5`yEupmTz0FG;Y(5e+?ghvSmq}U$69a=+60_1rK^Xl9OjWrUQbttfc${tBmXz z>#(9LK5>VxXjnl)FNT@nQ;7HQFNoAK9Uj20VXaM;5Fu3L=+*MARLAZBhsr~UAjIK+ zo$N4HFv(-N#e8oIckN84xxrppcfd-?_0B*x69(khcj`}%4(rkv;O5%+6;bF4#CjGv z_b|%esUp-Q;PpArJS+Z;J*V|Wj%JIB_V}N=nQImP!2MA27PQ%QyOGsl=}^VZ70#|4 znlxuWK6KM@cV$v=e|X``hr4E4a5L9}c;gVUn3Bl)Rvl5+Lz?w7Eu!*H6)8K6-k#<_ zr(u4Pb$8Z*1j<#ab@MDr%}=>qMRZs@j*muvUianz@Tv_qipRF!pS!Dp$Y3ir0XEYb ziUn{xSv3Yn6qZpbpGo+^x%~&eI;*8yVC(OGxkpPk??P<1Y55z9l@=uKq!UAcW2z(L z-^8Q{VXJi~-1MXEk=Df{=gmB1JS`2s7DDJEOeUC?*$yOdAv>Xq>|9r?t}Q=;T-+n+ zy1G?T$4Mwv7~4clZQFXusF^x~{Ft+nzHiFDB3n{;tQm55`OWt;-`@GSl~Gq za*&|rpWn0%es+jLqm*g1tRA~4-CV>A1A%BRq>R6T1XyBU6?dsu|%U2%-<@DuEc%G7u#Cl<2ZfbNslynsegaio@jh@N#(kS)(9o=WlRzG&3=pg$93XZ2e?ck+$AwRhpZz@l3ALufe&?vWZWo1pV_WLx7W z1^n=5%nSv_T*SmcAA|TH4&0uVBF?$(?;b|w(-)vy0G7jqP8j~jYdrUFWqx8;HgnM6 z3JJ|XCw)P>>z_0Hd6Zljt1i7m>iu-urO0 zFd$5~GLMN7g({w#{Y?7TA?R?R3X2OF=0eDzsXL;qW98aui~H*!tZW?tZe}?bLd@fw zv)8cA(Z7#znLGu(-p;gC6;9H7%<>VBHYJ9c>{NIaX!X2WS&Om}^d zS|*0cz)k4aCnkH}*tWA}^2ip3{)L@!is(X)@H_H*yG;LvWFO;^(objUcRM-rd*M^& zH!`2uXM<751%RVt0Lxr4q zB$dAbEz@6(C>Q|}8v48DZ>2Hcok;gpUT*HenLYL94KYU!E#oP{_ct3fH+qsPV>1*< zT3tmh0TPq(ra_3s6{fa7kseM<_7A$G=bmFH6131~-|Q|1%ZH9jE=-)U`Sdn9HGdL2 zzbEo&-K4+zjV$Z(8o4bM<@UTO^lqwLH0L<-72sZX>n4Mc1-ttG@&I(ysq?0vOb7y$ z*xj(Pq;%Qdqmkx70fn#2vewDv9^p~e;0O2D(2vLs!?EUCVkB`}^%-cSmQaq2a;L#bOQr9mi(Jz5_DPEa&GztbO(8F`9+QEwjT=Psz;$w&+G4H761?mWC)c zdm&K3N%H&LrdiWF{1Uf$cR=xL0{sveFueo~=+2uaaW4xR#yCL>3(1N-Hku|6@ZSK< zRMWQ|YbL@l)-EpO-4>a$0-V6sN_wih?={KwM|(}o-#kGO50vV&rW|sOh-a^8E-7Io zxsU?@t){4^`|;G5p4&loZx4TnGtQPg?6W6_PuQ`XYCVC+a`^l|s_X|&Y{VVTtt|00 zt?6<4)Iw~HJWdQGx`F}8N-Y^$lD84G)2Wl?Bmh0mQ5!mO)FTNJJQlcP9%jt(tM(bg z>}Oq|nS#QLa=728nVxnm_R8bP&exk(5@86nsJfndBO`51)lD5K3QEc^GVx^dXnBn& zzQYd@1Z)M9l5bStJkGAr3qK{%sH+;JHWhF=Xk^ zKx_mdNvVnXz+o9%e_^XohBwfU!;clp=e?~?yS{1*+QcE`a%FJn(mhD6w< zMNLpsfN=^KI^HiU&dL%AniYxU6SJ1yDB$ysJO2SL3l(gh7qr#CjkZebW;0uZm9RU!U$i+bd$d)CXImLD_Uz6ZT(U z-1ehX-;(KrWw8vokYFtBz2jgy9}Nc_{-Z6yXGf1k+?))$@#~+Ecb@&jTR!<)*4E~i zfuH?87T63mA^Iq&uVEkxu(<(iipGL^#meO`W7vPybpM6&vyEc3VK%^6h_evJirF^h z{7F7DWV@K8;#1mkUI3)C`eKf~S{ms&9^E8&%{}T|gwd2UiKooK5`I^A2>}D_u0}ib zD4i-PrUzff=-56kaIUZ$KBspyG~j-`!GZirH~F!!gt(^}Tg;CcQul@#PVQq4|(m_Vk=dJ*Pl|a z%1mw(D)6sw)btBwsbeS(*Ey87v%|VuX{4Re%RerOY^hLi`{&bD`d73JKetXhI9B*J z`R2~%zMm1uf(Yp%68$rp@JjWc&x;Lx?&Ct*r8s!!wP2whlFKDj9# z9=yZk`(VUfE@beehB8y7W>9LcSL5M5HJH*~^WbufXU~>Y6kECrc3&ub=*dX1NMCNS zTSz>OvKLH{6C-YgiGE?;e+$=-a9h|imiVJM#|fv{uUWR)ACepo5hHD50``4l zYE1_2iI0S?sC>bTpQGY6>h)VKEKIf>xDY|;Sdf@Yl$efeZe^?>7jm|I;u8y=C|{st zZP@FrICyU4ewUqME@9p4n1K|aT_dDtTe`Jm?D;J9-sjFuYMz+BvGN=kRbIC}rE2PS z&hOCbxf>02aXpF7&Ki8eEl1bY7;vf_g@MxR+8g(|B_BUGt5th}c||Wo0c%ek^Vr3A zTSBNqlT0PPP=oJ8_BkH!{II(G`NQ6dpM8>I;*ypTx>6AYQs{-sLi1?LLnTuml6=U$ z-popzWK*@A$@%Y^?#6L_D#c5)3^rS6U`X*D)i0`Kf ziVt1dZB2KC3Ja7>Sfy0oE5vz|CKmN~b*1Lrw2Jpd7K3`rs_EEYFfT8(BJFY5Siuno zzXt2$Lqp2^e!kkmqWNdmp%%3#h*}&u6ov+molG(7N?VT+`I>oncz+vly|>w(3-P|~ zd$F>=>503<*w^Q`il=kwQRH5_BgWHZfSSYSr0O~vKNUI(ch?`;3SNTV2ihly_4w^= z^d#$<>oqSEkwK?reWY{mx9A_;*j~JZ&_H5Jo1eR!N|*e#R3IwDU*VTlv=F{p3&Twy zj&&kP70uDMWhYF{<8!1sZ?RVpmCY;f48t|7j-2d`&Qo3u3~p;*saQF{>B1bE_UxRG zyCkG<^581ew5@q9m%{#_quiwH=BROIu;4xCx#IU({A-j`iX#_dm&b*Kw6jQg_Qw)$ zku4)RywFvh!cHO*e)!h7Psa(;b=}e9^ksC;X7rXk{yj>XX~@!`T{LtH@?gjghpdi5 ziXJcXy-#eeawBDQrmmZOvVf(12+iaL_0d$h>RtnlDBR^pJ0E|GW_5leY5LPiJf6+)AR%353cH88>V;y2%h`Jb0NRZGRa#w$6<6o`lw;YOyrU?{OXiHX=x)wwAYr^<)sQb@#W1cez2m1fUrdJ> zhrbye`AwT>c1|+Ln07u6SvXr9opP~6NF3WEJP=mL|H>afYqonL_52glRpnc8qp(lQ zMCBS4K@{l(V|gihum1a)j3HSy<><3DZnM3cYAo{;D) zDM3fLv(#`6?hJlc#O5@H12g>VSA>c=q60?Tr;29?#IcWYGVXC9>w*X7p#T#0oV>ob zi@5TG3t^$LfBQ~w%)|oE#roOXuflpx;W#0g!QdeXy3oWqAw$;eEgTnu{d1^)8R&2C zF$YQE)dbHykDn0^M)kkW!E-U=pE=T)Ul)zRph=Yrp)p{8AJ__vf>DmTAl5}dPPqOR z!`ShH5lz*jm=(~}>(v7ZrEc3xI|{mWqdn@xE-Qvb-apD3m`4sSOu+}`I9GxZobO6p zNTw71(*h$u^hxOx4J)ad0578gM6fNZs_CtQ&7-aw0pSvhPTx-GK7TCz6YWqEeqPf# z_Qk{7#oyi>JgXHxV9@CKB;==R?C3_!e`3~=385`lp1Cx8EDd z@|nbkup&NAz3q?zqzsPuhH+cu= z_$ccdwPa{H!&Nf%mxFeN%?pLgpH9QnrB|G&__iUoARAyo-+l;X^LO1+!;C)T^{9FRPiI zfc|OZrTtdma|3%q#z0-J7mMoeE!}cF5te=9=2WGx&S;|Lg}lNH(DI)Madf67Q648! zy~ZP-6J!0dW=68ViHfD0pV)JbCKpo`u%2d$>%_%9P!<#Mf<_$r zhMj@sstk%xke(AC;KLLAnGKaPnz9YIUee98tBM=Xd3jxUf!V6!Hjn3X9KNGakR2P~{w^(DZ-+O9WHhI<(vyReShVfZXjz%%h;SrWRr z3n$VKH z;Tn!W+(R78#qn2Pr}sgHy@OWxM}9DmI3H&;^51veCsVK89RFk?7IZki6I7_>vEDXX zhGQeQ`fqhDdrkcwGA_Q-;9)Q&vrULkN_Q-Zqm3Na*@^xI+fQ@>AyMo;fZzN~{TW2* zKu1z>l|DzzsbvzgJ8w@7Rt745di;o|nT?;z;1b6rBb@Xx?Nff?%tna5e{-#Stkix0 zL?c(*o6|)w@~zDL_VaFCgCp|W$Gt*QT@(g*UWaP)7x&lpX3HCWf7k)F+?6LQzvwxt zNt36#gramOc=?BjUrH9LK&$ObR$cs3Ql)--!uPiezX*^^rdqB<>A!$)e^BRDd)9tG zf4@I|KqwZsdIfz9GfGoM|MvqSkl3+A zw?1~358J5@eY#ueoKj$)Y-N#&i)YgHy(b_>@lvWKW6*atse&JHGY_i}kvcjw(eEn~ z4@P0s&(nhNE8k3>$6mGOjf|ncGQRpD>*eZ)D8?Qa!SNhp^PJr#Sv{*?wi+LFXtd38 zYG(1;fCWvio-9g`n#BpD&YWOMJ{)o0iC#a8ePe^j=@5_58;FZ*5)2eUBQ9Jh7gI8) z7sWrERZx7PU%lVV;L1Zgsc&L=57Vq7*oz6uK{a3KwS=?0}#gE$G< z7y1E(l8Iimr^IwG%wK-V5QzL6WBP1a=%Y(H_%SYIW{3q3QUBtAJgW%P}Gqn=&$VtS&MUJWJI9Pn} zqz24%FGL}Rm1iugf#7jWWMwd`(t+3jKRD+oPWbjTM8OszcEsZub@!>D;GHs3yYL;z zI~I+`FTL$M0u^yiX2mxx4fDUMfiUVL=rcX@>TZ_Yq2dYW?!yI3q{xz#G~=$GSok|F zlc~5^&zIk8kmJ}UXaxE2dVm@+^2nrS!=c6f-q$-xk7q8}X1qETmk<`yrW*FLf7+#i z{QSsDJv>H73osu??DG%%KDv);7*SAIVtVmA17*ESq(5%={Ta5@waY(#bZHf4$tATG zhO2ClAuJnq3Prnb^Vc)v|HY;{lX&c!MM$9v(DBo@YjnFRA$YQcc$um z6Il-z9M%by%4zA?idG5lisWEP9QpCg{1WJ?YX;W+Td>B@?fs8@E56koQ1HV_b=ONB z1iajo$>k(j_IKXiW8%^zu=s5pQJ}_J#nfHZvS3#+uaG`uEn}|~m6uCU#p-;a1p)6G z9d8Md^j50XYCjE@o~K87GD{HAI@`c<7z%d&4_?GOiyh3Nqx*>u5YJBocWX<_l8`S- zcYis1EK-}_ZK+cqV@%wuBkq53+%Wu9wfIao`dmL%T{En>K?=utOUkCnJGo+R;*LFej})O%MbhQlRwKoPZtEP zTm6uJ97kP!)CN-*-Q~!`PGf0Hy-s%mFk1uaNZlC(iUdbdv zb#`+hb?|#VK6Y+G69zA~r>cH|FG<2YuE>mu9rJ9K%C@88`%M*Zc9+&@4qJCU-ar3y zRqf45r;CZ55xRU<-yS(=exkbI(x}TSD#;NFhX^EZw%7zrjIg(Uf{8>N^uIg7JkYEI zJrS&E5k2KGk-#^=h1l}pd^*2sv=j)1A`T8yBEzSXEK4~Zv_sJsZRYz7KZ`yIUc`JM z2f#D%&iL0Q_ptS_(&gf88|4-)>+x@;V!i%|65F50Mh){7V}tWLJX?)?ev^b$+%DhD zskWpr{T$O!xO|-gd@}-2aIeq5i3JPYl#UNyES~E>#XowOET+TOM>kr}U|0t`+(?TX zJSpN$1#VL_%wfa@mg1f^ftxb#7Ce*{ZWce>tL;F5>uqg}K|AB7=z_!C42K5W&*)msm5wXT9qSxrYOnw&^mmF_(Mk z@3hSx?rz~Y(o}ckPWK*R8o|DkXdozIor~fDvcZ!y0o>?NVSgt|TIz-98!;sdA9*>q z>em|J6_*WJJBX)PCn>why8xUK%^-RDV!?@J@!Yo(`>5ZZFrqk#m`B8jXqq8CkY<48 zJMN%o`uw34%JW3YR*TePN)in}t&+2Y0Mp27wM+Bq;UrSq&)R&(&#(2?eIpuvVq3Rx zs!<}8AeAG4p&{*Y>TtnE(ACEl1I8Iez=5c_g*7m1+DLtSDqw!B%}q7+r^`%YEEvJlA1*P)80n!A)` zooa8sFge2te-!ZI{37-{2{_r@fCsJ;l;(&+kETZ4#)Gb}K|FQ3eIk!CKe@3MCZK~{ z$T*95fOE#*uI_m_rMfyMr}pQumn#W6!v>0PfV2s_mFMJr)%p_!SEqv?GlEhvJ`S;s zQf=SN*YRCKfNXO;W(h6^U@2~sSL(Aam02wsN(DEc(%skzy9IpXLQ3x9JBfAB9?PYK zdlLCZ2Is+i)t>`NFa3vn*@=)sSc)|9Yhgm~uX@k5#lGp@(~NU|62hV38!wvVeJ;$X zF1wp>Y2ok9yb)uGD-o@qMa!ckY49)^?2k9AKMlfqOhNXOVuoWBtgX6jf494O zWXpyO9+t{@Jr+gQ%4)YX_0hr!c){JDzBvN7fz>T+{pNf|^Z0Y1pmWV%tu$ei;zb@b zoC$o9B`(AN`?T7k$QGCe5iWGx1pWXU$92#tYOQp&S~KeLoO$)7tN!8uvPM|LEKLf9vKFYgIp*Y3^wa5bYucHIfnpS z7x}?Q_}meBSQA);eu=$f0_dNDhgK`)0$`DbN?6Hjm4E_=de_6e7hF@7(P0`oy$hI9 zxdv+>gVx=Mmb2ArH}~%AYmmU6_`QY17VcspXGy?`{(5)7grHIWQkg<_8CP^kGm;4Y zc-sj}gA}pyDGQjAyPwP4sj%Fy1D|onEHDS1Fw6jORj$w?gb3^6ov{@#t%?@yvTiTw z(mLaZ+$VwhGW0cU<3a~UiR=oVWjY>2UXE}+V;;b^jv@AeH{No&khzQft5}D3ocQo6 zsM(##m47jNQ+=Lf<|n@ zE(P0hFrZ6GjNzy;@~NVnT@z#O(YRfxi?jnbX=YhYJ_VQV``?L`J|fxZksT4_hevQB zk(MZRE+nJd68znDOt|x&d|{anm0Rf%at&IUiAFb4(1f#<@$V*wxQdJIES4Z+;t2b1ki6xc^65V24> z!2#Fzw3w#ymkBh~YVMyGl4O7XvMlQXM#Y1FpD!77bB*zlvSy?s^G_LX@4&jSizvf& zFbycI_-|9L?ye__aufjLITbB63ftQ3&Dou+_!GOE?^cz?E$WJF&eU=tz)3^{bg!e` z11{w7I6`>t$}{9Z+}-Nun1Il6ndVweUTHA#q-jpNa$Y!x7XNgL~9pg^+sCW`4!eu_?5^58%u*qY(V)? z=J1FkX{~NTjaNQDDcZVQZT{MsWIE=iQ*FI65^TkPDBofRmJSq0I=^v}lB{a>X5tt0 zR{1#sMdvzg0p2#>Ypp?PA7VTEC;W!pVKddZ%})FP8BmyE1+f0aS4qS+O%_uB_dMZ) zz!qwPO+iR+t_a3+nnB&=j+wiLTPnw`jl!9;o%CVS)`}c^9Z8R@M^H^xA_He4OFHg@ z@J3u~u-n1K{DT)Pj_){n&s(g3_}3FZl}vPRXmdQ_ysHFspQ(q?$Jk|SoS@b}LZ&ke zN~ShAOo%~`{{5u?$~orjnCD9XnA?5~XRUx$;Vu;D{~#&rf2^{9X@;elKTc%tO~$hs zVJr~G`5R9|2L@uv&oK?A;J;4;W%LwFkLfnU+Dzau)b9RVU0d=%bKnGGLokxw&5^XE zk~xv4)*QAj=O92FOC;|-9w&}qU&e_;q$VuF@&)(1`nbdQ=$?Bny?Tl z1)5rQ%Hvb#W+Fx^p_=-uS+KCvYOKO4)goVw`x-KvCu;UEh41ARR^r6RrQl*c`LXdp zaPRykOKCGr=$V${XMb|Tkjt}@ou*A0pMJi&9LD_lBw(PT&mbpzI>}88)odePyN%~VxFLxQX zg4akFUr;CLsP3-SE|EShxB`z(j^?(pO`DrD?T8$?iY0_ir@rRRtevZkwqg@S8%1gk z4_7@C=D!mY@k8P_dnmvPZO4V>=_?L?*CD$OL$o$$RS~^Pn3K2?I4cSN96^`r!K?@M zN8@0gIyv)>`}DOOkRagAB7G!|r82_Vq$Q;s!zW&+^60xqB?luJSp&(O2;>%6rxNOc zY5g%r-WU%8;m;V%mBcawF2rk1izE_nn_0e!?*WsXbfJ!Ie+pv$K(AxD>gtDx{90P{ zuIg((K4Jz6Po`km=(pC>aF&QP=W2f>aZ#DbIJppghQr4e${R~W4GUqWVY`W?8}3_d z9EYP0^luzvs#LXt*G;v+qT-Is!FZ!qxpqlYjAAbv&S}T3J|^xZF75(PIkVCK9q;DU zEINOJZ~ymSUzzY#?P;)LHW$Vtu(d`{1Dai_dgD8aDfCx@y1#~PGPG)bybrHkDPMtR z2lFFHIMzYEi3%WzcGI68*|C2R{EP)HjYDZoAL_)OY6r@U4aHS=sCisi-W?S`vXZsu0_|nq!2Bv7`l5DVWV^U~wiM}=-g?m6A|}bBM&v^FegeS2Tkj+23ZUO}Ap)hZ z?}DaLWxwaW#eXWw{||Q7oQ-|Xc}t|oPLjb~1E_TWGFRU5{?Zn4lxEBixB21=unhdL z&|h@+%|Bk80vdYmky5o=-iNniCHubc|K5YqgcZ@C-J+~3pA%>QxkNL6lL>MYcH4+7 zIlS8S)8JVQ|ImkcY0mnMLwY~~`t=_VhI(V^vKj+h=(F zAselWsXMEqF@Gd}9><5$_3Yk#A%_0Oe)99}kaK$4A;+FF`WKdheGlyW)NNt7mb7oO zxSi(pon-fjnNtko1En~}??5B1-Pq>CJ?P*Wk6qBF-mQv%w~6aP903e?ot9(-)=XSO zFvP8AHbd91YMD+*?ymQ{aqjwjIlU})E~c%xttei#>C&T@{ms)StFOc_V~nZxSrX~b zroLjg-Xh$pLDR8{Asb-JMlqxS*h&_nf|s+)j{5c`SdQ&bfFXl%1?zDVN79a(!iiWy za<; tL3U0J%E5`dr`_==gv0J~v=g#R$Cj$dgzYCghJKF(X8$FpZYdc%_A5akH! zJoy=zmr_R}HakFO6feZw0+pKupmSB6BfKI()>U^ewKG(}6@Gt)E+H1tcHbll5)M2aY_Cr#0lo@c|FtywBLnhgOPIdtdv!K1s z8-3xllsbk>6j~hVyLrIIz8RC_cx=Bxant7liKm_-6TUIc*AGvmT5GtD6A#-dr=D}) z8>3>`{l>qGwqm|Sw~xPPZ7FpxZn^$bBH!6qLk&(K2ZHWI>#%Vs>qDjE(H~Q;y?a{I z{o$_LveQZ;M-=+KK5o4QKPNr5*+|;OdPvnyiq(?75I;KU_U1SyfUkbVV4?_`J59jy zylwhg_Jd^@4JZ?=b&zWoL9os(4ko0}U$5T7-=w}QaL@jCoSz@63;K*C-uUUHyiJH5 zQOwSaT8F>*_Y3QPzs>!>=z{l;zEY$EzhO<^%8NtveXUw=7s}L5Jy~fM5m7J@_DuMy z-~Dk$_Hcd~N{xBbe{nu=2_N$4UI!uZ#j=6s@2f=l&4I`@r#XadUwUc2!@^MGayfc< zS>eAgoija46sYeO#-gnhIH>se~fD$y%6H zl7u8C#8kErlASSk2xXfnL^4Sw>y$O?*!PkwW8e36#yacW@A5p)=lFe|=lvYV_xtbn z4}Z*k95eUrzOL(ayezRoL6_&V~K6$i$%OpFb$vO1HgY^z=vL3E?Wg{>pPQTtsg z1ZfFt4bn;kw}i9PF5`HV$8!!B{Ybpkudo#ce7RMg@!f2-h8+2c-xfcwwp$}kGQyQt z%)7|~U};hj3mSRsSeB>z58QMmIrl-o@ovZa?EdHEDI`S!nTR)IPLTxjElid#buAQR z?(TK9lGhUiy@N{oPzO|rJr+DB1>}4`5$6_^9Vt+Cyv-u_^gRSgjl8xTq{<`)CGSq{ ze%ry4Wxa#fAO%{@%M5`=EBkCoX{eU;!+gp169Aa=2vJ*U#jdTtdo)6AqQNuw3#5bd zPv|Cb_QiOr+zg*)y(yl zwV&cOYCnd)Gj?lfg5$k)j4y}OEPgw#RYQg)DHZ&uDL0xm*NcHE;Uw1DY^mjeu%0SP^QS6i-PnF5`Ck(F?jbZnd zJ!rm7ce>z}TQm(-vN}Ih6j0L^(sE{B>iCbeP%|anHte5fy+^}$8w?4FO&*FIU?@jSjFHM06su)!wpX8kSKEm&EoV_jofZ0yDns{>duEh*Z0P0c1x|jtDjUlKQD@9 zIJ&o4mhUkRN;9;Sy-K)^`;Jwm!m-q&H8U7B>amt{M1j&65@`BamlBsQQ_|~dD(?2Ui;()8WG=mcI3ajsIrk`QqDc9%z8b{ z4MYN$hCx=!N84?9{aoGeXI&kyjhOAs3MZ4B)m=#+sTF9Tp~cnxGA z?vYGMtitgC*DvYoJPqsz#7|#{3(z`39H>(6up3s8jP)ew*NuwRkzrxDIWZ^RQ6_cd z?P_|Kk4x^)6bVVx_wh;3jq2$lHFVRt%hF}UoikQjJ@GaBvJUJyzIL3vsD<-^JBJSE z{bJeJjdAndd3E5CV=#_@0Dr-x6i6C29(DD&JwHPFL*Xi2>@S2xXO5-Un) zUDVIwibji`t0dWq&IwGn_BqQJBq!!CPG++TidWeFKFl-TT?^}(%R4Nu-8dh3H2j_c zx5DMkr-+SL1llfasKszKv*9biYcgLuJ##qHd<~v&HwjEWr?ou`M7@YkK z2%VdR&s3c8K4)`FkXywTOmt^bwdW(T`xHCm!z$pHgOMxe(`IFx2;!iTiWLFfIR>C>OfRVc7%H*jpD)Pd)1-+Vt&w(d zhT;PwhYw5aQ1>NY{=>2FEzk)C3ZdCB0T?@>dyuaR7{|5odvV_I*e!KpxY;$nrw}d4-Q5 zsO5{Ia;{(|!$p85^@_)YT-ByJN=_A(2?z6Bz-_@$DjP}w~ zWvW^UMTR}KsgA+jP3HXMr^t(*F|{<+Jw&+yKds?Ggj_BuZY#*$Vw05@ejnatq!Ad2Wx+MzP2E*_b#v^R?n8i$s*Jg zZM>UI|8Q7z&#*I0&^LjiXkXy@gZ5pk$b~klfOmY2^yvQUH|EX@Z4*?tE|^IhsK*&C z7F9UTHp4@W=Q2z~4kyb*fv(oMiW~6RwkHn7IGN9f3#pLr4E#`P#cdqHibe21$gcfgsS0OBo?D*C7h-%c{fQls-5g^o+{_m=C9bI~ZIIM1V72GFS1O zqzN}9rIC%OYoqhDunaW_S+cy|UN@*vNC9TAquh%u#kZylO9xj=&itw$Ur{X8f=oYm zl%QgTDneH{sXM9?2{lAv$Dy6w*Bl48Z}^=t)!aM9FIDdLvwO$mjg#LQ?2Dk3_<)tv z5TX%NS+~AvnWF^E=*mYm8_U1$4SusmAALw2KHWu!FnKmT1(wewH!*ml)d35H&8?dY zINo6k_n#Pac0bzV{58}*`cPXX&#)y%U)PH)xyv_O%a@2%@uJvH=0;OyPFLD=)r-T;t_iN8f3Ww1rK@O^FR2BV=VD6{0d^Qf}`xpoD}A zj(ioy_ex4lp0T5SzYe#Pj0Td?m#z<_QRl~oxxC{mlSN4se1yWRd$!e$SIyrG-+7iO z$*VuVr)jb?Waq(a$H^Bkg%HIU`K-ix=qP2l{+))(2&tf0NRN8EWJJ`X&CX&l2qIC{Ora>w0TRWaEh3Ua9AA2u>YyxrBy{|*660nM zP1h5DIIg_J8=m1RrI}n+WQ&ric`mN%pK8&bKdlmvptX$xv(k=AoAguvMCa2T_og}Sp6-Vk?~&f*Wku+yr+41s0@c>E zMeIdj`||t%BP;x@bPNx7U$$&OwMQ0oWov?1KS@ICON) zPzyJOvxW3gU%gm~b~Qk6GY){(Ph`G1R6b|*o(d(FQYpn9z5LPP>yQ0#JS2D`Tanvj zcxS4M3a6xNJH&Fjw| zY}n(prx2km<8gz~A$2N$M1?H&AXS4nKIn2I{91XZno?%Ey->uVlgB+Qnl_${DGtcj zy1hIX&<_6~s+130z>0)M*ymr!ML zd84xHs0sUHnb+fnlNVMGYP4r$LpNhtpK!nO%G(-H$8;rz&i??ZM}^HjRIIlulRbb= zU`z+Cb<}sqKZL(fn?cX;ZTQ*VIV|F%IB8sO$K}^Hirh?dPvk<2WIB8QlP)p~)n)ao z%xiSe)~fJ=$kpF=61g8UelYfycut{Jsm_+o*wS8Dd%gU=6JKm(dD7k^Dx%jq4+Pxi z*kvxULp-zZM*NYl16RFHeaYIhBw&4eV)rfsUp6m%+HVe$Ar(Ni;zTsWH0u72o}i;Y#2zSH<#yaL{K!cDXZg{@G`~B+V(Q9RXv_V0jJK%c@Ovo zeuN~c=UL3d{pm7JOOVaP%TK~0eA=UvCd@#R7ir`TiAT|Zm!&{fzw(SJl$ z%H;_c*P4k*!#85J5W4|vN9Hu{TkTlRF}%od?SoKEaR|3l&C&6K{c*?olLFRqSg|er znMmYVguU8l{m+{w>m>SJw&83O@s$R@1>rd+UpWdEHQ&$B4{$<+KAMCDPeryCi5WZ= z4p`^wU>VR}WX*5>#){Iej!oB+$6Lxsn8ac2LTBJ5HDl8sE$pv*FL@ggP4gR3=N=_K z%Thy*PDnXgzmZ`zDMYrkoLE}wJw@(D`CjiArH>_U@LEq&^-N`2JYmmVIvrC$Y$DMl z@!=neD51}=Jip8x#4KfN_RYKWI8d`l z_QSj7lYH`Y4>8mpNiiM}rw|)TG1q{=8oy0|QTYBndv6kXjgB#YNg6~M(aCi^0GuTdLS2}3NKV%TON|RZ#h)X`3@BNaeq0edcr0X2|F>z)$DcWG0 zcP`jpa7w?*>^{qxXCK+%&abM!p)Zi*FR%}3h3O6rS)WJp(){$O;%{J^&*?6Ftv4=w z%n-nZq@E=H(5qTIUuNE19w#sGC0jg;jb?El^`LCBc)7>WtmBxxrL@mxEtA9EiCP`w zRrIn#`X^C%yBv)?ph!~%^|A^Lq|;o8It$s+Ng#|VQ*=0$pgF$Ck5WQ>zlb`&*gDTV zFYmvmVICk)%${<8-yMx@n5{n zD0ns1J}N|tm=pldFJY=lY3EsSU`>5uDe%KbDWp1c0XL-tsadi!r^bz8wJS`iK-7rw z%(Q~)Oks%w)+I!h*tM$C@#^=7N%|5=M8mEU`OTmE99MjR5hTwMt8~iUZW`#}JgVt9?5)N!BV@wF!)%-bYm!IMIsUKxT3b;>4 zluh#-??0}=49HOnDIb?~>13ezS8~kqzeStppyvuO!~x$y>?ZRzR>vS1wXMv2toEh0 z&xT2Uew&e-2lEScKCr(cu;Ll90RpKuG`I`}jkWRETk`)NmmhK<-|VYREo~j;oO5KfQ&7QK*h3@iqt!wV!G-OM zCkk(Pt#qD2-SSZ!nNW~bHe5qlQr#3cyv@9?mD?_{`B})uG1T7_DwwW@MNW_uNR4r_ zpB5n5627qE-1nfd7x6))rFEcKC5djN!dyU_e{va*nxE?U!*S7<{g~JY1QBA&tndmo z(2elcfW2*gy}CSt$R3iI+DgnC$4EfV@!OCNeqxs-$Qs=sCKuof&SBbYpi2aaGY@7bA_U!>l~g z*a7Y+3Y@BiDn1dv)IbL`p0l_$03}8Q2*x9@H}?F~?1%Jjn0C4?D8G#x{#t_Ag$gU z6@?NifcR&aq}&r+b`Q)0e_f6yi4=X4m<^+z>#e(G=r_PNsD31E_vU&Q`um3tf5l#0 zS}aSfGe-d*rg5k<+x$@>qu|wc)O>Cb1HJww^mJP1UKkD85_Va7gK{}72&--{_}F8Q zjF{+$I_GM%1jP*gQd!C2nYFT$eu@Pew*(wC#~x}re^}m}Wf1T{Tir%mr9q&Ol!ab< z(E1S!V1(ceoo9pItiT+ofv}YW&HAxYiS<3C?lfi%ogDl24@Vg)n!z6eupse&Nj2bN z91;vv_~4Te5du}+4ZX9#Nt0dWNE6cjfM zeUYukpuI1D?uVI_6w~Vp$jyTP<(u%oK4cWfi!L~{n_~J)B-lHp|7qxe37i_5lT*yf zRIsB(2O(N-O7M3k0^(bHI*rAfXBn@{PA1=YvGERlt0=O(eTORY4Ihh+ULv#j#FDV5 zC}a2%4}EC4mso8^V=cm4{_8oRZAI}EkSZaEqO zVcI`*3FuWT>hwkcZ8(KxOO1<8rA^<-%gygx5)Ba`id~81`)+)*hXWl0)#&1WA=hpe zw6P9=R~<$?;4^V@z{fIlUI4@O&Dj2GMmEw%B5w{dRzR<0gU%&s=0&Le5*bA~?*dEW zY4$FCJK(S*#b8!;KvZK?KY++$-vQ9$8??$mxuG%=rRYF26%xmOkD5twB+x{_+Tp{L zBEK4hV-3bJy&EkSRL^wREC*SC&q!AfQQZ^9_w$cD(C2iRubPU^*0_RC8gt%8jJw}` z@{`u7!F&>dj(kX7NnnD(Yx1Q91M|p5u*$T{ArlYQXIwjK#j*k@_5A?J(7t>(0Z_8z zbN0o{ivv`7FeLH=yI=P40ypD`h*}13@ zY@2KyL>H2!{7dK1TKx~5gFG~nj$FA~rVj4x0d8V|`P@Z+1!4ur8DbQ{l;kGDVZLLn zqyW_Ax$mOz)gFk73@Z4WcmX=g_qS`_37ieGm)BhcpuvaG3s}3XU5js>bCtddEuyK3 z!y}h4Kgpm=P^wgk(27q{9_hpJ%VJ+`mkb1LYW(AcrOS-$8g)WglL2&DQZTAlnRJ_@hvN;bgUvUvQ|ej zLGgFpZoP@p59^SFNeg^dK;v?_^!gZl6lyw8DPjj^L2H-L_85B+{3PQKhj95NU{h?p zwc6#c{eIYY=C-`biGYcNzCoB408+XbK6ZkxQPa>X*Mmcl`td^?sF<*XsbxM%dkSUh=^MK~$;M}=}%D=WKEKfmzVx5(4B5jBTj&6%#C27!A+ zVdJX}8FrggUB=fqJ3f(4K6nGjNGTWoQ+H5<S8>_D>uK!2>kZUFQVyj#GnSkdP~xmBZ4*x_}-bxCHYwA zU&vi(EkcKZ)PIz8&|EP&HSPMZA3PC!?kXs@17msP82ddD z$Bji7{PwsI1pHx0F9xM$t*lnGM1{3f)+8JD&wXU0JqHU=T z^r{PsU(ge@xD22T`8_k5Y3MdWZX14h3|$Fvc_)sx#_K&ST#b2x?Lm3=YNQDg-_I|m z|I=A4JG|z4r0GAM#Q;KYr?TaNg099C$g-k5Q5*a5Anxj6JjwrYvcDz+|{#e6Y9k1bSHvr-MlUwvgEK29- zq_U(-ih?&Z($$oTMLc7y@6$34`bYY$W8IjR7An747p#v?_@uqW-^zH8tO3HSDC!P@ z8S9>e2AnxGqNlyCL3;W%timY53-u{-22zmG+3_gp>y_8m1n7lG2rE4v(cOm0s zR95R_4n|^NdH;qRrIE^CJ1_V-LdWH!=+JlPx39R7W2bCHXDyR;<5~p6KLv-Z#$a&E z69sAmrl%}C*3YrH|B)a&YzfD13v@+3=MYAVu@m=sFA zE|>PaqA^pplfG|WE++n4(7JHz&$@v)AjMqKQRq8OEYYw|?w*^gpOWf7lRPxWX(}3{ zbb4m)NmkZhnw&4Sud_YaQKXUgC4&`2D@x7y)O(i&qV=`29=%QHG)0pnEm73^+NWYF zXS$j&38>>UIl?%MF3*AM;nQ6rDtGVBv?T6>Tej`AHpJ|Js?;=;hgoJc39vGjpNl(2 zI##Y|r!`64%P)-h*mvO&{*7e5b+SSH_ZS^wh2zRu+atFfnqL=b4~@=CzBIxcHQ^L! zyHQBmv8CocL35rL2TZ?m6uk)&+qU)+OS*fki+)%0mZpGc0j`TYDN&E#UpMOV!gna) zQLyxoq3c1>9gpTtRc_p>)Ba6LVmUQ_D37z+mAPp{uY(_Rf>J|Q{^_h&lQ6$fP(R}!<qrMvzE?bNvPqTb8)kmix_8p(56AWk-v-VQ zTUQ?Cd{*W&;L`QUFIR(gjnps9}ZRSh@LvsxsG(Viov}F3$(8>S53nrB#M9kQ7!+)P5*v49~Hh@wtVQ#1F;vi z&5P_NPfK0KmhN=D?UYm7J1Qx zL>qUxe6f()hD3Qdr&O{19o^Or!)d7!p;l~zoNFubH>8oi+_9WRlZ9+kxy=X7O0~~E z`m1^Fu_i+(4Py>>C36>bDE>gzd!G5~P?b{5anGlHTfyqwY}FqQFZKC}F!;>aqbMKe z^En5cSw!tYb)zkPk8;TBcUu)n@9$D>(rDX!$7R-bl0M1~IzkG=3H8=J8C}ZvRJ!H6 z7_s9}1M}Iw&Ew=Lb$>6W=)9%&^MW=+k#6bjVoVkyA787(K$E@o-l{3N?)BPqkl?2i z>&&OHgs|dUwKhEIF1~MXVP3IBVC^Br|8(K#xz6&Vl2}oRfcAJMLt1l0&)`&{(os^K zY!hq}e^D@ho)z19v0Z*H=yL{>9w}YxRQzh=B+k>UTvmsq?IRrfPx6b@zgTqFXDvqPw&V zJ7XMImd6chuh8)0svc4&Yi{Iex;#7@XsC0RwqWr><9nsL)C!S5FAVro-nV8mB27JV z?TcnVm76l~&x*CodOy0#Sxzb}vHI*~EnH^sqB)_}N~;z$;?;s8r_oZX%Z=Sfn1JfjoZ(oxo<$a^V!;+#kMzY>&Le(X+d(#wivZxijW%IQ66bB~3aSj4w9 z$9Kkc-Rb&~W0T_LGYkDNbz_o`iexG6YGCip1a(*%;KbWOr54}{`~?7%F=7vjb;Vhz z_I4vQBMP)OfFwQX1GsGNyf!)&034UW;A;$gC<`6stTP7QYQw`y@7Qm}p0x;S$|ee& zU)rhESv9w(VSIKTwB^~_XbWCaNm3(nJzBT4@X%0}Z^^tb)w2J2WSU4fzU^}Wm=mtm zxC`Dj@YO*Vn3My7X{Ty|j6h8|bpw)&F%2M*0=HP!emtyhfTj}$dypfS+i}_%gIJ9i zOz;upA%%76NeewE-{MB@?>@J-tzR&oEAvpCG-gOK&(C_EAFfJJh}1u!_-SF&^?E2R znzEEUk~G^NF_u&2?wu?)3Qn_4B~_L%*VG4`CwtHqZ+NRAKW0UCO-i zt4+7K7NENSZWDal$P{u=H@!8#yGXFmfFO1mL?`WOOgoI;I8Gmzng6^VG-2Y(b8xb;VNm7Ck-2CqFm4_2I8!H3% zG#+2yiC)1ob+9t8MyBhRk9hAqeIyPYDV-o#l~=s|A*Xt`@?NNKcg1GVw|JxX32JnNtf z#+wZ+9>Q22Rvma*vXuQEx6fKC2In{Nph}r0UVX(P{oZovi&H`yv~bSFuepWu#w%NN zaId~-FB#oC16_S>Xqwpl?K90!yMny_qOKt1?am_Q!$sFdgLO-h_ueP6Qlw_^#gAB; z;E_JF&~QI>ITSu*UnG`|RdseDrW&oVa~E*4cf1~s9u3X^Ogba=3nxYU!*PoSOmb_X zg9T_?f<<}a#BNo&+8@tT8QKE3k5!j3NY*WXC09Q?<7viNN2%A3sb`zsm{;Q*Su`I* zM!KW6&uBvVit~+UQ)J(Tt$x@05fxV4g1qR+7^cLBxRZ8!W3Ex6UK|WHXm>iE7r;?3 z8n9hCvK72VVK|vN0?+c8_E(A%F`mnrNFMbfCc%mF#j*OD$rz z(7LmzwP7a=lDt5-V-^5Bq>;5M$g*dUS_`cHa3Bl+aICkZ-VhhUNRj+b3xY-^)8EEExa}etC+nCS1p1p(?$c?8QGE zwss-b`!>yfJac`;lGzyrFqNm7hncS#J^kngi zRTn@1<9jVQMt}3|I>eB(lUjLcz8Xd{8ErlFW%O3^veD?OFE!ob`$GO+xJ2V%-`zV{ zaf)$due5r_i_Z-w)OA1Q-+#frb5p zDF(ZsFr>Nr=mn2{-aX&muNe#MSRwL6%t;xAf|C!lL+?{teyyVZW)`vjjoJZU!`I3( z`8{0Nr{YL4zT_ZOs8QFUT9okiiuYgwQTEP{h6Za0v#$QOvZZWB<%?*{`-qjj(_UyK z%klK6YCN#ZxpUxf1%^0_(V?lPV!hbUSxCyfNxyIrPVo0+ZW8eQD_=1AaxXq2Y4>R5 zM9Tf4@}zNjMt-^;OS+c(DqaMXvGFb+5gvVy`3LF?vDZ^+0eXs%C9H_d^I@J7#hd#EU!c-(|#@X6l* z)7r2A!s;-t4SDd$$|e>T>}sw_zgYINm~Lyxp7`lsuLbEGftlSl>3n`PVUpH#U2446rSm!AyRVf5j#}9w z*PCwTN8T+=&F?f6Y{Wyw-% z#$e+6J2WGsvOJp8=+V=00&Ce^kw2LAs1V&*K4W=}&G=&mo0;W7*tbnT zv)bnC$E<{wTCD5yR@+afPsI&7ZO%d$Fy9(!=PE0X(4dbw;iKlfc|jN672AusbxpX% zd8#*^B3tO$-oCYTDPu)vWSixoaa5S^(8ms%?nriobX-)ma^ z1)_L{le<{UdFQ@)Z9%(gF?#+erU_P()<)SJQy)sD2D)WhI4s$O8%5-q4C6}`d|n(l8`L?3Qc3XWyQ9d$t0+K`c`Rwy*_n*m4}92pNWr2|tq0qK#TR`Fq1KZ`lBxBwDi?r6vgdUZV-%0Lcs9F+aOy&l$EKbcidnUM`@2 zG+b(TK}PyJ880o~FE2>^IeNM7yn=JuOXH9|tVlbs!0%#=@?`5<_FD=(cR4~BfJD~W z0J*DDgGB)e@5)5=%#h_>$|+@S4@Qy*Qp>fFD88D+t)WWW?Gl1K!ZI95;Ia1gSom;E z?v3zL1fIslw?Sg@h>oFHqNF41vK$soh5fbN!5@GreYne;eZH^TCNW~Mx81)9<8wmS zyq*iFjITghM&!5-%XiRj+=8P}c3kksp?R~{fk$=sSSO>Mw>KP)dw_e2UU8xtG$?~} zRZh~v8;U0AC4&p(JTq^94NZ8pbpEtflHQ-Hiy~-(H6Zge56{$9-}hO~mYr7<(A9COUkwyzu4I z%FKO1RXI&{Iw}=ut)t%#f4Zf3zs$^W0umt~)OA#g>&R(3`5*#eYZNH80sJpqsb?LA z_E3@4^Sy4aDFf1r8Lyg(ibpGv3yoW35qhd&F@Q3{`iuP@YxKU3KiU)#1|c=dkVEEC3w6F$erG%^M}LpVj6`QS*7=@ws-RzTfI)@ z;Z(w@45Pt1J>O3dFhhD{8p~TMyh~7`2fe~%-o;);@l+>>WQlQ0ZT}mJ&|&$7t9bN)pDKEs;ihp?o{mMmt220~}tL)!sX$GUh#NuBxF2 zBx8*I35tVDvCHI?am>H}IP%{=`pL2`$ZmiR!{k0$csC08U#G$%@yx4Gn-f3qct-;3 zP-CXBOG4;IJdmMu5LvsR=>PmlaDOM4K2NRFSTFBwYlnj9!8t8s5(}Kv&C#Nu0@%IuVSh ztxIqGP4>rvQnsi*RXQr9&mk-3{QDid5Ygj zTt?GmUic#Mr2ioOJ21KbsRQT^FYfZc#+8kn@elmiJL-tPwoqEValKOFUV+BL;x z2G?EC?E#PqA@=tzUxh7qg_Ig|7VvxMLQ>{P!N@fgM<^ClIznk%-Ny+i>fv0Mf3%|> z0xb;3$)p)EKu19Y;AaB#1A)-pyB4@s#y;|`{NIXo-KITx$RXcE3X$f4sm3#e6-mwg zVCJC*hj-!*&LVeIAWgAqzldp_XBU#SO>-{2;EFCf=*gkNK!1uIk^KE-QauZ+jHKc) z_^SFSK4!DdqSM(nb3i^0p^l+cQ6rxjSK^1aJ@QcLj82>T8rN|DWG;Dx4>Cj*kOIYM z0pQGqmP>^O@>5burNI}QWF4>rh$p;ZutmvZ$BDc?&x}ul$oAyJ4?0)qzvl%}#Q-wc z35P?#EP!R!w$SkLPG-m}?eg-1$EZ;Ggm@H1a2v5?p6Ug2*;6HtsvFfIxn*tkx&%5L z$uK}iJbI0IQfe@Y$v0k}EVwA+!qCzX!3tjUljxV$xl~m^p67 zgsqCb`sGwe;#vOU9h=zk%)Z{C$5ST~FxI9rLOL z$0-b9FH^QE4IS8WqWoUxD4oYKsEc8Oju!On_`t2_{3WdE@SNEg;j&Rw*4u~VBH8lVsfI%$Ym4*YLDD+%}=4HVddb}dJ}`FMa6dOTT#kV+xMvNQC#b?KT}t2 zevXn-*pp36Fz{oDMEW}bcoJmEhaCzw*; zU4YyHkKzFBOS)|nv9vA>UlLTNJ4r`&;{LH4;QzTB%r2rfn%N)MO1YinYwF2{=4Mx3 z)&^KrHwXnAZu)HtD+VcY9@7B&weIzY1KR+`4W0gQm;#nxAHt%2!J|~w-PPrbCSUFS zoB^e#+vg{IEFSx0qiCL(MX;vS^D(S_5UgnOWn8V*CgE|{AUhVkQ&J<9NOL0e`N5%? zB<2(fK8gSLkLAFm;NNoyLohK~*r}-LLZCwk05o}h`c_tf>braH4~IU9!Utdj4u<$8Qi+c>I{#GMv_wb=FUXPnI) z>zHQSH?==DbpykLB_bH)ru7z+!jp)&CyrBo2{?;aV=0S|JJXxhJJEEJ(C~`mwBZIa z!G)S!?3MNNykhGQagC=*i0W_d>IgJdCfhOPp;8P6GxR-5;K8k*3k@6`QVVUpUK=u{ z?9??M){P3;yx;E3Gpz7%?{S~yo9lv?zw!PxsXtD*&L+_KnWwR*XqR^fg~&Y0#MOd5y4Ct0Wo;x?izu)6GY^c0<0YHk+_}~ z1T8400lOy;>i6Z%v^hwhLS#KphXUZV^&B7r(foCb+>dPDs*87SDQmD0(`&}FZ+d|= zMtvL*8CK;bxO7bLb|7jyV2Bfa!OrijcWb}Y28Np1T7~P_X)^z+>r*W6Uf6biVs+ln zcm}%SeQ9!iZ~9^zLzDrAIM8M;7lUgnIwDgSLdY1ndag$W-2kg&KE%>%z%EhSG1M_~ zEXBKK`zHEb18dtM;Gcs>|FQvs?$8w4vf!z_yLzOAEuCLz>y}()7gmgU3*<}FR)09| z^#Fv;y=&9yZ`V5aBlpk$mox7js|x7ouvr!mOWLuVw|p%{1&=xm}lhXhD8^OS!WYn`P5SdBPd z!yA;V<#il{o|$IxGONjE%8LlcG4bGF;&X*?`&+k2qPos)JKn2v8Q(tTxldgS=Sp5s zl``PcAB?65hT(?1mcY>a+HIYKvW)@mzB7yLlC7ca{i>$v9JjQtW{mww&Pn_1oco80 zk7eXu<7C#8{N^b&Fqh6qY0L0)Sf2J&zh7PA2425PIG@~c_I(iC+z$}iGO0}slJr;_rXIG? zCDeu)OS`TyE#@}K8@8K=d7853-j(XEXj}uSA6*zG?qwd`(2Wf#%Bn;(Z#-|9%jH15 z!@6PY;HD#W#P$A)_Nu+m@FNfwZHN_=I^}nxi(s^7&(aJICz?w8(Qyx%o?xgJtmywd ziwMXLXm%Ur#kO5oMZ2Fpqs6cKWg5Xl(55PWvxy6h@ijtEXIi{?aJ$8kt>n4_mfP4f z>%0MNbL0w+q=D#R?^qR$|_Ktiu7zuDyl$w7-XTcxPq(NID{rn# z5MXcPz?~$iX3`DnO{=E4v_19=cQ3DfW9y8piRXq)<|Sp%+As#BW-z@WM#wsIcjQWU z_oxAT z1q>bs^3UiFFrZ(9$)GQn4TSe35T+VuiCYOG;HIw@;9ADxnH5J_w^-41&Ol5Ed{bP!l$_2#?REnfg#Mr2q`kZNF>m8RVE1X;qY_&Yskj`f4WOGa8W_6tU>F zKPXCGb^doDX*5Yg7R+Hm6h(6Q4@VT5q#Jzhe6&%>5hryc!??^PHOVrgxJ&vxwN;9# z`iAZ7=@3Ipu-NyFQX%+h6UYlpfWgrdJk1UPl7zM02COZK=y+@zgYXvmC1$|dj+wB7 z3n#&;6$SvBz|)i0nJ2(gbJt?lR}t`2$9V?5f5VIBH--;oC=ofsoVvRmd&eKPTk9O? zynFci5#d+!i41X4CJR+VEe9P6MYke zkOe#*B~k_$Kv8G#BpCA6@gPY#_X-0NLZX`xf%NnY9bbF zb{H>YEBaUM?p=4RkL@AOXT6g6gdgowx!!+038&wO0*JrfPdDH12To*%r0y7eg*Uv*;=pZu3h^#&nlf8~^!{m__x$s#^rhrqPd&d# zOowZH0c#iCU1mvob?$6MAt#@jx`hO%%ZlTw_PV7xJ~gW5@*&+jdQeRo{oH!PXi?Nz zkTYFvsWtgzg0_f1w1Xh&&YXkZ0LPjjOd@D%fF{0pzlBMkV2?rg=O2#4s8Md}<93fT zp0nrs&+6Y9eL(p51Sc`+oODo!?)Z!b{!_8bwZrRd*;QhvcT3n2$CslSP4LRO{Bj>l zk~+Npi`5cDyFckOCH@+{G|Ao2kzl{lzvOSA^j~=USX>AU=FW=#GN>fQWZ|%|vgLpE zxUZ=J&>~umRL3*R04H-~;U{kr8xSq(lhwno#U-q`Q~Gst(TpXd%rIr5!VFEeJ@$wjFH>Yrc&IPYrp>SL-N52vpRMUHa;~#tinjJ) z$3LbNcX9HZwq2p^_=BSbF*6nh1gTHKu_9+3R+64k#cB|_=Fr#_&%ym6odyIb+-Pfh)(DgQo>P|?U11T zyf8dUh0`1LzjCJgV|QW&vT`*94$;Sj*(l6653@|x!sk4*$+$}Ia2%@D7nbrJ~rt{bL`;~6$WOF<_ zuV}V^$=Bt@h z5?P>%qC62&MwzkZm!=RW~B=3WdZ%cdXN>1WiXB|ZBt6Y6}e&{tX7<>@FZcu|*=zx~I{Cx!fx0jR#6 zVG~KPW@uLlh}igKwx-`NAKX`+*OeZp%D1%_Wd0ruYQ<0OB-$d!!L_s)nc$F%>BPuY zGi(qMKY23mx;}|7FS)kP{r0sFBdIk#{BftFfq7v6IUr#W(T$o)_#EH4hLoBGo5P-Z zWETAI1rb}zgv;z8;#7|o9DoT2#@Hvy@t+o`?>pJkczVh-CM*cz(-fTo^Sx`*w*P3i zJ848Lg2Baqaj{?O0(e$`(2IpVlV-CLuXbQ#>IajQ04cRl6UE`s@5&l>XmS721% z4}Io61}^ZRh+XRsj^JSo=AhTIEUs?Lqe>bVr`n@q;8h%o_SDECzT_v3@h;0l+P84 zdFt0P&cK26p?c%2W7)0S7{|x1N)QK+>w?on=`TYvMvF6d}3`{v|X`+m_xHj-s;_X^v%YYM@8MXj<>LaW!l=C_iKe0GScDF zYr1+L597Ucfn@T?mZWoLu4ARj`^1m}PvNBE^IzJPpKI@^kUx(Pg=8>bG~@O=mDfT> zZXeN^D0n<^fw%RjrS%z6&FQMxUqj~>`8V)Qoj7jc?eFelCQ>Vi@6;G}% z7p%nxlC`$r&f}ZHv%dyrZ+7>;qWU@2-^wTSJT}gteJ)8!T$w2V%S2oYMmL$nKHGrp z@XFm|S8?&q`)$*f*SXsc!*BRRPXfabzR_hHdW=uQDUUAL_=@p#>+;g>SDV%s7}nT9 z&pNmTRGvo#4xCq%QE+_45W>;H%X{XFYU0{!!@|COQ;*bwO3iv$TyiqVc zVk>g2LbE!9_ze>})%0KbmtY}NT7S=|mA2!f5Zx@#%SLVY?VfS>{y4gnhkS$`kApaU z;XA#mCKSHz@w6<@KPclF-S@NtZuSyJ=f@P9zrcKl^H0(ZDJJyn>t=VWrU2Kj~O4gq(=%TzDJ&=;C0Frbq7o0uKSuxhXPaY*0$` zhnCD>%L|oucl5b!e{d))F~qcHv3jf}y5(da&wo`~1G`qaBFZ);wh<1^P^D zW2LG1Srgh4{UJsgsNxTvDe_JX4ZS#DN*7Zro4%n{B*Hq6pDraJRWs&DGuEESOqN=U z&Vko#n~&9H5$nDffidazJcw79`lPePMw7AWC0yw;sBU47*G&5W8G^Ipr+Ei)iM zR)(U|*@zFbk)WvL#;eyXo+Kbc4iCN}a&nTmJ-wg$A4^_!NIst(@IL;W(Z%exMIjE& zy!A4O2M6q9`{3b;_{QC>Pc6NiN%yY#_@_+<;9NiS?{N`)VX%P>m?u3~x)yH~L_fU9 z1jA&V!}7}ncwsu|YEWR9Ig~?bx zB3TQ_N>%b&{k|dVZxGTCNh4-pKWmBBOXb)qtC;siDsfwba2#qOlqb}f?2_Aj@7P{t_4S|B^NMMJ-!VTg6;aUG5ix-ssEMA}oflb`M zix)^Np*+ao+wc7Xn)MB<8OH{9jXFKz)W{fAZ$|7Otqt1j^kv!4Vj9RuR`?iwYzjBm zN&9Vmx23?@-f;H*z6}Mx5~eV=t&k3bs&P={!>xEiIzLNoOPV6jWN#7anSaJ%*tH$3 zEG?@kjsHG>N?ti#I-M^M!M8^zRhTu183gs+HNXZEwnm5pFW|YI&Hai(SFKxZXT5Yc zE_%_LuzGQ1crmJ$Ejl^VprBJ{5k25i`nH%EqjaazXjS!7PgkfbI_OkgZtr55CETt~ zTMHdYolLl16Zfhz2>Xl6DfQPHhff(RI~E zK~M8bK^xrJnoSrmE!U|NAM}jlM6vbBRD=F+qK!)Tn?_iLHc}Ct7i0}LixzA|3?n^e z7PG#vI{T}2$=Q>xdGOHw8`kPA*apvE?wdXUWXne;!CL;_PT&;Eeu%9`CSlsJb>_&) zPV(=#sv5|MH2Da*V8SM|7ADrPo1wrms_`3EQc?VuWwiZw{Lf_+3_GAT42+lxo*S)x zNbn7!4P!JIkmq*kTl@RJe}a7D25(Hr17feYFaC|4N&IMX+g+y=8m%q&)tl>T-A-Zx zYzRl@>Z~)2k~&Cv5&7wz%(tgm1U0m7+r1s^?>Cs?P{smTaTrf?#YSPl0wv2(`iO5Q zaD3_Q+p`(V2Nz_dd#Q0!)lc!tD)qh=nB`gK7)&kf&Z&_S>r_p6>@1K6N3z7|22}Vh z@QM2hmG;6gCG+~Hw)Z@THPqqvt-_&?kc8iP%1RTQ%Mr}BC0|G8w(=2jFTJlwPyZQ> zAyvY9)h_f>kJ1q=6B%c38@OvcP*dAKg?SL__bFT4m=H`~z}T+@dFpPfd?ry+m8>xv znhhNq@g)Vnp6omR*zi8)%LIIvMtyjrEotRY4s|*9Z0#M9()Nhkm>V<2s(cp!eSqJ<4dvR)- zipsB6_3uRY9hSA_3cqT}KL?)JoJyV|b*B`=mPE&qgKPDV7cfUEETgX5+uCPcY3Qto zErZuTV^3>rn|DPpO6fIJbQ4kB&&hWZCpzMtpla}9!q~6;F#O4B$!G8s3+mb<4_j^n z=guAtb+YTVt1c5R7Z=H0)H3-$j6O($WD+G)l}< zhpez@Cteo;s2jB>UzXFmGM}XXDl)TQ)(Qg)U+5$)Pp~@QQ!wa-xO7s&h7KUt>&_kl zbE{*`aZCE5%lR$F6=GT<1lWRmh7v<8aB0>!ghvtM&__sv_K#hKPi(`<4$GKt>;!#6 zy;CP!rOQ=5YRk-)Oh2ZVg}!#*Z|bXtuPb^03JP%T+y6A~pF)o37^ktMC?hhg&b%p@ zeb^V)!um3CKXE))O8rYkZ}lMxZRq^kU_PlQ8~OBG{Xwm%?dZ;LN8@;`m{J@KUq8BB z&`Bqbyk+p9042N#D5j%Jlm)0Z9=j!PzFNCYb~`a28IULe?Wdm__uolzN^a0D3^(c# zC_J%3QkkS|ZDxS?>~7*#&904UYywLV+B>3tPfR%bH$2Z+cy)Hjytd7N zFP|_Z39~x%MS@M@FO4t-J|vN~-UHyIIHOzq)Cp z7jcFB@aL}aqf+$AM=PjR6K4`A%!}B=`qM`(12g+~-LRj!v+FzeqsYYRj)ls;ibFk@ zeMfj+UqZA?N$*XMnT}noRE%NWj-aeeV51b|AfVaJ z23*Sd@k|5kk0qeZ_R9iv5Rx*#yL0PU7r2vxyD1e^@b-$PtQ&#FQ0E3f&5awic83cN z;NM0gBFdes*_jSvTFd-Iwha9pbO1#I8^P3}1&CotN&oAY_)_d&f6zL%AzKkSo2~;8 zok@U3%tJX*%g|a1+m7t=D-_y|WrZvlPB;!8*M5tJQ(7)IKw}rpB!>M z&;6>`{3U4-&QcFtgThZ^=_imZ4B;?4n`pm;r8$z;zo~B;iTA(DyLc~nPcRPkS+XO$=Ilj{P&4J9_7zLXU2$?d-{9bT)M}R#4YP%Tio(!gh zZAu3MSe+=AVkW)p!W%=|Jj)ih-LU0W<)CGCxX%{fJJF@%tD2-KjLL)y%-`g|Mk0D7 z2cJ<1fTo!#0458&KpLzazvESqG3JvuF<-%-AAro0owdk~?lr~{jEZ^izj*ZmFEnt0 z`54x))+ZQT z^;)Mj9LW5FEd&v8(oCpveNV}~NckG6+`xCwH#&`&fWoD4dlCacS{Z6PdROx?i8jYm zaCzEy_X9aAE!;l>5nDz0aHP}N;CEOwif^j#w56w(9A!weDK=ouV82+*cHfX4h}kg{ z8yj>Wt+4VZ{DYT&6LOG_cen{H`yge(I!j4NrB^YJ`uP*-TvW4m%a|)p+$IQg?s*vh zZYh}^%&wF-0Bgn?_}tI5%b)8XDt)UoVqtUTbJJmoy!6OGSUG-j-s@;-qCWchsdhnO zPuoBczY8XSC4eIN(s0&T-Pm!5h!a3UY4W_g`IUm@%?GD%o!hJ z@;i=gnMnF~{x68^us;(Ew(^3pQ`-70*aot|?T2x@+}n zAib_Qxip&Vp2<-vEb8eBNS?5ATLrysVYnR&MrX6Lj%x};9^IGe^D6U-YV4pi8A+E@ zZHmxG33y@0my=HVR?PuO1|MfQ60*lk*cKX&8Ka1^OgUl$tY;cKUl63}1(QyOEjGvB ze8c9nTH(l-CFB&-vd7JHp|3>F62)k&=z0o&({9P5ZT&08@8I%Jy7pX^Wqx}alflYefiycT)evMa!~bi^mCQE zQRGF$yanD7?P7=Kk4xJ{F4K+@auqhcvu$1YE}{Rm(A~63c)J?Qsz`Xo#4A=&~0Nn=k=N_P74pWBS z&)&$txU8l8tzxv+_cb326{GHfZ_8WNEW zY|t{u;){fL?6{JF;;|Q^>X&DBm=$~AMsHnx31g0H`n6e(icq=6g8j6!yuuq(&KV{h z;gE3V#n@|gRG2KHN67C<^Jjx4Ooo)q*9Rd{jq5UBp{i#E!Ioc7j8@^BTNXWq-=)v@ ztJ7i~3LNp%7GsxVFOTLe@Ja5~ZZDRl?g>ZO-&)0c$!`9YF>eEOkwQK$4xlT&9MIP#Kj?L4xu zSnjSFCA^40K22W&U>aj&Ox_b-l0`IOu+pkl!mxZAZj{ib1SuYR@W(T8dBbw8cTdD1 zbYzdsQsd3c7B9^2(g;KZ;D3-+WHLoPI%9$I$ku$lM$xE$17UFBYN>Dg!kqE0Lt*;5 z@}EzdY8$o5U*$0OrlgZaagYkVKtq%=b4@+@<6XxQ(W~jfHSrM`kjZ$at9dgh{+7}8`St|r_bWH6NH{*y?yLqANXB6GT zq+eZFOUVI=O3&nXPc_lBD|CUBFDrEgs`XD(EvOA}*{8Pie63HlheDetXHJGO$CuCYZ zfx(VFofX<3-dz0i#Ii9LkS_6*r?A4d%xn9$vM9)gZ)9SKxMT)#;nQ8F>3h3(LDf5! zg#zg23pV_}mOnjOu)L~GeAl!3h?UpO=aU&Hr`rEmf2xGNci}WpcHD%w2mA}0<^GmZ za`c&sVd(L^5A122r^It0%RYu^F=~MhQ-2`0xi@>nTxgWJj-GC;W!!J z$SLzF(HHB0YUe|jLGa!mnctpw3Qp}!$_f#KME2Wjf}KvH#=|yyLoq{1;pK0)xA1GI zS8VC=@9yGn^xlXeeFPT3T_%>*VX;2;TuTiOV|m*B4s(@ye1CKSzen%N^ki)Dvw@XJ z^S4GQoIQR1jRmFA=*er~h`?0fYI_=gBunL1-%G?Q)6&G!%EM#>8eg@h#=V|WdiCP-9r5faL4cn3>B{mt5sX!D<#mC@3&CuRNA(c9M&_UNg~ zyejm#;~OHzX-*5}rQSbqrXjc2I)iX*1E9YrI`IWvEVm{JMA+9NfjIkR_FE4$i}@)z z7+kan9~dvw5<9XpM}lvP$xt|isWZ($4=2z)G&EB$wWD0n`YPX3(XKPbDw@V3lDF37 z1w=~?5#vabV!Gjb1e+jb z@iQq0{m)$(<1MU%o!dKID4or95x1!;iJtK}hM!nmQO(0O^)~g>GgjsX{o+GuTKcbh zYRQh|W2{qV8_ST(4SX5)o(rrserPlN2yQn*+i~|F92E&KVa~<`*$^@3qtTi!Wf)P|Ae=L5)#wJ~;+<`BNSMcv(CI2HbQD0;xrD z(@zzE9MY53`yegZZsfbOKC>D}vWDhI<+_UV`V?FMVa4}MVqeVF+}gdZ<0Pc@(`U#j zU&1WbeoV@Zwu6Jr_w% z#OwpQ0(C5lC*ijc$Ty7$MEt!S=}^ESz&_wtkx@jF#4r>Ho)Lgt(@+|wxzcr|;QYv7I{#$ARcp({&*P_-ctt^h&aPWC6{lyetyq49U* zJpP-8C4d-?7~X;&u%+v93`vu9&=DF7o()|==EM47L8w)IKcIKC0XqPT^{;ElzdZmg z0eoYV4@s8>&XsifQ$T}&AjGqO1|foU5AcKjOg;HuMBN|wSJZt~;h$0WxNg*75Tt8` z+}LzuHTlC(8ki3FsvbBRz6v*unDv2vjN=$Ww%9s&E2K7Q$T)D9*rM36Iu;3srP3qD z+Y97WcHAiKpgH@5z4RZUHsD^<#JDARS-FW~1s`KZ$$XC+o2+ly#=Ra7gk9vv^pIv& zmd;VenA|po5{@^P3j2ngT5oJ`@r+!agnXVEGV8)L!dX4dT0*qqct>sDu5Ozoc)PO(j2z z@4<>MoxUe`#_i?j=dtr?)hNq;PvqVO)zO3f%i=3HdS~LNryZEx2FjvOwH6x_JJM>j zugE#4S=4Av2KUB>2e0$8v?^ybvDgU>H0{aT&)4Yr&Nck2>~0BxS0rOii`Bx{r8A)(Q^r zGQK04eKn9@EZbM-eHc>kWc;~7sX@RdOgjwzNhkb&@XjN)rzFWH-VaqYX#zS#?mWG9Dr_dp8eX%K~R?*@$MzD?nL_2V)m2PtPOnm z1AK%x0Rds!R~)+hFNUrvmak$%iQ5S*E#jZ_H|qmw!=HH?1XonEz~`c;`rwHV=F8jZrflp5*G&+MIGneZ0`Vf48t`xw zUuYwq-@==4lw#$Ac+u;fpzbo7sN^Nn(2;v~(u*S=-xZEdyBZ}CF1CNq1u;&k58-q_ zkrSqJ&H1W2-5}gPU*bqFq=L3<0IN&`@#z+jc5WKl=Qze5X{v5@ZIf|0_y@-ejlFdf zgnV`>*5L~UHp$f?uCWuj+bhqf>uyXjm7fGlP}CqbDob5ilF!oZMG^ z%4=K2nb(~aJ;2H3A@={XHNETq($u*=QNbVcvPR~fQo{;9O?cT~5i`@>X2$8W$IblM z2ghMkECS%^^$2iwU`0wgIjs(fywbb>`Q>^{zp;f9tdLF z3|*{aYS0z+=ugMnNmRsxCvDC}j*f)Gty=dThacVhaxW&cLWT7Qhmq0q7QJx42s00= zC~sHCFT;g>eno@`{jw4EJ*qiNSifmg@vxU_U4Q(kb)BlWGk!iVQ+J~0;RDt8ZmzrFwSKCKVDEFb(&6#b}T{gO@t3RXgVQJJs6LzQon%(e~er!g3zUrqtbSWc{V z#x?wPG3~3JPr7Z&h*NL3LQzR5ii!1^1H?h7pV6`+UxI#OGA8gT!+f>?a}Qf* zq@l|nTF2&Yu%v3`Z}=N9|TbspJ49EZ5aHvql66Klog z-_GRp+nX>!Y}WUGYE-85z(x?^?b_%UbrM;D(^R_UAQebZqYy(piDF)X4fT*jiSIXk z)Ax%T-FJUjrqDG zxcbuRP9Vfic5&n5!%ZXar=xPOO2m{mt3NVqxgic!*k&FDMlK7)6Asat4bZMaH+4x^K)K~j+ohg=>gK}2GfG2<`N9@S~PBgM%mS+ zqvfjcBX{;YW4+3^?g86;whznq_oDVwQgk63Mwp#)Xm{ww?-%&?_KplBfZS_y#r;w; zPH7f{BV*7Ter?7e;=HWW6GACdKM{S2<8QJ2xDd>qd98C*5l*D=6S(+BcbYFY4!gZ6 z3bSvv(qOtGZ}36CQ9?N(QBC^BSp{jX9cwCVJ3j@AHNJruijkt+Obj+S`hCBEx+t$| zO4Da_duz5$`ny?wAT{&Gf2nKOEt>yxEbR}DAeZu$Y@h)8!kD7|w)Q|*%^P9NZ4Z%K z*Ed+{qzyOb1#lzbr3U~Jv4Re0pC2W@PAZs1PlIU`(5lJ*L94p_KhUbRI05<^a_ztU z(nY`tRMp5LHNqJZ<{PLjJ){;gO|2-Gy1v522Fgm`auE>454qJ1UMePZ$w zIOabM(rh*8A7S9}#Jfbs8O3ctv-Aq^bx|l|Qm-vB6n+`Qm4YRj|G^<^C(-4{rai zX}^8_0;k785^Z;mW50THihJfmSA}nxQ!ad6YG13J&wPIA6UdKM2K5Vz3}4EQiQxWM zjt7XLB^OER_cHcrq%HUA6QibQ&7-yXGB7)9tngw> zjzgB|YY>u*TUXod!g_+Ed#5ad?TAJRp0(W&I*01~)W3e($>ov`?HBeic0$PBe`XWx^FHAJ z_Ki9$jZT{D9~{XRBxoC$3?=b1B(#tCnX=S$=40YZY~!)7%+CMUNBlkO7{zU-j1pU+ zEG;ffR|<^y0L^b=OxbQDuYUPelj`uHTi55d*%t476e)ln&0DpDc&_cD;Ber4LYAg% zDJ*Ox6B4*?_hyQo!0c2PNB0y;|>>$=QYO+2kOTLyBQf+ed zc4ic^YZ=vVD#^3lkYYuOd-F?TB{`mr`=N$t#N{=sUGuFL>HdkA{fRloGNvDAYO`+8 zVY&Wgb>gwR&)zysQ?_5q-1z!LYjP*i3L^{_gn^cjSM;t&grm1c=r*ip;t#q$Iq__K zy|2wO#rd#a0*>K~pDq2kw~Wmh3Ty5z4-aaSiY>POx&^<>^+btv znZkLB@x|-iwaXIAsxJc=EBL9qufOaKypH%`b>T!I%P=Zu{MS)-$0hym$DwQ}z1p66 z8}ogXD{Rb)+MgtojqDw4r?nB@9URq}3}>Tg_CFw+I zxKDJx@Y!eytG3VimOHO16CZzHAz(H=EntAxAxJ}bBISjR^cPA>kjI>-fia_An@>Ns z)6A~R)KlJ-V*z#B55|73rOdL5A2aEfx2#Ww$MQMjUuJwh1lI43_opUPAMvtl=z>g8 zb41^k76IQi$m1#YdUw*rJK_^|BhHX;CnZ|W^{urYKG8?9argxt{Avj%wEdRX(U%kI zYn&L0wQHS&2%1S3(gDlI#v7d)qn84ldo`B0bC%JI>c{W}nR+L~Bh5nB zl5O9ZHJO2;(CTC|>ctqvq%){2@oB_5KC;rf0xfAK^qFWcaikGB|F%XotNph;-rXt` zrvYkg!lZX-O-hlKFMlMw8zWdE+{1ZKeG`b-8Zs zxghyMW%WjmACjhQbcdGoDcm>tkulq_uEKg|n&wSfZf%$~@G+X;?uUm_`l=;9 zjxAI971hQzbT$C*U6$5Zl}Ri+f37$iRC>JXhZI=ylo3NM;spC>owS&p%KC9!Z7G_e zsH(~xgh-+9%?^`)+;a5Y1a~(a$J&0JuDY8!kc4aiQxX(}0W4eH6#@_aX#E7KR+$*7 zl9X{pp)aP(vdH^Af5YIm&TM==J`BExrB5|!wn&Kfvvi|H=@`GPvJ2LRgf0x4x^lS= zbn0y(#)%+%F?2F&U7u_%V(E1J4UY<<p*l5$&jVV2nTP;s${@))qCsAlWk4aawAB{(Tr&nw+o(tmJEdAmRAfKETr9YlY? zqF(v!r6c^dtkNW1EKRcJ=Ck;MNw9x9K$Of@eg&69$oor!?n=2|}^k(NJb zd_M*ak#szuPhPc6NBD#fq3wg({!C$QMjneuzzAgxR(CG zNxt}FuKOLb5*wuZ&TB5L>d?ICm$LoP^rAE`@t+44zkEGX{SvnEr09LC`>=GtGJ5Mx z_vt)InBJEzkJk9z=XTiz?(elVR_m2}rui)YvBr_9`Sy=3nG?i4zUrsi=W6WpYt$9r zv7*F(Bg?Emje>}2!=d5vsInHrATSD~MoOZuoA`db>Qm5oKI!fHtH)XMu!mdD(beMN zuX`sZ72fs*Hk&r|2m4&_j;KUN55IFi~pk{IIod=*ASQARWJ?#%4 zY=zb-JegEge}Mj`>iz43>}C<3`FutygkS>Z)#rYENIrr*w%$J7lHns8QD$|bYqiCL zxDY#hmQSl>mAk(4h5Af=$_sH>-1<($(+n$_D(~%Aw{#Eqs>i^9HzYDMxbgNn3pY2? z$*-@~#>iPY;`!@H&q^iI6sQ^gn&ZC#PGaPwBzyw?3=;MtHLQAi`7G0{I8dHbp9ks#<4J7ErCf zE4jfeIL-BnUUKfj>{r(d8~9%hlZy2P*l|*$fn}`)>(P{Kb>qZY_A^-+)Tx=bbt?LD zoXD*=>S~;O9{-L&Sh1&`{}A_MFj4IMyn4`ciSf2Vy|>Ja4r z1k7IGC(J=3_$e)mCFDy)63Qa}4Htgs( zxa+29No-xW)xgO_xVc4aRHuLq&ZTi!2#Qa`p6cFIis7eRN!}!FKH4S+OW21Mic!_p zUN&6A&neO#u#;G4ndj*HkTAz#XRz7-Jg@qu!QhxAw`)X~&ZKo#yGgcpR@#h%>CW_I`MOjdv#EIQ>%v zpf@t>3(o_GFzNuGIR5+~U4A8gR!FJvV4xC6-4L2TwqsR!!ti+}MJK8RB~Wx&7TC+O19m(0s&`-kEmG>S1DE$lC`^vQ_2b`v+VvwURHuFQRF; z%^wDHzUOmq!_OnRm51p0LX^I^K7nU^--Ci!QAWNuplQ=WmeXgiJ_d}Zujf0o{oD~V(MLMkrrU*m51g)BVZ>2w18))wI zGAyi*Urg_rxgrZn53iS1-~9B`E4^{6B@A!X=9Xt;W!>76r?GlE61%T22vtgcz*INN z8kE7fS!8MaI;YjMWK*D==(E%YF<2?<)MeMIsJ!s_4?>wSQE z2*f(OLOMDp>M!x=*psT}$M7r=FN$c?jIE+Okj4DmCjAi&Uo#p`r_QJ`3v~b&|2cif zNI2W&rs<6r+jAp1)Hnp{3Afk@5L_#mJXej*ZYf=}xKX&H&&hNO&V0~-JfBtLZ-VN# z5pBUP(Z&u(+i=Y(_G^XWsuoK&`lRJP$JxI0I=FtgT1&e1*tFMKGU5@< zKjlgdQaE*qvg~WA(9|HR<5{^}iC=KYq33A(TT(m66?J3+9ut?>8G6J>cUF*K{Dgf-WAnF1TPi=jv4$p0!9$&egVB`jawL|tgrx=x-u$uToM9A5y-Hc$tb+xaDI(F|+`588L!D9|t0{e7 zedb?l+Bt)QccJc7>valwYkgjtJHVz@tSUA{zG{Cr-@Xz@SQr3rsF>efdeGz>gXFTD zxGyp(Uxu?oq?0>D6Qlyd@F#%`Oa6&1O3-9z;^?mvOQpb$H&40k&!>X44-Jg;J#r^4 zd^05o%ei6rqAVwOKAe^;1@I|v#h;E}H=-4%EI({&mvv4TC>Pt2IEhM6!_b`mgZ5bpYBCj1&K5@H6>JI1QqO~A4U{ekJS4`L0 zS}nRoK?Xf{EYX(t_O^)g$;m}>a9QCO346)mx33GRJ@l!WViH$pt8tUd@)H&npOkLB zoh=PtBzESl@&3IsVDSh>lRgIN7+|4#Q53L*ufZjVKPh7q2~)TpjsIrD7pehxB|R4M z+hzc$r}UT#@qau-1jRF(iKq$GTV}sKv|_?iTt%V)kO$F_!P|dpbbo*Roo6PX|H?$O zdYXugeWn|rhrL?^{P2mTf~<0=mcD8mCPIxe^65FB~LgnNRYG zf6PMf59wciU?;JpE2g7W+Y2%=6UW$`Cy*-(AbSn7nc&sOyWht{N|?=m_ z4P8Z@9v&Be`ZX}+<}E@} z$DOXCM%vt`9`Y42qEQduq~G1CTiYfpl|kz1V;;TmE*~QhuXO6yjCm;yd9d?yLO`== zy`I%bG-+sNvMlm%3H)93zeMz-8oa9IDttL69fH~H)l-#r_mpEi9`$K z#I~mIhITB;9{na+>RF`yW00 zT&~_U7txfb@>6-{fqByL=1f&bSr6uE%o%#bg>Mo#HqkJ2LL^Sap=dY%?2T;?bnCDB>j@Tb)=9<__TeX@PmBx{icFpD*VqKL62FIAESb*Lh$F7^+Wc)&<5Eu~mO? zFnRPr^Hv%@m*NZQ0FI9jmq2xgF0TR<)-Y=pEZ5J-xQk$^3OF<;3-@SvlKEZge7-Ih zk>qDSzk7C7ck(0cZ<(y5NVn? zj?oE7Av1DvBT^Z8fF+s@ZG+ok>XE#iO~@hDhOVENKhGtL$y!tkDDe&nubN8=%nhBq zFzLLKiM`gx08BC`ferxWUBr4xlL;r5o}z}`6XTyn@ginN(rtX5-?Uy`-ky>*_YHHq zai9|&?q;cDxW+OpZ7XEGHu3#kIfhTx1lO`-I~cLQL%IGI5kCMgBeIh4xZmJwDD-YA zZ*q&B0ubLPnUF98o@|GVLYgyzv9`&A;LJ6@0wfs-EL)_6cfAPg#YpioqT5gKQPP-j0^aACJo@&vEFp>`R;N8cxqRlTLL9#3koE!MB9Xxfnzh~ zHXJ&}N>XYqQA4nCD3h%3^#e^iTho2?(TU;m-U+3av}+mZPsI2zv-n^AtKS!{SEm>f z!ah`#zDkQ%J#br6px=x;mGe$G)Ve@%fp{&M8u-9!G&|B7uen5AtjtwCj4Pc`dow1zZQkqTfPvN;(hTW@cj7i`S!OEze{@_XU-+e3XhSo0f^+ zywhLdbBT5?5mY}3`mgi__2&e$xSZ+w_2j_gt=n+Sf*_P!msRh>a=_MU=C^O-yU9bI zcarI1hil8bH^yG9n|!&`Od=3=FkE*$WL`|+(;j`H+?#zNH(y5r^BVpuao`fI`FH2X zE#O;v>r;q6qj#uB@#rIk-b=y3;HufKEpY-v*~IrHGDprFR=JZU$bg+|L;s?O*)HU% zd|9qMjX4i>fgHMFkZN5;#nvvoxT7lHt)DTX8Xtg@ZHxWD&CFWE2i|9g1H5CGOH=@b zf1%W^#zs(Vb8OlUxNnn=ed1-Ph!LD>V4uEL8+H`-#>qNnmMJ}D_J9hNFc2{f?DUu; zm3>a0V4o_wcfgTy(*5JGT8yLH_dyxB94M?y@nNTQpH5P}(4*jCE%j4D{!#j^)R0pp zd-vSo&-Ht{(X4WqjKPC(_G*&9`mJ)ititayd*;r0ZP8W+xR@#5-$|Tn?eDw#e z@|>p%i)C=SOi;6N`Ch!4d`AoTC-WP~YW_~m9c@M`Z@_n}S-7Rp;ymrqI^UVZuDyLr z%GY{Tk}i(vb~|NMS66w4gN(Wr>7v@3Mr}uHkYw4~u`tvDm6EP%t_*#z)Mtsm0xTbF zTagJ3Sf65=ugC(CfvA`CxNx=2!M-PG!U<0XUK0D%B{^?yM)J?r+E{Rk5} zHu>m;CASD8*CU+mtJpY!yo(!{hX)Sb!)Q_0kE=%FCmDyy@%2aHu5iXI_C<6O7bX-~ zW8--DW(n_lggrGqSmNj8efN|A5Yoi_t`sQM`0@J;`u&kF>03__qne%?_IjsR(swsF z;;{9_Sh=FfgK7uGN7F*WBNLxqBNumuAO$=uXG;v=^;`CFzbZQ1FFEo(KGdv~pSx?a zyDITmMvSF^=Mh=&bH6PZ&(gxLMNVq`*xrA=#?DR4YSxh&g)Ys1=h81}n%{KR(^qSH?cC!npQD0VYNvlrk2sq*N$tXSkxRAQ~$vQKWmw=qX18-rl3MCeL{tXV0kvm|} zL3BUJm`I*3Ubv3j{a{7|ISz71ybSIe?w+M3>W%EVCsHVL=V`5Fr-9a9wnAziy4Ne^GoJ?3iYp>|hJ z+d|3FC;1=8Hu}el$u!dWg1bv7GiQvAcB+6kL79Ssp4a^QO#s92-yT79XQvOg6#6^k z*N8R$>m%IR`iYvs`f89Mq0V~b*1mNtYg-WD2-E-eHC`_b=O9(LQAzv`(cB4Al+a+m zBNAO+D4pW&ed8gooDN>S6gMuiYp2_awXl%M)n=2&Ph+cik9~M~R>MRlaK68v#$8e! zEE{tEW{fspKI|@RC*dBoWzmtT?nN`N>}5&2*n1vzR|q@Pp}SIYl1N|jzqm_N!11B1 zo|0Ki1?hPUDfPrdK{t#6Xr$@t188l+7?<;uL$_y=S)HNwiI@O-+|EKlh{u-lLkrcE z7_0cOitE^?p3QG_f)it+~OVN#=EH*Na z3@wkj8eKT}*eiom>OJYgN)?zEH@9qC?b=biazw`9JNwcT|)6x-JSL(g`3)6M|HcrZnk@ zh=8a_69FM2U8G4BLLwj_HBtmcB}!E(k=_X%6zLs=5I~WhP(MhS=X0Jl_g!nQeaF~$ z+;PS@``+_M3bF z4Lym&(LF9r<3~KE^PfQB@zbHpy}uMb$A9d4Rs14b6c&yZTQ)sG{erHTh!8hPg0u!H z_`d9@G4j64`TcSJ6Eb}`8!N}mmCtrvWmlt^KOFl&_n9uje8~QMA>Rs*Q)|bfjCH1p zN1d)J?kAX0d*`1rY8`^X;T?w8r7+e1HP>>7EQiBhS(K>3<#N*o8|mj!EVC*HF}o~m z^7siSV^6Qs^45dpXVpr}NgKgs|A7bFMn}-&R1=*06v|n#OXhm*?Vy{Ilq_L z>I=_LbFgbp$bi=i#$WuG>lt?jsm6%rS>;MLyK(vvM)0$<(bbuO__wN_nu=YF4#Sek zqU7pMndkxdZ6sM5_Y}7)`3tn4regrBH3yV|yw#*9kC~U$!Sk7!R*&OB)n&!E+TL?= z&|6u7E>0~pzVtT?c&^g^H306$G=U_$mO1GLkUGr;Alj|!3>eF2?F^NoPj9fU-qbF_ zQc z4e$NMxDPMV(Q}V6WNGwMb0te{HD5{BS8A$z+K~c_CeYATE!Ry`zH?`cC;6HytU%#K@ zL(bGig5p0egLCPDj?cfgALsmKfVc~H1DyN`Go28&dL{RR&b*4}OL+gCE8V0oZ^9CV zmms5Gm&ji8eZ1Y-!nK6W8sT3B{KgEpm`ge~97mWXLxxCCe8@r6``37Nr~Er>yoZHL zp#O|(IQAG3Uj7EATvaG1j+JbjSSUqxAIVe^x1Q|bVzbEgr)r=@`ifCM2B2>GuU>5Azo3i988mr1rr$15xMO`tnTOli3-=)@=(QPW5K-N9V8?vGX4s zq^RAL?BW2%LMC}^iQSc<<;<8lbtxy5K_E(J$$I0^9_kTS2vJ5TC4KyI)qGnQeGRmu zbJ5jirdBo|1FDz1(ezqu3#1jTnI?;?=sJv3w6+E4KN~5b;$b4M;gkn;&5KHAhdN)Wim;RqNCA zs*|>R5WC4?70{LdJ{o4y09!4W&5OYJ4#NXZBye)Qv4Jv&W?8s++E6}+Fd0l*Q6SR? z?`<3$?GCo{G#Vdg6iZfN{*+5=$x6fUjz{e}pETZXZbGNooAxN23SsG-W2{%5lN@oW6s#`J^Nt>Xr5b$A)}%}MZhZz; zIWjXddwKl8tawPRUF?I4*kDvEMtnl&7+hu|%h+{@YuK8qdDZ=V_~kQ9zs=_GQ{9m~ zmTx}uq}k`^lE$_U#P+}Cc73{ePHk0Ahd37AR}{WZuFSz+D%Ewy&^4ra6+O5h{fj>b zj$FE6)=3f%k>y-o6NpMC!Sku^W7|G$va9<`DC%+4CkNT3ajX`Wa0*UmHwSi9p24j` z!Of0+W#_?3VhR@*w=k{iuiV*ZJV)9&h<+?{fLG#?-2<-o{iHhE>lCwV@Bg4__MBW- zp4GfoZKo|iE~6PhDr-v+faH8Q*8EzUV0cnmDycZ9!O;4kK>|Qu%mPMY<2~sOz8qvE zY+Cyebo2o)lDwWf5iGVjCG6t3W9<0sE+jtEn$k^}wMOkf>%n~9*qE=3)U>-Z&gXdR z83^@*SU=4?jRtd8Jf%ApaH7vJ-@jvIOKO_gLk_Q_I(9ZCx?HWoOXY*Bd!3tjcmHe% z!3meK!ek#1bS=PwC>9HbA}~f`a*+N+9YC@KCS6;*-8kY*GFZYWzm}J;braa2S3%*)ri5_s3$LiM^(|`88>KlUT z^>ttatAfjUg)EZUTi`aqbc9gqB$o!bF}4MJlw|r4g@1?0?yivk1Bl=uT-@*jKUEM| z)jEJ2x2sj*I}SdJrcbGiKt$My+y&2z*+1uWrG+F@b<-q1U;Zp)yv&b5EjC6ryJea( z#d;W5?hUzb4JobFLbY=5S#!}%*V6$w&HmQdfOWp;c2cD=s@U;o$p`RB_+iTsL~ zCG>afq1cXUJVo)}FZFNl<(bTDq?RrLymvjZf4Lyb#r zE-E!?ZDt_go>YEOMzPundOmhmQgid*fAgeHB2JrzZ^hmVsqb50WkHu|)^^+D>$(0J zA8;wJEmST{`X+P#qhzjBVEFzaI(hCqh~(9P2O7*88XSWC)+^L}k``QcOoip`wY3}1 zZv={&NY2Dr^7?0pcrS|Yp0@h??JFX%T1TlDuYUD=BRjMD2hHKhgJOk5{=3p$@+a#} zK)&x%JgkC&oLY-q+gv=1KN7ARU-eCmk1=nfYWNpYm&oqO>Y!0AnFX&%dqA23W#Tf^TKB6q-d5+jX-BW$_Y6yS z&%3&$sMb!mu7~-8i=)!l0go32aS)S?8iu~A=i3gmUnY$gQzA^ST&s6?5r#|A|K{mh5Bu8)D;m{;&SThtlh?ci+f{!~k1cuJQL2o7`{a0P zNA?rQO_@c2p&gE}ekprf)XcBKR&}oVBhPyqHPkY8o`W1t0i&&xuZn3g1(|xq+3okOe!Fuuh7au=? zUhYq3LoF`9-FCD%49)EM?&{~?RuLQe{-VQ9xBGLU(^PL9J_USN$K(Q;T z@56Y1<0nO$e)Z+7c_jWjx*SbmsX+sZ_27!Iwkr$ear`*+RQ&C*iOWzZ zTKd@+nQM7@Sz{H44VZPMHstoXU%0&=;PRa_-mH;8Wf~w!8;TmiRRZuvns(;(t=&#> zwB3s^U%lh1gWX=c2F$sJ2TGKh+SGD`X?leRt!as-`2Gl@4}QOnu-4IIXF9&|O}2gO>U>PH6$qB9^Vo+u z`*#NKT3z;*yQW|%ZJ^?cJfq768h9t*-I4<_v2!xd^gp?0vK_DO@1{#nVWGKZ^i<&FwdS=4;0Jfa6&rKxHmS-O01y&>`XvD_LHm{K7o=SWz?*m12f16n z(A-d}-{NqbfNfV`^vI?s*rO+v?M0P@8a3xGzkk`lwQ0ijts~Xc!af|%u2}x@cHpVL znuChfvwB^e3BR6$&4>O6|BBL&{3}ZTXUU`kn&K7V4?4qzDixjy2sM{^Mt%Mo^(`@* z*rVgDGatVzAbm}`Na>oD+s$jfL7ty<&rr{S7(zhrE6GtEu8`;wrPONMCv&+|E)K{G zz(fmG<2RRofL5y{951~m<6c49(B-{mSUP$L`uj{%-<-vqYrb(cv_u;+_y~KlLQBK! z!~rQ7~{huQ(ucdv;N2tEvgz zohHFVoirLIp~;619Z^sCvc+jacQ!o_Ow9)av|Uftj4Q8&{dygl)|UG5DCW5JiwC%h z*cNTSgjF=8QvKy0G`y2%EC3#}ySwFC>2Fso$q={mL|!^n{(2c;a`^ExQ_G+Gj##a_Z@$b;@();b<;)!4> z>*O;Pzm$QDt$&b4X%$8Ol0RqSGr6)VX3n$ZoM*>Lee3#4jOrhwP;9GNcYG%(yH%$v2ZAKEAXff zFgbzt;3@WOxsz*Yw#!U!V5?G4(&uBkqw$$P+b%j&qrE;A)+e4xJ(hu0MXKv?P-2lD z*tqGa)%q@!WQNb_UX{5L`6;0{OBK@Jm$DD}F@un&Si*HwY_m`*o9RNvM};_f3sx`3 zZ>Q>nUZUQ{F39Y$$9E;0U1i^}Kg`bXSh(sIhY}b6*j*Vw4ki`*Q~3xWMV~jf^<9YR z^_t;;HOFW3)k#izfP%%UsboF#S&XsFL%4X}(w0;ZIGhzP|8DmGaz$9(ysD=lZ5 zg38zfux)oq1u!LX!MB}*KGWsHkbUwQ#Ze@kg);(=laescO=aT2dVl^MsIo%hP2iBG;oUHlREL8c z#L=S?znIh|neLPltp+-tN=*W&ZfG@cr}`f>?lYJq#Hox;Sd=jP=mLQ<-7OZL;de$x z{O5)33OCu3WNw8L1a2kkMMhb{^y+j#k#_#Nv9h`J*TzR@UG9Z5ssQ+TXacs3Hx}uF z1l&qYJ4N+B-l-dv*ZFe6ZB$Y)>*4yc)4T%d9DV2n`J~d~l7k8m9!{{kgXPUCjCh+{ z_Hs!u>3kU{2L#MfZ|<#*_#!m1F+oHxC`5Y0X+cwzf&wi~P{i0AW~1WTLXtHyy9tVB zFQi3HB+F#SQkf=r#!}}zp?q+de`)RagE$0UtG)m7DJgz%eQvG+cEHo18YQRk0z*u* zh}|_rrvlm|@FCTzv$D49*GzWq2NAG6r%z%CS-X;G7oxxagqZQ#i?72>`+I8FlK??@ zOD$CIQkuqAlr97E!PZkGmuvutd?*5o_>QuJ=bp51>+`x5 z7#P%ao3`%yY=D#Y&!mt8>S8t*uVCFSR-Qnz>;6w_%r}w>J zu4NBPDnxvb$BoJhCfcxg;H4-ruAgglPo}QB53PRR@Z!%*NS%Eowiq0^tlk%Zt8#0_ zu#p)+eEop1)$W&6oqaB1vk)Yv28vk7_J^i+7lhI<=;@i+qRS8>6T1T}?z~j-@q$zP z0?rUWt=ODyfla4FX7WeETp7s(Flyx0E--M@TnT>$77?+Hn1GWzV{YKE;(LQ}?nNF7$H8 zah~g0)%)GLTV`0_A}Nt!zytx=jytK)tQ~^6iMEZ)a~ErPHKy7iPsjf#)cTk1hEaLp zdJ~afO8o^~GnDV>^ONPhQs_Pdcvdkb@KVBzLDH5(gdFNsqYI&C{~P6%@+;~YvNn(z zOjNo$Y&j5~=Sf@eV*cjcu5UKAchN5*_Eipo*Y}9+?bu3a8%1eBH}?5V!aJwBYNw2v zI#g_8Hn0luH3;3rJa#Pfu+BUxj$?aKsc5X(bIBmdGDFssk4_!)4b)%0@i!qHbRU(Z zyULv)btvh)dD&JRqRy;+-tv}U?toSp9vhDo_=Cn9DM&syq$A~-%{Hvur!l;(wl1H4 zr=3r%hqLH+d_Z^T9*E5UZCQsOE<$6G9L?fjBSoJo;*Mj7`}ob@xGZMoSrJr6U!Q~KUC_aI`L4TBciyz|}bMMM^SFv?5I5ktN| zL58_`o&GQ#NFLVW;^%e0FL0ILAvb=<6p%KJCwt;iG$E%Hj)%mM+JkLtp1rHcSZE85 z)IVKTE0Qkq9HOS(i9p$P5$!s;F+VlV#W<0#u$wNzz#vU4J|AzL({Qbt5!X`(kAR$6 z$MnRfDY?E$D5oer=~b^8L_3;yxjNpTbOreQ_*n_6^2T>JYUl(nQDNVklBdHM0<{M6 z=P{_z&63CX9%178p0u#tinQvQS* zbk%bS!~F|g1xeD;Y9&cghoGkA@SD?ZHGccM>M z2rp%uHX&T#%ml+2&~|$aTZxNobaWDapZ8$Mwp~k+HIfw-sm*UHlB~zi&7`zvXEL@s z8)jTHUg??MSk@Hh665|-QA6!(dCFuwz_2e!%uE1xc-^F+X323Ml{*1gE@S!}`cbDzSL2^<=%>}RD2*2m7l!cw4aFXo@-{A&~@>dE^Mg}I08ix3aF#5 zqHyP=b2e*q1Myx_noKEqr*~HzR!F>v!6PgvK&xJ}CEh3w$`&I~cC%b_J||w;?)ubr zMJVdTQjo|XE3md7Q4W6Wi~EE!Kn{<27CI0W@Opzy9YhB|tu%ZFu8_^Y%dPtx{}_4KQYKhc;NnuC^s=RP^z8>6Mu z)Xnj^vjw%@0v?=~JRl96S>zf@y<6oF(&G=BskM$~d457wbwQDg?or;Gn@^QacAYRw z4x`hPx$OZauNhL_HD8=ISk#@?T_`BaGetB%aIaVH^J4piJ;OfCD-t-5wy;*gOtvp( zwuL>`xd!=PZ@I!aK2xfMZVLIH_C4T1t5 z-ntcy2PCPtF^A+g>$6*l6TjZZI zSaE;pf}gD=XGP@hox_3$UT+k*hqmdc0TLc~FYg1RsN2NTz77(_Tg>0D*eIqR7f~b$ zQ1~#tIN+=?!veHL92x>-i=pm)xpajhMHDaB$M>1L-^q*fRFaWyJ$^Q zz&$DXjV#5$_Q7Iiys~P=xOe4VP5h<@??V~Em@nx_B;P(}8pVz5DJw!wy!maYQ$)b- z%K~mB%MdKSx#1I>2YBU!XJZOnn_Q~M7?X6ZwMuM!opn*|oTZcY2S&6bdeUi;D`^NZ zgpjosf=o-U%}{NJe=EyRAryWgp^Y9SSu$(_iB~|kS4SRo-@bReOXL=JdUBl&cj7jq zRu%y_&0+!$)F?6w5U$%Hh)$3xT^Uc!agckP&LYvM(E9Qx=L?I(#X{SohJ7gjg2ytt zTSHHmYMDwUH(DIFJfX zNhQxLPzzI#-L_zKx?4P?{h`Zu+9kTVZ0u)rXV)zpVMs@I2|3V#BL~&NfOB4Nf9Ad; zOMV{NOnNak5O>AzCN@;colvShx?`V%_@Z0oVIa1jGWMipaeWc=P8R8z z0cRp^x2_FbTR;2Ga2dBQK@96W>Q7sMMZivNNz@T>?G0021sOkj2mBx0U4LEy_U9r{ zR_8p|Vev?gU0Ad(qzd;;fE*#aYv&;)^2WynDhdgDNDIpbsoDi^AA>bYI3ak$3qScP zpy-R(u-5gIWMPIwb8EVfEI3MvCDs$mZA`jKHV4nEMe`=uN{_6MQFaq=LV=?gh9Sgz}pqo1Fc-SizFiR-t@rXvPsTS!kr zC;D-GyQp|5sPOZ#x1L{)Z5H=LunqGXR5w|TY~~w{jq}KXtKQXx$0|oFIqpYb;z5`Y zgK@OidgU*tniv&6%VY`WcaVEBL@>Q8Mn?vy0o92`D=-EvQ|MFhFtpBMO?p@++xtV7 zrAf8?^K$YiTcA!P*g)U{z`ero3Pb9+K3Edllq>~<@7duPD7B=%2y*R66 z!ZayLcU)iCyY{OxxOLBpybwu-sBAz9Imq7??yh|?NX$B>K)qnIxGxUO5=}cowI?<- zi4LZxLc*@R_0ApMaO5zQEgC_L8LV{q-c&rHbP0M3F_e9NjCbFRh)RZQ`>SRm=Afzj zbMAM$mF0(G%}Z-V68Cs^F0PA_T>FSlCgp$~@&46vV)3api8lu{T`G3>)B@y^hH2Eh z=V(&qnnA95$-4?lI#t|e`du=gvS7M_!?8~VG*CSle~8__LpiWP5+a``UX1qE{Y(`N zak^=e1hsg!9!{)tWKC2*YcvnGq?Y`i>&c<=e;4k}QbcGJ)&yTwMjvn{#`5{&C4r-p^KbVy3kgUtq###w*52NIT(MWS*uhw6{_?kPkHync zZy@x@!IVND9k5y6tO-~V&7t5(6y~iRIfJdpT)Jo?v@0^eu_&^4Pa|*zRtlrVF2#kg zP+LNg)U@z~;V*D6QJqFkJZ?|1FIOkZQ>KK}L&XY==?iI3`fmP-CE*gF-q1WD%cT6L!YuR>wo&XEzVjj z7gx7#1YctqSuiDNuZ(?XYz zNVEPCyngKxr5Nd9C57HF>et<9+-0PgVfuW8L$y$RBSZ%?ud zu{Z@hVSN*hPt}|lg;pDqvkp2iB)Yp`HLe0Cm4Hd9Ymj7I8Ll0260k+C>psio8%bR> z99__ahN}P52=X-&8Se%q%QXjajRttglv^i4giu=OpSv0~eCM&XYHFpDB&qgAbv?&b zJ&~OrOeg?FhJAvcCfv;bcvpLDb{yp-TmH3kDP@l5PgX2w^u83_1!}%S*A|fL$VFT< zk{d4|)d31ydJ9{@58UJZG&lvKBN7@l_T*?6Gw$<5cUzxK51uczb$?rUgG1;?JYpIl z2b>|n$a(}^@^a%CLP#h7v|@wLtAK(OZm~l94>uo0VZ{Am6}DF~`D;h^r8POThGCB3 z0)5Aa&O4`Gp5CIFzjvE~%x&jD?2N{>Vc0`tI*wwa zaUG!(lWu6!+EfN<`LW)IF0(c2G-C>YR8nUX4%Mt?2%oxH94Ahyq6Il4#`030o$pyA92rMIY_x+Qj}zpw4q)%3J*EELNWnUYy>z<_QU3T@!xsIL5EQ{a3Dn|h$UQ-`MQCvh3^!>TfKX~GJ?w2(^K7r))MkT=*e59_3Q zfVpF2(*&fmAiYvZrlrf_3$ORL_wTQ_@7j{Q>wH*3l-lQ5BUfkIt8p$dn=tkC(@%n; zTL#n?u_b{jYrftFS~c?dQ6EOqeS)gTYL2pDd~VObfgZv29v{Arn}&12-dTeLCNdAI zaYoDYHKs9 zGvAL8u!L@Y-GnrI?)G!%_9gsWe@)S~nD_sh@!orj%0#>YQkx3Vr+7%FV0rf%3|p)> z?SRr=2N$UQim3;;6iEI>?ds&5ceT@x_=X`yBi>%Kq8M45N{+kKmP+u@JOd{in@A3 z$Esn-VJoL;e`3Ucj|`3XZ*x)p9O91HldQ|`wf2-R9mkp4CwsOcm_Sy>lS-pq1@_h- zmka$H?tPKTF5QSoMV=X?ktqQsF~Mvxg;(Ern1gmNadIh#s!}J-tBkFRB$xKQKt}l4 zl5hXqcKECP@Zaef^2g}EcmHz!p)~j}JReK`$eO9)GTW%HAgd^fGXHuBlK}1-V8hly z8;~GW+$Ick$cUF?>&Hsv7q6r^pOC&#`2+bPyvcyB*1E-)%t*v_LZ&x&7M45T%8L_% zpOz#Q#(IedymAe~FNYk`q#C#GW3Xr6$v?spB16Qe(HokeI_1o7jlhCW;_v2Pl9ndv zatL%k0$|B&k(UG6s467BS8}Og^8LKgvfL@FzRfR=7z}9rL4mR+zIy|@kYu4ptZ7jY z?8cL3+4)c1kX$`KUQ=Msv}4>OPQ!gnZIw~7QB`-EVSkHI>2#fF+CuUQ+Bl&zRxsxk zqrX;}(LJJaWCQ-e?MO%jy0Uu%M!eXrqe{su-hd0u4={aaY0ze$C4X_r6rmE9wu7GB z$!1_yS2=3@#CiEc3muL5&?QwkKj|)+6Nn{RETCGET!3Pye6bd^IK09v=*6vW$ZI-h zx`SlSTAqWq+_!j@sscx0#!dETUMPIyVhQp~Kk22(0=YEV2iGGphm0&1#y4s%+UqVR zzo%f3@7Bzx+Jlbq+>cVsQNAa0?jl{XhV}P}YMfVjZN-iQL`N0%E%C`pt<$4a#^Zsf z155o|s7!=|_5s$Z5Yu)JKG}!q5w#iM;VU!MP^+SW>sxo~4Vu78GlOHyfYQDSXtn{t zOC?a{SDP=EnP~d(td-;LDE5>;ey&{pSzKXO&9N2J`0HJ;+5v$fDv#KR+$4cq2Devp!G|8g8@&J42nu(j!FRjtu}zDnizr2*0?%h}kmfDO->5%Mh$bJHmp@ zE=gK8lvj<)7L05y*lcWyxi2MkS*67A8|{i>J=iO<-w>;s> z_vpGqm^~dd0EtBuL&zgeosY#U7lW#YGMEKyoX)*VYgyU@qnx5rK(JVk%0gBjq6+*1 zH93O4LZ?)drM(p(S*-@#OmvuB+C&pThX*0Fm^DfWj|c$8tOsDPvg7W+eRV1bxY{p z_}vF*PYirTJ%h38J{X`!OgPAadDd=i^+9!xB{p_8T|T8(9$1}8x)aUH$I%lTlzQ?9G&G-m>cBQY+4z>QidrRg;ac;=N`FOn; zqcPJ_R)Is^{T52L8?ZJn<2k@oJ_W3`RU}Zj2tvsf()2kBqhj;nj3=7waw6{Tpq^$@ zwMTWJ?j!Jd#Y<(lE2*;2TyC-yDe!q?li*DRx_K;$%tkVWI{~N#P41}6M2{LU zSk|a`__23qdG3q(157>0&rt^I20(uz9HO+xYz>rZYPmlj1{%@z(H%dbBZ**xA|K0K+z0h6wmY zN6;a5S}x;NL5FCJ#4=5wc(zU4kC)rV;)4u^U{g=*EiowVljj`Yn6f>uxtH+K(exe1 z#w+ZDnjeo{%1eCFZ>Vzkr4S07jcrM%_KyI1WX{2lGv*;_BZ!`8J#gaw8=fqHYvrxApBxaVLg+iX-Dlt zvtaQYS-THH`wIh(VhV$3kJ){+vWy!uP&VYe6UcA)N)gS8*ny&j1psi5 zp{J`So_giA0E^WTt{j%Ai}sO>-^eoBm}*H$_xTaI6tM;~rViq0$WYL=PotgyNuawl z^K{=j1vNK)xA1$4b|^m9*9a4k6QPQ*0$}D8tgb7Gk<8e=Wcxb-t%)|e>+H`unyVWYOHBJ2>JL0^BU=~HMP93 zH_)X3=9}Rvmd1wx%#|9F#8~vyjL>&FHU7m9_ZfRYBH`fCSr&9w`+gRsYJ+z@7*{cK zBM2)U;uD*0`eCtf5v(&~5zL5T-AdDL2s7E9l2b`iUE zi1Qm?nqydV_jkdHfonFH0PU;&-@P-!9y{r+etSxLIMJ>9*{5|t7|sRUC;{vicvA1I z@`mpH*mX~pebTDzNB?Fz3v$f zPJs1gd1f0d0a>w}K(--N+^P{kwex!mALupjq zu|sfLDD0%1Y%wLEZ^T-R!j+2OUNu^NasSdsXm6@fzg;5pvh@Ot%>CF>fh+@M^SuDF zBS0B?x6E#GJi|AHH)v<`4J^-4$e{~_3F-;3d_9e6hI0llyxwB;;LTR8jPHhJO{+FX z($$|W6kE1bSEt!kFD-~aJ_%CY7p1+Zb_xnQL}a@ znq?@Fy3PY!aJot&Z#-2p8r>P1m-F?+j@IHSv{y8WHPokNvHS^`o$4LW;ERcpr82=U zC+r`LBGk0wAxx(4yPY$I?{6u|Udwy9mY7@x?(fGOe^1&Dq=y27CyoPgJY=y|hxaL1 zoQ-E{S5-c2r85!5>p8U?jVVk;wF-*@J_O#@W=5j(v6N?}5n< z5$J4K4ez=|A$3RqN|w}NN|sR&_K15niRYr88Ay``ok>qTSoNLskU(p;hmNmu;UdY8+Npuu z;Czp4bDDp)P)_{$N?6S4sR%3R&5=ZqsJ4Ak?(sm_j^l5)F{~D?u3} z?=&NOxvv$|3W05E32^pDHy?+e0wU(o)2Iay2jZB_6M)2jJJIGST47vKYWWD86s`?2 z5idsRsD$vE5g3vmcFw*1aE3OPOJ9VP+JS3Zeat}6vd#z3i-_>w`;ioQ;B^f{KNA)v z%BIY&92^WbzYR)M@;fHO_U)}z9ZeK2Uut85-~%3}`4K{EFvi_l6|jrSw2GaE2zBI$ zAD+L(Wz-{nZvm_4{!XD}ps$svL}k{Zff9=0D%}*F-*W}TEu&w7tE(_bC3V7M$gD`J zIxNrfmgb@GnZ=EhUCo*l^j^}5qpxQhtxDWctkpx+qIO^Iw~LlZ{a`gZo<-gRBpkul z9|!me6UKlOek(SMZ6oHnIA^b42z-3U*@Jzfl;JjJBJ20pj{|Jb1hcIpNgc2y-_i{_ zhP*g{w9OiJA7LT_8o<_oKwxv)g2%1by`HxfSbfr-6dU(+X->Qwy7U_CfkynLO`-p< zq7Uqzvkpy*`ywFqzONWL$qa7p*GfEF_ck#OL=p$`i|e@VI=vqVa@?+x@qfQQ@VA(* zzv8<7dM5uMg1L)^AnKc}1uG31u_nql)=cm1^^q6Uy@Hs$^F8j$dwrQ^;ZQW?IZ`nQ zbo8rouU@$}aiJtO+Q6d-{Spj1L`Q(&w-OLbrA{NawV{9i1p;kmkDZwuI0X8U>)&*@ z#da8|LKXyFY7CO&4;tKzDb)~j^|x5y_yGU|zk10eqD`nOH+-`Yx0U8*1J#FM|yk!Q5*-G>3?Q~{&)Ww`N!D*tD5%T1cd*E zI{1I<*I@ol0GWdI7&yL~x#GEaLqoMTW*AcO{Zr!06q~osEmY{MDBHjZi;Xmoh{$mdRfADwEKgR#hNc`LEp-c9OMMCD*HU{uXa;5q{J2%n=4+3W! zT>ZD~lRzB_c B1c?9u literal 0 HcmV?d00001 From ed46588900e607fc3a6dc1c62aed0ce8c7ec5bbd Mon Sep 17 00:00:00 2001 From: Orazio Date: Tue, 31 Dec 2019 10:43:10 +0100 Subject: [PATCH 08/10] Add rm safeguard to updateRepo(), update README --- README.md | 47 +++++++++++++++++++---------------------- auto_install/install.sh | 6 +++++- 2 files changed, 27 insertions(+), 26 deletions(-) diff --git a/README.md b/README.md index 84a36ba..3e2a174 100644 --- a/README.md +++ b/README.md @@ -110,7 +110,7 @@ Asks you for the name of the client to remove. Once you remove a client, it wil the given client config (specifically its public key) to connect. This is useful for many reasons but some ex: You have a profile on a mobile phone and it was lost or stolen. Remove its key and generate a new one for your new phone. Or even if you suspect that a key may have been compromised in any way, -just revoke it and generate a new one. +just remove it and generate a new one. `pivpn list` If you add more than a few clients, this gives you a nice list of their names and associated keys. @@ -143,7 +143,7 @@ Importing Profiles on Client Machines **Windows**: Use a program like WinSCP or Cyberduck. Note that you may need administrator permission to move files to some folders on your Windows machine, so if you have trouble transferring the profile to a particular folder with your chosen file transfer program, try moving it to your desktop. -**Mac/Linux**: Open the Terminal app and connect to the Raspberry Pi using `sftp your-user@ip-of-your-raspberry`. Download the config using `get /home/your-user/configs/whatever.conf` (if using WireGuard) or `get /home/your-user/ovpns/whatever.ovpn` (if using OpenVPN). The file will be downloaded in the current working directory, which usually is the home folder of your PC. +**Mac/Linux**: Open the Terminal app and copy the config from the Raspberry Pi using `scp pi-user@ip-of-your-raspberry:configs/whatever.conf .` (if using WireGuard) or `scp pi-user@ip-of-your-raspberry:ovpns/whatever.ovpn .` (if using OpenVPN). The file will be downloaded in the current working directory, which usually is the home folder of your PC. **Android/iOS** (WireGuard only): Just skip to _Connecting to the PiVPN server (WireGuard)_ @@ -156,20 +156,18 @@ Connecting to the PiVPN server (WireGuard) **Windows/Mac**: Download the [WireGuard GUI app](https://www.wireguard.com/install/), import the configuration and activate the tunnel. -**Linux**: Install [WireGuard](https://www.wireguard.com/install/) following the instructions for your distribution. Now, create the /etc/wireguard folder and prevent anyone but root to enter it (you only need to do this the first time): +**Linux**: Install [WireGuard](https://www.wireguard.com/install/) following the instructions for your distribution. Now, as root user, create the /etc/wireguard folder and prevent anyone but root to enter it (you only need to do this the first time): ``` -# mkdir /etc/wireguard -# chown root:root /etc/wireguard -# chmod 700 /etc/wireguard +mkdir -p /etc/wireguard +chown root:root /etc/wireguard +chmod 700 /etc/wireguard ``` Move the config and activate the tunnel: ``` -# mv whatever.conf /etc/wireguard/ -# wg-quick up whatever -[...] -# +mv whatever.conf /etc/wireguard/ +systemctl start wg-quick@whatever ``` -Use `wg-quick down whatever` to deactivate the tunnel. +Run `systemctl stop wg-quick@whatever` to deactivate the tunnel. **Android/iOS:** Run `pivpn -qr` to generate a QR code of your config, download the Wireguard app [Android link](https://play.google.com/store/apps/details?id=com.wireguard.android) / [iOS link](https://apps.apple.com/it/app/wireguard/id1441195209), click the '+' sign and scan the QR code with your phone's camera. Flip the switch to activate the tunnel. @@ -178,27 +176,26 @@ Connecting to the PiVPN server (OpenVPN) **Windows**: Download the [OpenVPN GUI](https://openvpn.net/community-downloads/), install it, and place the profile in the 'config' folder of your OpenVPN directory, i.e., in 'C:\Program Files\OpenVPN\config'. After importing, connect to the VPN server on Windows by running the OpenVPN GUI with administrator permissions, right-clicking on the icon in the system tray, and clicking 'Connect'. -**Android**: Install the [OpenVPN Connect app](https://play.google.com/store/apps/details?id=net.openvpn.openvpn), select 'Import' from the drop-down menu in the upper right corner of the main screen, choose the directory on your device where you stored the .ovpn file, and select the file. Connect by selecting the profile under 'OpenVPN Profile' and pressing 'Connect'. - -**Linux**: Install OpenVPN using your package manager (APT in this example). Now, create the /etc/openvpn/client folder and prevent anyone but root to enter it (you only need to do this the first time): +**Linux**: Install OpenVPN using your package manager (APT in this example). Now, as root user, create the /etc/openvpn/client folder and prevent anyone but root to enter it (you only need to do this the first time): ``` -# apt install openvpn -# mkdir -p /etc/openvpn/client -# chown root:root /etc/openvpn/client -# chmod 700 /etc/openvpn/client +apt install openvpn +mkdir -p /etc/openvpn/client +chown root:root /etc/openvpn/client +chmod 700 /etc/openvpn/client ``` Move the config and connect: ``` -# mv whatever.ovpn /etc/openvpn/client/ -# openvpn /etc/openvpn/client/whatever.ovpn -[...] +mv whatever.ovpn /etc/openvpn/client/whatever.conf +systemctl start openvpn-client@whatever ``` -Press CTRL-C to disconnect. - -**iOS**: Install the [OpenVPN Connect app](https://apps.apple.com/it/app/openvpn-connect/id590379981). Then go to the app where you copied the .ovpn file to, select the file, find an icon or button to 'Share' or 'Open with', and choose to open with the OpenVPN app. +Run `systemctl stop openvpn-client@whatever` to disconnect. **Mac**: You can use an OpenVPN client like [Tunnelblick](https://tunnelblick.net/downloads.html). Here's a [guide](https://tunnelblick.net/czUsing.html) to import the configuration. +**Android**: Install the [OpenVPN Connect app](https://play.google.com/store/apps/details?id=net.openvpn.openvpn), select 'Import' from the drop-down menu in the upper right corner of the main screen, choose the directory on your device where you stored the .ovpn file, and select the file. Connect by selecting the profile under 'OpenVPN Profile' and pressing 'Connect'. + +**iOS**: Install the [OpenVPN Connect app](https://apps.apple.com/it/app/openvpn-connect/id590379981). Then go to the app where you copied the .ovpn file to, select the file, find an icon or button to 'Share' or 'Open with', and choose to open with the OpenVPN app. + Removing PiVPN ---------------- @@ -252,7 +249,7 @@ sources. 3. Of course there is [OpenVPN](https://openvpn.net) -4. Also [Wireguard](https://www.wireguard.com/) +4. Also [WireGuard](https://www.wireguard.com/) 5. And as always the ever vigilant [EFF](https://www.eff.org/) diff --git a/auto_install/install.sh b/auto_install/install.sh index 166b501..3625e70 100755 --- a/auto_install/install.sh +++ b/auto_install/install.sh @@ -796,7 +796,11 @@ updateRepo(){ else # Pull the latest commits echo -n "::: Updating repo in $1..." - $SUDO rm -rf "${1}" + ### FIXME: Never call rm -rf with a plain variable. Never again as SU! + #$SUDO rm -rf "${1}" + if test -n "$1"; then + $SUDO rm -rf "$(dirname "$1")/.pivpn" + fi # Go back to /etc otherwise git will complain when the current working # directory has just been deleted (/etc/.pivpn). cd /etc && \ From a9f5e7346fa596f021bcf8a043b749dc14b86986 Mon Sep 17 00:00:00 2001 From: Orazio Date: Tue, 31 Dec 2019 12:28:26 +0100 Subject: [PATCH 09/10] Revert to more portable commands --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 3e2a174..276892a 100644 --- a/README.md +++ b/README.md @@ -165,11 +165,11 @@ chmod 700 /etc/wireguard Move the config and activate the tunnel: ``` mv whatever.conf /etc/wireguard/ -systemctl start wg-quick@whatever +wg-quick up whatever ``` -Run `systemctl stop wg-quick@whatever` to deactivate the tunnel. +Run `wg-quick down whatever` to deactivate the tunnel. -**Android/iOS:** Run `pivpn -qr` to generate a QR code of your config, download the Wireguard app [Android link](https://play.google.com/store/apps/details?id=com.wireguard.android) / [iOS link](https://apps.apple.com/it/app/wireguard/id1441195209), click the '+' sign and scan the QR code with your phone's camera. Flip the switch to activate the tunnel. +**Android/iOS:** Run `pivpn -qr` on the PiVPN server to generate a QR code of your config, download the Wireguard app [Android link](https://play.google.com/store/apps/details?id=com.wireguard.android) / [iOS link](https://apps.apple.com/it/app/wireguard/id1441195209), click the '+' sign and scan the QR code with your phone's camera. Flip the switch to activate the tunnel. Connecting to the PiVPN server (OpenVPN) -------------------------------------------- @@ -183,12 +183,12 @@ mkdir -p /etc/openvpn/client chown root:root /etc/openvpn/client chmod 700 /etc/openvpn/client ``` -Move the config and connect: +Move the config and connect (input the pass phrase if you set one): ``` -mv whatever.ovpn /etc/openvpn/client/whatever.conf -systemctl start openvpn-client@whatever +mv whatever.ovpn /etc/openvpn/client/ +openvpn /etc/openvpn/client/whatever.ovpn ``` -Run `systemctl stop openvpn-client@whatever` to disconnect. +Press CTRL-C to disconnect. **Mac**: You can use an OpenVPN client like [Tunnelblick](https://tunnelblick.net/downloads.html). Here's a [guide](https://tunnelblick.net/czUsing.html) to import the configuration. From ef6e84419e6e7e0e10937c42c0ff8210d42a4a3d Mon Sep 17 00:00:00 2001 From: Orazio Date: Thu, 2 Jan 2020 18:50:12 +0100 Subject: [PATCH 10/10] Fix typo and mv command --- auto_install/install.sh | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/auto_install/install.sh b/auto_install/install.sh index 3625e70..d9fc07f 100755 --- a/auto_install/install.sh +++ b/auto_install/install.sh @@ -872,7 +872,7 @@ askWhichVPN(){ fi fi else - if (whiptail --backtitle "Setup PiVPN" --title "Installation mode" --yesno "WireGuard is a new kind of VPN that provides near-istantaneous connection speed, high performance, modern cryptography.\\n\\nIt's the recommended choise expecially if you use mobile devices where WireGuard is easier on battery than OpenVPN.\\n\\nOpenVPN is still available if you need the traditional, flexible, trusted VPN protocol. Or if you need features like TCP and custom search domain.\\n\\nChoose 'Yes' to use WireGuard or 'No' to use OpenVPN." ${r} ${c}); + if (whiptail --backtitle "Setup PiVPN" --title "Installation mode" --yesno "WireGuard is a new kind of VPN that provides near-istantaneous connection speed, high performance, modern cryptography.\\n\\nIt's the recommended choice expecially if you use mobile devices where WireGuard is easier on battery than OpenVPN.\\n\\nOpenVPN is still available if you need the traditional, flexible, trusted VPN protocol. Or if you need features like TCP and custom search domain.\\n\\nChoose 'Yes' to use WireGuard or 'No' to use OpenVPN." ${r} ${c}); then VPN="wireguard" else @@ -1498,7 +1498,7 @@ set_var EASYRSA_KEY_SIZE ${pivpnENCRYPT}" | $SUDO tee vars >/dev/null else # Generate Diffie-Hellman key exchange ${SUDOE} ./easyrsa gen-dh - ${SUDOE} mv "pki/dh.pem pki/dh${pivpnENCRYPT}.pem" + ${SUDOE} mv "pki/dh.pem" "pki/dh${pivpnENCRYPT}.pem" fi # Generate static HMAC key to defend against DDoS