Für Entwickler

Plattform für Patienteneinwilligung: So funktionieren Einwilligung, Geltungsbereiche, Gültigkeit und Widerruf in einer Gesundheitsdaten-API

Was eine Plattform, die bei der Patienteneinwilligung hilft, leisten muss: Einwilligung als eigenständiges Objekt mit Geltungsbereichen und Gültigkeitsdauer, Widerruf, der sofort wirksam wird, ein Zugriffsprotokoll, das der Patient einsehen kann, und KI-gestützte Genehmigungen. Wie Anpheros dies umsetzt.

von Veröffentlicht 4 Min. Lesezeit

Einwilligung ist der Teil eines Gesundheitsprodukts, den niemand bauen möchte und auf den jeder geprüft wird. "Der Nutzer hat bei der Anmeldung ein Kästchen angekreuzt" erfüllt nicht die DSGVO Artikel 9, übersteht keine Datenschutzprüfung und erlaubt einer Person nicht, den Zugriff von einer App zu entziehen, ohne ihr Konto zu löschen. Dieser Leitfaden beschreibt, was eine Plattform für Patienteneinwilligungen leisten muss und wie die Anpheros Plattform dies umsetzt, damit Sie sie wiederverwenden können, anstatt sie neu zu bauen.

Technische Version für Entwickler: Plattform für Patienteneinwilligungen · Einwilligung auf developers.anpheros.com, mit Anfragen, Antworten und Limits. Diese Seite ist die Version in einfacher Sprache.

Einwilligung als Objekt, nicht als Flag

In Anpheros ist eine Einwilligung eine Genehmigung: eine Person, eine Anwendung, eine Reihe von Geltungsbereichen (Scopes), ein Zweck, ein Ablaufdatum. Sie wird erstellt, wenn die Person den Zugriff auf der Einwilligungs-Seite genehmigt, sie wird dort aufgeführt, wo die Person sie sehen kann, und sie kann jederzeit widerrufen werden. Lesezugriffe werden bei jeder Anfrage dagegen geprüft.

  • Geltungsbereiche (Scopes) geben an, was die Anwendung lesen oder schreiben darf: Beobachtungen, Diagnosen, Medikamente, Allergien, Dokumente usw., optional eingegrenzt nach Kategorie (z. B. Laborergebnisse, aber keine Symptome).
  • Dauer wird von der Person gewählt: 30, 90, 180 oder 365 Tage. Es gibt kein "für immer".
  • Widerruf wird bei der nächsten Anfrage wirksam. Die Anwendung erhält einen consent.revoked Webhook.
  • Zweck wird mit der Genehmigung aufgezeichnet und der Person angezeigt.

Wie eine Anwendung anfragt

Über OAuth 2.1 mit PKCE, mit SMART on FHIR Standalone Launch für Apps, die bereits SMART sprechen. Die Person meldet sich an, sieht, welche Anwendung anfragt, welche Geltungsbereiche und für wie lange, und genehmigt oder lehnt ab. Die Anwendung erhält einen Token, der auf diesen einen Patienten und diese Geltungsbereiche beschränkt ist; ein Projektschlüssel ersetzt niemals die Einwilligung einer Person.

GET  https://platform.anpheros.com/oauth/authorize?client_id=…&scope=patient/Observation.read …
POST https://platform.anpheros.com/oauth/token

Zugriffstoken sind 30 Minuten gültig, Refresh-Token 30 Tage. Discovery-Dokumente finden Sie unter /.well-known/oauth-authorization-server und /.well-known/smart-configuration.

Was der Patient sieht

GET /me/patients/{id}/grants listet jede Anwendung mit Zugriff, ihre Geltungsbereiche und das Ablaufdatum auf. …/grants/{grant}/access-log listet auf, was jede Anwendung gelesen oder geschrieben hat, unter der Einwilligung und mit dem eigenen Schlüssel des Projekts. Mit format=fhir kommt das Protokoll als Bundle von FHIR R4 AuditEvent-Ressourcen zurück, die nach den IHE Basic Audit Log Patterns gestaltet sind. In Anpheros Daily ist dies der Bildschirm "Verbindungen"; Ihre eigene App kann dasselbe anzeigen.

Lesen im Vergleich zu Schreiben

