Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/EXT-10.md
T

3.8 KiB

EXT-10 · Google-Cloud OAuth + Calendar-Scope-Antrag

Typ Setup (External)
Owner Raffael
Cycle/Fenster W1 — Fundament & Identität · fällig 2026-06-18 · Gate W1
Status geplant

Was zu tun ist

  • Google-Cloud-Projekt + OAuth-App anlegen, Consent-Screen konfigurieren.
  • Scopes: calendar.events (sensitiv, der eigentliche Zugriff) + userinfo.email + openid (nicht-sensitiv, zur Konto-Zuordnung) — kein Gmail, kein userinfo.profile (Postfach-Sync → v2).
  • Modell: pro Person (User-OAuth, jeder verbindet sein eigenes Konto, auch privates Gmail). Org-weite Variante (Domain-wide Delegation) ist bewusst v2 → siehe VR-P16.
  • Redirect-URIs (Konvention app.<domain>/integrations/<provider>/oauth/callback, Tenant im OAuth-state):
    • https://app.hivegrid.de/integrations/google/oauth/callback
    • https://staging-app.hivegrid.de/integrations/google/oauth/callback
    • Lokale Dev-URI erst beim P16-Bau nachtragen: lokal läuft die App unter app.localhost:3000 (Subdomain, Multi-Tenant), nicht localhost:3000. Google akzeptiert *.localhost nicht zuverlässig → voraussichtlich die Cloudflare-Tunnel-HTTPS-URL registrieren (pro Dev, nutzen wir ohnehin). Google erlaubt Nachtragen jederzeit.
  • Scope-Verifizierung bei Google beantragen (Review dauert Tage bis Wochen) — setzt eine öffentlich erreichbare Datenschutzerklärung (hivegrid.de/datenschutz) voraus.
  • Testmodus-Brücke mit Test-Usern (eigene + Geerkens-Konten) einrichten, bis die Verifizierung durch ist.
  • Nach Anlage: Client-ID + Secret in Coolify-Prod-Env (web/api/worker) + ~/.cli-tokens/hivegrid-prod-services.

Warum / was es blockt

Die Google-Kalender-Integration (nur Google in v1; Outlook → v2) braucht eine verifizierte OAuth-App mit Calendar-Scope.

  • Blocks: P16 (Kalender, nur Google)

Abhängigkeiten

  • blocked-by: —
  • blocks: P16

Definition of Done

  • OAuth-App + Calendar-Scope (calendar.events sensitiv + userinfo.email/openid zur Konto-Zuordnung)
  • [→] Verifizierung beantragt — ausgelagert nach EXT-15 (eigener Review-Zyklus, blockiert auf hivegrid.de/datenschutz live)
  • Testmodus-Brücke mit Test-Usern (eigene + Geerkens-Konten eintragbar)

Umsetzungsstand (2026-06-21, Owner Raffael)

  • Google-Cloud-Projekt HiveGrid + Calendar API aktiviert. OAuth-Consent (External, Test-Modus) konfiguriert.
  • Scopes: calendar.events (vertraulich) + userinfo.email + openid (nicht-vertraulich). Kein Gmail/profile.
  • OAuth-Client (Webanwendung) erstellt, Redirect-URIs app. + staging-app.hivegrid.de/integrations/google/oauth/callback.
  • Test-User eingetragen (Brücke bis Verifizierung).
  • Client-ID + Secret eingetragen als GOOGLE_OAUTH_CLIENT_ID/_CLIENT_SECRET/_REDIRECT_URI:
    • Prod-Coolify (web/api/worker-general), REDIRECT_URI=app.hivegrid.de/...
    • Staging-Coolify (web/api/worker-general), REDIRECT_URI=staging-app.hivegrid.de/... (gleiche Client-ID/Secret, eine Google-App deckt beide Redirect-URIs ab). Gesetzt via control:localhost:8000, da die saas-ctrl.com-CF-WAF die OAuth-Werte im API-Body blockte.
    • lokal ~/.cli-tokens/hivegrid-prod-services (mode 600).
  • Offen: (1) Verifizierung beantragen, sobald hivegrid.de/datenschutz live ist; (2) lokale Dev-Redirect-URI + Code-Flow beim P16-Bau (Connector unter /integrations/google/..., siehe INTEGRATION-CONTRACTS §3).

Status: Eigener Scope (OAuth-App-Anlage + Creds) erfüllt — DONE (Plane, 2026-06-21). OAuth-App + Scopes + Test-User live, Client-ID/Secret auf Prod + Staging + lokal verdrahtet. Die Verifizierung ist nach EXT-15 ausgelagert (Backlog, blockiert auf Live-Website) und kein Teil mehr von EXT-10. Selbst machbar offen: 0.