PassIT.

94 Installation Guide
(ITINITI, version 1.0)

PassIT component introduces a single place for a user/password administration in

eDeveloper 9.4 systems. It allows supervisor to create/edit users their passwords as
well as their rights and groups. On top of connecting existing eDeveloper functionality
component offers password configuration set up and Application Access Management
functionality. PassIT component uses normal usr_std.* file to store users,
passwords as well as their rights and groups.

0. MCI Configuration

To install the component edit attached PassIT94.mci file to tell the component your
environment set-up.
First you need to specify the path for mff file. To do this replace <ComponentsPath>
tag with a path to directory where the PassIT94.mff is stored.

MCI file section:

APPLFILE = "<ComponentsPath>PassIT94.mff"

Then you need to choose the database available for the component. The component
should work with any database system. It has been tested with Pervasive 9.0 and
MSSQL 2003.
There are two database definition examples included in the MCI file -
Pervasive/Btrieve and MSSQL.

Pervasive:
You need to specify only a path where table files will be stored. Replace <DataPath>
with a path to component's data directory on the disc.

MSSQL:
To enable MSSQL access specify Database name, Server and authentication
parameters. Replace <DBName> with the proper database name, <SQLServerName>
should be replaced with database server available for eDeveloper. Database
connection authentication parameters represented by <SQLUser> and
<SQLPassword> tags. Hint: Use eDeveloper's [Secret Names] to store user name and
password.

MCI file section:

Pervasive:
PassIT94DB=1, , , <DataPath>, , , , , NoMagicRecordLock,
ChangeFileInToolkit, CheckDefinition, CheckKey, FileLocks, , , ,
NoCheckExist, 0, , NoXATrans, NoAS400SrvrSort,""

MSSQL:
"PassIT94DB=21, <DBName>, , , <SQLServerName>, , <SQLUser>,
<SQLPassword>, NoMagicRecordLock, ChangeFileInToolkit,
CheckDefinition, NoCheckKey, NoFileLocks, , , , CheckExist, 0, ,
NoXATrans, NoAS400SrvrSort,"

Note: This entry creates new Logical Name in your application - application ini file
must be enable for writing. Remove the line you're not using.
1. Connecting Component to Your Application

After installing the component you need to register it in your application. Refer to
eDeveloper's “Reference Guide” for instructions.

There are four main tasks PassIT component is designed for - it can be used for users
and password management, password change management (triggered by user or
time driven), event logging and application access control.

Available Programs

AdminMenu - administration menu for the component. Here user can manage users
and their passwords and configure password creation rules. Connect this program
somewhere in the application - menu, keyboard shortcut, etc.
Note: AdminMenu program is accessible by Supervisor user.

Login - checks if the user's password expired and user account status. Connect this
program in Task Prefix of the Main Program.
Parameters:
i.AppName - main application name - used as information for event logging;
i.ExternalPasswordScreen? - switch for using external password dialogue (in main
application's layout). When this parameter is True component's change password
screen is not shown.
o.LoginOK? - returns True when the password change has been successful;
o.ChangePasswordNeeded? - in case of external password screen usage returns True
when the user need to change his password;
o.SessionID - temporary session id for calling UpdatePassword and
ChangePasswordScreen programs.

Logout - saves logout event in Event Log. Connect this program in Task Suffix of the
Main Program.
Parameters:
i.AppName - application name user as information for event logging.

ChangePasswordScreen(PassIT) - internal screen for password change. With this

program user can change password on demand. It can be connected in the menu on
keyboard shortcut or somewhere else n the application. Before calling this program
you need to get temporary session id from getSessionID.
Parameters:
i.SessionID - temporary session id;
o.PassChangeOK? - returns if the password change was successful.

getSessionID - get temporary session id.

Parameters:
o.SessionID - temporary session id for calling UpdatePassword and
ChangePasswordScreen(PassIT) programs.
updatePassword - batch program for updating user password. Checks the
correctness of entered password. This program is designed only for use from external
password screen. Before calling this program you need to get temporary session id
from getSessionID.
Parameters:
i.SessionID - temporary session id;
i.UserId - User id [User(0)];
i.UserPassOld - old user password;
i.UserPass - new user password;
i.UserPassReType - new user password re-type;
o.Updated? - returns True when the password was changed;
o.ErrorMessage - reason for unsuccessful password change.