FetchBy

The identity used to look up a principal. The type field determines the identity kind and the required fields.

One Of
typestringrequired

Allowed values:oidc

issuerstring(uri)required

The OIDC issuer URL that issued the claims.

>= 1 characters

claimobjectrequired
Show Child Parameters
Example

FetchByOIDC

object

Looks up a principal by matching an OIDC claim name and value.

typestringrequired

Allowed values:oidc

issuerstring(uri)required

The OIDC issuer URL that issued the claims.

>= 1 characters

claimobjectrequired
Show Child Parameters
Example

FetchByPrincipalID

object

Looks up a principal by its unique principal ID.

typestringrequired

Allowed values:principal_id

principal_idstring(uuid)required

The unique identifier of the principal to fetch.

Example

FetchByConsumer

object

Looks up a principal by a Kong consumer ID for the requesting control-plane.

typestringrequired

Allowed values:consumer

consumer_idstringrequired

The unique identifier of the Kong consumer.

>= 1 characters

workspace_idstring

The workspace ID within the control plane.

Example

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