	< Previous PageNext Page >

Login Reference Application

The Login application is a PAM-enabled (Pluggable Authentication Module) utility that enables a user to initiate provisioning and log in to a BlackDog device. You can customize the BlackDog login experience, causing the BlackDog to do such things as:

require all or a subset of authentication tokens at login.
present a customized login dialog.
offer additional login options to the user.

The login application uses Glade to launch an X application on the host PC. This application is stored in /usr/src/login-screen-1.0 of the SDK.

By default, only the fingerprint authentication portion of the login sequence is enabled for BlackDog; optionally, you can enable the username and password tokens using PAM configuration.

Changing the Authentication Sequence explains how to modify the authentication sequence, and the types of tokens and PAM modules required for successful login.

Screen Components

Note: By default, this part of the login set is not seen. You can enable it using the PAM utility.

The login screen has three panes (the tabs for the panes are hidden):

User name pane. The first pane prompts for the user name. The pane contains a user name prompt region, a message region, and a text box. The text box echoes characters entered in the user name dialog. During user entry, the text in the Username field is echoed to the user.
Password pane. The second pane contains a password prompt region, a message region, and a text box. User entry in the password field is obfuscated with asterisks (*).
Activity bar pane. The third pane contains an activity bar that displays while the user credentials are being validated.

There are three buttons on the screen:

OK requests validation of user credentials.
Cancel closes the login application and shuts down the BlackDog. The user must unplug the BlackDog from the host and reconnect it to attempt login again.
Help displays help text for the login utility.

Screen Layout

The Login window is divided into nine areas. The login dialog (shown below) uses the center area.

The Username and Password panes are essentially identical, with only the Prompt label and the message text being different. The messages can be customized.
The progress bar pane is different in that the prompt takes the place of the message and the progress bar takes the place of the text entry field.
Your logo can be placed in any area.

Login Application Syntax

Usage

/opt/realm/bin/login_screen [OPTION]

Options

`- d (--debug)`	Enable debugging options.
`-m (--max-retries) <number>`	Specifies the maximum number of login attempts allowed.
`-p (--provision)`	Use the PAM provisioning module.
`-u (--user) <login>`	Specify the user login as <login>.

Trainer Application Syntax

Usage

/usr/bin/trainer [OPTION]

Options

`-h (--help)`	Describe the options.
`-u (--user) <login>`	Specify the user being trained.

Deploying an Updated Login Application

For more information on how to deploy the application to a BlackDog device, see Deploying Applications Directly to BlackDog.



	< Previous PageNext Page >



		Copyright © Realm Systems, Inc. 2003-2005. All rights reserved.