Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Páciens hozzájárulási platform egészségügyi appoknak
A hozzájárulás beépítve az adatrétegbe: OAuth 2.1 és SMART scope-ok, cél és lejárati idő a személy által választva, egy hozzáférési napló, amit láthat, visszavonás a következő kérésre, és mi marad az app tulajdonában.
A beteg hozzájárulási platform lehetővé teszi a személy számára, hogy eldöntse, mely alkalmazások olvashatják vagy módosíthatják egészségügyi nyilvántartását, milyen célból és mennyi ideig, valamint lehetővé teszi számukra, hogy bármikor megtekintsék és visszavonják ezt a hozzáférést. Az Anpheros beépíti a hozzájárulást az adatrétegbe: egy alkalmazás csak a személy által az Anpheros hozzájárulási oldalán jóváhagyott engedélyen keresztül érheti el a beteg FHIR R4 rekordját, minden olvasás és írás ezen engedély alatt naplózásra kerül, ahol a személy láthatja azt, és a visszavonás a következő kérésre lép életbe. Ez az oldal bemutatja, hogyan működik ez, mit kell tennie az Ön alkalmazásának, és mit nem kell felépítenie.
- 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
Miért tartozik a hozzájárulás az adattárhoz
A legtöbb egészségügyi alkalmazás a hozzájárulást egy jelölőnégyzetként rögzíti a saját adatbázisában, majd az alkalmazáskódban érvényesíti azt. Ez addig működik, amíg egy második alkalmazás, egy klinikai integráció vagy egy AI funkció ugyanarra az adatra van szüksége: mindegyiknek újra kell implementálnia a szabályokat, és az illetőnek nincs egyetlen helye sem, ahol láthatná, kinek van hozzáférése. Amikor a rekordot tároló platform érvényesíti a hozzájárulást is, minden kliens ugyanazokat a szabályokat kapja, és az illető megkapja az alkalmazások listáját, amelyet áttekinthet.
| Hozzájárulás mint jelző az Ön alkalmazásában | Hozzájárulás az adattárban (Anpheros) | |
|---|---|---|
| Hol érvényesítik | Minden alkalmazás kódjában | Minden API kérésnél, a platform által |
| Hozzáférés hatóköre | Bármi, amit az alkalmazás olvasni dönt | Csak az engedélyezett erőforrás típusok és kategóriák |
| Lejárati idő | Ritkán implementálva | Az illető választja meg: 30, 90, 180 vagy 365 nap |
| Mit lát az illető | Az alkalmazástól függ | Minden alkalmazás, annak hatókörei és lejárati ideje, valamint egy hozzáférési napló |
| Visszavonás | Manuálisan kell terjeszteni | A következő kérés meghiúsul; az újratöltési token nem működik |
A páciens által vezérelt funkciók
Hogyan kér hozzájárulást az alkalmazása
Az Anpheros az OAuth 2.1-et használja PKCE-vel és SMART on FHIR v2 scope-okkal. Az Ön alkalmazása elküldi a személyt a hozzájárulási oldalra a szükséges scope-okkal és egy opcionális céllal; jóváhagyás után hozzáférési tokent (30 perc) és forgó frissítési tokent (30 nap) kap pontosan egy beteg számára.
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)
Egy scope, mint például a patient/Observation.rs?category=laboratory, korlátozza az olvasást a laboratóriumi eredményekre; a kategória szűrőt a szerver érvényesíti. A megadott engedélyen kívüli erőforrás típus 403-et; az engedélyen kívüli beteg 404-öt eredményez, így az azonosítók nem szondázhatók.
Visszavonásra való reagálás
Amikor a személy megszünteti az engedélyt, az adott tokennel érkező következő kérés meghiúsul, és a frissítési token nem tudja visszaállítani a hozzáférést. A azonnali tisztításhoz iratkozzon fel a consent.revoked webhookra, amely a grant_id, az Ön által látott betegazonosítót, a hatóköröket és a revoked_at tartalmazza.
await anpheros.webhooks.create('https://your.app/anpheros/hook', { events: ['consent.granted', 'consent.revoked'] });
Amit az Anpheros nem csinál
- Nem gyűjt hozzájárulást az adatelérésen kívüli célokra, mint például marketing vagy kutatásban való részvétel.
- Nem dönt a jogalapjáról. Az adateléréshez való hozzájárulás egy ellenőrzési pont; az adatvédelmi nyilatkozata, szerződései és feldolgozási nyilvántartásai továbbra is az Ön birtokában maradnak.
- Egy projekt saját API kulcsa látja azokat a betegeket, amelyeket a projekt létrehozott, engedély nélkül. A hozzájárulás szabályozza más alkalmazások általi hozzáférést.
Gyakran ismételt kérdések
Mi az a beteg hozzájárulási platform?
Olyan szoftver, amely rögzíti, hogy egy személy mely alkalmazásoknak engedélyezi egészségügyi adataihoz való hozzáférést, érvényesíti ezeket a választásokat minden kérésnél, megmutatja a személynek, ki mit ért el, és lehetővé teszi a hozzáférés visszavonását. Az Anpherosban a hozzájárulás a FHIR R4 rekord részét képezi, nem pedig egy különálló szolgáltatás.
Milyen szabványokat használ az Anpheros a beteg hozzájáruláshoz?
OAuth 2.1 PKCE-vel az engedélyezési folyamathoz, és SMART on FHIR v2 beteg hatókörök (patient/<Type>.<cruds> egy opcionális ?category= szűrővel) arra, hogy egy alkalmazás mit olvashat vagy írhat. Az OpenID Connect egy ID tokent ad hozzá, amikor openid fhirUser-et kér.
Korlátozhatja-e a beteg az adatainak csak egy részéhez való hozzáférést?
Igen. A hozzáférés az engedélyezett hatókörökben szereplő erőforrás-típusokra és kategóriákra korlátozódik, például csak laboratóriumi megfigyelésekre (Observations). Minden más hibaüzenetet eredményez.
Meddig érvényes a hozzájárulás?
A személy 30, 90, 180 vagy 365 napot választ a hozzájárulási oldalon. Ezt követően a grant lejár, és az alkalmazásnak újra kell kérnie.
Láthatja-e a beteg, hogy mit tett az alkalmazás a hozzáféréssel?
Igen. A személy látja az összes hozzáféréssel rendelkező alkalmazást, annak hatóköreit és lejárati idejét, valamint egy hozzáférési naplót, amely felsorolja, hogy az egyes alkalmazások mit olvastak vagy írtak.
Mi történik, amikor a hozzájárulást visszavonják?
Az adott hozzáférési tokennel érkező következő kérés meghiúsul, a frissítési token nem használható új lekérésére, és a szervere consent.revoked webhookot kap, ha előfizetett rá.
Kapcsolódó
- Hozzájárulási és hozzáférési modell: a szabályok teljes egészében
- Hitelesítés és OAuth: tokenek, scope-ok és a kódcsere
- Beteg hozzájárulás implementálása SMART on FHIR használatával
- Webhookok:
consent.grantedésconsent.revoked - Orvosi adatproveniencia magyarázata
- Longitudinális betegadat API
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card