device-identity: what a machine is, as a chain of signed statements checked offline (manufacturer credential, owners, firmware attestation, anchored on 28001; 175/175 with the AIP-23 verifier); conformance: the device-bundle vectors and the rules that cover them; control-plane console; README

This commit is contained in:
Aere Network committed 2026-10-11 20:31:49 +03:00
1 parent 5fb38c5d0b
commit 54028e07f4
215 files changed
+77436 -56

No files matched your search

+337
View File
@@ -1060,6 +1060,343 @@
}
],
"marked": "by a marker on every check"
},
"device": {
"artifacts": [
"device-bundle"
],
"rules": [
{
"id": "device.form",
"source": "form",
"level": "integrity",
"sites": 1,
"says": "the file is a device bundle"
},
{
"id": "device.manufacture-form",
"source": "manufacture-form",
"level": "integrity",
"sites": 1,
"says": "the manufacture credential is a DeviceManufacture credential with the device id, the device key, the model and the serial in the clear"
},
{
"id": "device.manufacturer-id",
"source": "manufacturer-id",
"level": "authenticity",
"sites": 1,
"says": "the manufacturer id is the id derived from the manufacturer keys in the credential"
},
{
"id": "device.manufacture-holder",
"source": "manufacture-holder",
"level": "authenticity",
"sites": 1,
"says": "the manufacture credential is held by the manufacturer itself: ownership leaves it only by a signed transfer"
},
{
"id": "device.manufacture-signature",
"source": "manufacture-signature",
"level": "authenticity",
"sites": 1,
"says": "the manufacture credential is signed by the manufacturer, Ed25519 and ML-DSA-65, both (each signature in canonical base64: the same bytes in another text are not that signature; the link is exactly its statement and its signature, and the signature object exactly its members: a member more is another text of the same signed statement, and is refused)"
},
{
"id": "device.manufacturer-trusted",
"source": "manufacturer-trusted",
"level": "authenticity",
"sites": 1,
"says": "the manufacturer is one of the manufacturers the verifier trusts"
},
{
"id": "device.manufacture-window",
"source": "manufacture-window",
"level": "integrity",
"sites": 1,
"says": "the manufacture credential is valid on the verifier's clock"
},
{
"id": "device.manufacture-status-list",
"source": "manufacture-status-list",
"level": "integrity",
"sites": 1,
"says": "a current status list of the manufacturer, handed to the verifier, can be read at the credential's index"
},
{
"id": "device.manufacture-revoked",
"source": "manufacture-revoked",
"level": "integrity",
"sites": 1,
"says": "no current status list of the manufacturer recalls the manufacture credential"
},
{
"id": "device.device-key",
"source": "device-key",
"level": "authenticity",
"sites": 1,
"says": "the device key the manufacturer names is a canonical ML-DSA-65 public key"
},
{
"id": "device.device-id",
"source": "device-id",
"level": "authenticity",
"sites": 1,
"says": "the device id is the id derived from the device key"
},
{
"id": "device.firmware-form",
"source": "firmware-form",
"level": "integrity",
"sites": 1,
"says": "the firmware release has a model, a version, a sequence number and the digest of the image"
},
{
"id": "device.firmware-signer",
"source": "firmware-signer",
"level": "authenticity",
"sites": 1,
"says": "the release is signed by the manufacturer of the device, whose id is the id of its keys"
},
{
"id": "device.firmware-signature",
"source": "firmware-signature",
"level": "authenticity",
"sites": 1,
"says": "the release is signed by who released it, Ed25519 and ML-DSA-65, both (each signature in canonical base64: the same bytes in another text are not that signature; the link is exactly its statement and its signature, and the signature object exactly its members: a member more is another text of the same signed statement, and is refused)"
},
{
"id": "device.firmware-model",
"source": "firmware-model",
"level": "integrity",
"sites": 1,
"says": "the release is for the model of the device"
},
{
"id": "device.firmware-retracted",
"source": "firmware-retracted",
"level": "integrity",
"sites": 1,
"says": "no current firmware policy of the manufacturer retracts the release"
},
{
"id": "device.firmware-rollback",
"source": "firmware-rollback",
"level": "integrity",
"sites": 1,
"says": "the sequence number of the release is at or above the highest floor of the manufacturer's current firmware policies"
},
{
"id": "device.firmware-software",
"source": "firmware-software",
"level": "integrity",
"sites": 1,
"says": "the attestation handed is a Proof of Software attestation that hashes to its statementHash, is the one the release names, and lists the image digest"
},
{
"id": "device.chain-length",
"source": "chain-length",
"level": "integrity",
"sites": 1,
"says": "the ownership chain has at most sixty-four transfers"
},
{
"id": "device.transfer-form",
"source": "transfer-form",
"level": "integrity",
"sites": 1,
"says": "every link of the ownership chain is a transfer"
},
{
"id": "device.transfer-device",
"source": "transfer-device",
"level": "integrity",
"sites": 1,
"says": "every transfer is a transfer of this device"
},
{
"id": "device.transfer-ids",
"source": "transfer-ids",
"level": "authenticity",
"sites": 1,
"says": "in every transfer, the giver and the recipient carry the ids derived from their keys"
},
{
"id": "device.transfer-from",
"source": "transfer-from",
"level": "authenticity",
"sites": 1,
"says": "the first transfer is given by the manufacturer, every other by the recipient of the transfer before"
},
{
"id": "device.transfer-prev",
"source": "transfer-prev",
"level": "integrity",
"sites": 1,
"says": "every transfer carries its position and the hash of the link before it"
},
{
"id": "device.transfer-signature",
"source": "transfer-signature",
"level": "authenticity",
"sites": 1,
"says": "every transfer is signed by who gave it, Ed25519 and ML-DSA-65, both (each signature in canonical base64: the same bytes in another text are not that signature; the link is exactly its statement and its signature, and the signature object exactly its members: a member more is another text of the same signed statement, and is refused)"
},
{
"id": "device.transfer-time",
"source": "transfer-time",
"level": "integrity",
"sites": 1,
"says": "transfer times do not go backwards and none is in the verifier's future"
},
{
"id": "device.authorization-form",
"source": "authorization-form",
"level": "integrity",
"sites": 1,
"says": "the authorization names a device, an ownership head and a sorted list of action names"
},
{
"id": "device.authorization-device",
"source": "authorization-device",
"level": "integrity",
"sites": 1,
"says": "the authorization is for this device"
},
{
"id": "device.authorization-owner",
"source": "authorization-owner",
"level": "authenticity",
"sites": 1,
"says": "the authorization is granted by the current owner, whose id is the id of its keys"
},
{
"id": "device.authorization-ownership",
"source": "authorization-ownership",
"level": "integrity",
"sites": 1,
"says": "the authorization is given under the current ownership head"
},
{
"id": "device.authorization-signature",
"source": "authorization-signature",
"level": "authenticity",
"sites": 1,
"says": "the authorization is signed by who granted it, Ed25519 and ML-DSA-65, both (each signature in canonical base64: the same bytes in another text are not that signature; the link is exactly its statement and its signature, and the signature object exactly its members: a member more is another text of the same signed statement, and is refused)"
},
{
"id": "device.authorization-window",
"source": "authorization-window",
"level": "integrity",
"sites": 1,
"says": "the authorization is valid on the verifier's clock and when the device attested"
},
{
"id": "device.authorization-action",
"source": "authorization-action",
"level": "integrity",
"sites": 1,
"says": "the action the device asks for is one the owner granted"
},
{
"id": "device.status-retired",
"source": "status-retired",
"level": "integrity",
"sites": 1,
"says": "no status record read retires the device: of the manufacturer (never lifted), or of the current owner of the chain shown under any ownership head or none (it holds while the chain shown says that owner owns the device)"
},
{
"id": "device.status-suspended",
"source": "status-suspended",
"level": "integrity",
"sites": 1,
"says": "the record with the highest number read of the manufacturer, and of the current owner of the chain shown under any ownership head or none, does not suspend the device (of two with one number the stricter holds)"
},
{
"id": "device.attestation-form",
"source": "attestation-form",
"level": "integrity",
"sites": 1,
"says": "the attestation carries a nonce, an audience, a time, the firmware it runs, an ownership head and an action"
},
{
"id": "device.attestation-key",
"source": "attestation-key",
"level": "authenticity",
"sites": 1,
"says": "the key in the attestation is a canonical ML-DSA-65 public key and the device id is derived from it"
},
{
"id": "device.attestation-device",
"source": "attestation-device",
"level": "authenticity",
"sites": 1,
"says": "the attestation is by the device, and with the key, that the manufacturer certified"
},
{
"id": "device.attestation-signature",
"source": "attestation-signature",
"level": "authenticity",
"sites": 1,
"says": "the attestation is signed with the device key (ML-DSA-65), the signature in canonical base64; the link is exactly its statement and its signature, and the signature object exactly its members: a member more is another text of the same signed statement, and is refused"
},
{
"id": "device.audience",
"source": "audience",
"level": "integrity",
"sites": 1,
"says": "the attestation was made for this verifier"
},
{
"id": "device.nonce",
"source": "nonce",
"level": "integrity",
"sites": 1,
"says": "the attestation carries the nonce this verifier gave"
},
{
"id": "device.freshness",
"source": "freshness",
"level": "integrity",
"sites": 1,
"says": "the attestation is dated no further ahead of the verifier's clock than its tolerance, and no longer before it than the allowed age"
},
{
"id": "device.attestation-firmware",
"source": "attestation-firmware",
"level": "integrity",
"sites": 1,
"says": "the firmware the device says it runs is the release shown (digest and sequence)"
},
{
"id": "device.attestation-ownership",
"source": "attestation-ownership",
"level": "integrity",
"sites": 1,
"says": "the attestation names the current ownership head"
},
{
"id": "device.witness-envelope",
"source": "witness-envelope",
"level": "integrity",
"sites": 1,
"says": "the AIP-23 envelope given is the envelope of a device attestation, hashes to its statementHash and commits to this device and this attestation"
},
{
"id": "device.witness-time",
"source": "witness-time",
"level": "integrity",
"sites": 1,
"says": "the attestation is not dated after the moment the verifier read its envelope on the chain (of several readings, the earliest)"
},
{
"id": "device.unreadable",
"source": "unreadable",
"level": "integrity",
"sites": 1,
"says": "every field a check reads can be read (a time is an RFC 3339 UTC time, a hash input is JSON)"
}
],
"marked": "by a marker on every check"
}
},
"notEnrolled": [