SMART diFHIR

Langkah 1: Atur persetujuan admin untuk aplikasi klien Anda

Untuk menggunakan SMART di FHIR, Anda harus terlebih dahulu mengautentikasi dan mengotorisasi aplikasi. Saat pertama kali menggunakan SMART di FHIR, Anda juga harus mendapatkan persetujuan administratif untuk mengizinkan aplikasi mengakses sumber daya FHIR Anda.

Jika Anda tidak memiliki peran kepemilikan di aplikasi, hubungi pemilik aplikasi dan minta mereka untuk memberikan persetujuan admin untuk Anda di aplikasi.

Jika Anda memiliki hak administratif, selesaikan langkah-langkah berikut untuk memberikan persetujuan admin kepada diri Anda secara langsung. (Anda juga dapat memberikan persetujuan admin kepada diri Anda nanti ketika diminta di aplikasi.) Anda dapat menggunakan langkah-langkah yang sama ini untuk menambahkan pengguna lain sebagai pemilik, sehingga mereka dapat melihat dan mengedit pendaftaran aplikasi.

Untuk menambahkan diri Anda atau pengguna lain sebagai pemilik aplikasi:

1. Di portal Azure, buka Microsoft Entra ID.
2. Di menu sebelah kiri, pilih Pendaftaran Aplikasi.
3. Cari pendaftaran aplikasi yang Anda buat, lalu pilih.
4. Di menu sebelah kiri, di bawah Kelola, pilih Pemilik.
5. Pilih Tambahkan pemilik, lalu tambahkan diri Anda atau pengguna yang ingin Anda setujui adminnya.
6. Pilih Simpan

Langkah 2: Aktifkan proksi SMART on FHIR

SMART di FHIR mengharuskan Audience URI pengidentifikasi memiliki URI yang sama dengan URI layanan FHIR. Konfigurasi standar layanan FHIR menggunakan Audience nilai https://fhir.azurehealthcareapis.com. Namun, Anda juga dapat menetapkan nilai yang cocok dengan URL tertentu dari layanan FHIR Anda (misalnya https://MYFHIRAPI.fhir.azurehealthcareapis.com). Ini diperlukan saat bekerja dengan proksi SMART on FHIR.

Untuk mengaktifkan proksi SMART on FHIR di pengaturan Autentikasi untuk instans FHIR Anda, pilih kotak centang PROKSI SMART on FHIR.

Proksi SMART on FHIR bertindak sebagai perantara antara SMART di aplikasi FHIR dan ID Microsoft Entra. Balasan autentikasi (kode autentikasi) harus masuk ke proksi SMART di FHIR alih-alih aplikasi itu sendiri. Proksi kemudian meneruskan balasan ke aplikasi.

Karena relai dua langkah kode autentikasi ini, Anda perlu mengatur URL balasan (panggilan balik) untuk aplikasi klien Microsoft Entra Anda ke URL yang merupakan kombinasi URL balasan untuk proksi SMART on FHIR, dan URL balasan untuk aplikasi SMART di FHIR. URL balasan gabungan mengambil formulir berikut.

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

Dalam balasan, aHR0cHM6Ly9sb2NhbGhvc3Q6NTAwMS9zYW1wbGVhcHAvaW5kZXguaHRtbA adalah versi URL yang aman dan dikodekan dengan URL balasan base64 yang aman untuk SMART di aplikasi FHIR. Untuk peluncur aplikasi SMART on FHIR, saat aplikasi berjalan secara lokal, URL balasannya adalah https://localhost:5001/sampleapp/index.html.

Anda dapat membuat URL balasan gabungan dengan menggunakan skrip seperti berikut ini.

$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

Tambahkan URL balasan ke aplikasi klien publik yang Anda buat sebelumnya untuk ID Microsoft Entra.

Langkah 3: Dapatkan pasien tes

Untuk menguji layanan FHIR dan proksi SMART on FHIR, Anda harus memiliki setidaknya satu pasien dalam database. Jika Anda belum menggunakan API, dan Anda belum memiliki data dalam database, lihat Mengakses layanan FHIR menggunakan Klien REST untuk memuat pasien. Catat ID pasien tertentu.

Langkah 4: Unduh SMART di peluncur aplikasi FHIR

Server FHIR sumber terbuka untuk repositori Azure mencakup SMART sederhana pada peluncur aplikasi FHIR dan sampel SMART di aplikasi FHIR. Dalam tutorial ini, gunakan SMART ini pada peluncur aplikasi FHIR secara lokal untuk menguji penyiapan.

Anda dapat mengkloning repositori GitHub dan membuka aplikasi dengan menggunakan perintah berikut.

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

Aplikasi ini membutuhkan beberapa pengaturan konfigurasi, yang dapat Anda atur di appsettings.json:

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

Kami sarankan Anda menggunakan fitur ini dotnet user-secrets :

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

Gunakan perintah berikut untuk menjalankan aplikasi:

dotnet run

Langkah 5: Uji proksi SMART on FHIR

Setelah memulai SMART pada peluncur aplikasi FHIR, Anda dapat mengarahkan browser ke https://localhost:5001, tempat Anda akan melihat hal berikut:

Saat Anda memasukkan informasi Pasien, Pertemuan, atau Praktisi, Anda melihat bahwa konteks Peluncuran diperbarui. Saat Anda menggunakan layanan FHIR, konteks peluncuran hanyalah dokumen JSON yang berisi informasi tentang pasien, praktisi, dan banyak lagi. Konteks peluncuran ini dikodekan base64 dan diteruskan ke SMART pada aplikasi FHIR sebagai launch parameter kueri. Menurut spesifikasi SMART on FHIR, variabel ini buram ke SMART pada aplikasi FHIR dan diteruskan ke IdP.

Proksi SMART on FHIR menggunakan informasi ini untuk mengisi bidang dalam respons token. Aplikasi SMART di FHIR dapat menggunakan bidang ini untuk mengontrol pasien mana yang diminta datanya, dan bagaimana aplikasi di layar dirender. Proksi SMART di FHIR mendukung bidang berikut.

• patient
• encounter
• practitioner
• need_patient_banner
• smart_style_url

Bidang ini dimaksudkan untuk memberikan panduan kepada aplikasi, tetapi tidak menyampaikan informasi keamanan apa pun. Aplikasi SMART di FHIR dapat mengabaikannya.

Perhatikan bahwa peluncur aplikasi SMART di FHIR memperbarui informasi Luncurkan URL di bagian bawah halaman. Pilih Luncurkan untuk memulai aplikasi sampel, dan Anda akan melihat sesuatu seperti berikut ini.

Periksa respons token untuk melihat bagaimana bidang konteks peluncuran diteruskan ke aplikasi.