Merge branch 'rdp_enhance' of skyfall/tab-sorcery into dev

README.md

@@ -21,14 +21,38 @@ Default username (bob.user)
 
 Once done, all hostnames in the DNS zone should be available for SSH/Telnet/RDP by a tab-completable alias of just the hostname (in new shell sessions).
 
-#### Can I change the window geometry for rdesktop?
+### Options
-Yes! You simply need to export a variable *before* calling the tab-sorcery.sh script. The variable to export is called **SORC_GEOM_RDP**, which will take the form of [width]x[height].
+Options can be configured as exported variables, set in your shell RC files before calling the tab-sorcery script itself. So far there are two options:
+##### Windows RDP Window Geometry
+###### Variable: SORC_GEOM_RDP
+This option sets the resolution of your Windows RDP connections. If left unset or an invalid value is detected, the default is **1600x900**.
 Example:
 ```
 export SORC_GEOM_RDP='1280x720'
+```
+
+##### Windows Password File (INSECURE)
+###### Variable: SORC_PASS_FILE
+This option supplies the path to a plain text file containing a list of hostnames and passwords in the following format:
+```
+hostname=password
+```
+If this option is provided, hosts marked as Windows hosts will check this file for a password and pass it on to the alias for the host in order to make logging into Windows almost as painless as *nix hosts.
+**This feature should be considered temporary and used only at your own risk.** This is a **very insecure** thing to do, and the intent is to replace this later with LastPass support or similar instead, and was added mostly as a personal exercise.
+
+To configure, once you have your password file set up, just export the location as a variable in your shell RC before sourcing the __Tab Sorcery__ script like so:
+```
+export SORC_PASS_FILE="$HOME/.some_file"
+```
+
+### Full Example of How to Call the Tab Sorcery Script
+Here is a full example utilizing all available options. Please note that only the last line, beginning with a dot, is absolutely required.
+```
+export SORC_GEOM_RDP='1280x720'
+export SORC_PASS_FILE="$HOME/.some_file"
 . $HOME/git/tab-sorcery/tab-sorcery.sh example.com 127.0.0.1 bob.user
 ```
-The default window geometry that is used if this variable is either unset, or if an invalid value is detected is **1600x900**.
+
 
 ## DNS Setup
 You'll likely want to create a DNS zone specifically for this script for better control over the hosts included. I would recommend using a TLD not normally available, to be sure you don't have any overlap with existing DNS names. This domain doesn't need to be publicly queried, and actually it's probably in interest of security if it isn't.

tab-sorcery.sh

@@ -14,6 +14,13 @@ case "$SORC_GEOM_RDP" in
 	*) geom_rdp='1600x900';;
 esac
 
+# Check for a plain text password files for Windows hosts
+# (Disclaimer: This is highly insecure and unrecommended.)
+case "$SORC_PASS_FILE" in
+	[~$/abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789]*) pass_file=$SORC_PASS_FILE;;
+	*) pass_file=/dev/null;;
+esac
+
 get_hostip () {
 	#host_ip=`echo $zone_xfer | grep ${host} | grep A | awk '{print $3}'`
 	host_ip=`echo $zone_xfer | grep $1 | grep A | awk '{print $3}'`
@@ -30,7 +37,16 @@ while read host <&3; do
 			get_hostip ${host}
 			alias ${host_short}="${connect_cmd} ${user_name}@${host_ip}"
 		elif [ "`echo $zone_xfer | grep $host | grep TXT | awk '{print $3}'`" = '"windows"' ]; then
-			connect_cmd="rdesktop -g $geom_rdp"
+			if [ -f $pass_file ]; then
+				if pass_line=`grep $host_short $pass_file`; then
+					winpass=`awk -F= '{print $2}' <<< "$pass_line"`
+					connect_cmd="rdesktop -g $geom_rdp -p $winpass"
+				else
+					connect_cmd="rdesktop -g $geom_rdp"
+				fi
+			else
+				connect_cmd="rdesktop -g $geom_rdp"
+			fi
 			get_hostip ${host}
 			alias ${host_short}="${connect_cmd} -u ${user_name} ${host_ip}"
 		elif [ "`echo $zone_xfer | grep $host | grep TXT | awk '{print $3}'`" = '"cisco"' ]; then