Sessions
🤖 Generated with Claude Code
⚠️ Not yet reviewed
Co-Authored-By: Claude (noreply@anthropic.com)
Eine TisSession verknĂĽpft einen Benutzer (und optional einen Makler) fĂĽr die
Dauer einer Arbeitssitzung mit einem Server-seitigen Zustand. Sie wird ĂĽber die
Session-API der tis.identity.api angelegt und geprüft und trägt zusätzlich
externe Daten (SessionDaten-Segmente).
Session-Typen​
| Typ | Create-Endpoint | Zweck |
|---|---|---|
| MaklerBenutzer | POST /v1.0/maklerBenutzerSessions | Arbeitssitzung eines Makler-Benutzers |
| Sachbearbeiter | POST /v1.0/sachbearbeiterSessions | Arbeitssitzung eines Sachbearbeiters |
| SwissLifeSelect (Legacy) | POST /v1.0/swissLifeSelectSessions | externe SLS-Session; entfällt mit der SLS-Ablöse |
PrĂĽfen/Abholen: GET /v1.0/sessions/{tisSessionId}.
Session anlegen​
Clients erzeugen Sessions nie direkt, sondern immer über ein internes System. Beim Anlegen (maklerBenutzer/sachbearbeiter) können optional mitgegeben werden:
quellsystem— das interne erzeugende System (z. B.gfapi-deeplinkservice,hybridgui).clientId— der externe OAuth-Client, über den der Flow ausgelöst wurde.sessionDaten— initiale Segmente (siehe unten).
Lesart der Provenance: Client → über Quellsystem → für Benutzer.
SessionDaten-Segmente​
Statt eines schemalosen Daten-Blobs trägt die Session einen Envelope mit benannten,
versionierten, owner-eigenen Segmenten (type, schemaVersion, immutable,
opakes data). Die tis.identity.api speichert und liefert Segmente, deserialisiert
sie aber nicht — Ownership liegt bei der jeweiligen Domäne. Hintergrund und
Prinzipien: tis.identity.api/docs/adrs/ADR-006-session-datenstruktur-und-segments.md.
Operations (SessionApi v1.0):
| Operation | Zweck |
|---|---|
PUT /v1.0/sessions/{id}/sessionDaten/{type} | Segment anlegen/ersetzen; immutable: true → danach nicht mehr überschreibbar (409) |
GET /v1.0/sessions/{id}/sessionDaten/{type} | Einzel-Lookup, immer 200 mit exists-Flag |
POST /v1.0/sessions/{id}/sessionDaten | Batch-Lookup ({ "types": [...] }) |
immutable-Segmente sind write-once und trust-relevant; mutable Segmente sind
last-writer-wins. JSON-Schemas der GF-Segmente:
tis.gf.api/docs/schemas/ (gf.security-scope.v1, gf.druckdaten.v1).
OpenAPI-Spec: tis.identity.api/contracts/rest/tis.identity.api_SessionApiV1.json.
Session-Lifetime — heute​
Der Ablauf einer Session ergibt sich aus zwei Grenzen (Konfig-Section SessionApi):
SessionLeasetime— gleitende Idle-Lease; bei jeder Nutzung wirdGeaendertAmUmneu gesetzt und die Lease-Uhr läuft neu.SessionMaximumLeaseTime— absolute Obergrenze ab Erzeugung; wird nie überschritten.
Ablauf = min( GeaendertAmUm + SessionLeasetime ,
ErzeugtAmUm + SessionMaximumLeaseTime )
Standardwerte: SessionLeasetime = 5400 s (90 min Idle), SessionMaximumLeaseTime
= 43200 s (12 h ab Erzeugung). Ein automatisches Löschen abgelaufener Sessions gibt
es heute nicht.
Session-Lifetime — geplant​
Status: geplant — noch nicht umgesetzt. Terminlich an die SOAGFX-Migration Java → C# gekoppelt.
- Anlegen: Der UI-Container (
hybridgui/tis-hosting-shell) legt Sessions mit einer für den Arbeitstag passenden Lifetime an. - Stille Erneuerung: Läuft eine Session ab, wird sie im Hintergrund still gegen eine neue ausgetauscht — ohne Unterbrechung für den Benutzer.
- Verlängerung bei GF-Nutzung: Wird eine Session für einen Geschäftsfall genutzt, verlängert jeder SOAGFX-Aufruf (neuer GF, GF öffnen, GF speichern …) die TisSession um 90 Tage. So hat die Versicherung genug Zeit, Updates zum Geschäftsfall zu liefern.
- Cleanup: Sessions werden 30 Tage nach ihrem Ablauf aus der Datenbank gelöscht.
Referenzen​
tis.identity.api/docs/adrs/ADR-006-session-datenstruktur-und-segments.md— Datenstruktur & Segmentetis.gf.api/docs/adr/0001-one-time-token-opaker-handle-statt-jwt.md— GF-Deeplink One-Time-Tokentis.gf.api/docs/diagrams/— Trust-Passthrough-Edit-Flow