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

54 lines
3.8 KiB
Markdown

# 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
- [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.