# Klinikai hozzáférési kérelmek beteg jóváhagyással (CIBA)

> Az OpenID CIBA folyamat a klinikai hozzáférési kérelmek mögött: a recepció megadja a beteg e-mail címét, a beteg jóváhagyja az alkalmazásban vagy e-mailben 30, 90 vagy 365 napra, és a klinika alkalmazása megkapja a tokeneket.

Source: https://developers.anpheros.com/hu/guides/clinic-access-request

**Egy klinika csak akkor fér hozzá egy beteg rekordjához az Anpheros-on, amikor a beteg azt jóváhagyja.** A klinika alkalmazása egy kérést küld, amely megnevezi a beteg e-mail címét és a szükséges hozzáférést. A beteg ezt megkapja az Anpheros alkalmazásban és e-mailben, látja, ki kér és mire, kiválasztja, mennyi ideig engedélyezi, és jóváhagyja vagy elutasítja. Ha jóváhagyja, a klinika alkalmazása megkapja a tokeneket, és a hozzáférés lejártáig vagy a beteg visszavonásáig olvashatja a rekordot.

A folyamat a szabványos OpenID Connect Client-Initiated Backchannel Authentication (CIBA) folyamat, poll módban. Ez azért létezik, hogy a recepciósnak ne kelljen telefont vagy linket átadnia a betegnek: a kérés a beteghez jut el, nem a klinika képernyőjén keresztül.

## Lépésről lépésre

1.  **A recepció megadja a páciens e-mail címét.** A klinika alkalmazása meghívja a `POST /oauth/bc-authorize`-et az ügyfélhitelesítő adataival, a páciens e-mail címével mint `login_hint`, a szükséges `scope`-mal és egy rövid `binding_message`-vel, amelyet a páciens látni fog.
2.  **A platform minden címre ugyanúgy válaszol.** A válasz tartalmaz egy `auth_req_id`-öt, egy lejárati időt és egy lekérdezési intervallumot, attól függően, hogy az e-mail címhez tartozik-e Anpheros fiók. Nem derül ki, kinek van rekordja. Egy fiók nélküli személyre vonatkozó kérés egyszerűen lejár.
3.  **A páciens dönt.** Értesítést kap az Anpheros alkalmazásban és e-mailben. A kérés megjeleníti a szervezetet, a hatókört és az üzenetet. Kiválaszt egy időszakot 30, 90 vagy 365 napra, és megnyomja az engedélyezés vagy az elutasítás gombot. Az e-mailben található link nem hagy jóvá semmit megnyitáskor, mert a levelezési szkennerek megnyitják a linkeket; a páciensnek meg kell nyomnia a gombot.
4.  **A klinika lekérdez.** Az alkalmazás meghívja a `POST /oauth/token`-ot a `urn:openid:params:grant-type:ciba` grant type-al és a `auth_req_id`-al. Amíg a páciens nem döntött, a válasz `authorization_pending`. Jóváhagyás után a tokenek egyszer térnek vissza. Az elutasítás `access_denied`-et, a megválaszolatlan kérés pedig `expired_token`-et ad vissza.
5.  **A klinika olvas és ír az engedélyezett hatókörön belül.** Minden olvasási művelet naplózásra kerül, és látható a páciens számára. A klinika csak azt változtathatja meg vagy törölheti, amit maga írt.

## Mi védi a beteget

- **Csak ellenőrzött e-mail cím.** A kérés csak egy ellenőrzött e-mail címmel rendelkező fiókhoz illeszkedik, így senki sem kaphatja meg más személy kéréseit a saját címével történő fiók létrehozásával.
- **Hatókörrel és időkorláttal rendelkezik.** A hozzáférés erőforrástípusonként és műveletenként, meghatározott időszakra szól. Egy kérés, amelyre senki sem válaszol, alapértelmezés szerint egy napon belül, legfeljebb pedig hét napon belül lejár.
- **Bármikor visszavonható.** A visszavonás a következő kérésnél lép életbe. A klinika nem tudja magát újra bejelentkeztetni.
- **Látható.** A beteg minden csatlakozást és minden hozzáférést lát az alkalmazásban. Lásd: [hozzájárulási és hozzáférési modell](https://developers.anpheros.com/hu/guides/consent).

## Mit kell építenie egy klinikának

- Egy bizalmas OAuth kliens regisztrálva a platformon, titkos kódját a szerveren kell tárolni.
- Egy lekérdező ciklus, amely tiszteletben tartja az intervallumot és kezeli a négy kimenetelt.
- Egy mód a páciens döntésének megjelenítésére a recepción ("vár a páciensre", "jóváhagyva …-ig", "elutasítva").
- A visszaküldött tokenek rövid élettartamú hitelesítő adatokként való kezelése: az access tokenek 30 percig érvényesek, a refresh tokenek pedig minden használatkor rotálódnak. Lásd [hitelesítés és OAuth](https://developers.anpheros.com/hu/guides/authentication).

Egy olyan klinika számára, amely inkább a páciens előtt nyit meg egy hozzájárulási oldalt, például az asztalnál, a PKCE-vel és a SMART on FHIR standalone launch-al rendelkező standard engedélyezési kód folyamat is támogatott.

## Gyakran ismételt kérdések

### Kell a páciensnek klinikán tartózkodnia?

Nem. A jóváhagyást a saját telefonjukról vagy az e-mailben található linkről is megadhatják, bárhol is legyenek. Így egy kérést az időpont előtt is el lehet küldeni, és egy külföldön tartózkodó páciens is jóváhagyhatja azt.

### Mi van, ha a páciensnek nincs Anpheros fiókja?

A kérést elfogadják, majd döntés nélkül lejár, és a klinika nem tudja megállapítani, hogy létezik-e fiók. A páciens létrehozhat egy fiókot, és a klinika új kérést küldhet.

### Meddig tart a hozzáférés?

A páciens 30, 90 vagy 365 napot választ a jóváhagyáskor. Korábban is visszavonhatja.

### Láthatja a klinika a teljes rekordot?

Csak azt a hatókört, amit a páciens jóváhagyott. A hatókörök erőforrástípusonként és műveletenként vannak beállítva, és kategória szerint szűrhetők.

### A kérés folyamata szabványos?

Igen. Ez OpenID Connect CIBA, így meglévő OAuth könyvtárak használhatók. A szélesebb modellhez lásd a [healthcare API patient consent](https://developers.anpheros.com/hu/guides/healthcare-api-patient-consent) útmutatót.

### Ez élőben elérhető?

Igen, a platformon privát béta verzióban. A produkciós hozzáféréshez ellenőrzött szervezet és aláírt adatfeldolgozási megállapodás szükséges.

## Kapcsolódó

- [Betegadat-platform klinikák és kórházak számára](https://developers.anpheros.com/hu/guides/clinics-and-hospitals)
- [Beteghozzájárulási platform egészségügyi alkalmazásokhoz](https://developers.anpheros.com/hu/guides/patient-consent-platform)
- [Beteghozzájárulás implementálása SMART on FHIR segítségével](https://developers.anpheros.com/hu/guides/smart-on-fhir-backend)
- [Biztonság, adatvédelem és adattárolási hely](https://developers.anpheros.com/hu/guides/security)
