# Beteg hozzájárulási platform egészségügyi alkalmazásokhoz

> Az adatrétegbe épített hozzájárulás: OAuth 2.1 és SMART hatókörök, a személy által választott cél és lejárati idő, egy általuk látható hozzáférési napló, visszavonás a következő kérésre, és ami az Ön alkalmazásának még birtokában van.

Source: https://developers.anpheros.com/hu/guides/patient-consent-platform

**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.

<!-- visual:consent-flow -->

## 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

<!-- visual:consent-controls -->

## 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.

```ts
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.

```ts
await anpheros.webhooks.create('https://your.app/anpheros/hook', { events: ['consent.granted', 'consent.revoked'] });
```

## Amit az Anpheros nem csinál

- Nem gyűjt hozzájárulást az adatelérésen kívüli célokra, mint például marketing vagy kutatásban való részvétel.
- Nem dönt a jogalapjáról. Az adateléréshez való hozzájárulás egy ellenőrzési pont; az adatvédelmi nyilatkozata, szerződései és feldolgozási nyilvántartásai továbbra is az Ön birtokában maradnak.
- Egy projekt saját API kulcsa látja azokat a betegeket, amelyeket a projekt létrehozott, engedély nélkül. A hozzájárulás szabályozza más alkalmazások általi hozzáférést.

## 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á.

<!-- visual:cta-consent -->

## Kapcsolódó

- [Hozzájárulási és hozzáférési modell](https://developers.anpheros.com/hu/guides/consent): a szabályok teljes egészében
- [Hitelesítés és OAuth](https://developers.anpheros.com/hu/guides/authentication): tokenek, scope-ok és a kódcsere
- [Beteg hozzájárulás implementálása SMART on FHIR használatával](https://developers.anpheros.com/hu/guides/smart-on-fhir-backend)
- [Webhookok](https://developers.anpheros.com/hu/guides/webhooks): `consent.granted` és `consent.revoked`
- [Orvosi adatproveniencia magyarázata](https://developers.anpheros.com/hu/guides/medical-data-provenance)
- [Longitudinális betegadat API](https://developers.anpheros.com/hu/guides/longitudinal-patient-data-api)