v0.2.0 — Open Source Prototyp

TI-Gateway

Lokaler Telematikinfrastruktur-Prototyp mit Software-Kartenterminals, SOAP-Konnektor, ePA 2.0 und Web-Dashboard

PROTOTYP — Nicht für produktiven Einsatz
irm https://downloads.c3po42.de/ti-gateway/install.ps1 | iex
💳

SOAP-Konnektor

Emuliert die gematik-Konnektor-Schnittstelle. ReadVSD, GetCards, VerifyPin, ExternalAuthenticate, SignDocument — alles lokal testbar.

💳

Smartcard-Emulation

Virtuelle eGK und SMC-B mit realistischen Testdaten. 4 Slots, eigene Karten per JSON-Datei erstellbar.

🔌

SICCT-Terminal

TCP-Server auf Port 4742 emuliert ein eHealth-Kartenterminal. APDU-Weiterleitung, PIN-Verifikation, Slot-Management.

📊

Live-Dashboard

Web-UI mit Echtzeit-Updates via SSE. Karten-Status, SOAP-Log, Dienste-Ampel, Test-Buttons und integrierte Dokumentation.

🏥

IdP-Anbindung

Optionale Integration mit dem gematik ref-idp-server (Docker). OpenID Connect Discovery, Authentication Challenges.

💊

E-Rezept-Tests

Demo-E-Rezepte erstellen und auflisten. Mock-Daten lokal, optional gegen den gematik eRp-Fachdienst testbar.

📄

ePA 2.0

Elektronische Patientenakte mit Dokumentenverwaltung, feingranularer Zugriffskontrolle, Medikationsplan und Berechtigungsprofilen.

🔒

Zugriffskontrolle

ePA 2.0 Berechtigungsprofile pro Institution und Dokumentenkategorie. Vertraulichkeitsstufen und zeitlich begrenzte Freigaben.

Architektur

  Primaersystem (PVS / KIS / Browser)
  SOAP-Client ──► https://localhost:8500
                        │
  ┌─────────────────────▼─────────────────────────┐
  │          TI-Gateway (FastAPI)        Port 8500 │
  │                                                │
  │  ┌────────────┐ ┌────────────┐ ┌────────────┐ │
  │  │ SOAP-      │ │ Card-      │ │ SICCT-     │ │
  │  │ Handler    │ │ Manager    │ │ Server     │ │
  │  │ (6 Ops)    │ │ (eGK,SMCB) │ │ TCP :4742  │ │
  │  └─────┬──────┘ └─────┬──────┘ └────────────┘ │
  │        │               │                       │
  │  ┌─────▼───────────────▼──────────────────┐   │
  │  │     Externe Dienste (optional)          │   │
  │  │  IdP │ Titus VSDM │ eRp-FD │ ePA 2.0   │   │
  │  └────────────────────────────────────────┘   │
  └────────────────────────────────────────────────┘

Dashboard

Emulierte Karten
┌──────────┐ ┌──────────┐
eGK │ │ SMC-B
│ Max │ │ IKK │
│ Muster- │ │ Kliniken │
│ mann │ │ │
│ KVNR: │ │ Telematik│
X1105.. │ │ 3-SMC-..
└──────────┘ └──────────┘
4 Slots mit eGK und SMC-B
SOAP-Log (Live)
14:23:01 ReadVSD OK
14:23:05 GetCards OK
14:24:12 ExternalAuth OK
14:25:00 Titus:ReadVSD ERR
14:25:33 IdP:Challenge WARN

Dienste
SOAP-Konnektor SICCT
IdP (Docker) Titus
ePA 2.0 (Demo)
Echtzeit-Log und Dienste-Status
Test-Aktionen

[eGK lesen] [GetCards]
[SMC-B Auth]
[Titus VSDM] [IdP Challenge]
[eRezept erstellen]
[eRezepte auflisten]

ePA 2.0
[Aktenstatus] [Dokumente]
[Upload] [Berechtigungen]
[Medikationsplan]

Dokumentation
[README] [Handbuch]
12 Test-Buttons + Doku

SOAP-Operationen

OperationBeschreibungVoraussetzung
ReadVSDVersichertenstammdaten von eGK leseneGK eingelegt
GetCardsAlle gesteckten Karten auflisten
VerifyPinPIN einer Karte verifizierenKarte eingelegt
ExternalAuthenticateAuthentifizierung mit SMC-BSMC-B eingelegt
GetCardTerminalsKartenterminals auflisten
SignDocumentDokument signieren (Mock)SMC-B eingelegt

ePA 2.0 — Elektronische Patientenakte

OperationBeschreibungVoraussetzung
GetRecordStatusAktenstatus abfragen (Version, Dokumentanzahl, Größe)eGK eingelegt
GetDocumentsDokumente aus der ePA abrufen (mit Berechtigungsprüfung)eGK + SMC-B
UploadDocumentDokument in die ePA hochladeneGK eingelegt
GetPermissionsBerechtigungsprofile anzeigen (feingranulare Zugriffskontrolle)eGK eingelegt
GetMedicationPlanMedikationsplan mit PZN, Dosierung und VerordnereGK eingelegt

Die ePA 2.0 simuliert feingranulare Zugriffskontrolle: Jede Institution erhält nur Zugriff auf freigegebene Dokumentenkategorien. Vertraulichkeitsstufen (normal, sehr hoch) und zeitlich begrenzte Berechtigungen werden emuliert.

REST-API Endpoints

MethodePfadBeschreibung
POST/soapSOAP-Konnektor-Endpoint
GET/api/statusGateway-Status + Karten + Log
GET/api/cardsAlle eingelegten Karten
GET/api/servicesStatus externer Dienste
GET/api/eventsServer-Sent Events (Live)
POST/api/test/*12 Test-Aktionen (SOAP, eRp, ePA)
GET/docs/readmeREADME (Markdown)
GET/docs/handbuchBenutzerhandbuch (Markdown)

Tech-Stack

Python 3.10+ FastAPI Uvicorn SOAP 1.2 SICCT/TCP SSE httpx lxml zeep cryptography

Systemvoraussetzungen

KomponenteMinimumBemerkung
Python3.10+Im PATH
BetriebssystemWindows 10/11, Linux, macOS
Ports8500 (HTTP), 4742 (SICCT)Auto-Fallback auf 8501
DockerOptionalNur für IdP-Server
BrowserChrome, Firefox, EdgeFür Dashboard

Mitgelieferte Demo-Karten

eGK — Max Mustermann

KVNR: X110501499
Kasse: IKK classic (109519005)
Adresse: Musterstr. 42, 50667 Koeln
Generation 2+, ECC-Zertifikate
PIN: 123456

SMC-B — IKK Kliniken

Telematik-ID: 3-SMC-B-Testkarte-...
Typ: Krankenhaus
BSNR: 123456789
ECC Auth + Sign Zertifikate (bis 2029)
PIN: 123456

Links