Skip to main content

Workforce Identity Provider

WorkforceIdentityProvider​

Defines the integration of an external workforce identity provider.

Federates an external IdP (for example Google Workspace or Microsoft Entra ID) through SAML or OIDC for workforce Single Sign-On. NOT YET IMPLEMENTED: the engine does not provision this resource.

PropertyTypeDescription
apiVersionstringAPI schema version. Must be lowops.manifests.v1.
kindstringResource kind. Must be WorkforceIdentityProvider.
metadatamapThe engine reads reserved keys to resolve the manifest identity and to find its parent PublicIngress.
specSpecUser-authored workforce identity provider specification.

Spec​

User-authored workforce identity provider configuration.

Protocol settings (SAML or OIDC), attribute mapping and an access condition. NOT YET IMPLEMENTED: the engine reads none of these fields and provisions no workforce pool provider.

PropertyTypeDescription
descriptionstringOptional free text that describes the role of this provider. AI assistants use it as context. The engine does not copy it to any provisioned resource.
disabledboolIf true, disables the provisioned workforce pool provider.
attributeMappinglist of AttributeMappingEntryMaps attributes of the external IdP to Google Cloud attributes, for example google.subject.
attributeConditionstringCEL expression that must be true for an identity to authenticate.
expireTimestringRFC3339 timestamp at which the workforce pool provider expires.
samlSamlNOT YET IMPLEMENTED. SAML provider settings. See Saml.
oidcOidcNOT YET IMPLEMENTED. OIDC provider settings. See Oidc.

AttributeMappingEntry​

PropertyTypeDescription
keystring
valuestring

Oidc​

OIDC provider settings.

NOT YET IMPLEMENTED. Configuration for an OIDC-based provider.

PropertyTypeDescription
issuerUristringOIDC issuer (discovery) URI that identifies the external provider.
clientIdstringOAuth 2.0 client ID registered with the external provider.
webSsoConfigWebSsoConfigNOT YET IMPLEMENTED. Web SSO settings. See WebSsoConfig.
jwksJsonstringJSON Web Key Set (JWKS) that verifies tokens from the OIDC provider.

WebSsoConfig​

OIDC web SSO behavior.

NOT YET IMPLEMENTED. Controls the browser sign-in flow: response type, claim resolution and extra scopes.

PropertyTypeDescription
responseTypestringOAuth 2.0 response type of the web SSO flow: CODE or ID_TOKEN.
assertionClaimsBehaviorstringHow the flow resolves claims: MERGE_USER_INFO_OVER_ID_TOKEN_CLAIMS or ONLY_ID_TOKEN_CLAIMS.
additionalScopeslist of stringExtra OAuth scopes to request in the web SSO flow, in addition to the defaults.

Saml​

SAML provider settings.

NOT YET IMPLEMENTED. Configuration for a SAML-based provider.

PropertyTypeDescription
idpMetadataXmlstringSAML metadata XML document of the external IdP, to establish the SAML trust.