Define Entry Trust Manifest publisher-domain alignment - #107
Draft
jonathanhefner wants to merge 1 commit into
Draft
Define Entry Trust Manifest publisher-domain alignment#107jonathanhefner wants to merge 1 commit into
jonathanhefner wants to merge 1 commit into
Conversation
Make the existing publisher-domain requirement interoperable by limiting Entry Trust Manifests to publisher-authorized `urn:air` entries and defining how `did:web`, HTTPS, and IDNA-shaped SPIFFE identities supply the comparison domain. Delegate identity syntax to the governing standards, compare complete IDNA2008 domains exactly after ASCII case normalization, and keep ports, paths, queries, and fragments in the identity but outside publisher-domain comparison. Keep publisher authorization as a producer requirement while defining the consumer response when usable alignment cannot be established. Record that alignment checks consistency only and that a Trust Manifest signature covers its `identity` but not the containing Catalog Entry identifier by itself. Update stale identity examples, the authoring guide, and ADR-0024 to reflect the boundary. Signed-off-by: Jonathan Hefner <jonathan@hefner.pro>
Contributor
Author
jonathanhefner
marked this pull request as draft
September 6, 2026 01:40
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The specification requires a Trust Manifest’s identity domain to align with the publisher domain in the containing Catalog Entry’s identifier. That requirement cannot currently be applied consistently because Catalog Entry identifiers are extensible, not every identifier communicates a publisher domain, and the alignment procedure is undefined.
This PR defines a clear boundary for core Entry Trust Manifests: they are supported on Catalog Entries with publisher-authorized
urn:airidentifiers. Entries with other identifiers remain valid Catalog Entries, but cannot include a core Entry Trust Manifest.For supported entries, the specification defines interoperable publisher-domain alignment for
did:web, HTTPS, and SPIFFE identities. When alignment cannot be established, consumers disregard the Trust Manifest’s claims and apply their normal policy for an entry without a usable Trust Manifest.ADR-0024 records this decision and its rationale. The accompanying documentation and examples are updated accordingly.
Rationale
This keeps two distinct use cases separate:
urn:airidentifiers when they cannot truthfully assign a publisher-controlled identifier.The specification can add support for other identifier or identity forms later if it defines an equally unambiguous publisher-domain relationship for them.
Publisher-domain alignment is only a consistency check. It does not establish domain control, publisher or signer authorization, signature validity, artifact integrity, authenticity, or trust. Those properties continue to require their corresponding verification procedures and an independent trust policy.
Related work
This PR addresses the publisher-domain alignment concern in #70.
It complements #105, which permits registries to use non-
urn:airidentifiers while intentionally leaving Trust Manifest behavior out of scope.It proposes a narrower alternative to the identity-related change in #81. That PR’s digest concern is independent.
#104 is currently a merge prerequisite because it removes examples that would otherwise contradict this rule.
AI usage disclosure: This PR was developed with AI assistance under my direct supervision and review.