Skip to content
Docs

Google Cloud

Google Cloud is the primary cloud provider with dedicated integration support in the current codebase. The registry supports `gcp`, the alias `google-cloud`, and a separate `google-logs` provider for logging-oriented flows.

Purpose

Configure Google Cloud access in ActsAsGeek through the authenticated integration routes, then use the project monitoring, secret storage, and usage-ingestion surfaces that already exist in the product.

Prerequisites

  • A signed-in Supabase session.
  • A CSRF token for POST and PATCH requests.
  • A Google Cloud service account key JSON when using the current settings UI flow.

Setup

1
Create the credential with POST /api/integrations using provider `gcp` and a `service_account_key` payload when you use the current UI.
2
Attach the credential to a project or environment in the integrations settings surface.
3
Configure project log scanning with /api/projects/[projectId]/log-scanning/configs when you need Cloud Run or Cloud Logging ingestion.

API & contracts

FieldTypeDescription
gcpoauth2 · api_keyThe alias map resolves `google-cloud` to `gcp`.
google-logsoauth2 · api_keyThis provider is used for logging-specific workflows and the settings UI can fall back to the main `gcp` credential.
  • The GCP verifier parses `service_account_key` and attempts to verify service-account credentials.
  • Project connector bindings accept `gcp` and `google-logs` connector types.
  • The agentic connector registry has dedicated connector implementations for `gcp` and `google-logs` rather than the generic API-key path.

Failure modes

  • POST /api/integrations returns 400 for unsupported auth types or invalid request payloads.
  • GCP verification fails when the supplied service account key cannot be parsed or authenticated.
  • Mutation routes return 401 without a session and 403 when the CSRF token is missing.

Back to Integrations