WinAdminPassword 1.5
====================

# Description
====================

 Tool for the deployment of unique passwords for Windows and Unix systems. It is based on the serial number
 of computers and a secret key. The advantage is that no password is stored in a database and
 you can display them with a GLPI plugin, Webmin...

# Installation
====================

 Prerequisistes :
	* POSIX / GNU Linux/ Unix systems : Perl, Config::Crontab, Digest::SHA1, dmidecode and chpasswd
	* Microsoft Windows systems : ActivePerl

 Installation : 
	* Microsoft Windows x64 : 
		- perl is not installed : Execute "Win32\winadminpassword-1.5-x64.exe" file
		- Perl is already installed : Execute "Win32\winadminpassword-1.5-noarch-without-perl.exe" file

	* Microsoft Windows x86 :
		- Perl is not installed : Execute "Win32\winadminpassword-1.5-x86.exe" file
		- Perl is already installed : Execute "Win32\winadminpassword-1.5-noarch-without-perl.exe" file

	For Microsoft Windows, you can deploy packages with the silent parameter "/S".
	(See GPO, Sysprep, PsExec, WPKG, OCSInventory NG, FusionInventory, Uranos...)

	* RHEL/CentOS/Fedora :
		- install perl-Config-Crontab RPM : http://pkgs.org/search/?keyword=perl-Config-Crontab
		> cd RPM
		> yum install winadminpassword-1.5-0.1.noarch.rpm

	* OpenSuze :
		> yast2 --install perl perl-Config-Crontab perl-Digest-SHA1 dmidecode
		> cd RPM
		> rpm -ivh winadminpassword-1.5-0.1.noarch.rpm

	* Mandriva :
		> urpmi perl perl-Config-Crontab perl-Digest-SHA1 dmidecode
		> cd RPM
		> rpm -ivh winadminpassword-1.5-0.1.noarch.rpm

	* Debian/Ubuntu :
		> apt-get install dmidecode libdigest-sha1-perl
		> cd DEB
		> dpkg -i libconfig-crontab-perl_1.33-1_all.deb
		> dpkg -i winadminpassword_1.5_all.deb

	* GNU Linux / BSD / POSIX : 
		- install perl : http://www.perl.org/
		- install dmidecode : http://www.nongnu.org/dmidecode/
		- install chpasswd 
		- install Config::Crontab : perl -MCPAN -e 'install Config::Crontab'
		- install Digest::SHA1 : perl -MCPAN -e 'install Digest::SHA1'
		- install WinAdminPassword :
			> cd Others
			> perl Makefile.PL
			> make
			> make install

 Use :
	> winadminpassword --help
	> man winadminpassword

# Manual
====================

Usage
        winadminpassword [-v] [-h] [--printserial] [--printpassword] [--changepassword] [-s serial] [-k secretkey]
 [-u username] [-w password] [-l length] [-a algorith] [-r color] [-z size] [-j] [-o] [-t] [-d date]
 [-x secondsecretkey] [-g] [--printdate]

Functions
 -v, --version                          Displays the script version
 -h, --help                             This information
 -y, --printdate                        Print date in WinAdminPassword format
 -m, --showserial, --printserial        Print serial number of this computer
 -p, --showpasswd, --printpassword      Print password (-k and -l are mandatory)
 -c, --chpasswd, --changepassword       Change password for a user (-k, -u and -l are mandatory)

Options
 -o, --verbose                          Print generated password when you use --changepassword function
 -s, --serial=SERIAL                    Set the serial number
                                        default : the serial number of computer where the script is executed
 -k, --key=KEY                          The very secret key
 -x, --skey, --secondkey=KEY            The second key (optional but really useful with the GLPI plugin because
					it is not stored in the database and it is requested each time to the passwords)
					you can use a simple passphrase
 -u, --user=USER                        Set the username of the local account to change his password
 -w, --passwd, --password=PASSWORD      Set the password if you don't want use the generated password
 -l, --length=LENGTH                    Set the length of the generated password
 -a, --algo=ALGO                        Set the algorithm for generating the hash that will be use to generate password
                                                1 : \$key.\$serial
                                                2 : \$serial\$key
                                                3 : \$serial\$key\$serial
                                                4 : \$key\$serial\$key
                                                5 : \$key\$serial
                                                default : 1
 -j, --html                             Print the output of --printpassword in HTML
 -r, --color=COLOR                      Set the print color for the html output
                                        default : orange
 -z, --size=SIZE                        Set the size for the html output
                                        default : 16
 -t, --time                             Add the current time to the hash, in order to generate a password
					based on the system time
 -g, --cron                             Add the command line to cron, it will be executed every
					hours. (Very useful with -t)
 -d, --date=DATE                        Set the date to find a timed generated password
                                                use "10.2011.Feb.12" for Feb 12 2011 at 10am
                                                Months : Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec
                                                Hours : 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

!! On unix or GNU Linux systems, you must despecialize $ charaters with \ in your command line

Samples

 PrintSerial :
        # winadminpassword --printserial
                print the serial number of this computer

 PrintDate : 
	# winadminpassword --printdate
		print the current system date in WinAdminPassword format

 ChangePassword :
        # winadminpassword --changepassword -k "myverysecretkey" -l "12" -u "Administrator" -o
                change the password for Administrator account. The password size will be 12. 
		The output will print the generated password

        # winadminpassword --changepassword -k "myverysecretkey" -l "12" -u "root" -t
                change the password for root account. The password size will be 12.
		The generated password will be based on systemtime. Use -d parameter to find it.

        # winadminpassword --changepassword -k "myverysecretkey" -l "12" -u "root" -t -g
                add this command to cron. Every hour the password will be changed. Use -d parameter to find it.

 PrintPassword :
        # winadminpassword --printpassword -a "2" -s "AB4528CF" -k "myverysecretkey" -l "18" -j -r "red" -z "12"
                print the generated password with myverysecretkey and the second algorithm for the 
		AB4528CF serial. The output will be in HTML in red and with size 12.

        # winadminpassword --printpassword -l 12 -s "AB4HGD" -k "myverysecretkey" -x "hello" -d "3.2011.Jul.28"
                print the result of timed generated password at 3 Hours in July 28 2011. 
		The second secret key is "hello".

# FIND PASSWORDS
====================

 You can place winadminpassword script on Webmin software and call the command : 
  - winadminpassword --printpassword -k "myverysecretkey" -s "$getserialfromform" -l "12" -j

 You also have a GLPI plugin if you want to print them in GLPI (https://forge.indepnet.net/projects/winadminpassword)

# DEPENDENCIES
====================

This module requires these other modules and libraries:
Config::Crontab
Digest::SHA1

# COPYRIGHT AND LICENCE
====================

# WinAdminPassword - A utility to deploy unique passwords for Microsoft Windows and Unix systems. #
# It is based on the serial number of computers and a private key. #
# The advantage is that no password is stored in a database. #
# Copyright (C) 2011 Nicolas BOURGES #
# 
# This program is free software: you can redistribute it and/or modify #
# it under the terms of the GNU General Public License as published by #
# the Free Software Foundation, either version 3 of the License, or #
# (at your option) any later version. #
# 
# This program is distributed in the hope that it will be useful, #
# but WITHOUT ANY WARRANTY. without even the implied warranty of #
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the #
# GNU General Public License for more details. #
#
# You should have received a copy of the GNU General Public License #
# along with this program.  If not, see <http://www.gnu.org/licenses/>. #