42 lines
2.3 KiB
Markdown
42 lines
2.3 KiB
Markdown
# VR-P16 · Google Workspace Kalender für ganze Firma (Domain-wide Delegation)
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Typ** | Feature / External (v2) |
|
|
| **Owner** | Raffael |
|
|
| **Cycle/Fenster** | v2 — Backlog (nach v1-Launch) |
|
|
| **Status** | Backlog |
|
|
|
|
## Was zu tun ist
|
|
Org-weite Google-Kalender-Anbindung für Kunden mit **Google Workspace**, sodass nicht jeder
|
|
Mitarbeiter einzeln per OAuth zustimmen muss, sondern ein **Workspace-Admin die HiveGrid-App
|
|
einmal org-weit freigibt** und HiveGrid auf alle Mitarbeiter-Kalender der Domain zugreifen kann.
|
|
|
|
- **Service-Account** in der bestehenden Google-Cloud-App (EXT-10) anlegen + **Domain-wide
|
|
Delegation** aktivieren (eigener technischer Pfad neben dem User-OAuth aus v1).
|
|
- Admin-seitiger Freigabe-Flow: Workspace-Admin trägt die Client-ID + Scope(s) in der
|
|
Google-Admin-Console unter „API-Steuerung → Domänenweite Delegierung" ein.
|
|
- HiveGrid-seitig: Impersonation pro Nutzer (`subject`-Param), Tenant-Konfiguration „Workspace-Domain
|
|
+ Service-Account-Modus" statt Einzel-Connect.
|
|
- Doku/Onboarding für Workspace-Admins (welche Client-ID, welche Scopes, wie freigeben).
|
|
- Sicherheits-Guard: Vollzugriff auf alle Firmenkalender ist heikel → klare Tenant-Opt-in,
|
|
Audit, Scope minimal halten.
|
|
|
|
## Warum / Kontext
|
|
v1 (EXT-10 + P16) macht die Kalender-Anbindung **pro Person** (jeder Nutzer verbindet sein eigenes
|
|
Konto, funktioniert auch mit privatem @gmail). Größere Kunden mit eigener Google-Workspace-Domain
|
|
wollen das **org-weit** ohne Einzel-Consent. Das ist ein anderes technisches Modell (Service-Account
|
|
+ Domain-wide Delegation), nur für Workspace-Kunden sinnvoll und für die v1-SHK-Zielgruppe (meist
|
|
kein Workspace) überdimensioniert → bewusst nach v2 verschoben.
|
|
|
|
## Abhängigkeiten
|
|
- **blocked-by:** EXT-10 (Google-Cloud-App + Calendar-Scope müssen existieren), P16 (Kalender-Basis pro Person)
|
|
- **blocks:** —
|
|
|
|
## Definition of Done
|
|
- [ ] Service-Account + Domain-wide Delegation in der Google-Cloud-App eingerichtet
|
|
- [ ] Admin-Freigabe-Flow dokumentiert (Workspace-Admin-Console)
|
|
- [ ] HiveGrid Tenant-Konfiguration „Workspace-Domain / Service-Account-Modus" + Nutzer-Impersonation
|
|
- [ ] Org-weiter Kalender-Zugriff ohne Einzel-Consent nachgewiesen (Test gegen eine Workspace-Domain)
|
|
- [ ] Sicherheits-/Datenschutz-Guard (Tenant-Opt-in, Audit, Subprozessor-Eintrag → VR-P31)
|