MIT Network Audit docs
Questions and terms

Terms explained

4 min read Odoo 18.0

Short definitions of the terms that you meet in MIT Network Audit, in alphabetical order.

Addon (module)

The Odoo module that the audit names as the origin of a call. The module reads the call stack and takes the first Odoo module that is not base, web or MIT Network Audit itself. Calls from other standard Odoo apps, such as Discuss (mail), are shown under that app. It is shown in the Addon column. If it finds none, the column is blank. See Understand a recorded event.

Append-only log

The log (network.egress_log) that does not allow edits or deletes in normal use. In Odoo, the model refuses write and unlink, except for the retention job. A database trigger also blocks changes to sealed rows and gates deletes. A person who controls the database session can lift the delete gate. See Inspect recorded network activity.

Attribution

Finding the module that made a call, by reading the call stack. It is a best guess from the stack. It does not prove who intended the call. See Advanced: how capture works.

Chain seq

The position of a row in the hash chain. It is a unique number that only goes up. See Understand a recorded event.

Channel

The way a call was captured: requests, urllib, httpx, smtp, imap, pop3, ssl, socket, or http_inbound for inbound requests. You can switch channels off in Disabled channels. See Change audit settings.

Egress

Traffic that leaves your Odoo. The module also records inbound requests.

Egress component

An entry in the list under Network Audit ▸ Configuration ▸ Egress Components. It decides whether a destination counts as MIT-bound. See Change audit settings.

Fingerprint

A salted HMAC hash of method|host|path of a request. Identical requests give the same fingerprint, so you can group them. It is not a hash of the content, and strict redaction removes it.

Forensic body capture

An optional feature that stores request and response bodies for modules on an allowlist. It is off by default, and only users in the Network Forensic Officer group can use it. Changes to its settings and each reading of a body are logged. See Change audit settings.

Hash chain

A way to link rows: each row's hash includes the hash of the row before it. If a row in the middle is changed or removed, later hashes no longer match. See Verify the log and export evidence.

Masked header

A header whose value is replaced by [REDACTED]. The module masks the value of sensitive headers, such as Authorization and Cookie, and headers with names that contain token, secret, password, api-key or auth. The header name is kept. Other header values are stored.

MIT-bound

A destination that matches an entry with MIT-bound switched on in the Egress Components list. All other destinations are third-party.

Network Audit group

The Odoo group that can read the Trust Report, the Audit Log and the other audit views, and download exports. Odoo administrators are in it automatically. See Security and capture limits.

Network Forensic Officer

The Odoo group that can configure forensic body capture and read captured bodies. Administrators are not in it automatically.

Retention job

The daily job that deletes rows older than Audit retention (days). It never deletes at or after the latest signed head.

Rollup (summary table)

The table network.egress.rollup. It holds daily totals that the Trust Report and Traffic Summary read. The daily job and the Refresh button rebuild it for the last few days.

Row hash and prev hash

The Row Hash is a SHA-256 hash over a row's fixed fields and the previous row's hash. The Prev Hash is the previous row's hash. Both are on the event form.

Self-egress

An outbound row attributed to MIT Network Audit itself. The module is designed to make none. The Trust Report shows the count and turns to alarm if it is above 0. See What the report verdict means.

Signed head

A daily HMAC signature of the newest row's position and hash, stored as chain_seq:row_hash:signature in the system parameter mit_network_audit.signed_head. The key is stored in the same database. It lets the standalone verifier detect that the newest rows were cut off. See Verify the log and export evidence.

Strict redaction

A setting that removes the URL path, the query parameter names and the fingerprint from new rows. See Change audit settings.

Third-party

A destination that does not match an entry with MIT-bound switched on. Your own mail, AI and cloud providers are third-party. So is a MIT host that is missing from the list.

Verdict

The state shown on the Trust Report: all-clear, attention or alarm. It comes from a fixed rule on counts and sizes. See What the report verdict means.