Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Egészségügyi API páciens hozzájárulással
Hogyan ad hozzáférést a páciens a rekordhoz OAuth 2.1 scope-okon és időtartamokon keresztül, hogyan naplózzuk és vonhatjuk vissza, mit változtat az alkalmazás tervezésén, és hogyan tartja távol egymástól az alkalmazásokat a páros azonosító.
A beteg beleegyezésével működő egészségügyi API olyan, ahol a beteg ad hozzáférést egy rekordhoz, egy célra, egy időre, és a beteg láthatja és visszavonhatja azt, ahelyett, hogy az adatok tulajdonos szervezete egyszer döntene róla. Az Anpherosban a beleegyezés nem egy beállítható mező; ez az a mechanizmus, amelyen keresztül egy alkalmazás egyáltalán elérhet egy rekordot. Ez az útmutató elmagyarázza, hogyan működik ez egy fejlesztő számára, és mit változtat egy alkalmazás tervezésén.
Két út a rekord eléréséhez
| Szervezeti hozzáférés | Beteg által engedélyezett hozzáférés | |
|---|---|---|
| Ki engedélyez | az Ön szervezete, egy API kulcs segítségével | a beteg, egy OAuth 2.1 hozzájárulási képernyőn keresztül |
| Tipikus felhasználás | egy klinika vagy laboratórium eredményeket ír, saját alkalmazása a felhasználói nevében ír | egy harmadik féltől származó alkalmazás, egy AI asszisztens, egy orvosi eszköz, egy családtag |
| Hatókör | azok a betegek, akiket az Ön szervezete hozott létre, vagy amelyeket megosztottak vele | a beteg által elfogadott hatókörök (patient/Observation.read, …) |
| Időtartam | amíg a kulcs érvényes | a beteg által választott időtartam; megújítható, visszavonható |
| Látható a beteg számára | igen, a hozzáférési naplóban | igen, visszavonási lehetőséggel |
Mindkét út ugyanazon az API-n és ugyanazon a FHIR rekordon keresztül vezet. A különbség az, hogy ki tartja a kulcsot az ajtóhoz.
A hozzájárulási folyamat, lépésről lépésre
- Az Ön alkalmazása elküldi a beteget az Anpheros engedélyezési végpontjára a szükséges scope-okkal és egy egyszerű nyelvezetű indoklással.
- A beteg látja, mit kér, kiválaszt egy időtartamot, és elfogadja vagy elutasítja. A képernyő a beteg nyelvén jelenik meg.
- Hozzáférési tokent kap, amely korlátozott az adott scope-okra és a betegre. A tokenek rövid életidejűek; a frissítési tokenek addig érvényesek, amíg a hozzájárulás.
- Minden ezzel a tokennel végzett olvasási és írási művelet naplózásra kerül az Ön alkalmazásának nevével. A beteg látja a naplót az alkalmazásában.
- Ha a beteg visszavonja a hozzájárulást, a következő kérés egy világos hibával meghiúsul. Webhookot kap, így tud tisztítani.
A folyamat szabványos OAuth 2.1 PKCE-vel és SMART on FHIR scope-okkal, így a meglévő könyvtárak működnek. Az Authentication and OAuth útmutató tartalmazza a pontos paramétereket, a Consent and access model pedig a mögöttes szabályokat.
Mi változik az alkalmazásában
- Kevesebbet kérdez. A hatókörök erőforrástípusonként és irányonként értelmezendők. Egy testsúlyt ábrázoló alkalmazás
Observation.read-t kérdez, nem a teljes rekordot. - Tervezzen a visszavonásra. A hozzáférés bármikor megszűnhet. Keveset gyorsítótárazzon, olvasson újra szükség szerint, és kezelje a visszavont hibát normál állapotként.
- Ingyen bizalmat kap. A betegek látják az Ön alkalmazásának nevét, mire fér hozzá, és mikor olvasott utoljára valamit. A jól működő alkalmazásokat könnyebb elfogadni.
- Származási információval ír. Minden, amit ír, az Ön alkalmazását mint szerzőt hordozza, és ha releváns, azt a személyt, akinek a nevében. A beteg és más alkalmazások meg tudják különböztetni az Ön adatait a sajátjuktól.
Identifikátorok, amelyek nem szivárognak
Minden alkalmazás páronkénti azonosító alatt látja a beteget: ugyanaz a személy más azonosítóval rendelkezik az Ön alkalmazásában és egy másikban. Két alkalmazás nem egyesítheti az egy személyre vonatkozó adataikat a beteg beleegyezése nélkül, még akkor sem, ha mindkettő az Anpheros-ra épül. Az Ön kódja számára ez láthatatlan; a beteg számára ez a különbség a beleegyezés és egy formalitás között.
Családtagok és gondozók
A hozzájárulás kiterjed azokra is, akik mások helyett kezelik a rekordokat: szülő gyermek helyett, felnőtt gyermek idős szülő helyett. A rekord a létrehozó fiókhoz kapcsolódik; más fiókok hozzáférést kapnak, amelyet visszavonhatnak. Az Ön alkalmazása ugyanazt a hozzájárulási mechanizmust látja, ahol a gondozó az, aki elfogadja.
Kapcsolódó
- Hozzájárulási és hozzáférési modell
- Hitelesítés és OAuth
- SMART on FHIR backend
- Egészségügyi API
- Biztonság, adatvédelem és adattárolás helye
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card