FetchByCustom

object

Looks up a principal by an arbitrary key/value pair.

typestringrequired

Allowed values:custom

keystringrequired

The custom key to match against.

>= 1 characters

valuestringrequired

The value of the identity to match against.

>= 1 characters

Example

AuthResponse

object

Response returned after a successful authentication operation.
Wraps the resolved principal with cache control metadata.

principalobjectrequired

A principal resolved from the directory. Contains the principal’s identity and metadata.

Show Child Parameters
ttl_secsintegerrequired

Time in seconds the data plane should cache this authentication result.

credential_idstring(uuid)required

The unique identifier of the authenticated credential (API key or basic auth).

consumerobject

The Kong consumer associated with the resolved principal in the given control plane and workspace context.

Show Child Parameters
Example

FetchPrincipalResponse

object

Response returned after a successful fetch-principal operation.
Wraps the resolved principal with cache control metadata.

principalobjectrequired

A principal resolved from the directory. Contains the principal’s identity and metadata.

Show Child Parameters
ttl_secsintegerrequired

Time in seconds the data plane should cache this result.

consumerobject

The Kong consumer associated with the resolved principal in the given control plane and workspace context.

Show Child Parameters
Example

ConsumerIdentity

object

The Kong consumer associated with the resolved principal in the given control plane and workspace context.

idstringrequired

The unique identifier of the Kong consumer.

control_plane_idstringrequired

The Kong control plane this consumer belongs to.

workspace_idstring

The workspace within the control plane, if applicable.

Example

Principal

object

A principal resolved from the directory. Contains the principal’s identity and metadata.

idstring(uuid)requiredread-only

Contains a unique identifier used for this resource.

Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7

display_namestringrequired

Human-readable name of the principal.

metadataobjectrequired

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.

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

Example