AuditMaster Basics
An Overview of AuditMaster Basics
The following topics cover the basics of AuditMaster use.
•
Starting the AuditMaster Client
•
Logging in from an AuditMaster Client
•
Changing Your User Password
•
Running AuditMaster under PSQL Security
•
Restarting the AuditMaster Event Handler
•
Using Shortcut Menus
Starting the AuditMaster Client
AuditMaster Viewer is a client interface for querying, displaying, and reporting database transactions logged by the AuditMaster event handler.
►
To start AuditMaster Viewer
1
Open AuditMaster Viewer.
2
Log in to gain access to the application.
For more information, 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.
•
User
A regular user is able to query and view audit records and manage audit record archives.
•
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 PSQL Security.
►
To log in to the viewer
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.
2
In the login dialog, enter a valid user name and password, and click OK.
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.
►
To change your password
1
Log in to a server in the data tree.
2
Select Server > Change Password.
3
In the Change Password dialog, enter your current password in the field provided.
4
Enter the new password in both fields provided.
The password is case-sensitive, can be up to 10 characters long, and may use any numbers or letters.
5
Click OK.
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 relationship of AuditMaster logins to database and Windows logins, read Displaying Audit Records under PSQL Security.
Running AuditMaster under PSQL Security
AuditMaster is compatible with all PSQL database security settings. AuditMaster installation adds the AuditMaster internal database to the PSQL DefaultDB data directory list. After installation, the security settings in DefaultDB provide the same protection for the AuditMaster database.
The following table summarizes typical security settings. The first two rows give the settings, the next two rows describe logins and permissions, and the last row lists the protection provided.
 
Security
Classic
Mixed
Database
Database Security on DefaultDB
On
On
On
Btrieve Security on DefaultDB
Off
On
On
Authentication in AM Viewer
AuditMaster login
•
AuditMaster login
•
OS or network login
•
AuditMaster login
•
PSQL login
Database User Needed
None
•
PSQL user under DefaultDB. Must match OS or network login.
•
PSQL user must have at least Select permission to run existing queries
•
To create and save new AuditMaster queries, PSQL user must have Update and Insert rights.
•
PSQL user under DefaultDB
•
PSQL user must have at least Select permission to run existing queries
•
To create and save new AuditMaster queries, PSQL user must have Update and Insert rights.
What is protected?
AuditMaster access
•
AuditMaster access
•
Audit data and .ddf files
•
PCC SQL editor access
•
Btrieve file access
•
AuditMaster access
•
Audit data and .ddf files
•
PCC SQL editor access
•
Btrieve file access
Additional Notes
•
AuditMaster and PSQL logins are separate and unrelated authentications, even though in some cases AM Viewer presents a single dialog to enter both because both are needed at that time.
•
When you have Database security policy under DefaultDB and you want to use AuditMaster Viewer from a remote client, in PCC you must enable Prompt for Client Credentials under Properties > Access for the PSQL server engine. This setting provides a login dialog in AM Viewer for the remote user.
•
After installing AuditMaster, if you need to change PSQL security policy, first close all AuditMaster Viewer clients. Failing to do so results in status code 94 permission errors.
•
If you are not currently using Btrieve Mixed or Database security and you enable it only to increase AuditMaster security, keep in mind that DefaultDB is a global configuration and applies to all transactional Btrieve applications using PSQL. Enabling security for AuditMaster may require changes to how you manage access to PSQL or Btrieve data.
See also information under Displaying Audit Records under PSQL Security.
Restarting the AuditMaster Event Handler
Most changes to AuditMaster configuration prompt you to restart the PSQL services before they take effect. Viewer clients must not be running during this operation, or network and database access errors will occur after the restart.
►
To restart the event handler
1
Exit from all open instances of AuditMaster Viewer.
2
On the PSQL server, if PSQL Control Center (PCC) is not running, then start it.
3
In PSQL Explorer, right-click the Services node and select Restart All Services.
4
Once services have restarted, you may reopen AuditMaster Viewer and continue data monitoring.
Using Shortcut Menus
You can right-click an item in the viewer to open a menu. The menu varies depending on what you select. The following menu appears when you right-click a server in the data tree.