Documentation
¶
Overview ¶
Package ocireference parses and binds the OCI references crossing the controller/data-plane trust boundary.
Index ¶
- func Authority(rawReference string) (string, error)
- func CanonicalAuthority(raw string) (string, error)
- func MatchAuthority(rawReference, rawGrant string) error
- func MatchRequested(requested, reported string) error
- func ValidatePinned(pinned, digest string) error
- func ValidateResolution(requested, pinned, digest string) error
- type Reference
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Authority ¶
Authority returns the canonical HTTP authority selected by the OCI client. ORAS maps a small number of logical registry names to a different request host, so authorization must use Reference.Host rather than the parsed Registry field. Beyond that client-defined mapping, comparison deliberately does not resolve DNS names, collapse explicit ports, or remove trailing dots.
func CanonicalAuthority ¶
CanonicalAuthority validates an authority-only host[:port] value and applies only the case folding permitted for a registry host. Transport schemes, credentials, paths, and encoded separators are rejected rather than normalized into a broader credential scope.
func MatchAuthority ¶
MatchAuthority requires a Secret-owned authority grant to name the exact registry selected by an OCI reference.
func MatchRequested ¶
MatchRequested verifies that a resolver report describes exactly the requested repository and effective selector. This deliberately treats an omitted selector and :latest as equivalent.
func ValidatePinned ¶
ValidatePinned verifies an already-bound immutable reference and digest.
func ValidateResolution ¶
ValidateResolution binds a pinned reference to the same repository as the request and to the exact reported SHA-256 digest.