Fejlesztőknek

Beteg hozzájárulási platform: hogyan működik a hozzájárulás, a hatókörök, a lejárati idő és a visszavonás egy egészségügyi adat API-ban

Mit kell tudnia egy beteg hozzájárulást segítő platformnak: a hozzájárulás mint első osztályú objektum hatókörökkel és lejárati idővel, azonnali hatályú visszavonás, egy hozzáférési napló, amit a beteg elolvashat, és AI által írt, jóváhagyásra váró tartalmak. Hogyan valósítja meg az Anpheros.

Szerző: Megjelent: 4 perc olvasási idő

A hozzájárulás az egészségügyi termékek azon része, amit senki sem akar megépíteni, és mindenki ellenőriz. Az „a felhasználó bejelölt egy négyzetet a regisztrációkor” nem felel meg a GDPR 9. cikkének, nem állja meg a helyét egy adatvédelmi felülvizsgálaton, és nem teszi lehetővé, hogy egy személy egy alkalmazásból való hozzáférését az account törlése nélkül vegye el. Ez az útmutató leírja, hogy mit kell tennie egy páciens hozzájárulási platformnak, és hogyan csinálja az Anpheros Platform, így Ön újra felhasználhatja ahelyett, hogy újraépítené.

Műszaki verzió fejlesztőknek: Páciens hozzájárulási platform · Hozzájárulás a developers.anpheros.com oldalon, kérésekkel, válaszokkal és korlátokkal. Ez az oldal a köznyelvű verzió.

Hozzájárulás mint objektum, nem mint jelző

Az Anpherosban a hozzájárulás egy engedély: egy személy, egy alkalmazás, hatókörök halmaza, egy cél, egy lejárati dátum. Akkor jön létre, amikor a személy jóváhagyja a hozzáférést a hozzájárulási oldalon, felsorolásra kerül ott, ahol a személy láthatja, és bármikor visszavonható. Minden kérésnél ellenőrzésre kerül.

  • Hatókörök mondják meg, hogy az alkalmazás mit olvashat vagy írhat: megfigyelések, állapotok, gyógyszerek, allergiák, dokumentumok és így tovább, opcionálisan kategória szerint szűkítve (például laboreredmények, de nem tünetek).
  • Időtartam a személy választja meg: 30, 90, 180 vagy 365 nap. Nincs „örökké”.
  • Visszavonás a következő kérésnél lép életbe. Az alkalmazás kap egy consent.revoked webhookot.
  • Cél rögzítésre kerül az engedéllyel, és megjelenik a személynek.

Hogyan kér egy alkalmazás

OAuth 2.1 PKCE-vel, SMART on FHIR standalone launch-al azoknak az alkalmazásoknak, amelyek már beszélnek SMART-ot. A személy bejelentkezik, látja, melyik alkalmazás kér, milyen hatóköröket és mennyi időre, és jóváhagyja vagy elutasítja. Az alkalmazás kap egy tokent, amely csak arra az egy páciensre és azokra a hatókörökre korlátozódik; egy projektkulcs soha nem helyettesíti a személy hozzájárulását.

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

A hozzáférési tokenek 30 percig, az újrafrissítő tokenek 30 napig élnek. A felfedezési dokumentumok a /.well-known/oauth-authorization-server és a /.well-known/smart-configuration címen találhatók.

Mit lát a páciens

A GET /me/patients/{id}/grants felsorolja az összes hozzáféréssel rendelkező alkalmazást, annak hatóköreit és lejárati dátumát. A …/grants/{grant}/access-log felsorolja, hogy mit olvasott vagy írt, a hozzájárulás alatt és a projekt saját kulcsával. format=fhir esetén a napló FHIR R4 AuditEvent erőforrások Bundle-jaként tér vissza, az IHE Basic Audit Log Patterns mintázat szerint. Az Anpheros Daily-ben ez a „Kapcsolatok” képernyő; a saját alkalmazása is mutathatja ugyanezt.

Olvasás írással szemben

