agentrouter.admin.v1.GatewayAuthPolicyService
GatewayAuthPolicyService is the control-plane API for gateway authentication config: what authn runs on a project gateway and how a verified identity maps to an Agent Router principal. Agent Router reconciles these into Envoy Gateway SecurityPolicies.
Introduction
DeleteClaimProjectBinding
Delete a claim-to-project binding.
ListAppMappings
List the app mapping of an organization, ordered by issuer and app.
SetAppMapping
Map an app to the one project it reaches. The app is the value of the claim that names the app in tokens of issuer (azp on Entra v2.0 tokens and Keycloak, appid on Entra v1.0 tokens, client_id on PingFederate, cid on Okta). Each app of an issuer maps to exactly one project: a second call for the same issuer and app replaces the project and returns the one it replaced. In directory identity mode the data plane takes a token call's project from this mapping alone and refuses a call through an app with no mapping (decision record 104). A built-in install may hold mappings, for example while it prepares the move to directory mode, and its data planes do not read them. Each change writes an audit row with the old and the new project. An organization holds at most 100 mappings and 24 KiB of rendered rows, because every data plane that hosts a gateway of the organization receives the whole mapping in its configuration; a call past either limit fails with RESOURCE_EXHAUSTED, and a call that replaces an existing mapping works at the limit.
DeleteAppMapping
Delete the mapping of one app. In directory identity mode a token call through that app is refused from then on. The audit row records the project the app was mapped to.
ListIDPRegistrations
List the IdP registrations of an organization, ordered by issuer, audience and id.
CreateIDPRegistration
Create an install-level IdP registration of an organization (decision record 104): the issuer and the audience whose tokens identify the organization's people and applications in directory identity mode. An organization holds at most 16 registrations, and the 17th is refused with RESOURCE_EXHAUSTED.
GetIDPRegistration
Get one IdP registration of an organization.
DeleteIDPRegistration
Delete an IdP registration.
UpdateIDPRegistration
Edit an IdP registration.
GetPrivateAddressSettings
Read one organization's private-address settings: whether the management plane accepts a gateway auth policy's jwks_uri, and a project OIDC contract's issuer and discovered jwks_uri, on a non-public address for that organization. INHERIT means the organization follows the deployment's own setting.
SetPrivateAddressSettings
Change one organization's private-address settings. ALLOW lets the management plane accept a non-public address for that organization, DENY refuses one even while the deployment allows it, and INHERIT follows the deployment's own setting. A field left UNSPECIFIED keeps its stored value. The settings change what the management plane accepts only, so a data plane that fetches keys from a private address still needs its own environment variable. Refused with FAILED_PRECONDITION on SaaS.
ListGatewayAuthPolicies
List gateway auth policies for a (customer, project, gateway) scope.
CreateGatewayAuthPolicy
Create a gateway auth policy (one authentication mechanism on a gateway).
GetGatewayAuthPolicy
Get a gateway auth policy by id.
DeleteGatewayAuthPolicy
Delete (soft) a gateway auth policy.
UpdateGatewayAuthPolicy
Update a gateway auth policy's provider config + enabled flag.
ListClaimProjectBindings
List the claim-to-project bindings of a policy.
CreateClaimProjectBinding
Bind a claim value to a project under a policy. A token call that sends no x-tars-project acts in that project when the token the policy verified carries the value in the claim.
ListIdentityMappingRules
List identity mapping rules for a policy.
CreateIdentityMappingRule
Create an identity mapping rule under a policy.
DeleteIdentityMappingRule
Delete an identity mapping rule.