From 689f0bb697646d42f2e8f8d740f8d0732c8eca92 Mon Sep 17 00:00:00 2001
From: dlandon <dlandon@familyoflandon.com>
Date: Wed, 3 Apr 2024 10:38:52 -0500
Subject: [PATCH] Add Outgoing Proxy Manager.

---
 emhttp/plugins/dynamix/OutgoingProxy.page     | 314 ++++++++++++++++++
 emhttp/plugins/dynamix/OutgoingProxy.php      |  50 +++
 .../plugins/dynamix/OutgoingProxyManager.page |   6 +
 .../dynamix/include/OutgoingProxyLib.php      | 108 ++++++
 .../plugins/dynamix/scripts/outgoingproxy.sh  | 117 +++++++
 5 files changed, 595 insertions(+)
 create mode 100644 emhttp/plugins/dynamix/OutgoingProxy.page
 create mode 100644 emhttp/plugins/dynamix/OutgoingProxy.php
 create mode 100644 emhttp/plugins/dynamix/OutgoingProxyManager.page
 create mode 100644 emhttp/plugins/dynamix/include/OutgoingProxyLib.php
 create mode 100644 emhttp/plugins/dynamix/scripts/outgoingproxy.sh

diff --git a/emhttp/plugins/dynamix/OutgoingProxy.page b/emhttp/plugins/dynamix/OutgoingProxy.page
new file mode 100644
index 000000000..7b5474270
--- /dev/null
+++ b/emhttp/plugins/dynamix/OutgoingProxy.page
@@ -0,0 +1,314 @@
+Menu="OutgoingProxyManager"
+Title="Outgoing Proxy Manager"
+Tag="icon-network"
+---
+<?php
+/* Copyright 2024, Lime Technology
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License version 2,
+ * as published by the Free Software Foundation.
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ */
+
+$opmPlugin		= "dynamix";
+require_once("plugins/".$opmPlugin."/include/OutgoingProxyLib.php");
+
+/* Parse the plugin config file. */
+$cfg = parse_plugin_config();
+
+/* Pid file used to track the Running/Stopped status. */
+$opm_pid		= "OutgoingProxy";
+$pid_file		= "/var/run/".$opm_pid.".pid";
+if ($cfg['proxy_active'] != "0") {
+	file_put_contents($pid_file, "running");
+} else if (file_exists($pid_file)) {
+	unlink($pid_file);
+}
+
+/* Be sure proxy_mames are defined */
+$cfg['proxy_name_1']	= $cfg['proxy_name_1'] ?? "";
+$cfg['proxy_name_2']	= $cfg['proxy_name_2'] ?? "";
+$cfg['proxy_name_3']	= $cfg['proxy_name_3'] ?? "";
+
+/* Get the encrypted url. */
+$proxy_1_url			= $cfg['proxy_url_1'];
+
+/* Parse the url, user, and password from the full url for proxy 1. */
+$url_array				= get_url($cfg['proxy_url_1'] ?? "");
+$cfg['proxy_url_1']		= $url_array['url'];
+$cfg['proxy_user_1']	= $url_array['user'];
+$cfg['proxy_pass_1']	= $url_array['pass'];
+
+/* Get the encrypted url. */
+$proxy_2_url			= $cfg['proxy_url_2'];
+
+/* Parse the url, user, and password from the full url for proxy 2. */
+$url_array				= get_url($cfg['proxy_url_2'] ?? "");
+$cfg['proxy_url_2']		= $url_array['url'];
+$cfg['proxy_user_2']	= $url_array['user'];
+$cfg['proxy_pass_2']	= $url_array['pass'];
+
+/* Get the encrypted url. */
+$proxy_3_url			= $cfg['proxy_url_3'];
+
+/* Parse the url, user, and password from the full url for proxy 3. */
+$url_array				= get_url($cfg['proxy_url_3'] ?? "");
+$cfg['proxy_url_3']		= $url_array['url'];
+$cfg['proxy_user_3']	= $url_array['user'];
+$cfg['proxy_pass_3']	= $url_array['pass'];
+?>
+
+<form markdown="1" name="outgoing_proxy_manager" method="POST" action="/update.php" target="progressFrame">
+<input type="hidden" name="#file" value="/boot/config/proxy.cfg">
+<input type="hidden" name="#command" value="/plugins/<?=$opmPlugin;?>/scripts/outgoingproxy.sh">
+<input type="hidden" name="#arg[1]" value="apply">
+
+<p><strong>_(Enable Outgoing Proxy)_</strong></p>
+_(Select Proxy)_:
+: <select name="proxy_active" style="width:20%;" size="1">
+	<?=mk_option($cfg['proxy_active'], "0", "_(None)_");?>
+
+	<?if (($cfg['proxy_url_1']) && ($cfg['proxy_name_1'])):?>
+	<?=mk_option($cfg['proxy_active'], "1", $cfg['proxy_name_1'], "disabled");?>
+	<?endif;?>
+
+	<?if (($cfg['proxy_url_2']) && ($cfg['proxy_name_2'])):?>
+	<?=mk_option($cfg['proxy_active'], "2", $cfg['proxy_name_2'], "disabled");?>
+	<?endif;?>
+
+	<?if (($cfg['proxy_url_3']) && ($cfg['proxy_name_3'])):?>
+	<?=mk_option($cfg['proxy_active'], "3", $cfg['proxy_name_3'], "disabled");?>
+	<?endif;?>
+</select>
+
+:outgoing_proxy_enable_plug:
+> Select the Proxy to use.  Only online Proxies will be selectable.
+>
+> If your network environment requires an outgoing http proxy, define that here.
+>
+> Outgoing connections from the webgui and some system processes will use the specified http proxy.  Docker container installs and updates will use the proxy, but the container itself will not, neither will any VMs.
+>
+> For a more comprehensive solution you might consider setting up <u><a href='https://docs.unraid.net/unraid-os/manual/security/vpn/#configuring-vpn-tunneled-access-for-system/' target='_blank'>_(VPN tunnel access for System)_</a></u>.
+:end
+
+<p><strong>_(Outgoing Proxy)_ 1</strong></p>
+_(Name)_:
+: <input type="text" name="proxy_name_1" style="width:20%;" maxlength="25" value="<?=$cfg['proxy_name_1'];?>" placeholder="(_(Required)_)"><span id="proxy-status-1"></span>
+
+:outgoing_proxy_name_plug:
+> Outgoing Proxy name for this Proxy.
+:end
+
+_(URL)_:
+: <input type="text" name="proxy_url_1" style="width:30%;" maxlength="100" value="<?=$cfg['proxy_url_1'];?>" onchange="verifyUrl(this)" placeholder="_(http://IP:port or http://host:port)_">
+
+:outgoing_proxy_url_plug:
+> Outgoing Proxy URL for this Proxy.  The URL can be entered with or without credentials.  The credentials will be parsed from the URL.
+>
+> If you enter a User and Password, they will be used as new credentials.
+:end
+
+_(User)_:
+: <input type="text" name="proxy_user_1" class="wide" maxlength="100" value="<?=$cfg['proxy_user_1'];?>" placeholder="(_(Optional)_)">
+
+:outgoing_proxy_user_plug:
+> Outgoing Proxy User Name for this Proxy.
+:end
+
+_(Password)_:
+: <input type="text" name="proxy_pass_1" class="wide" maxlength="100" value="<?=$cfg['proxy_pass_1'];?>" placeholder="(_(Optional)_)">
+
+:outgoing_proxy_password_plug:
+> Outgoing Proxy Password for this Proxy.
+:end
+
+<p><strong>_(Outgoing Proxy)_ 2</strong></p>
+_(Name)_:
+: <input type="text" name="proxy_name_2" style="width:20%;" maxlength="25" value="<?=$cfg['proxy_name_2'];?>" placeholder="(_(Required)_)"><span id="proxy-status-2"></span>
+
+:outgoing_proxy_name_plug:
+> Outgoing Proxy name for this Proxy.
+:end
+
+_(URL)_:
+: <input type="text" name="proxy_url_2" style="width:30%;" maxlength="100" value="<?=$cfg['proxy_url_2'];?>"  onchange="verifyUrl(this)" placeholder="_(http://IP:port or http://host:port)_">
+
+:outgoing_proxy_url_plug:
+> Outgoing Proxy URL for this Proxy.  The URL can be entered with or without credentials.  The credentials will be parsed from the URL.
+>
+> If you enter a User and Password, they will be used as new credentials.
+:end
+
+_(User)_:
+: <input type="text" name="proxy_user_2" class="wide" maxlength="100" value="<?=$cfg['proxy_user_2'];?>" placeholder="(_(Optional)_)">
+
+:outgoing_proxy_user_plug:
+> Outgoing Proxy User Name for this Proxy.
+:end
+
+_(Password)_:
+: <input type="text" name="proxy_pass_2" class="wide" maxlength="100" value="<?=$cfg['proxy_pass_2'];?>" placeholder="(_(Optional)_)">
+
+:outgoing_proxy_password_plug:
+> Outgoing Proxy Password for this Proxy.
+:end
+
+<p><strong>_(Outgoing Proxy)_ 3</strong></p>
+_(Name)_:
+: <input type="text" name="proxy_name_3" style="width:20%;" maxlength="25" value="<?=$cfg['proxy_name_3'];?>" placeholder="(_(Required)_)"><span id="proxy-status-3"></span>
+
+:outgoing_proxy_name_plug:
+> Outgoing Proxy name for this Proxy.
+:end
+
+_(URL)_:
+: <input type="text" name="proxy_url_3" style="width:30%;" maxlength="100" value="<?=$cfg['proxy_url_3'];?>"  onchange="verifyUrl(this)" placeholder="_(http://IP:port or http://host:port)_">
+
+:outgoing_proxy_url_plug:
+> Outgoing Proxy URL for this Proxy.  The URL can be entered with or without credentials.  The credentials will be parsed from the URL.
+>
+> If you enter a User and Password, they will be used as new credentials.
+:end
+
+_(User)_:
+: <input type="text" name="proxy_user_3" class="wide" maxlength="100" value="<?=$cfg['proxy_user_3'];?>" placeholder="(_(Optional)_)">
+
+:outgoing_proxy_user_plug:
+> Outgoing Proxy User Name for this Proxy.
+:end
+
+_(Password)_:
+: <input type="text" name="proxy_pass_3" class="wide" maxlength="100" value="<?=$cfg['proxy_pass_3'];?>" placeholder="(_(Optional)_)">
+
+:outgoing_proxy_password_plug:
+> Outgoing Proxy Password for this Proxy.
+:end
+
+&nbsp;
+: <input type="submit" value='_(Apply)_'><input type="button" value="_(Done)_" onclick="done()">
+</form>
+
+<script>
+	/* Refresh Proxy Manager page showing updated proxy status. */
+	function refreshPage() {
+		$.post(OPMURL, {
+			action: "proxy_status",
+			proxy_1_url: "<?=$proxy_1_url;?>",
+			proxy_2_url: "<?=$proxy_2_url;?>",
+			proxy_3_url: "<?=$proxy_3_url;?>",
+			proxy_active: "<?=$cfg['proxy_active'];?>"
+		}, function(data) {
+			/* Refresh the proxy status. */
+			/* Update the proxy status div */
+			$('#proxy-status-1').html('<strong>' + data.proxy_status_1 + '</strong>');
+
+			/* Update the proxy status div */
+			$('#proxy-status-2').html('<strong>' + data.proxy_status_2 + '</strong>');
+
+			/* Update the proxy status div */
+			$('#proxy-status-3').html('<strong>' + data.proxy_status_3 + '</strong>');
+
+			// Get a reference to the dropdown element
+			const dropdown = document.querySelector('select[name="proxy_active"]');
+			const options = dropdown.getElementsByTagName('option');
+
+			/* Enable the dropdown element if the proxy is available or active. */
+			const condition_1 = $('#proxy-status-1').text().trim() === '' || $('#proxy-status-1').text().trim() === 'Active';
+			const optionToEnableOrDisable_1 = options[1];
+
+			if (optionToEnableOrDisable_1) {
+				if (condition_1) {
+					/* Enable the option. */
+					optionToEnableOrDisable_1.removeAttribute('disabled');
+				} else {
+					/* Disable the option. */
+					optionToEnableOrDisable_1.setAttribute('disabled', 'disabled');
+				}
+			}
+
+			/* Enable the dropdown element if the proxy is available or active. */
+			const condition_2 = $('#proxy-status-2').text().trim() === '' || $('#proxy-status-2').text().trim() === 'Active';
+			const optionToEnableOrDisable_2 = options[2];
+
+			if (optionToEnableOrDisable_2) {
+				if (condition_2) {
+					// Enable the option
+					optionToEnableOrDisable_2.removeAttribute('disabled');
+				} else {
+					// Disable the option
+					optionToEnableOrDisable_2.setAttribute('disabled', 'disabled');
+				}
+			}
+
+			/* Enable the dropdown element if the proxy is available or active. */
+			const condition_3 = $('#proxy-status-3').text().trim() === '' || $('#proxy-status-3').text().trim() === 'Active';
+			const optionToEnableOrDisable_3 = options[3];
+
+			if (optionToEnableOrDisable_3) {
+				if (condition_3) {
+					// Enable the option
+					optionToEnableOrDisable_3.removeAttribute('disabled');
+				} else {
+					// Disable the option
+					optionToEnableOrDisable_3.setAttribute('disabled', 'disabled');
+				}
+			}
+		}, 'json');
+	}
+
+	/* polyfill to fix reportValidity() for Firefox. */
+	if (!HTMLInputElement.prototype.reportValidity || (navigator.userAgent.indexOf("Firefox") !== -1)) {
+		HTMLInputElement.prototype.reportValidity = function () {
+		if (this.checkValidity()) {
+			return true;
+		} else {
+			var labelText = "_(Invalid data)_";
+			try {
+				labelText = $(this).closest('dl').children().first()[0].textContent;
+			} catch (err) { }
+				/* the browser generates the validationMessage, we cannot translate it. */
+				swal({title:labelText,text:this.validationMessage,html:true,type:'error',confirmButtonText:"_(Ok)_"});
+				return false;
+			}
+		};
+	}
+
+	/* Verify the format of the url. */
+	function verifyUrl(inputElement) {
+		const fieldValue = inputElement.value;
+		/* Return true if the field is blank. */
+		if (fieldValue.trim() === '') {
+			return true;
+		}
+
+		/* Verify the url is in the correct format. */
+		if (fieldValue.startsWith("http://") && fieldValue.match(/:\d+$/)) {
+			inputElement.setCustomValidity("");
+			return true;
+		} else {
+			inputElement.setCustomValidity("_(Please match the requested format)_:\n\n"+"'_(http://IP:port or http://host:port)_'");
+			inputElement.reportValidity();
+			return false;
+		}
+	}
+
+	$(function() {
+		/* Status indicator on upper right of page. */
+		showStatus('pid','<?=$opm_pid;?>');
+		
+		/* Page refresh rate in milliseconds. */
+		const REFRESH_INTERVAL = 15000;
+
+		/* Set page refresh interval every 15 seconds. */
+		window.setInterval(refreshPage, REFRESH_INTERVAL);
+
+		/* Do an initial page refresh to fill in values. */
+		refreshPage();
+	});
+
+	/* URL for Outgoing Proxy PHP file. */
+	const OPMURL = '/plugins/<?=$opmPlugin;?>/OutgoingProxy.php';
+</script>
diff --git a/emhttp/plugins/dynamix/OutgoingProxy.php b/emhttp/plugins/dynamix/OutgoingProxy.php
new file mode 100644
index 000000000..4ea3c6209
--- /dev/null
+++ b/emhttp/plugins/dynamix/OutgoingProxy.php
@@ -0,0 +1,50 @@
+<?php
+/* Copyright 2024, Lime Technology
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License version 2,
+ * as published by the Free Software Foundation.
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ */
+
+$opmPlugin	= "dynamix";
+require_once("plugins/".$opmPlugin."/include/OutgoingProxyLib.php");
+
+switch ($_POST['action']) {
+	case 'proxy_status':
+		/* Get the active proxy. */
+		$proxy_active		= urldecode($_POST['proxy_active']);
+
+		/* Get the proxy 1 status. */
+		$proxy_1_url	= urldecode($_POST['proxy_1_url']);
+		if ($proxy_1_url) {
+			$proxy_1_status	= proxy_online($proxy_1_url) ? ($proxy_active == "1" ? "Active" : "") : ($proxy_active == "1" ? "Offline" : "Not Available");
+		} else {
+			$proxy_1_status = "";
+		}
+
+		/* Get the proxy 2 status. */
+		$proxy_2_url	= urldecode($_POST['proxy_2_url']);
+		if ($proxy_2_url) {
+			$proxy_2_status	= proxy_online($proxy_2_url) ? ($proxy_active == "2" ? "Active" : "") : ($proxy_active == "2" ? "Offline" : "Not Available");
+		} else {
+			$proxy_2_status = "";
+		}
+		/* Get the proxy 3 status. */
+		$proxy_3_url	= urldecode($_POST['proxy_3_url']);
+		if ($proxy_3_url) {
+			$proxy_3_status	= proxy_online($proxy_3_url) ? ($proxy_active == "3" ? "Active" : "") : ($proxy_active == "3" ? "Offline" : "Not Available");
+		} else {
+			$proxy_3_status = "";
+		}
+
+		echo json_encode(array( 'proxy_status_1' => $proxy_1_status, 'proxy_status_2' => $proxy_2_status, 'proxy_status_3' => $proxy_3_status ));
+		break;
+
+	default:
+		outgoingproxy_log("Undefined POST action - ".$_POST['action'].".");
+		break;
+}
+?>
diff --git a/emhttp/plugins/dynamix/OutgoingProxyManager.page b/emhttp/plugins/dynamix/OutgoingProxyManager.page
new file mode 100644
index 000000000..91c1bf768
--- /dev/null
+++ b/emhttp/plugins/dynamix/OutgoingProxyManager.page
@@ -0,0 +1,6 @@
+Menu="NetworkServices"
+Type="xmenu"
+Title="Outgoing Proxy Manager"
+Icon="icon-network"
+Tag="icon-network"
+---
diff --git a/emhttp/plugins/dynamix/include/OutgoingProxyLib.php b/emhttp/plugins/dynamix/include/OutgoingProxyLib.php
new file mode 100644
index 000000000..0a3b07b23
--- /dev/null
+++ b/emhttp/plugins/dynamix/include/OutgoingProxyLib.php
@@ -0,0 +1,108 @@
+<?php
+/* Copyright 2024, Lime Technology
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License version 2,
+ * as published by the Free Software Foundation.
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ */
+
+$opmPlugin			= "dynamix";
+
+/* UI config file location. */
+$plg_config_file	= "/boot/config/proxy.cfg";
+
+/* Output config file location for set_proxy script. */
+$proxy_config_file = "/boot/config/proxy.cfg";
+
+/* Outgoing Proxy Manager logging tag. */
+$opm_log	= "Outgoing Proxy Manager";
+
+/* Outgoing Proxy logging. */
+function outgoingproxy_log($m) {
+	global $opm_log;
+
+	$m		= print_r($m,true);
+	$m		= str_replace("\n", " ", $m);
+	$m		= str_replace('"', "'", $m);
+	exec("/usr/bin/logger"." ".escapeshellarg($m)." -t ".escapeshellarg($opm_log));
+}
+
+/* Parse plugin config file. */
+function parse_plugin_config() {
+	global $plg_config_file;
+
+	$cfg = is_file($plg_config_file) ? @parse_ini_file($plg_config_file, true) : array();
+
+	return($cfg);
+}
+
+/* Check to see if the proxy is online and available. */
+function proxy_online($proxyUrl) {
+
+	$rc	= true;
+
+	if ($proxyUrl) {
+		/* Initialize cURL session. */
+		$ch = curl_init("http://www.msftncsi.com/ncsi.txt");
+
+		/* Set cURL options. */
+		curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3);	/* Timeout in seconds. */
+		curl_setopt($ch, CURLOPT_HTTPPROXYTUNNEL, true);
+		curl_setopt($ch, CURLOPT_PROXY, $proxyUrl);		/* Url is a proxy. */
+		curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); /* Return transfer as a string. */
+
+		/* Execute cURL request. */
+		$response = curl_exec($ch);
+
+		if ($response === false) {
+			/* Proxy is not available. */
+			$rc	= false;
+		}
+
+		/* Close cURL session. */
+		curl_close($ch);
+	}
+
+	return ($rc);
+}
+
+/* Get the URL with the user and password parsed from the url. */
+function get_url($cfg_url) {
+
+	$return	= [
+		'url' => '',
+		'user' => '',
+		'pass' => '',
+	];
+
+	if ($cfg_url) {
+		/* Parse the URL by removing the user and password. */
+		$urlComponents = parse_url($cfg_url);
+
+		/* Parse user, password, host, and port from stored URL. */
+		$host		= isset($urlComponents['host']) ? $urlComponents['host'] : '';
+		$port		= isset($urlComponents['port']) ? $urlComponents['port'] : '';
+		$user		= isset($urlComponents['user']) ? $urlComponents['user'] : '';
+		$pass		= isset($urlComponents['pass']) ? $urlComponents['pass'] : '';
+
+		/* Return array of url, user, and password. */
+		$return['url']		= "http://".$host.':'.$port;
+
+		/* Extract the credentials. */
+		if (strpos($cfg_url, '%') !== false) {
+			/* The credentials are urlencoded. */
+			$return['user']		= urldecode($user);
+			$return['pass']		= urldecode($pass);
+		} else {
+			/* The credentials are not urlencoded. */
+			$return['user']		= $user;
+			$return['pass']		= $pass;
+		}
+	}
+
+	return($return);
+}
+?>
diff --git a/emhttp/plugins/dynamix/scripts/outgoingproxy.sh b/emhttp/plugins/dynamix/scripts/outgoingproxy.sh
new file mode 100644
index 000000000..5858ac9a0
--- /dev/null
+++ b/emhttp/plugins/dynamix/scripts/outgoingproxy.sh
@@ -0,0 +1,117 @@
+#!/usr/bin/php
+<?php
+/* Copyright 2024, Lime Technology
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License version 2,
+ * as published by the Free Software Foundation.
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ */
+
+$opmPlugin	= "dynamix";
+require_once("plugins/".$opmPlugin."/include/OutgoingProxyLib.php");
+
+/* Save settings and update config. */
+function apply() {
+	global $opmPlugin, $proxy_config_file;
+
+	/* Process the new configuration. */
+	$cfg = parse_plugin_config();
+
+	for ($i = 1; $i <= 3; $i++) {
+		$proxy_name	= "proxy_name_".$i;
+		$name		= trim($cfg[$proxy_name]);
+		$proxy_url	= "proxy_url_".$i;
+		$url		= trim($cfg[$proxy_url]);
+		$proxy_user	= "proxy_user_".$i;
+		$proxy_pass	= "proxy_pass_".$i;
+		if (($name) && ($url)) {
+			/* Confirm the url is in the proper format. */
+			if (strpos($url, 'http://') !== false && preg_match('/:\d+$/', $url)) {
+				/* The string contains 'http://' and a port designation at the end */
+				$proxy_user	= "proxy_user_".$i;
+				$proxy_pass	= "proxy_pass_".$i;
+
+				/* Parse the URL components. */
+				$urlComponents = parse_url($url);
+
+				/* Replace user and password in the url. */
+				$host = isset($urlComponents['host']) ? $urlComponents['host'] : '';
+				$port = isset($urlComponents['port']) ? $urlComponents['port'] : '';
+				$user = isset($urlComponents['user']) ? $urlComponents['user'] : '';
+				$pass = isset($urlComponents['pass']) ? $urlComponents['pass'] : '';
+
+				/* Use the entered user if not blank. */
+				$cfg_user		= $cfg[$proxy_user] ?? "";
+				$user			= $cfg_user ? $cfg_user : $user;
+				$encodedUser	= (strpos($user, '%') === false) ? urlencode($user) : $user;
+
+				/* Use the entered pass if not blank. */
+				$cfg_pass		= $cfg[$proxy_pass] ?? "";
+				$pass 			= $cfg_pass ? $cfg_pass : $pass;
+				$encodedPass	= (strpos($pass, '%') === false) ? urlencode($pass) : $pass;
+
+				/* Reconstruct the URL with new credentials. */
+				if (($host) && ($port)) {
+					$constructedUrl = 'http://';
+					if (($encodedUser) && ($encodedPass)) {
+						$constructedUrl .= $encodedUser.':'.$encodedPass.'@';
+					}
+					$constructedUrl .= $host.':'.$port;
+				} else {
+					$constructedUrl	= "";
+				}
+			} else {
+				/* The string does not contain 'http://' and/or a port designation at the end */
+				$constructedUrl	= "";
+			}
+
+			/* Save the constructed url. */
+			$cfg[$proxy_url]	= $constructedUrl;
+		} else if (! $name) {
+			$cfg[$proxy_url]	= "";
+		}
+
+		/* Remove user and pass from the configuration file. */
+		unset($cfg[$proxy_user]);
+		unset($cfg[$proxy_pass]);
+	}
+
+	/* Rewrite config file. */
+	/* Convert the array to an INI string. */
+	$iniString = '';
+	foreach ($cfg as $key => $value) {
+		$iniString .= "$key=\"$value\"\n";
+	}
+
+	/* Write the INI string to a file. */
+	file_put_contents($proxy_config_file, $iniString);
+
+	/* Let things settle. */
+	sleep(1);
+
+	/* Now run the proxy setup script. */
+	if (is_executable("/usr/local/sbin/set_proxy")) {
+		exec("at -M -f /usr/local/sbin/set_proxy now 2>/dev/null");
+
+		outgoingproxy_log("'set_proxy' script executed");
+	} else {
+		outgoingproxy_log("'set_proxy' script does not exist");
+	}
+}
+
+/* Main entry point, */
+switch ($argv[1]) {
+	case 'apply':
+		apply();
+		break;
+
+	default:
+		echo("Error: 'outgoingproxy.sh {$argv[1]}' not understood\n");
+		echo("outgoingproxy.sh usage: 'apply'\n");
+		exit(0);
+		break;
+}
+?>