AIP-23 proof kinds: secret-access carries requestHash (the presentation is signed for this exact request), claimedHolder/claimedPresenter, judged, and the allowed values of each field

This commit is contained in:
Aere Network committed 2026-10-19 00:06:23 +03:00
1 parent 6110ef2047
commit 316ba7171f
2 files changed
+45 -11

No files matched your search

+44 -10
View File
@@ -490,41 +490,75 @@
"type": "digest",
"note": "sha256 of the content, 0x + 64 hex"
},
{
"name": "requestHash",
"type": "hash",
"note": "already a 32-byte hash (0x + 64 hex); any other form is refused, not hashed"
},
{
"name": "service",
"type": "plain"
"type": "plain",
"values": "1 to 256 printable ASCII characters without spaces (the audience of the service)"
},
{
"name": "secret",
"type": "plain"
"type": "plain",
"values": "a secret name (^[a-z0-9][a-z0-9_-]{0,63}$), \"*\" for list, or null"
},
{
"name": "version",
"type": "plain"
"type": "plain",
"values": "an integer >= 1, or null"
},
{
"name": "operation",
"type": "plain"
"type": "plain",
"values": "put | get | metadata | rotate | revoke-version | grant | revoke | list"
},
{
"name": "verdict",
"type": "plain"
"type": "plain",
"values": "allowed | refused | failed (failed: allowed and entered, then the change could not be stored)"
},
{
"name": "rules",
"type": "plain"
"type": "plain",
"values": "a list of rule names (^[a-z][a-z0-9-]{0,63}$), at most 128"
},
{
"name": "grant",
"type": "plain"
"type": "plain",
"values": "a grant id (^[A-Za-z0-9][A-Za-z0-9_.:-]{0,63}$), or null"
},
{
"name": "holder",
"type": "plain"
"type": "plain",
"values": "an aere-id (aere-id: + 40 hex) verified from the presentation, or null"
},
{
"name": "presenter",
"type": "plain"
"type": "plain",
"values": "an aere-id verified from the presentation, or null"
},
{
"name": "claimedHolder",
"type": "plain",
"values": "an aere-id the presentation claims and nobody verified, or null"
},
{
"name": "claimedPresenter",
"type": "plain",
"values": "an aere-id the presentation claims and nobody verified, or null"
},
{
"name": "judged",
"type": "plain",
"values": "a list of { grant, rules }, at most 64"
},
{
"name": "createdAt",
"type": "plain",
"values": "an RFC 3339 time"
}
],
"required": [
@@ -534,7 +568,7 @@
"presentationHash",
"createdAt"
],
"attests": "a secrets service judged one request (put, get, rotate, revoke or grant) on a named secret and version: the verdict and the rules that decided it, the presented identity (presentation digest), the holder and presenter, the grant and the policy (digest); never the value",
"attests": "a secrets service judged one request (put, get, metadata, rotate, revoke-version, grant, revoke or list) on a named secret and version: the verdict and the rules that decided it, the presented identity (presentation digest) and the request it was signed for (request digest), the holder and presenter when verified (claimed ones are named as claimed), the grant and the policy (digest); never the value. Its values have a fixed vocabulary (KINDS.json, values)",
"added": "2026-10-18",
"vector": "secret-access.json"
},