AnpherosAnpheros PlatformDevelopers

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.

How one consent works, end to end
  1. 1 · Your app asksOAuth 2.1 with PKCE: SMART scopes, a purpose and the patient's language
  2. 2 · The person decidesOn the Anpheros consent page: what, for whom and for how long — 30, 90, 180 or 365 days
  3. 3 · Your app readsOne patient's record, only the granted resource types and categories
  4. 4 · Every access is loggedThe person sees each read and write by your application
  5. 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

What the patient controls
WhoEach application is listed by name with its own grant
WhatResource types and categories, e.g. only laboratory Observations
WhyThe purpose your app declares is shown on the consent page
How long30, 90, 180 or 365 days; access ends by itself
What happenedAn access log of every read and write under the grant
StopRevocation takes effect on the next request

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

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

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Product updates by email

New features, guides and the end of the beta. One email a month at most.

Send me occasional Anpheros Platform updates by email (new features, API changes, guides). I'll confirm by email and can unsubscribe in one click from any email. Privacy