AnpherosAnpheros PlatformDevelopers

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

Platformă de consimțământ al pacientului pentru aplicații de sănătate

Consimțământul integrat în stratul de date: scopuri (scopes) OAuth 2.1 și SMART, scop și expirare alese de persoană, un jurnal de acces pe care îl poate vedea, revocare la următoarea cerere și ce deține în continuare aplicația dvs.

O platformă de consimțământ al pacientului permite unei persoane să decidă ce aplicații pot citi sau modifica dosarul său medical, în ce scop și pentru cât timp, și îi permite să vadă și să revoce acel acces în orice moment. Anpheros integrează consimțământul în stratul de date: o aplicație accesează dosarul FHIR R4 al unui pacient numai printr-o autorizație aprobată de persoană pe pagina de consimțământ Anpheros, fiecare citire și scriere sub acea autorizație este înregistrată unde persoana o poate vedea, iar revocarea intră în vigoare la următoarea cerere. Această pagină arată cum funcționează, ce trebuie să facă aplicația dvs. și ce nu trebuie să construiască.

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

De ce consimțământul aparține stratului de date

Majoritatea aplicațiilor de sănătate înregistrează consimțământul ca o căsuță de bifat în propria bază de date și apoi îl impun în codul aplicației. Acest lucru funcționează până când o a doua aplicație, o integrare clinică sau o funcție AI necesită aceleași date: fiecare trebuie să reimplementeze regulile, iar persoana nu are un singur loc pentru a vedea cine are acces. Când platforma care stochează înregistrarea impune și consimțământul, fiecare client primește aceleași reguli, iar persoana primește o listă de aplicații pentru a le revizui.

Consimțământ ca un indicator în aplicația dvs. Consimțământ în stratul de date (Anpheros)
Unde este impus În codul fiecărei aplicații La fiecare cerere API, de către platformă
Domeniul de acces Orice decide aplicația să citească Doar tipurile și categoriile de resurse acordate
Expirare Rar implementat Ales de către persoană: 30, 90, 180 sau 365 de zile
Ce vede persoana Depinde de aplicație Fiecare aplicație, domeniile și expirarea acesteia, și un jurnal de acces
Revocare Trebuie propagată manual Următoarea cerere eșuează; token-ul de reîmprospătare nu mai funcționează

Ce controlează pacientul

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

Cum solicită aplicația dvs. consimțământul

Anpheros utilizează OAuth 2.1 cu PKCE și SMART on FHIR v2 scopes. Aplicația dvs. trimite persoana la pagina de consimțământ cu scope-urile de care are nevoie și un scop opțional; după aprobare, primește un token de acces (30 de minute) și un token de reîmprospătare rotativ (30 de zile) pentru exact un pacient.

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)

Un scope precum patient/Observation.rs?category=laboratory limitează citirea la rezultatele de laborator; filtrul de categorie este aplicat de server. Un tip de resursă în afara grantului returnează 403; un pacient în afara grantului returnează 404, deci ID-urile nu pot fi interogate.

Reacția la revocare

Când persoana încheie o autorizație, următoarea cerere cu acel token eșuează, iar tokenul de reîmprospătare nu poate readuce accesul. Pentru a curăța imediat, abonați-vă la webhook-ul consent.revoked, care transportă grant_id, ID-ul pacientului pe care îl vedeți, scopurile și revoked_at.

await anpheros.webhooks.create('https://your.app/anpheros/hook', { events: ['consent.granted', 'consent.revoked'] });

Ce nu face Anpheros

Întrebări frecvente

Ce este o platformă de consimțământ al pacientului?

Software care înregistrează ce aplicații o persoană permite să acceseze datele sale de sănătate, impune acele alegeri la fiecare solicitare, arată persoanei cine a accesat ce și îi permite să retragă accesul. În Anpheros, consimțământul face parte din înregistrarea FHIR R4 în sine, mai degrabă decât un serviciu separat.

Ce standarde folosește Anpheros pentru consimțământul pacientului?

OAuth 2.1 cu PKCE pentru fluxul de autorizare și SMART on FHIR v2 patient scopes (patient/<Type>.<cruds> cu un filtru opțional ?category=) pentru ceea ce o aplicație poate citi sau scrie. OpenID Connect adaugă un ID token atunci când solicitați openid fhirUser.

Poate un pacient să limiteze accesul doar la o parte din datele sale?

Da. Accesul este limitat la tipurile de resurse și categoriile din scope-urile acordate, de exemplu, doar Observations de laborator. Orice altceva returnează o eroare.

Cât durează consimțământul?

Persoana alege 30, 90, 180 sau 365 de zile pe pagina de consimțământ. După aceea, grantul expiră și aplicația trebuie să solicite din nou.

Poate pacientul să vadă ce a făcut o aplicație cu accesul?

Da. Persoana vede fiecare aplicație cu acces, scope-urile și expirarea acesteia, precum și un jurnal de acces care listează ce a citit sau scris fiecare aplicație.

Ce se întâmplă când consimțământul este revocat?

Următoarea solicitare cu acel access token eșuează, refresh token-ul nu poate fi folosit pentru a obține unul nou, iar serverul dvs. primește un webhook consent.revoked dacă s-a abonat.

Conexe

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