Public Ingress
PublicIngress
Defines a public entry point to platform services.
Creates external load balancing, SSL/TLS certificates, and DNS zones. It aggregates Identity-Aware Proxy (IAP) integration and authorization enforcement.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be PublicIngress. |
| metadata | map | Free-form key/value labels. The engine reads reserved keys (for example name, project) to resolve the identity of this manifest and its parent Project. |
| spec | Spec | Desired public ingress configuration. See Spec. |
Authorization
Authorization enforcement details.
Set only if spec.authorization_database has a value.
| Property | Type | Description |
|---|---|---|
| backendService | string | Self-link of the backend service of the authorization extension, named <metadata.name>-authz-ext. |
| accessRules | ComputedAuthorizationAccess | Authorization rules of all child HttpRoute and GrpcRoute manifests, aggregated. See ComputedAuthorizationAccess. |
IdentityProviderUiConfigsEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | TenantUiConfig |
LoadBalancerEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | ComputedLoadBalancerHost |
TenantUiConfig
Per-tenant login UI configuration.
Login page settings of one tenant, keyed by IdentityProvider manifest name.
| Property | Type | Description |
|---|---|---|
| signInFlow | string | Sign-in flow type, for example "redirect" or "popup". |
| displayName | string | Display name on the login page. |
| iconUrl | string | Tenant icon URL. |
| logoUrl | string | Tenant logo URL. |
| buttonColor | string | Hex color of the sign-in button. |
| tosUrl | string | Terms of service URL. |
| privacyPolicyUrl | string | Privacy policy URL. |
| signInOptions | list of SignInOption | Enabled sign-in providers. |
| styleUrl | string | Custom CSS stylesheet URL for this tenant. |
| heroImageUrl | string | Hero image URL. |
| heroBackground | string | CSS background of the hero panel. |
| immediateFederatedRedirect | bool | If true and exactly one federated provider exists, skip the sign-in UI and redirect at once. |
| redirectOnLogin | string | Redirect URL after sign-in. |
| redirectOnLogout | string | Redirect URL after sign-out. |
| gdprCompliance | bool | If true, the login app shows GDPR-compliant UI: a TOS acceptance checkbox before sign-in and a "Delete my account" button on the profile page. |
SignInOption
A single sign-in provider option.
One provider that the login page offers for this tenant.
| Property | Type | Description |
|---|---|---|
| provider | string | Provider identifier, for example password, google.com, anonymous. |
| useRecaptcha | bool | If true, the provider uses invisible reCAPTCHA. |
Spec
User-defined configuration for the public ingress.
Covers the domain, access control, authorization database, and login-app UI. Child route manifests (Http, Grpc, Tls, StaticAsset) attach to it.
| Property | Type | Description |
|---|---|---|
| description | string | Optional free text. AI assistants use it as context. The engine does not use it otherwise. |
| region | string | Preferred GCP region. If empty, it inherits the region of the parent Project. The resolved value is in computed.region. |
| domain | DomainConfig | Custom domain configuration. See DomainConfig. If unset, the ingress uses the default domain from the parent Project. |
| identityProviderApplication | IdentityProviderConfig | Source application of the identity-provider login UI. The engine validates it against the build definitions of the project and resolves it into computed.idp_login_application. If omitted, default configuration applies. See IdentityProviderConfig. |
| iapPermissions | DetailedAccessPermissions | Users and groups that can reach applications behind this ingress when IAP is on. They resolve into computed.iap_permissions and become IAP IAM bindings. See DetailedAccessPermissions. |
| authorizationDatabase | string | Name of a Database manifest in the same project that stores fine-grained authorization policies. It must exist. If set, the engine provisions two more Cloud Run services. -authz-ext is a read-only gRPC authorizer. -authz-svc is an Ory Keto read-write service for policies, with a one-time schema migration. |
| config | Config | NOT YET IMPLEMENTED. The engine ignores this block. See Config. |
| loginApp | LoginAppConfig | Login app UI settings. See LoginAppConfig. |
| securityPolicy | SecurityPolicy | Optional Cloud Armor policy for this ingress. If absent, the engine creates no policy and changes no backend service. See SecurityPolicy. The policy covers the IAP, GCIP, unauthenticated, session-refresh, and login-app backend services. It does NOT cover backend buckets (static sites, default static pages, login-app assets), which accept only CLOUD_ARMOR_EDGE policies. The unauthenticated backend uses Cloud CDN, and the policy runs only on cache misses. So content cached after an allowed request also reaches requests that the policy would deny. |
| allowDirectRoutes | bool | NOT RECOMMENDED. If true, a child HttpRoute can set ingress_path to DIRECT, which skips the mesh gateway. The default is false. A DIRECT route has no sign-in and no authorization from the engine. The service must check every request itself. The route also needs a security_policy that does not allow all traffic. |
Config
Advanced backend-service tuning.
NOT YET IMPLEMENTED. The engine ignores this block.
| Property | Type | Description |
|---|---|---|
| timeoutSec | int64 | Backend response timeout in seconds. |
| connectionDrainingTimeoutSec | int64 | Connection-draining timeout in seconds. |
| customRequestHeaders | list of string | Custom headers to add to requests to backends. |
| customResponseHeaders | list of string | Custom headers to add to responses to clients. |
| loadBalancing | LoadBalancing | NOT YET IMPLEMENTED. The engine ignores this field. See LoadBalancing. |
LoadBalancing
Load-balancing policy of the backend services.
NOT YET IMPLEMENTED. The engine ignores this block.
| Property | Type | Description |
|---|---|---|
| balancingMode | string | Load-balancing algorithm: UTILIZATION, RATE, or CONNECTION. |
| capacityScaler | double | Scales the advertised backend-service capacity, from 0.0 to 1.0. |
| description | string | Optional free text. The engine does not read it. |
| maxConnections | int64 | Maximum concurrent connections per instance. |
| maxRate | int64 | Maximum requests per second per instance. |
| maxUtilization | double | Target CPU utilization (0.0-1.0) for the UTILIZATION mode. |
DomainConfig
Custom, user-owned domain and DNS records.
If set, name is the base of computed.domain, and the platform provisions a DNS zone with the required records (see dns). The operator MUST delegate the domain: point its NS records at the name servers of the created zone.
| Property | Type | Description |
|---|---|---|
| name | string | Base domain for hostnames of child HTTP/gRPC routes and for computed.domain. Must be a hostname. The engine ignores empty values. |
| txtRecords | list of string | Extra TXT records for the zone apex. Engine runs do not erase them. Each entry must be a valid TXT value, for example google-site-verification=xxxxx. |
| apex | string | How the engine serves the bare zone apex (name itself). Routes are always at <route-name>.<name>. By default (empty) the engine leaves the apex untouched. There is no apex A record, and a TLS handshake for the bare apex fails, because the certificate map answers only for *.<name>. |
| dns | string | Who hosts the DNS for name. MANAGED (the default when empty): the engine creates a Cloud DNS zone for name with all records. These are the certificate-validation CNAME, the wildcard and apex A records, and the Firebase TXT/DKIM records. |
LoginAppConfig
Login app UI configuration.
Applies when Google Cloud Identity Platform (GCIP) is on.
| Property | Type | Description |
|---|---|---|
| displayMode | string | Sign-in display mode: optionFirst (all providers at once) or identifierFirst (email first). |
| selectTenantUiTitle | string | Title of the tenant selector screen. Required when GCIP is on with more than one identity provider. |
| selectTenantUiLogo | string | Logo URL of the tenant selector screen. |
| redirectOnLogin | string | Default redirect URL after sign-in. A per-tenant value overrides it. |
| redirectOnLogout | string | Default redirect URL after sign-out. A per-tenant value overrides it. |
| supportedLocales | list of string | Locale codes that the login app offers, for example ["en", "fr"]. More than one needs locale_cookie.name. |
| localeCookie | LocaleCookie | You must set it when supported_locales has more than one entry. See LocaleCookie. |
| styleUrl | string | Global custom CSS stylesheet URL. A per-tenant URL overrides it. Must be an HTTPS URL or a relative path. |
| tosUrl | string | Default Terms of Service URL. A per-tenant value overrides it. |
| privacyPolicyUrl | string | Default Privacy Policy URL. A per-tenant value overrides it. |
| redirectUris | list of string | NOT YET IMPLEMENTED. The engine ignores this field. It will allowlist OAuth redirect URI patterns. |
LocaleCookie
Locale cookie.
Names and scopes the cookie that stores the locale choice across sessions and subdomains.
| Property | Type | Description |
|---|---|---|
| name | string | Cookie name, for example locale. You must set it when supported_locales has more than one entry. |
| domain | string | Cookie domain, so that all subdomains share the cookie, for example .example.com. |
SecurityPolicy
Google Cloud Armor policy for the load balancer.
The engine creates one CLOUD_ARMOR policy in the project of the ingress and attaches it to every external backend service. Cloud Armor evaluates it BEFORE IAP, so it can only narrow access: a denied request never reaches IAP, and allow never bypasses IAP or GCIP.
| Property | Type | Description |
|---|---|---|
| rules | list of Rule | Custom rules, in any order: priority sets the order. At most 20 rules in total, with the rules from denied_region_codes (one per five regions). Cloud Armor allows 20 expression rules per project by default. The engine checks this per ingress only, so ingresses in one project can still exceed the quota at apply time. |
| deniedRegionCodes | list of string | Regions whose requests the policy refuses with 403: ISO 3166-1 alpha-2 upper-case codes, for example CU, KP (XK for Kosovo is also valid). The engine adds deny rules, five regions per rule, at priorities 1000 and up in alphabetical order. Each code can appear once. |
| defaultAction | string | Action for requests that match no rule: allow (the default when empty), deny(403), deny(404), or deny(502). A deny default makes the policy an allowlist. Health checks bypass Cloud Armor, so the backends stay healthy. |
Rule
A single ordered rule of the policy.
Matches requests with a Common Expression Language (CEL) expression and applies action. The lowest priority number goes first, and the first match wins.
| Property | Type | Description |
|---|---|---|
| priority | int32 | Evaluation order: lower numbers go first. Must be unique within the policy, from 0 to 2147483646 (2147483647 is the default rule). Must not be in the range of denied_region_codes (1000 upwards, one priority per five regions). |
| description | string | Optional free text. The Cloud Console shows it. |
| expression | string | Required CEL expression that a request must satisfy. To match source IP ranges, use inIpRange(origin.ip, '<cidr>'). Maximum 2048 characters and five subexpressions joined by ` |
DetailedAccessPermissions
User and group access definitions.
The engine resolves the listed manifests to Google Workspace identity emails for IAM bindings.
| Property | Type | Description |
|---|---|---|
| members | list of string | Names of OrganizationUser manifests. |
| groups | list of string | Names of OrganizationUserGroup manifests. |
IdentityProviderConfig
Container configuration of an identity provider for a tenant.
It points to a source image and configuration layout for an Identity Provider solution, for example Keycloak.
| Property | Type | Description |
|---|---|---|
| source | string | Name of the BuildDefinition manifest that supplies the container image. Required. The build must exist. |
| container | string | Name of the container in the source BuildDefinition. Required. It must match one of the containers of that build. |
| version | string | Tag of the container image to deploy. Required. |
| spec | ContainerSpec | Optional container overrides (command, args, env, resources). See ContainerSpec. |
ComputedAuthorizationAccess
Map of hostnames to authorization rules.
The authorization extensions use it as an in-memory index.
| Property | Type | Description |
|---|---|---|
| rules | list of RulesEntry | Map of hostname to the rules of that host, from all child HttpRoute and GrpcRoute manifests. |
ComputedLoadBalancerHost
Compiled paths of a load balancer host.
Becomes the host rules in the URL map.
| Property | Type | Description |
|---|---|---|
| iapPaths | list of ComputedLoadBalancerPath | Paths protected by IAP (Identity-Aware Proxy) authentication. |
| gcipPaths | list of ComputedLoadBalancerPath | Paths protected by GCIP (Identity Platform) authentication. |
| unauthPaths | list of ComputedLoadBalancerPath | Paths served without authentication. |
| bucketPaths | list of ComputedLoadBalancerPath | Paths served from a static GCS bucket backend. |
ContainerSpec
Core configuration block for a runtime container.
It overrides the entrypoint, variables and compute constraints of the base image.
| Property | Type | Description |
|---|---|---|
| enabled | bool | NOT YET IMPLEMENTED. The engine ignores this field. Intended use: turn the container off but keep its definition. |
| command | list of string | Container entrypoint. Overrides the image entrypoint (the container command). |
| args | list of string | Arguments for the entrypoint (the container args). |
| env | list of EnvVariableDefinition | Static environment variables. The engine merges them with variables from secrets and access control. |
| uid | string | NOT YET IMPLEMENTED. The engine ignores this field. Intended use: the user ID of the container process. |
| gid | string | NOT YET IMPLEMENTED. The engine ignores this field. Intended use: the group ID of the container process. |
| resources | ContainerResources | CPU and memory requests and limits. See ContainerResources. |
RulesEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | ComputedAuthorizationAccessRules |
ComputedLoadBalancerPath
Compiled routing path of a load balancer.
Becomes one path matcher in the URL map.
| Property | Type | Description |
|---|---|---|
| matchers | list of HttpRouteRuleMatch | Compiled match conditions. |
| tenant | string | Tenant of this path. Set only for IDENTITY_PROVIDER authentication. Only used for IDENTITY_PROVIDER |
| hostRewrite | string | Host header rewrite for the backend request. |
| pathRewrite | string | Path rewrite for the backend request. |
| bucket | string | GCS bucket name. Set for static bucket content. Used for static buckets (a Bucket manifest name) |
| siteConfig | string | Name of the SiteConfig (CDN application) whose engine-owned bucket backs this path. The ingress uses it in place of a Bucket manifest. Mutually exclusive with bucket. |
| notFoundPage | string | Resolved not-found page from BucketRouteConfig.not_found_page. Empty means no fallback. If set, a 404 on this path serves the page with status 200. |
| responseHeaders | list of string | Resolved response headers for the backend bucket, one Name: value per entry. They are the security_headers preset of the StaticAssetRoute merged with its response_headers. An explicit header replaces a preset header of the same name. Bucket paths only. |
| notFoundStatus | int32 | Resolved from BucketRouteConfig.not_found_status. 0 or 200 serves the not-found page with status 200. 404 keeps the real 404. It applies only if not_found_page has a value. |
| complexity | int64 | Weight that sorts path matchers. A higher value is more specific and the load balancer evaluates it first. |
| timeout | string | Route-level request timeout, as a Go-style duration string, for example 1800s. It overrides the default of the backend service. |
| idleTimeout | string | Route-level idle timeout, as a Go-style duration string, for example 60s. |
| agentName | string | Name of the agent this path routes to. If set, the path is rewritten to /agents/{agent_name}/ for the agentic proxy. |
ComputedAuthorizationAccessRules
Authorization rules for one host.
Lists the rules that apply to the traffic of the host.
| Property | Type | Description |
|---|---|---|
| rules | list of ComputedAuthorizationAccessRule | Rules from all child HttpRoute and GrpcRoute manifests for the host. |
HttpRouteRuleMatch
Match criteria for an HTTP request.
Selects requests by path, header or query parameter.
| Property | Type | Description |
|---|---|---|
| ignoreCase | bool | If true, path comparisons ignore case. |
| fullPathMatch | string | Matches if the request path equals this value. Mutually exclusive with prefix_match and regex_match. |
| prefixMatch | string | Matches if the request path starts with this prefix. |
| regexMatch | string | Matches if the request path fully matches this regular expression. |
| headers | list of HttpRouteRuleMatchHeader | Conditions on request headers. All must match. |
| queryParameters | list of QueryParameterMatch | Conditions on URL query parameters. All must match. |
ContainerResources
Compute requirements and limits of a container.
They map to the resource requests and limits of Kubernetes pods or Cloud Run services.
| Property | Type | Description |
|---|---|---|
| requests | ContainerResource | Minimum CPU and memory guaranteed to the container. |
| limits | ContainerResource | Maximum CPU and memory that the container can use. |
EnvVariableDefinition
Static environment variable.
The engine adds it to the environment of the container.
| Property | Type | Description |
|---|---|---|
| name | string | Variable name. |
| value | string | Literal value. |
ContainerResource
Single resource boundary for a container.
It sets the requests or the limits for CPU and memory.
| Property | Type | Description |
|---|---|---|
| cpu | string | CPU quantity in Kubernetes/Cloud Run notation, for example "500m" or "2". |
| memory | string | Memory quantity in the same notation, for example "256Mi" or "1Gi". |
ComputedAuthorizationAccessRule
Computed authorization rule.
Part of the configuration that authorization extensions use to resolve user scopes.
| Property | Type | Description |
|---|---|---|
| identitySource | string | Copy of spec.authorization.identitySource of the child HttpRoute or GrpcRoute manifest. |
| matches | list of HttpRouteRuleMatch | Copy of the spec.matches block of the child HttpRoute or GrpcRoute manifest. |
| checks | list of ComputedAuthorizationAccessRuleCheck | Copy of the spec.authorization.checks block of the child HttpRoute or GrpcRoute manifest. |
QueryParameterMatch
Condition on an HTTP query parameter.
A route match uses it to select requests by URL query parameter.
| Property | Type | Description |
|---|---|---|
| queryParameter | string | Name of the URL query parameter to test. |
| exactMatch | string | Matches if the parameter value equals this string. |
| regexMatch | string | Matches if the parameter value fully matches this regular expression. |
| presentMatch | string | If set, matches if the parameter is present, whatever its value. |
HttpRouteRuleMatchHeader
Condition on an HTTP header.
A route match uses it to select requests by header.
| Property | Type | Description |
|---|---|---|
| header | string | Name of the request header to test. |
| invertMatch | bool | If true, the rule applies when the header condition does NOT hold. |
| exactMatch | string | Matches if the header value equals this string. |
| regexMatch | string | Matches if the header value fully matches this regular expression. |
| prefixMatch | string | Matches if the header value starts with this prefix. |
| presentMatch | bool | If true, matches if the header is present, whatever its value. |
| suffixMatch | string | Matches if the header value ends with this suffix. |
| rangeMatch | RangeMatch | Matches if the header value is an integer in this range. |
RangeMatch
Integer range for a header test.
A header condition matches a header value against this range.
| Property | Type | Description |
|---|---|---|
| start | int64 | Lower bound (inclusive): the smallest integer that matches. |
| end | int64 | Upper bound (exclusive): one more than the largest integer that matches. |
ComputedAuthorizationAccessRuleCheck
Computed access check for a route rule.
The identity tuple (namespace, relation, object) that the authorization extension checks.
| Property | Type | Description |
|---|---|---|
| namespace | string | Copy of spec.authorization.namespace of the child HttpRoute or GrpcRoute manifest. |
| relation | string | Copy of spec.authorization.relation of the child HttpRoute or GrpcRoute manifest. |
| object | string | Copy of spec.authorization.object of the child HttpRoute or GrpcRoute manifest. |