AnpherosAnpheros PlatformDevelopers

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.

How one consent works, end to end
  1. 1 · Your app asksOAuth 2.1 with PKCE: SMART scopes, a purpose and the patient's language
  2. 2 · The person decidesOn the Anpheros consent page: what, for whom and for how long — 30, 90, 180 or 365 days
  3. 3 · Your app readsOne patient's record, only the granted resource types and categories
  4. 4 · Every access is loggedThe person sees each read and write by your application
  5. 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

What the patient controls
WhoEach application is listed by name with its own grant
WhatResource types and categories, e.g. only laboratory Observations
WhyThe purpose your app declares is shown on the consent page
How long30, 90, 180 or 365 days; access ends by itself
What happenedAn access log of every read and write under the grant
StopRevocation takes effect on the next request

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

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ó

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Product updates by email

New features, guides and the end of the beta. One email a month at most.

Send me occasional Anpheros Platform updates by email (new features, API changes, guides). I'll confirm by email and can unsubscribe in one click from any email. Privacy