FetchByCustom
objectLooks up a principal by an arbitrary key/value pair.
Allowed values:custom
The custom key to match against.
>= 1 characters
The value of the identity to match against.
>= 1 characters
AuthResponse
objectResponse returned after a successful authentication operation.
Wraps the resolved principal with cache control metadata.
A principal resolved from the directory. Contains the principal’s identity and metadata.
Show Child Parameters
Time in seconds the data plane should cache this authentication result.
The unique identifier of the authenticated credential (API key or basic auth).
The Kong consumer associated with the resolved principal in the given control plane and workspace context.
Show Child Parameters
FetchPrincipalResponse
objectResponse returned after a successful fetch-principal operation.
Wraps the resolved principal with cache control metadata.
A principal resolved from the directory. Contains the principal’s identity and metadata.
Show Child Parameters
Time in seconds the data plane should cache this result.
The Kong consumer associated with the resolved principal in the given control plane and workspace context.
Show Child Parameters
ConsumerIdentity
objectThe Kong consumer associated with the resolved principal in the given control plane and workspace context.
The unique identifier of the Kong consumer.
The Kong control plane this consumer belongs to.
The workspace within the control plane, if applicable.
Principal
objectA principal resolved from the directory. Contains the principal’s identity and metadata.
Contains a unique identifier used for this resource.
Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7
Human-readable name of the principal.
A map of metadata key-value pairs associated with this entity. This metadata is passed to the data plane
to enrich the execution context. During authentication, metadata is inherited and overridden in a hierarchical
manner: Directory metadata is inherited by Principals, which is then inherited and overridden by Credentials.
An ISO-8601 timestamp representation of entity creation date.
Example:2022-11-04T20:10:06.927Z
An ISO-8601 timestamp representation of entity update date.
Example:2022-11-04T20:10:06.927Z