Zum Hauptinhalt springen

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​

TypCreate-EndpointZweck
MaklerBenutzerPOST /v1.0/maklerBenutzerSessionsArbeitssitzung eines Makler-Benutzers
SachbearbeiterPOST /v1.0/sachbearbeiterSessionsArbeitssitzung eines Sachbearbeiters
SwissLifeSelect (Legacy)POST /v1.0/swissLifeSelectSessionsexterne 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):

OperationZweck
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}/sessionDatenBatch-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 wird GeaendertAmUm neu 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.

Session-Lifetime (geplant)

Referenzen​

  • tis.identity.api/docs/adrs/ADR-006-session-datenstruktur-und-segments.md — Datenstruktur & Segmente
  • tis.gf.api/docs/adr/0001-one-time-token-opaker-handle-statt-jwt.md — GF-Deeplink One-Time-Token
  • tis.gf.api/docs/diagrams/ — Trust-Passthrough-Edit-Flow