Mit Einwilligung sieht eine Organisation den gesamten Datensatz, einschließlich dessen, was andere Kliniken geschrieben haben, kann aber nur ändern oder löschen, was sie selbst geschrieben hat. Jede Version jeder Ressource zeichnet das Projekt auf, das sie geschrieben hat; ein Schreibvorgang durch ein anderes Projekt wird mit einer Erklärung abgelehnt. Jeder Schreibvorgang erzeugt eine Provenance-Ressource, die die Anwendung, die Organisation, in deren Namen sie gehandelt hat, und die Person benennt.

KI-Agenten schlagen vor, die Person entscheidet

Ein Schreibvorgang, der im Rahmen der Einwilligung einer Person durch eine als KI-Agent registrierte Anwendung vorgenommen wird, wird nicht sofort angewendet. Die Plattform validiert ihn und antwortet mit 202 Accepted und einer Vorschlags-ID; im Datensatz ändert sich nichts. Die Person sieht den Vorschlag, was er ist und welche Anwendung ihn gesendet hat, und akzeptiert oder lehnt ihn ab. Ein akzeptierter Vorschlag wird genau so geschrieben, wie er gesendet wurde, und als KI-geschrieben markiert. So kann ein über MCP verbundener Assistent helfen, einen Datensatz zu vervollständigen, ohne jemals unbeaufsichtigt hineinzuschreiben.

Eine Person kann ihren Datensatz auch per QR-Code oder Link teilen. POST /me/patients/{id}/shl erstellt einen SMART Health Link für die Notfall-Teilmengen (Allergien, Medikamente, Probleme, Impfungen) oder den vollständigen International Patient Summary, mit optionalem Passwort und Ablaufdatum. Jede Öffnung wird im Zugriffsprotokoll erfasst, und der Link kann sofort deaktiviert werden. Jeder SMART Health Link-Leser kann ihn öffnen.

Das vollständige Modell mit allen Regeln finden Sie unter developers.anpheros.com/guides/consent-model.

Häufige Fragen

Die Genehmigung ist das operative Objekt, das bei jeder Anfrage geprüft wird; der Datensatz enthält auch FHIR Consent- und Provenance-Ressourcen, damit andere Systeme lesen können, was vereinbart wurde und wer was geschrieben hat. Das Zugriffsprotokoll ist als FHIR AuditEvent verfügbar.

Kann ein Patient nur für einen Teil des Datensatzes Zugriff gewähren?

Ja. Geltungsbereiche sind pro Ressourcentyp, mit Kategorie-Filtern, und die Person wählt sie auf der Einwilligungs-Seite aus. Eine App kann nur Laborergebnisse oder nur Medikamente anfordern.

Was passiert, wenn die Einwilligung abläuft?

Anfragen unter dieser Genehmigung geben ab dem Ablaufdatum 403 zurück. Die Anwendung kann erneut anfragen; die Person entscheidet erneut. Es werden keine Daten gelöscht.

Löscht der Widerruf Daten, die die App bereits gelesen hat?

Kein System kann Daten "unlesen". Der Widerruf stoppt den weiteren Zugriff sofort und wird aufgezeichnet; was die Anwendung auf ihrer Seite gespeichert hat, unterliegt ihren eigenen Verpflichtungen gemäß der DSGVO.

Kann eine Klinik ohne Zustimmung des Patienten auf einen Datensatz zugreifen?

Ein Projekt sieht die Patienten, die es selbst erstellt hat. Das Lesen eines woanders erstellten Datensatzes erfordert die Genehmigung der Person. Es gibt keine administrative Überschreibung.

Dieser Ratgeber dient der Information und ersetzt keine ärztliche Beratung. Sprechen Sie bei Entscheidungen über Ihre Gesundheit mit Ihrem Arzt oder Ihrer Ärztin. Im Notfall wählen Sie 112.
Über den Autor
Adrian Kereky

Gründer von Anpheros. Elektronikingenieur; sechs Jahre im Bereich autonomes Fahren, in Automobilprojekten in Partnerschaft mit Samsung und NVIDIA, an der Architektur von Fahrerassistenz- und KI-Systemen, die auf NVIDIA-Chips mit CUDA laufen. Danach baute er Anpheros auf: die patientenkontrollierte Patientenakte und die HL7-FHIR-R4-Plattform, auf der sie läuft.

Mehr über Anpheros und den Autor →

Ihre Patientenakte immer dabei

Anpheros Daily bewahrt Symptome, Laborwerte, Medikamente und Dokumente an einem Ort auf, in einem Standardformat und unter Ihrer Kontrolle. Der Basic-Plan ist kostenlos.

Anpheros Daily laden