SMART on FHIR

1. lépés: Rendszergazdai hozzájárulás beállítása az ügyfélalkalmazáshoz

A SMART FHIR-en való használatához először hitelesítenie kell és engedélyeznie kell az alkalmazást. Amikor első alkalommal használja a SMART-t az FHIR-en, rendszergazdai hozzájárulást is kell kapnia ahhoz, hogy az alkalmazás hozzáférhessen az FHIR-erőforrásokhoz.

Ha nem rendelkezik tulajdonosi szerepkörrel az alkalmazásban, lépjen kapcsolatba az alkalmazás tulajdonosával, és kérje meg őket, hogy adjanak rendszergazdai hozzájárulást Önnek az alkalmazásban.

Ha rendelkezik rendszergazdai jogosultságokkal, hajtsa végre az alábbi lépéseket, hogy közvetlenül rendszergazdai hozzájárulást adjon magának. (Később rendszergazdai hozzájárulást is adhat saját magának, amikor az alkalmazás kéri.) Ugyanezekkel a lépésekkel hozzáadhat más felhasználókat tulajdonosként, így megtekintheti és szerkesztheti az alkalmazásregisztrációt.

Ha saját magát vagy egy másik felhasználót szeretne hozzáadni egy alkalmazás tulajdonosaként:

1. Az Azure portálon lépjen a Microsoft Entra ID menüpontra.
2. A bal oldali menüben válassza az Alkalmazásregisztráció lehetőséget.
3. Keresse meg a létrehozott alkalmazásregisztrációt, majd válassza ki.
4. A bal oldali menü Kezelés területén válassza a Tulajdonosok lehetőséget.
5. Válassza a Tulajdonosok hozzáadása lehetőséget, majd adja hozzá saját magát vagy a rendszergazdai hozzájárulást kérni kívánt felhasználót.
6. Válassza a Mentés lehetőséget

2. lépés: A SMART engedélyezése FHIR-proxyn

A SMART on FHIR használatához az FHIR szolgáltatás URI-jának megfelelő azonosító URI-val kell Audience rendelkeznie. Az FHIR szolgáltatás standard konfigurációja a következő értéket https://fhir.azurehealthcareapis.comhasználjaAudience: . Beállíthatja azonban az FHIR szolgáltatás adott URL-címének megfelelő értéket is (például https://MYFHIRAPI.fhir.azurehealthcareapis.com). Erre a SMART on FHIR proxy használatakor van szükség.

Ha engedélyezni szeretné a SMART on FHIR proxyt az FHIR-példány hitelesítési beállításai között, jelölje be a SMART on FHIR proxy jelölőnégyzetet.

A SMART on FHIR proxy közvetítőként működik a SMART on FHIR alkalmazás és a Microsoft Entra ID között. A hitelesítési válasznak (a hitelesítési kódnak) az alkalmazás helyett a SMART on FHIR proxyra kell lépnie. A proxy ezután továbbítja a választ az alkalmazásnak.

A hitelesítési kód kétlépéses továbbítása miatt be kell állítania a Microsoft Entra-ügyfélalkalmazás válasz URL-címét (visszahívását) egy OLYAN URL-címre, amely a SMART on FHIR proxy válasz URL-címének és a SMART on FHIR alkalmazás válasz URL-címének kombinációja. Az egyesített válasz URL-címe a következő űrlapot használja.

https://MYFHIRAPI.azurehealthcareapis.com/AadSmartOnFhirProxy/callback/aHR0cHM6Ly9sb2NhbGhvc3Q6NTAwMS9zYW1wbGVhcHAvaW5kZXguaHRtbA

A válaszban aHR0cHM6Ly9sb2NhbGhvc3Q6NTAwMS9zYW1wbGVhcHAvaW5kZXguaHRtbA a SMART on FHIR alkalmazás válasz URL-címének EGY URL-címvédett, base64 kódolású verziója. A SMART on FHIR alkalmazásindító esetében, ha az alkalmazás helyileg fut, a válasz URL-címe .https://localhost:5001/sampleapp/index.html

A kombinált válasz URL-címet az alábbihoz hasonló szkripttel hozhatja létre.