Hozzájárulással egy szervezet látja a teljes rekordot, beleértve azt is, amit más klinikák írtak, de csak azt változtathatja vagy törölheti, amit maga írt. Minden erőforrás minden verziója rögzíti az azt író projektet; egy másik projekt által végzett írás elutasításra kerül magyarázattal. Minden írás egy Provenance erőforrást hoz létre, amely megnevezi az alkalmazást, azt a szervezetet, amely nevében eljárt, és a személyt.

AI ügynökök javasolnak, a személy dönt

Egy személy hozzájárulása alatt, egy AI ügynökként regisztrált alkalmazás által végzett írás nem kerül azonnal alkalmazásra. A platform érvényesíti, és 202 Accepted választ ad egy javaslat azonosítóval; a rekordban semmi sem változik. A személy látja a javaslatot, hogy mi az, és melyik alkalmazás küldte, és elfogadja vagy elutasítja. Egy elfogadott javaslat pontosan úgy kerül beírásra, ahogy elküldték, és AI-ként írtként jelölve. Így tud segíteni egy MCP-n keresztül csatlakoztatott asszisztens a rekord kitöltésében anélkül, hogy felügyelet nélkül írna bele.

Egy személy QR-kódon vagy linken keresztül is megoszthatja a rekordját. A POST /me/patients/{id}/shl létrehoz egy SMART Health Link-et a sürgősségi alhalmazhoz (allergiák, gyógyszerek, problémák, oltások) vagy a teljes Nemzetközi Betegösszefoglalóhoz, opcionális jelszóval és lejárati dátummal. Minden megnyitás a hozzáférési naplóban szerepel, és a link azonnal kikapcsolható. Bármely SMART Health Link olvasó megnyithatja.

A teljes modell, minden szabállyal, a developers.anpheros.com/guides/consent-model címen található.

Gyakori kérdések

Az engedély az operatív objektum, amelyet minden kérésnél ellenőriznek; a rekord FHIR Consent és Provenance erőforrásokat is tartalmaz, így más rendszerek is elolvashatják, mi lett megbeszélve, és ki mit írt. A hozzáférési napló FHIR AuditEvent formátumban érhető el.

Adhat a páciens hozzáférést a rekord csak egy részéhez?

Igen. A hatókörök erőforrástípusonként vannak, kategóriaszűrőkkel, és a személy a hozzájárulási oldalon választja meg őket. Egy alkalmazás csak laboreredményeket vagy csak gyógyszereket kérhet.

Mi történik, amikor lejár a hozzájárulás?

Az adott engedély alatti kérések a lejárattól kezdve 403-at adnak vissza. Az alkalmazás újra kérhet; a személy újra dönt. Semmi sem törlődik.

A visszavonás törli azt, amit az alkalmazás már elolvasott?

Egyetlen rendszer sem tudja „visszaolvasni” az adatokat. A visszavonás azonnal megállítja a további hozzáférést és rögzítésre kerül; amit az alkalmazás a saját oldalán tárolt, azt a GDPR szerinti saját kötelezettségei szabályozzák.

Hozzáférhet-e egy klinika egy rekordhoz a páciens hozzájárulása nélkül?

Egy projekt látja az általa létrehozott pácienseket. Másutt létrehozott rekord olvasása a személy engedélyét igényli. Nincs adminisztratív felülbírálat.

Ez az útmutató tájékoztató jellegű, és nem helyettesíti az orvosi tanácsot. Az egészségeddel kapcsolatos döntésekhez beszélj az orvosoddal. Vészhelyzet esetén hívd a 112-t.
A szerzőról
Adrian Kereky

Founder of Anpheros. An electronics engineer, he spent six years in autonomous driving, on automotive projects run in partnership with Samsung and NVIDIA, designing the architecture of driver-assistance and AI systems that run on NVIDIA chips with CUDA. He then built Anpheros: the patient-controlled medical record and the HL7 FHIR R4 platform it runs on.

Többet az Anpherosról és a szerzőről →

Tartsd magadnál az egészségügyi dokumentációdat

Az Anpheros Daily egy helyen tárolja a tüneteket, leleteket, gyógyszereket és dokumentumokat, szabványos formátumban, az irányításod alatt. Az Alap csomag ingyenes.

Szerezd meg az Anpheros Daily-t