Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Zdravotnické API se souhlasem pacienta
Jak pacient uděluje přístup k záznamu přes rozsahy a doby trvání OAuth 2.1, jak je to zaznamenáno a lze odvolat, co to mění v návrhu aplikace a jak párová ID oddělují aplikace.
Zdravotní API s pacientovým souhlasem je takové, kde přístup k záznamu uděluje pacient, pro daný účel, na danou dobu, a pacient jej může vidět a zrušit, namísto jednorázového rozhodnutí organizace, která data drží. V Anpheros není souhlas polem, které nastavujete; je to mechanismus, kterým aplikace vůbec k záznamu přistupuje. Tato příručka vysvětluje, jak to funguje pro vývojáře a co to mění v návrhu aplikace.
Dva způsoby přístupu k záznamu
| Přístup organizace | Přístup udělený pacientem | |
|---|---|---|
| Kdo autorizuje | vaše organizace, prostřednictvím API klíče | pacient, prostřednictvím obrazovky souhlasu OAuth 2.1 |
| Typické použití | klinika nebo laboratoř zapisující výsledky, vaše vlastní aplikace zapisující jménem svých uživatelů | aplikace třetí strany, AI asistent, nástroj lékaře, rodinný příslušník |
| Rozsah | pacienti, které vaše organizace vytvořila nebo kteří jí byli sdíleni | rozsahy, které pacient přijal (patient/Observation.read, …) |
| Doba platnosti | po dobu platnosti klíče | doba, kterou pacient zvolil; obnovitelná, odvolatelná |
| Viditelné pro pacienta | ano, v logu přístupů | ano, s možností odvolání |
Obě cesty procházejí stejným API a stejným FHIR záznamem. Rozdíl je v tom, kdo drží klíč ke dveřím.
Tok souhlasu, krok za krokem
- Vaše aplikace odešle pacienta na autorizační koncový bod Anpheros s požadovanými rozsahy (scopes) a důvodem v prostém jazyce.
- Pacient vidí, co žádáte, zvolí dobu trvání a přijme nebo odmítne. Obrazovka je v jazyce pacienta.
- Obdržíte přístupový token omezený na tyto rozsahy a tohoto pacienta. Tokeny mají krátkou životnost; obnovovací tokeny (refresh tokens) platí po dobu souhlasu.
- Každé čtení a zápis s tímto tokenem je zaznamenáno pod názvem vaší aplikace. Pacient vidí záznam ve své aplikaci.
- Pokud pacient stáhne souhlas, další požadavek selže s jasnou chybou. Obdržíte webhook, abyste mohli provést úklid.
Tok je standardní OAuth 2.1 s PKCE a rozsahy SMART on FHIR, takže existující knihovny fungují. Průvodce Authentication and OAuth obsahuje přesné parametry a Consent and access model pravidla za ním.
Co se mění ve vaší aplikaci
- Žádáte méně. Rozsahy (scopes) jsou definovány pro každý typ zdroje a směr. Aplikace, která zaznamenává váhu, žádá o
Observation.read, nikoli o celý záznam. - Navrhujete pro odebrání. Přístup může kdykoli skončit. Ukládejte do cache málo, čtěte znovu, když je to potřeba, a zpracovávejte chybu odebrání jako normální stav.
- Získáváte důvěru zdarma. Pacienti vidí název vaší aplikace, k čemu má přístup a kdy naposledy něco přečetla. Aplikace, které se chovají dobře, jsou snadněji přijímány.
- Píšete s původem (provenance). Vše, co zapíšete, nese vaši aplikaci jako autora a, pokud je to relevantní, osobu, jejímž jménem. Pacient a jiné aplikace mohou rozlišit vaše data od jejich.
Identifikátory, které nepropouštějí informace
Každá aplikace vidí pacienta pod párovým identifikátorem: stejná osoba má v jedné aplikaci jiné ID než v jiné. Dvě aplikace nemohou spojit svá data o osobě bez souhlasu pacienta, i když jsou obě postaveny na Anpheros. Pro váš kód je to neviditelné; pro pacienta je to rozdíl mezi souhlasem a formalitou.
Rodiny a pečovatelé
Souhlas se vztahuje i na osoby, které spravují záznamy pro jiné: rodič pro dítě, dospělé dítě pro staršího rodiče. Záznam zůstává u účtu, který jej vytvořil; ostatní účty získávají přístup, který lze odejmout. Vaše aplikace vidí stejný mechanismus souhlasu, přičemž pečovatel je osoba, která jej přijímá.
Související
- Model souhlasu a přístupu
- Autentizace a OAuth
- Backend SMART on FHIR
- API pro zdravotnictví
- Zabezpečení, ochrana soukromí a rezidence dat
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card