SMART على FHIR

الخطوة 1: تعيين موافقة المسؤول لتطبيق العميل الخاص بك

لاستخدام SMART على FHIR، يجب عليك أولا مصادقة التطبيق وتخويله. في المرة الأولى التي تستخدم فيها SMART على FHIR، يجب عليك أيضا الحصول على موافقة إدارية للسماح للتطبيق بالوصول إلى موارد FHIR الخاصة بك.

إذا لم يكن لديك دور ملكية في التطبيق، فاتصل بمالك التطبيق واطلب منه منح موافقة المسؤول لك في التطبيق.

إذا كان لديك امتيازات إدارية، فأكمل الخطوات التالية لمنح موافقة المسؤول لنفسك مباشرة. (يمكنك أيضا منح موافقة المسؤول لنفسك لاحقا عند مطالبتك في التطبيق.) يمكنك استخدام هذه الخطوات نفسها لإضافة مستخدمين آخرين كملاك، حتى يتمكنوا من عرض تسجيل التطبيق وتحريره.

لإضافة نفسك أو مستخدم آخر كمالك لتطبيق:

1. في مدخل Microsoft Azure، انتقل إلى معرف Microsoft Entra.
2. في القائمة اليسرى، حدد تسجيل التطبيق.
3. ابحث عن تسجيل التطبيق الذي أنشأته، ثم حدده.
4. في القائمة اليسرى، ضمن Manage، حدد Owners.
5. حدد إضافة مالكين، ثم أضف نفسك أو المستخدم الذي تريد الحصول على موافقة المسؤول.
6. حدد حفظ

الخطوة 2: تمكين SMART على وكيل FHIR

يتطلب SMART على FHIR أن Audience يحتوي على معرف URI يساوي URI لخدمة FHIR. يستخدم Audience التكوين القياسي لخدمة FHIR قيمة https://fhir.azurehealthcareapis.com. ومع ذلك، يمكنك أيضا تعيين قيمة مطابقة عنوان URL المحدد لخدمة FHIR (على سبيل المثال https://MYFHIRAPI.fhir.azurehealthcareapis.com). هذا مطلوب عند العمل مع SMART على وكيل FHIR.

لتمكين وكيل SMART على FHIR في إعدادات المصادقة لمثيل FHIR الخاص بك، حدد خانة الاختيار SMART على وكيل FHIR.

يعمل وكيل SMART على FHIR كوسيط بين تطبيق SMART على FHIR ومعرف Microsoft Entra. يجب أن ينتقل رد المصادقة (رمز المصادقة) إلى SMART على وكيل FHIR بدلا من التطبيق نفسه. ثم يقوم الوكيل بإعادة توجيه الرد إلى التطبيق.

وبسبب هذا الترحيل المكون من خطوتين من رمز المصادقة، تحتاج إلى تعيين عنوان URL للرد (رد الاتصال) لتطبيق عميل Microsoft Entra الخاص بك إلى عنوان URL الذي يعد مزيجا من عنوان URL للرد لوكيل SMART على FHIR وعنوان URL للرد لتطبيق SMART على FHIR. يتخذ عنوان URL للرد المدمج النموذج التالي.

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

في الرد، aHR0cHM6Ly9sb2NhbGhvc3Q6NTAwMS9zYW1wbGVhcHAvaW5kZXguaHRtbA هو إصدار آمن من عنوان URL مشفر ب base64 من عنوان URL للرد لتطبيق SMART على FHIR. بالنسبة لمشغل تطبيق SMART على FHIR، عند تشغيل التطبيق محليا، يكون عنوان URL للرد هو https://localhost:5001/sampleapp/index.html.

يمكنك إنشاء عنوان URL للرد المجمع باستخدام برنامج نصي مثل ما يلي.

$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

أضف عنوان URL للرد إلى تطبيق العميل العام الذي قمت بإنشائه مسبقا لمعرف Microsoft Entra.

الخطوة 3: الحصول على مريض اختبار

لاختبار خدمة FHIR وSMART على وكيل FHIR، تحتاج إلى وجود مريض واحد على الأقل في قاعدة البيانات. إذا لم تكن قد استخدمت واجهة برمجة التطبيقات بعد، ولم يكن لديك بيانات في قاعدة البيانات، فشاهد الوصول إلى خدمة FHIR باستخدام عميل REST لتحميل مريض. دون معرف مريض معين.

الخطوة 4: تنزيل مشغل تطبيق SMART على FHIR

يتضمن خادم FHIR مفتوح المصدر لمستودع Azure مشغل تطبيق SMART بسيط على FHIR ونموذج SMART على تطبيق FHIR. في هذا البرنامج التعليمي، استخدم هذا SMART على مشغل تطبيق FHIR محليا لاختبار الإعداد.

يمكنك استنساخ مستودع GitHub والانتقال إلى التطبيق باستخدام الأوامر التالية.

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

يحتاج التطبيق إلى بعض إعدادات التكوين، والتي يمكنك تعيينها في appsettings.json:

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

نوصي باستخدام الميزة dotnet user-secrets :

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

استخدم الأمر التالي لتشغيل التطبيق:

dotnet run

الخطوة 5: اختبار SMART على وكيل FHIR

بعد بدء تشغيل SMART على مشغل تطبيق FHIR، يمكنك توجيه المستعرض إلى https://localhost:5001، حيث يجب أن ترى ما يلي:

عند إدخال معلومات المريض أو اللقاء أو الممارس، ستلاحظ أنه يتم تحديث سياق التشغيل. عند استخدام خدمة FHIR، يكون سياق الإطلاق مجرد مستند JSON يحتوي على معلومات حول المريض والممارس والمزيد. سياق التشغيل هذا مرمز ب base64 وتم تمريره إلى تطبيق SMART على FHIR كمعلمة launch الاستعلام. وفقا لمواصفات SMART على FHIR، هذا المتغير معتم لتطبيق SMART على FHIR وتم تمريره إلى موفر الهوية.

يستخدم وكيل SMART على FHIR هذه المعلومات لملء الحقول في استجابة الرمز المميز. يمكن لتطبيق SMART على FHIR استخدام هذه الحقول للتحكم في المريض الذي يطلب البيانات له، وكيفية عرضه للتطبيق على الشاشة. يدعم وكيل SMART على FHIR الحقول التالية.

• patient
• encounter
• practitioner
• need_patient_banner
• smart_style_url

تهدف هذه الحقول إلى توفير إرشادات للتطبيق، ولكنها لا تنقل أي معلومات أمان. يمكن لتطبيق SMART على FHIR تجاهلها.

لاحظ أن مشغل تطبيق SMART على FHIR يقوم بتحديث معلومات Launch URL في أسفل الصفحة. حدد Launch لبدء تشغيل نموذج التطبيق، ويجب أن ترى شيئا مثل ما يلي.

افحص استجابة الرمز المميز لمعرفة كيفية تمرير حقول سياق التشغيل إلى التطبيق.