Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Zdravotnícke API so súhlasom pacienta
Ako pacient udeľuje prístup k záznamu prostredníctvom OAuth 2.1 scopes a trvania, ako je to zaznamenané a odvolateľné, čo to mení v dizajne aplikácie a ako párové ID oddeľujú aplikácie.
Zdravotnícke API s povolením pacienta je také, kde prístup k záznamu udeľuje pacient, na určitý účel, na určitý čas, a pacient ho môže vidieť a odvolať, namiesto toho, aby o ňom raz rozhodla organizácia, ktorá údaje vlastní. V Anpheros nie je povolenie poľom, ktoré nastavíte; je to mechanizmus, prostredníctvom ktorého aplikácia vôbec získa prístup k záznamu. Táto príručka vysvetľuje, ako to funguje pre vývojára a čo to mení v návrhu aplikácie.
Dva spôoby prístupu k záznamu
| Prístup organizácie | Prístup udelený pacientom | |
|---|---|---|
| Kto autorizuje | vaša organizácia, prostredníctvom API kľúča | pacient, prostredníctvom obrazovky súhlasu OAuth 2.1 |
| Typické použitie | klinika alebo laboratórium zapisujúce výsledky, vaša vlastná aplikácia zapisujúca v mene svojich používateľov | aplikácia tretej strany, AI asistent, nástroj lekára, člen rodiny |
| Rozsah | pacienti, ktorých vaša organizácia vytvorila alebo ktorí jej boli zdieľaní | rozsahy, ktoré pacient prijal (patient/Observation.read, …) |
| Trvanie | kým je kľúč platný | trvanie, ktoré si pacient zvolil; obnoviteľné, odvolateľné |
| Viditeľné pre pacienta | áno, v denníku prístupu | áno, s možnosťou odvolania |
Obidve cesty prechádzajú cez rovnaké API a rovnaký FHIR záznam. Rozdiel je v tom, kto drží kľúč k dverám.
Tok toku súhlasu, krok za krokom
- Vaša aplikácia odošle pacienta na autorizačný koncový bod Anpheros s požadovanými scopes a dôvodom v bežnom jazyku.
- Pacient vidí, o čo žiadate, vyberie si trvanie a prijme alebo odmietne. Obrazovka je v jazyku pacienta.
- Dostanete prístupový token obmedzený na tieto scopes a tohto pacienta. Tokeny majú krátku životnosť; obnovovacie tokeny vydržia tak dlho, ako súhlas.
- Každé čítanie a zápis s týmto tokenom je zaznamenané s názvom vašej aplikácie. Pacient vidí záznam vo svojej aplikácii.
- Ak pacient odvolá súhlas, ďalší požiadavka zlyhá s jasnou chybou. Dostanete webhook, aby ste mohli vykonať čistenie.
Tok je štandardný OAuth 2.1 s PKCE a SMART on FHIR scopes, takže existujúce knižnice fungujú. Sprievodca Authentication and OAuth obsahuje presné parametre a Consent and access model pravidlá za ním.
Čo to mení vo vašej aplikácii
- Pýtate sa na menej. Rozsahy sú na typ zdroja a smer. Aplikácia, ktorá zaznamenáva hmotnosť, žiada o
Observation.read, nie o celý záznam. - Navrhujete pre odvolanie. Prístup sa môže kedykoľvek skončiť. Cacheujte málo, čítajte znovu, keď je to potrebné, a spracujte chybu odvolania ako normálny stav.
- Získavate dôveru zadarmo. Pacienti vidia názov vašej aplikácie, k čomu má prístup a kedy naposledy niečo čítala. Aplikácie, ktoré sa správajú dobre, sa ľahšie prijímajú.
- Píšete s pôvodom. Všetko, čo napíšete, nesie vašu aplikáciu ako autora a, ak je to relevantné, osobu, v mene ktorej. Pacient a iné aplikácie dokážu rozlíšiť vaše dáta od ich.
Identifikátory, ktoré neprezrádzajú
Každá aplikácia vidí pacienta pod párovým identifikátorom: tá istá osoba má v tvojej aplikácii iné ID ako v inej. Dve aplikácie nemôžu spojiť svoje údaje o osobe bez súhlasu pacienta, aj keď sú obe postavené na Anpheros. Pre tvoj kód je to neviditeľné; pre pacienta je to rozdiel medzi súhlasom a formalitou.
Rodiny a opatrovatelia
Súhlas sa rozširuje na osoby, ktoré spravujú záznamy pre iných: rodič pre dieťa, dospelé dieťa pre starého rodiča. Záznam zostáva s účtom, ktorý ho vytvoril; iné účty získajú prístup, ktorý môže byť odvolaný. Vaša aplikácia vidí rovnaký mechanizmus súhlasu, pričom opatrovateľ je osoba, ktorá ho prijíma.
Súvisiace
- Model súhlasu a prístupu
- Autentizácia a OAuth
- Backend SMART on FHIR
- API pre zdravotníctvo
- Bezpečnosť, ochrana súkromia a lokalita údajov
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card