# 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./integrations//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 - [x] 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) - [x] 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.