AuditMaster Basics

AuditMaster Basics
An Overview of AuditMaster Basics
This chapter explains the basics of AuditMaster use, covering the following topics:
n
n
n
n
n
n
Starting the AuditMaster Client
AuditMaster Viewer is a client interface for querying, displaying, and reporting database transactions logged by the AuditMaster event handler.
‰
Access AuditMaster Viewer from the operating system Start menu or Start screen.
Before you can use AuditMaster, you must log in. See Logging in from an AuditMaster Client.
Logging in from an AuditMaster Client
AuditMaster requires a user account with name and password. The type of account determines access to AuditMaster menu commands.
n
User
A regular user is able to query and view audit records and manage audit record archives.
n
Administrator
In addition to the above user privileges, an AuditMaster administrator can view the status log, set audit configurations, manage users, adjust system settings, and set the audit filter.
Note The built-in user ID admin has the default password MASTER. Passwords are case-sensitive; user names are not. To change this password, see Changing Your User Password. For information on the relation of AuditMaster logins to database and OS logins, read Displaying Audit Records under Pervasive PSQL Security.
‰
1
In the data tree, right-click a server name to select Login, or double-click the server icon. To log in to the currently selected server, simply press Enter.
The login dialog box appears.
2
You now have access to the server you selected.
Note For the AuditMaster server to recognize your login request, you need first to establish a regular network client login.
Changing Your User Password
AuditMaster server access is password-protected. While logged in to a server, you can change your password for that server only. On other AuditMaster servers, your password may differ.
‰
1
2
Select Server Change Password.
The Change Password dialog box appears.
3
4
The password is case-sensitive, can be up to 10 characters long, and may use any numbers or letters.
5
Your password is changed and must be used the next time you log in to AuditMaster.
Note The built-in user ID admin has the default password MASTER. Passwords are case-sensitive; user names are not. For information on the relation of AuditMaster logins to database and OS logins, read Displaying Audit Records under Pervasive PSQL Security.
Running AuditMaster under Pervasive PSQL Security
You can run AuditMaster under the Pervasive PSQL database security features. We recommend you first familiarize yourself with the security chapter in the Pervasive PSQL Advanced Operations Guide.
AuditMaster installation under Pervasive PSQL security varies. Under Classic security policy, it does not differ from a standard installation. Under Mixed or Database policy, however, login authorization rights and storing of security credentials vary.
After installation, AuditMaster may require security configuration. The following table summarizes default configurations under the three Pervasive PSQL security policy settings. N/A means “not applicable.”
 
C:\<installation directory>\Samples
C:\<installation directory>\Audit (default)
(Entered but not used)
C:\<installation directory>\Samples
C:\<installation directory>\Audit (default)
Data and .ddf files
C:\<installation directory>\Samples
C:\<installation directory>\Audit (default)
Data and .ddf files
Database user names and passwords must match OS or network logins exactly.
Database user names and passwords can differ from OS or network logins, if they exist.
When the Pervasive PSQL DefaultDB security is enabled and security policy is set to Mixed or Database, the database engine must be configured in Pervasive PSQL Control Center (PCC) for AuditMaster to run. To do so, select Prompt for Client Credentials in the Properties Access window for the Pervasive PSQL engine.
‰
1
Start Pervasive PSQL Control Center from the operating system Start menu or Start screen.
2
3
Right-click DefaultDB and select Properties.
The Properties window appears.
4
5
The window displays Security settings (e.g., Database).
6
The Directories window appears.
7
Under Directories, use the New button to add the audited file path names.
Include all directories where application data files reside. If needed, contact the application vendor for file locations.
8
When you’re done, select OK to close the window.
9
The New Group dialog box appears.
10
In the Group Name field, enter auditusers, and click Finish.
The group auditusers appears in the DefaultDB branch under the Groups node, next to the built-in PUBLIC group.
11
Right-click auditusers Properties.
The group properties window appears.
12
The group permissions for DefaultDB appear.
13
Select checkboxes for all database rights, including Create Table, and click Close. No specific tables need be added to the list.
14
The New User window appears.
15
Enter a user name and password for an AuditMaster user and select auditusers from the drop-down list. Note the following:
w
w
16
17
Return to step 14 for to add other AuditMaster users as needed.
Once AuditMaster users are added, those with administrative rights within the AuditMaster application may begin to create audit configurations as described in Chapter 6: Working with Audit Configurations.
See also information under Displaying Audit Records under Pervasive PSQL Security.
Caution After enabling and configuring AuditMaster under Pervasive PSQL, if you need to change database security policy, first close all AuditMaster Viewer clients. Neglecting to do so will produce permission errors in the form of status code 94.
Restarting the AuditMaster Event Handler
Most changes to AuditMaster configuration prompt you to restart the AuditMaster event handler before they take effect. Under Windows, viewer clients must not be running during this operation, or after the restart, network and database access errors will occur.
Depending on your platform, use one of the following methods:
n
‰
1
2
3
4
Using Shortcut Menus
Shortcut menus are an easy way to perform common tasks.
‰
1
The object is selected.
2
A shortcut menu appears with a list of commands. The commands vary depending on the context. The following shortcut menu appears when you right-click a server in the data tree.
Figure 4-1 Server Configuration Shortcut Menu
3
The window for that task appears.