From pGina

Contents 1 Disclaimer 2 Installation & Configuration Overview 2.1 System Requirements 2.2 Choose Authentication Method 2.3 Download pGina 2.4 Download Plugin 2.5 Install pGina 2.5.1 Install Options 2.5.2 Upgrade Options 2.6 Configure pGina 2.6.1 About Group 2.6.2 Logon Window Group 2.6.3 Plugin Group 2.6.4 Profile Group 2.6.5 Session Group 2.6.6 Advanced Group 2.7 Configure Plugin 3 Advanced Usage 3.1 Registry Options 3.2 Silent Install

Author: Steve Cross

Last Updated: 05/03/2010

Disclaimer

Please bear with me while I work on creating the documentation on this page. For the time being if you need assistance you can use any of the following resources.

• Mailing Lists
• Support Forums
• IRC Channel

If you would like to stay posted on the progress of the documentation, subscribe to the pGina Updates Mailing List and we will be sure to keep you informed!

Installation & Configuration Overview

The installation of pGina is fairly straightforward and follows many of the same conventions that other Windows programs use. However, from time to time people may experience issues or may not know exactly how a system needs to be configured in order to get up and running. This documentation is here to assist with those situations. I have done my best to be as thorough as possible while still explaining the steps clearly, but if you feel that I have missed something or did not explain something well, shoot me an email.

Below is a list of the generalized steps that you will need to follow in order to setup pGina-2.x successfully. Keep in mind that settings and configuration options will differ here and there depending on the targeted system or authentication method.

1. Verify that you meet the system requirements
2. Choose an authentication method
3. Download pGina-2.x
4. Download the chosen plugin
5. Install pGina
6. Configure pGina
7. Configure Plugin

Please note: As pGina is a modification of Operating System level components, should pGina ever crash, or otherwise become unusable, it will prevent any access to the system. For this reason it is important to know how to boot into Safe Mode, have a rescue diskette, or otherwise be familiar with remote registry editing.

System Requirements

• Windows Vista/7/2008
• If running Vista, .NET 3.5 SP1 or higher. If running on Windows 7 then .NET comes packaged with the operating system and you do not need to worry about .NET.

Choose Authentication Method

Download pGina

Latest Version: pGina 2.1.0

Version	Release Date
pGina 2.1.0	07-03-2010	Release Notes
pGina-2.0 build 109	05-02-2010	Release Notes

Download Plugin

List of all known plugins

Install pGina

Coming soon.

Install Options

Coming soon.

Upgrade Options

Coming soon.

Configure pGina

In this section you will find detailed information about using the included configuration application to configure pGina.

About Group

Logon Window Group

Plugin Group

Profile Group

Session Group

Advanced Group

Configure Plugin

Advanced Usage

Registry Options

Currently supported options are registry keys under HKLM\Software\pGina:

For boolean options, 0 = disabled, 1 = enabled.

Type	Name	IsBool	Description
REG_SZ	autofillLastUsername	Yes	Automatically complete the last logged in username field on the logon screen
REG_DWORD	disableDefaultCP	Yes	Disable the default credential provider (must be changed through config app)
REG_DWORD	disableShutdown	Yes	Disable pre-logon shutdown options (must be changed through config app)
REG_DWORD	enforceSessTimeout	Yes	Enforce a session time limit
REG_DWORD	forceLogin	Yes	If a username authenticated by pGina already exists on the local system, it's password will be reset by the one used to authenticate with pGina.
REG_SZ	globalGroups	No	A ';' seperated list of groups that all authenticated users should be added to
REG_DWORD	hideMotd	Yes	Do NOT display the MOTD
REG_DWORD	hidePlugin	Yes	Do NOT display the 'about plugin' text
REG_DWORD	hideProfile	Yes	Hide accounts created by pGina from the Windows logon screen
REG_DWORD	keepProfile	Yes	Do NOT remove profiles created by pGina at logoff
REG_SZ	lastSuccessfulUsername	No	Used by CredentialProvider to autofill unlock and logon screen (if autofillLastUsername is on)
REG_SZ	logFile	No	Full path where pGina will output logs to, defaults to c:\pGinaLog.txt
REG_DWORD	logLevel	No	(1-10) Log Level: 0 is no logging, 10 is full trace logging. For more details, see "Log Levels"
REG_SZ	logo	No	Path to a custom bitmap image to be displayed as the tile image instead of the pGina logo default image is 128 pixels square, at 299dpi @ 24 bpp
REG_SZ	logoffUtilPath	No	Full path to the executable needed to end a user's session after timeout
REG_SZ	motd	No	Message of the day text (no support for % macros yet!)
REG_DWORD	overridePluginSession	Yes	Forces pGina to use global sessionTimeout instead of value retrieved from plugin
REG_SZ	pathPlugin	No	Full path to the plugin DLL to load
REG_SZ	pluginName	No	Name of the plugin displayed under the logo
REG_SZ	sessionTimeout	No	(1-10080) Number of minutes before timed sessions log off
REG_SZ	sPassword	No	Password for single user login (only valid if sUserLogin = 1)
REG_SZ	sUserDomain	No	Domain for single user login (only valid if sUserLogin = 1)
REG_DWORD	sUserLogin	Yes	All plugin auth'd users will be logged in using with a preconfigured set of credentials (if this is set to 1, you must also configure sUsername, sUserDomain, sPassword)
REG_SZ	sUsername	No	Username for single user login (only valid if sUserLogin = 1)

Silent Install

Coming soon.