Skip to main content

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.

📄️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.

📄️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.