Audit Log: Integrity Proof
GET /audit-log/proof
Generates a ZIP package that proves the organization's audit log has not been altered or deleted, and that each entry already existed at the time of an external RFC 3161 timestamp. The package is verified outside EterShield.
Authentication: browser session only. Does not accept an API key. Allowed roles: ADMIN and AUDITOR.
Rate limit: 5 requests per minute per organization.
Query params (optional):
| Parameter | Type | Description |
|---|---|---|
fromSeq |
positive integer | Sequence number of the first entry (default 1) |
toSeq |
positive integer | Upper bound; the range ends at the last anchored entry that does not exceed it (default: the last anchored one) |
A package has at most 50,000 entries; above that, specify a shorter range.
Responses:
| Code | Meaning |
|---|---|
200 |
application/zip, with Content-Disposition: attachment; filename="etershield-prova-auditoria-<AAAA-MM-DD>-<fromSeq>-<toSeq>.zip" and Cache-Control: no-store |
400 |
Invalid fromSeq/toSeq (not positive integers, or fromSeq > toSeq) |
403 |
No session or role not allowed |
409 |
There is no timestamped anchor for the organization yet; there is no anchored entry in the requested range; or the range has more than 50,000 entries |
429 |
Limit of 5 requests/min exceeded |
ZIP contents:
| File | Content |
|---|---|
entries.jsonl |
One entry per line (seq, userId, action, entity, entityId, changes, createdAt, prevHash, selfHash, ...) |
anchors.json |
Anchors covering the range: root, digest, the organization's leaf and the Merkle path (hashes only; never data from other organizations) |
anchors/<id>.tsr |
RFC 3161 response for each anchor |
manifest.json |
Format etershield-audit-proof/1, organization, range, hash algorithms and SHA-256 of each file |
README.txt |
Verification instructions (PT/EN) |
Anchors are created hourly, so the range ends at the last entry that has already been anchored; the most recent entries are left for the next proof. Each generation is recorded in the audit log.
Verification: the public verifier is a single Node.js (18+) file with no dependencies, served without a session at <platform URL>/trust/verify-audit-proof.mjs:
node verify-audit-proof.mjs prova.zip [--ca cacert.pem] [--untrusted tsa.crt] [--json]
Exit code 0 = verified, 1 = there are problems, 2 = usage error. With --ca (requires openssl) it also validates the signatures of the timestamping authority.