As shown in Figure 126, external audit files consist of an audit file header and a sequence of audit records. Audit records can be either generated by the server (audit history records) or inserted by external entities (external audit records).
Figure 126
Structure of External Audit Record
The external audit record data (shaded) consists of an external audit record header generated by NetWare, followed by a sequence of bytes. The workstation provided data can be interpreted by the workstation in any way that is desired.
For example, a workstation product can treat this data as a workstation event header (for example, that lists the time the event occurred on the workstation and the workstation's audit record type) and additional data. See your vendor's workstation documentation for information on the workstation data in your external audit file.
WARNING: The external audit record header contains information written by the server at the time the audit event record is written to the audit file, for example, the date and time the event was recorded. Depending upon the workstation's audit architecture, this information might or might not be meaningful.
For example, the workstation might queue audit records for a period of time before uploading the records to the server to be written to the audit file. If the information in the external audit record header is not sufficient for an auditor to audit the actions of an individual user, then the workstation NTCB partition must record additional data in the workstation data.
The external audit file header is the same as the container audit file header defined in the section Container Audit File Header.
This section defines the binary format of each audit record in the external audit trail. Each audit record has a fixed header and, potentially, additional event-specific data.
Table 27 lists the subset of the event record types and formats described in Table 26 that are possible in an external audit trail. In addition, the table shows the events that can appear in an external audit trail that can not appear in container audit trails.
Table 27. Event Types in an External Audit Trail
Table 28. External Audit Event Types
The external audit record header (audit_external_rec_hdr) is a fixed structure that contains data for each audit event in the external audit file. Table 29 shows the contents of the external audit record header.
Table 29. External Audit Record Header
| Type | Element Name | Description |
|---|---|---|
uint16 |
replicaNumber |
Unused. |
uint16 |
eventTypeID |
Container audit event type from Table 27 |
uint16 |
recordNumber |
Sequence number. |
uint32 |
dosDateTime |
DOS-format date and time of audit event. |
uint32 |
userID |
NDS User object ID. |
uint32 |
processUniqueID |
Client process ID. This value can be used to trace client events (for example, file opens) to a specific process on that client. |
uint32 |
successFailureStatusCode |
Completion status: 0=successful, negative=failure. |