$replyUrl = "https://localhost:5001/sampleapp/index.html"
$fhirServerUrl = "https://MYFHIRAPI.fhir.azurewebsites.net"
$bytes = [System.Text.Encoding]::UTF8.GetBytes($ReplyUrl)
$encodedText = [Convert]::ToBase64String($bytes)
$encodedText = $encodedText.TrimEnd('=');
$encodedText = $encodedText.Replace('/','_');
$encodedText = $encodedText.Replace('+','-');

$newReplyUrl = $FhirServerUrl.TrimEnd('/') + "/AadSmartOnFhirProxy/callback/" + $encodedText

Adja hozzá a válasz URL-címet a Korábban a Microsoft Entra ID-hoz létrehozott nyilvános ügyfélalkalmazáshoz.

3. lépés: Teszt beteg lekérése

Az FHIR szolgáltatás és a SMART on FHIR proxy teszteléséhez legalább egy betegnek kell az adatbázisban rendelkeznie. Ha még nem használta az API-t, és nincsenek adatai az adatbázisban, tekintse meg az FHIR szolgáltatás elérése REST-ügyféllel a páciens betöltéséhez című témakört. Jegyezze fel egy adott beteg azonosítóját.

4. lépés: A SMART letöltése az FHIR alkalmazásindítón

Az Azure-hoz készült nyílt forráskódú FHIR-kiszolgáló egy egyszerű SMART on FHIR alkalmazásindítót és egy minta SMART on FHIR alkalmazást tartalmaz. Ebben az oktatóanyagban használja ezt a SMART on FHIR alkalmazásindítót helyileg a beállítás teszteléséhez.

Klónozhatja a GitHub-adattárat, és az alábbi parancsokkal léphet az alkalmazáshoz.

git clone https://github.com/Microsoft/fhir-server
cd fhir-server/samples/apps/SmartLauncher

Az alkalmazásnak szüksége van néhány konfigurációs beállításra, amelyeket a következőben appsettings.jsonállíthat be:

{
    "FhirServerUrl": "https://MYFHIRAPI.fhir.azurehealthcareapis.com",
    "ClientId": "APP-ID",
    "DefaultSmartAppUrl": "/sampleapp/launch.html"
}

Javasoljuk, hogy használja a dotnet user-secrets funkciót:

dotnet user-secrets set FhirServerUrl https://MYFHIRAPI.fhir.azurehealthcareapis.com
dotnet user-secrets set ClientId <APP-ID>

Az alkalmazás futtatásához használja a következő parancsot:

dotnet run

5. lépés: A SMART tesztelése FHIR-proxyn

Miután elindította a SMART-t az FHIR alkalmazásindítón, a böngészőt https://localhost:5001a következőre irányíthatja:

A Beteg, a Találkozás vagy a Kezelő adatainak megadásakor láthatja, hogy a Bevezetés környezet frissül. Ha az FHIR szolgáltatást használja, az indítási környezet egyszerűen egy JSON-dokumentum, amely információkat tartalmaz a betegről, a kezelőorvosról és egyebekről. Ez az indítási környezet base64 kódolású, és a lekérdezési paraméterként launch a SMART on FHIR alkalmazásnak továbbítja. A SMART on FHIR specifikáció szerint ez a változó átlátszatlan a SMART on FHIR alkalmazás számára, és átadja az identitásszolgáltatónak.

A SMART on FHIR proxy ezeket az információkat használja a mezők kitöltésére a jogkivonat-válaszban. A SMART on FHIR alkalmazás ezen mezők használatával szabályozhatja , hogy melyik beteghez kér adatokat, és hogyan jeleníti meg az alkalmazást a képernyőn. A SMART on FHIR proxy a következő mezőket támogatja.

• patient
• encounter
• practitioner
• need_patient_banner
• smart_style_url

Ezek a mezők útmutatást nyújtanak az alkalmazásnak, de nem adnak át biztonsági információkat. A SMART on FHIR alkalmazás figyelmen kívül hagyhatja őket.

Figyelje meg, hogy a SMART on FHIR alkalmazásindítója frissíti a lap alján található Indítási URL-címet . A mintaalkalmazás elindításához válassza a Launch (Indítás ) lehetőséget, és az alábbihoz hasonlót kell látnia.

Vizsgálja meg a jogkivonat válaszát, hogy a rendszer hogyan továbbítja az indítási környezet mezőit az alkalmazásnak.