Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,53 @@
|
||||
# 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.
|
||||
Reference in new issue
Block a user