ReferenceGrant identifies kinds of resources in other namespaces that are trusted to reference the specified kinds of resources in the same namespace as the policy. Each ReferenceGrant can be used to represent a unique trust relationship. Additional Reference Grants can be used to add to the set of trusted sources of inbound references for the namespace they are defined within. All cross-namespace references in Gateway API (with the exception of cross-namespace Gateway-route attachment) require a ReferenceGrant. ReferenceGrant is a form of runtime verification allowing users to assert which cross-namespace object references are permitted. Implementations that support ReferenceGrant MUST NOT permit cross-namespace references which have no grant, and MUST respond to the removal of a grant by revoking the access that the grant allowed.
4 top-level fields, 1 required · last changed in Gateway API v1.6.0
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
Spec defines the desired state of ReferenceGrant.
From describes the trusted namespaces and kinds that can reference the resources described in "To". Each entry in this list MUST be considered to be an additional place that references can be valid from, or to put this another way, entries MUST be combined using OR. Support: Core
Group is the group of the referent. When empty, the Kubernetes core API group is inferred. Support: Core
Kind is the kind of the referent. Although implementations may support additional resources, the following types are part of the "Core" support level for this field. When used to permit a SecretObjectReference: * Gateway When used to permit a BackendObjectReference: * GRPCRoute * HTTPRoute * TCPRoute * TLSRoute * UDPRoute
Namespace is the namespace of the referent. Support: Core
To describes the resources that may be referenced by the resources described in "From". Each entry in this list MUST be considered to be an additional place that references can be valid to, or to put this another way, entries MUST be combined using OR. Support: Core
Group is the group of the referent. When empty, the Kubernetes core API group is inferred. Support: Core
Kind is the kind of the referent. Although implementations may support additional resources, the following types are part of the "Core" support level for this field: * Secret when used to permit a SecretObjectReference * Service when used to permit a BackendObjectReference
Name is the name of the referent. When unspecified, this policy refers to all resources of the specified Group and Kind in the local namespace.
Source: gateway.networking.k8s.io_referencegrants.yaml
Changes to ReferenceGrant (gateway.networking.k8s.io/v1beta1) in each Gateway API version, compared to the version before it.
1 property is now required
Released · View ReferenceGrant in v1.6.0
The description of ReferenceGrant has changed
7 properties have changed the description
Released · View ReferenceGrant in v1.2.0
The description of ReferenceGrant has changed
10 properties have changed the description
Released · View ReferenceGrant in v1.1.0
The description of ReferenceGrant has changed
Released · View ReferenceGrant in v0.8.0
ReferenceGrant was first seen on this version of Gateway API
Released · View ReferenceGrant in v0.6.0
No examples of ReferenceGrant yet. Contribute one on GitHub.
kubespec.dev