Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Plattform für Patientenzustimmung für Gesundheits-Apps
Zustimmung in der Datenebene integriert: OAuth 2.1 und SMART Scopes, Zweck und Ablauf vom Nutzer gewählt, ein Zugriffsprotokoll, das er einsehen kann, Widerruf bei der nächsten Anfrage und was Ihre App weiterhin besitzt.
Eine Patienten-Einwilligungsplattform ermöglicht es einer Person zu entscheiden, welche Anwendungen ihre Gesundheitsakte lesen oder ändern dürfen, zu welchem Zweck und wie lange, und sie können diesen Zugriff jederzeit einsehen und widerrufen. Anpheros integriert die Einwilligung in die Datenebene: Eine Anwendung greift nur über eine vom Nutzer auf der Anpheros-Einwilligungsseite genehmigte Erlaubnis auf den FHIR R4-Datensatz eines Patienten zu, jede Lese- und Schreiboperation unter dieser Erlaubnis wird protokolliert, wo der Nutzer sie einsehen kann, und der Widerruf wird bei der nächsten Anfrage wirksam. Diese Seite zeigt, wie das funktioniert, was Ihre Anwendung tun muss und was sie nicht selbst entwickeln muss.
- 1 · Your app asksOAuth 2.1 with PKCE: SMART scopes, a purpose and the patient's language
- 2 · The person decidesOn the Anpheros consent page: what, for whom and for how long — 30, 90, 180 or 365 days
- 3 · Your app readsOne patient's record, only the granted resource types and categories
- 4 · Every access is loggedThe person sees each read and write by your application
- 5 · The person revokesThe next request fails; a refresh token cannot bring access back
Warum die Einwilligung in der Datenebene angesiedelt sein sollte
Die meisten Gesundheits-Apps speichern die Einwilligung als Kontrollkästchen in ihrer eigenen Datenbank und erzwingen sie dann im Anwendungscode. Das funktioniert, bis eine zweite App, eine Klinikintegration oder eine KI-Funktion dieselben Daten benötigt: Jede muss die Regeln neu implementieren, und die Person hat keinen zentralen Ort, um zu sehen, wer Zugriff hat. Wenn die Plattform, die den Datensatz speichert, auch die Einwilligung erzwingt, erhalten alle Clients dieselben Regeln und die Person erhält eine Liste von Anwendungen zur Überprüfung.
| Einwilligung als Flag in Ihrer App | Einwilligung in der Datenebene (Anpheros) | |
|---|---|---|
| Wo sie erzwungen wird | Im Code jeder Anwendung | Bei jeder API-Anfrage, durch die Plattform |
| Umfang des Zugriffs | Was auch immer die App zu lesen entscheidet | Nur die gewährten Ressourcentypen und -kategorien |
| Ablaufdatum | Selten implementiert | Von der Person gewählt: 30, 90, 180 oder 365 Tage |
| Was die Person sieht | Abhängig von der App | Jede Anwendung, ihre Scopes und Ablaufdaten sowie ein Zugriffslog |
| Widerruf | Muss manuell weitergegeben werden | Nächste Anfrage schlägt fehl; der Refresh-Token funktioniert nicht mehr |
Was der Patient kontrolliert
Wie Ihre Anwendung um Zustimmung bittet
Anpheros verwendet OAuth 2.1 mit PKCE und SMART on FHIR v2 Scopes. Ihre App leitet die Person mit den benötigten Scopes und einem optionalen Zweck zur Zustimmungsseite weiter; nach der Genehmigung erhält sie einen Access Token (30 Minuten) und einen rotierenden Refresh Token (30 Tage) für genau einen Patienten.
import { OAuthFlow, generatePkce } from '@anpheros/sdk';
const flow = new OAuthFlow({
baseUrl: 'https://platform.anpheros.com',
clientId: process.env.ANPHEROS_CLIENT_ID!,
redirectUri: 'https://your.app/callback',
});
const pkce = await generatePkce();
const url = flow.authorizeUrl({
scopes: ['patient/Observation.rs?category=laboratory', 'patient/Condition.rs', 'offline_access'],
purpose: 'treatment',
state: crypto.randomUUID(),
pkce,
lang: 'en',
});
// redirect the person to `url`; on the callback exchange the code (see the authentication guide)
Ein Scope wie patient/Observation.rs?category=laboratory beschränkt das Lesen auf Laborergebnisse; der Kategorie-Filter wird vom Server erzwungen. Ein Ressourcentyp außerhalb der Berechtigung gibt 403 zurück; ein Patient außerhalb der Berechtigung gibt 404 zurück, sodass IDs nicht abgefragt werden können.
Reaktion auf Widerruf
Wenn die Person eine Berechtigung beendet, schlägt die nächste Anfrage mit diesem Token fehl, und der Refresh-Token kann keinen Zugriff mehr gewähren. Um sofort aufzuräumen, abonnieren Sie den consent.revoked Webhook, der die grant_id, die angezeigte Patienten-ID, die Scopes und revoked_at übermittelt.
await anpheros.webhooks.create('https://your.app/anpheros/hook', { events: ['consent.granted', 'consent.revoked'] });
Was Anpheros nicht tut
- Es sammelt keine Einwilligungen für Zwecke außerhalb des Datenzugriffs, wie z. B. Marketing oder Teilnahme an Forschung.
- Es bestimmt nicht Ihre Rechtsgrundlage. Die Einwilligung zum Zugriff ist eine Kontrolle; Ihre Datenschutzerklärung, Verträge und Verarbeitungsverzeichnisse bleiben bei Ihnen.
- Der eigene API-Schlüssel eines Projekts sieht die von diesem Projekt erstellten Patienten, ohne eine Genehmigung. Die Einwilligung regelt den Zugriff durch andere Anwendungen.
Häufig gestellte Fragen
Was ist eine Patienten-Einwilligungsplattform?
Software, die aufzeichnet, welchen Anwendungen eine Person den Zugriff auf ihre Gesundheitsdaten erlaubt, diese Entscheidungen bei jeder Anfrage durchsetzt, der Person anzeigt, wer auf was zugegriffen hat, und es ihr ermöglicht, den Zugriff zu widerrufen. In Anpheros ist die Einwilligung Teil des FHIR R4-Datensatzes selbst und nicht ein separater Dienst.
Welche Standards verwendet Anpheros für die Patienteneinwilligung?
OAuth 2.1 mit PKCE für den Autorisierungsfluss und SMART on FHIR v2 Patient Scopes (patient/<Type>.<cruds> mit einem optionalen ?category= Filter) für das, was eine Anwendung lesen oder schreiben darf. OpenID Connect fügt einen ID-Token hinzu, wenn Sie nach openid fhirUser fragen.
Kann ein Patient den Zugriff auf nur einige seiner Daten beschränken?
Ja. Der Zugriff ist auf die Ressourcentypen und Kategorien in den erteilten Scopes beschränkt, z. B. nur auf Laborbeobachtungen (Observations). Alles andere führt zu einem Fehler.
Wie lange dauert die Einwilligung?
Die Person wählt auf der Einwilligungsseite 30, 90, 180 oder 365 Tage. Danach läuft die Erlaubnis ab und die Anwendung muss erneut danach fragen.
Kann der Patient sehen, was eine Anwendung mit dem Zugriff gemacht hat?
Ja. Die Person sieht jede Anwendung mit Zugriff, ihre Scopes und das Ablaufdatum sowie ein Zugriffsprotokoll, das auflistet, was jede Anwendung gelesen oder geschrieben hat.
Was passiert, wenn die Einwilligung widerrufen wird?
Die nächste Anfrage mit diesem Zugriffstoken schlägt fehl, der Refresh-Token kann nicht verwendet werden, um einen neuen zu erhalten, und Ihr Server erhält einen consent.revoked Webhook, wenn er abonniert hat.
Verwandte Themen
- Einwilligungs- und Zugriffsmodell: die Regeln im Detail
- Authentifizierung und OAuth: Tokens, Scopes und der Code-Austausch
- Implementierung der Patienteneinwilligung mit SMART on FHIR
- Webhooks:
consent.grantedundconsent.revoked - Erklärung der Provenienz medizinischer Daten
- API für longitudinale Patientendaten
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card