3.8 KiB
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, keinuserinfo.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/callbackhttps://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), nichtlocalhost:3000. Google akzeptiert*.localhostnicht 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.eventssensitiv +userinfo.email/openidzur Konto-Zuordnung) - [→] Verifizierung beantragt — ausgelagert nach EXT-15 (eigener Review-Zyklus, blockiert auf
hivegrid.de/datenschutzlive) - 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).
- Prod-Coolify (web/api/worker-general),
- Offen: (1) Verifizierung beantragen, sobald
hivegrid.de/datenschutzlive 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.