[adulau]

A physical or virtual network interface with its own identity, namespace and addressing, separate from the host and connections using it.

device can hold several addresses without binding them to individual interfaces; network-socket and network-connection represent traffic rather than interface inventory.

Existing templates considered: device, network-socket, network-connection.

Use related-to references to device and network-connection objects. Keep address/prefix pairs together rather than using independent multi-valued arrays.

OCSF mapping

• network_interface in OCSF 1.9.0 (versioned source)

MISP object relation	OCSF source path
interface-id	network_interface.uid
name	network_interface.name
type	network_interface.type
namespace	network_interface.namespace
ip-address	network_interface.ip
hostname	network_interface.hostname
mac-address	network_interface.mac
subnet-prefix	network_interface.subnet_prefix

Datetime relations use ISO 8601. Importers can prefer the OCSF _time_dt sibling, or convert the corresponding _time epoch milliseconds to a UTC datetime. Unreported booleans remain absent. Source codes, identifiers and strings keep their source meaning; this template is a CTI-oriented subset of the OCSF object.

All attributes default to to_ids: false. Descriptive metadata, local identifiers, counts, flags and timestamps disable correlation; typed network indicators, package URIs and hashes retain correlation where applicable. Nested entities use MISP object references. Source arrays are marked multiple only when their entries can be represented independently.

Example values

These are object-relation/value pairs for one object, with illustrative identifiers:

{
  "interface-id": "eni-123",
  "name": "eth0",
  "ip-address": "192.0.2.10",
  "subnet-prefix": 24
}

Validation

• ./jq_all_the_things.sh and ./validate_all.sh passed on the baseline plus all 29 proposed templates: 483 template definitions, relationship checks, 22 unit tests and unique UUID checks.
• This template passed JSON Schema validation, required-field reference checks and exact jq -S -j formatting checks against the same baseline.
• The example loaded and serialized with PyMISP 3.0.0 in strict mode.

This PR adds one version-2 template with a fresh UUID, based directly on main at a9c09f216032bc6093d09f68c743cda2dae29aac. It is part of a review of all 190 base OCSF 1.9.0 objects, compared with the 454 existing MISP templates. The review identified 29 new template proposals; existing-template extensions are recorded separately for future work. No live MISP server round-trip was performed.

Codex review updates

• Accept address-only or hostname-only interfaces allowed by the OCSF source constraint.
• Use counter for subnet-prefix so the MISP server accepts the valid value zero while preserving whole-number semantics.

Validation after the fixes: all 29 original examples and 20 regression examples passed with PyMISP 3.0.0 in strict mode; 69 regression checks passed against the unmodified MISP 2.5 PHP attribute validator, including zero/nonzero values, negative rejection and NetBIOS authorities. The complete repository validation suite was rerun on all 483 template definitions.

[chatgpt-codex-connector]

Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-11-09T16:36:07.571531Z	21fcee2	PR opened
🔒 Security Review	✅ Completed 2026-11-09T16:36:31.965501Z	21fcee2	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 21fcee2051

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".