Skip to main content
GET
List SPIFFE Mappings

Response

OK

trust_domain
string
required

SPIFFE trust domain. Must match the trust domain configured on the gateway for SPIFFE authentication to succeed.

Example:

"customer.com"

agent_id
string<uuid>

ID of the Hoop agent this mapping resolves to (exact form). Mutually exclusive with AgentTemplate.

agent_template
string

Go text/template that renders to a Hoop agent name. Used with SPIFFEPrefix. See the SPIFFE docs for template field details. Mutually exclusive with AgentID.

created_at
string
read-only

Creation timestamp

groups
string[]

The groups assigned to the agent when authenticating via this mapping.

Example:
id
string<uuid>
read-only

The unique identifier of this resource

org_id
string<uuid>
read-only

Organization ID

spiffe_id
string

Exact SPIFFE ID to match. Mutually exclusive with SPIFFEPrefix.

Example:

"spiffe://customer.com/agent/arqa-prod"

spiffe_prefix
string

SPIFFE ID prefix. Matches any SVID whose sub begins with this string; longest-prefix wins on lookup. Mutually exclusive with SPIFFEID.

Example:

"spiffe://customer.com/agent/"

updated_at
string
read-only

Last update timestamp