Skip to main content
Version: 3.2.0

GCS Workload Identity

Version: 3.2.0 Date: 2026-11-17

Goal: Operators on GKE must use Application Default Credentials instead of mounting a service-account JSON.

Solution: Explicit auth: workload-identity on Google Cloud Storage. The GCS client uses ADC. auth: key-file (default) keeps keyPath as today.

Features:

  • Mutual exclusion of keyPath and auth: workload-identity in YAML
  • Connection test resolves and displays the ADC identity, then writes a probe object
  • Distinct errors for missing ADC, 403 on the bucket, and missing bucket

Implementation Details:

  • sendFile uses the same client factory as the connection test (no more keyFilename: undefined)
  • UI switch hides the JSON upload when Workload Identity is on

Files Modified:

  • src/protocol/storage/google-cloud-storage/ - ADC client, identity, errors
  • src/core/configuration/config.schema.ts - auth + keyPath exclusion
  • ui/src/pages/storages/ - identity mode and test result
  • docs/user/configuration/storage.md - auth field (EN / FR)
  • docs/user/install/gke.md - bind Workload Identity, auth: workload-identity (EN / FR)

Release fragment: feat-gcp-adc