Type to search pages and rules.

Browse pages

Audit Obligations

This page states the external obligations that the audit extension satisfies.

Markdown

Intent#

This page states the external obligations that the audit extension satisfies. It is informative. The extension page owns every provision.

litespec/ext/audit#record-the-audit-adoption-decision requires an adoption decision. litespec/ext/audit#cover-the-required-audit-categories requires a stated selection of audited categories. Both ask a project to say why it audits what it audits. This page is the source those answers draw on, so a project records a decision rather than a survey.

Reference#

The frameworks#

Four bodies of guidance apply to a business application that holds personal data or touches payments. They agree far more than they differ. An implementation built to their union satisfies each one without a separate program.

NIST SP 800-53, AU family#

The AU controls split auditing into six questions. They are the most complete public statement of the problem.

ControlObligation
AU-2Select the audited event types and record the rationale for each.
AU-3State event type, time, location, source, outcome, and associated identities.
AU-6Review and analyze the records.
AU-9Protect the records from unauthorized change and deletion.
AU-11Retain records for a defined period.
AU-12Generate records across every component in scope.

AU-3 is the field list that the other frameworks restate. AU-2 is the control most projects skip, because an implicit selection needs no document.

ISO/IEC 27001:2022, Annex A 8.15#

Control A.8.15 requires logs of user activities, exceptions, faults, and security events. It requires protection from tampering and unauthorized access. It also requires analysis, which makes an unread trail a finding rather than a control.

PCI DSS 4.0, Requirement 10#

Requirement 10.2.2 names the fields for each event. They are user identification, event type, date and time, success or failure indication, origination, and affected resource identity.

Requirement 10.2.1 names the events. It includes individual access to cardholder data, actions by administrative accounts, access to the audit records, invalid logical access attempts, and changes to authentication credentials.

The success-or-failure field and the invalid-attempt event are the two obligations that a success-only trail fails.

OWASP Logging Cheat Sheet#

The OWASP guidance adds the developer-facing half. Record authentication successes and failures, authorization failures, higher-risk actions, sensitive data access, and data import or export.

It also states the exclusions. Never record passwords, session identifiers, access tokens, encryption keys, database connection strings, payment card data, or sensitive personal data.

GDPR#

The General Data Protection Regulation pulls in two directions at once. Reading it as only a constraint produces a thin trail. Reading it as only a mandate produces an erasure problem.

ArticleEffect on the trail
Article 5(2)Accountability requires demonstrating lawful processing, which the trail shows.
Article 30Records of processing activities need evidence of who accessed personal data.
Article 32Security of processing covers the integrity and availability of the trail.
Article 17Erasure applies to the personal data a record holds.
Article 15Subject access can reach audit records naming that person.

The resolution is the record shape. A trail retained on a legal-obligation or legitimate-interest basis stays lawful, and a supervisory authority accepts it. A trail that copies names, addresses, message bodies, or state snapshots into an append-only store conflicts with Article 17. No retention policy resolves that conflict.

litespec/ext/audit#exclude-personal-data-beyond-actor-identity and litespec/ext/audit#exclude-state-snapshots prevent that conflict at design time. litespec/ext/audit#remove-the-identity-mapping-on-erasure then satisfies an erasure request by removing the mapping from actor identifier to person. The record keeps its evidential value and the person stops being identifiable from it.

Two consequences follow for a project. Record the lawful basis and the retention period of each audited category in the adoption decision. Include the trail in the records of processing activities, because it is itself a processing activity.

Schema alignment#

The record shape follows a model that three sources describe in the same terms. An initiator performs an action on a target and produces an outcome at a time and from a place.

SourceContribution
DMTF CADF, DSP0262Initiator, action, target, outcome, and observer event model.
NIST AU-3The required content of one record.
OCSFVendor-neutral schema for shipping records to a security platform.

Building to that model costs nothing at design time. It lets a project map the trail onto a security platform later without remodeling the store.

Obligation to provision map#

ObligationSourceProvision
Select audited events and record the rationaleAU-2litespec/ext/audit#record-the-audit-adoption-decision, litespec/ext/audit#declare-audit-selection-on-every-command
Cover the required event categoriesAU-2, PCI 10.2.1, ISO 8.15litespec/ext/audit#cover-the-required-audit-categories
Generate records across every componentAU-12litespec/ext/audit#emit-audit-records-at-the-mediation-boundary
State the required record contentAU-3, PCI 10.2.2litespec/ext/audit#record-the-required-audit-fields
Identify the affected resourceAU-3, PCI 10.2.2litespec/ext/audit#record-the-required-audit-fields
Indicate success or failureAU-3, PCI 10.2.2litespec/ext/audit#record-every-attempt-outcome
Record invalid access attemptsPCI 10.2.1.4, OWASPlitespec/ext/audit#record-refused-authorization
Record the origination of the eventAU-3, PCI 10.2.2, ISO 8.15litespec/ext/audit#record-the-request-origin
Record credential and privilege changePCI 10.2.1.5, ISO 8.15litespec/ext/audit#cover-the-required-audit-categories
Record access to the audit recordsPCI 10.2.1.3litespec/ext/audit#audit-reads-of-the-trail
Record sensitive data access and exportOWASP, GDPR Art. 30litespec/ext/audit#record-personal-data-reads, litespec/ext/audit#record-bulk-export
Exclude secrets and payment dataOWASP, PCIlitespec/ext/audit#exclude-secrets-and-payment-data
Exclude sensitive personal dataOWASP, GDPR Art. 17litespec/ext/audit#exclude-personal-data-beyond-actor-identity
Protect records from change and deletionAU-9, ISO 8.15, GDPR Art. 32litespec/ext/audit#enforce-append-only-through-storage-privilege, litespec/ext/audit#provide-tamper-evidence
Retain for a defined periodAU-11litespec/ext/audit#retain-each-category-for-its-declared-period
Satisfy erasure without destroying evidenceGDPR Art. 17litespec/ext/audit#remove-the-identity-mapping-on-erasure
Review and analyze the recordsAU-6, ISO 8.15litespec/ext/audit#give-the-trail-a-read-path

Notes#

The sources behind every table above: