SMART on FHIR

1. Adım: İstemci uygulamanız için yönetici onayı ayarlama

FHIR'de SMART kullanmak için önce uygulamanın kimliğini doğrulamanız ve yetkilendirmeniz gerekir. FHIR'de SMART'ı ilk kez kullandığınızda, uygulamanın FHIR kaynaklarınıza erişmesine izin vermek için yönetici onayı da almanız gerekir.

Uygulamada sahiplik rolünüz yoksa uygulama sahibine başvurun ve uygulamadan sizin için yönetici onayı vermesini isteyin.

Yönetici ayrıcalıklarınız varsa, doğrudan kendinize yönetici onayı vermek için aşağıdaki adımları tamamlayın. (Daha sonra uygulamada istendiğinde kendinize yönetici onayı da vekleyebilirsiniz.) Uygulama kaydını görüntüleyebilmeleri ve düzenleyebilmeleri için diğer kullanıcıları sahip olarak eklemek için aynı adımları kullanabilirsiniz.

Kendinizi veya başka bir kullanıcıyı uygulamanın sahibi olarak eklemek için:

1. Azure Portal'da Microsoft Entra Kimlik'e gidin.
2. Soldaki menüde Uygulama Kaydı'nı seçin.
3. Oluşturduğunuz uygulama kaydını arayın ve seçin.
4. Soldaki menüde, Yönet'in altında Sahipler'i seçin.
5. Sahip ekle'yi seçin ve ardından kendinizi veya yönetici onayı almak istediğiniz kullanıcıyı ekleyin.
6. Kaydet'i seçin.

2. Adım: FHIR proxy'sinde SMART'ı etkinleştirme

FHIR üzerinde SMART, FHIR hizmetinin URI'sine eşit bir tanımlayıcı URI'sine sahip olmasını gerektirir Audience . FHIR hizmetinin standart yapılandırması değerini https://fhir.azurehealthcareapis.comkullanırAudience. Ancak, FHIR hizmetinizin belirli URL'si ile eşleşen bir değer de ayarlayabilirsiniz (örneğin https://MYFHIRAPI.fhir.azurehealthcareapis.com). Bu, FHIR proxy'sinde SMART ile çalışırken gereklidir.

FHIR örneğinizin Kimlik doğrulama ayarlarında FHIR'de SMART proxy'sini etkinleştirmek için FHIR proxy'sinde SMART onay kutusunu seçin.

FHIR üzerinde SMART proxy'si, FHIR üzerinde SMART uygulaması ile Microsoft Entra Id arasında bir aracı görevi görür. Kimlik doğrulama yanıtının (kimlik doğrulama kodu) uygulamanın kendisi yerine FHIR proxy'sinde SMART'a gitmesi gerekir. Proxy daha sonra yanıtı uygulamaya iletir.

Kimlik doğrulama kodunun bu iki aşamalı geçişi nedeniyle, Microsoft Entra istemci uygulamanızın yanıt URL'sini (geri çağırma) FHIR proxy'sinde SMART için yanıt URL'sinin ve FHIR üzerinde SMART uygulamasının yanıt URL'sinin bir bileşimi olan bir URL'ye ayarlamanız gerekir. Birleştirilmiş yanıt URL'si aşağıdaki formu alır.

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

Yanıtta, aHR0cHM6Ly9sb2NhbGhvc3Q6NTAwMS9zYW1wbGVhcHAvaW5kZXguaHRtbA FHIR üzerinde SMART uygulaması için yanıt URL'sinin URL güvenli, base64 kodlu bir sürümüdür. FHIR üzerinde SMART uygulama başlatıcısı için, uygulama yerel olarak çalışırken yanıt URL'si şeklindedir https://localhost:5001/sampleapp/index.html.

Aşağıdaki gibi bir betik kullanarak birleşik yanıt URL'sini oluşturabilirsiniz.

$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

Daha önce Microsoft Entra Id için oluşturduğunuz genel istemci uygulamasına yanıt URL'sini ekleyin.

3. Adım: Test hastası alma

FHIR hizmetini ve SMART'ı FHIR proxy'sinde test etmek için veritabanında en az bir hastanız olmalıdır. API'yi henüz kullanmadıysanız ve veritabanında veriniz yoksa bkz . Hasta yüklemek için REST İstemcisi'ni kullanarak FHIR hizmetine erişme. Belirli bir hastanın kimliğini not edin.

4. Adım: SMART on FHIR uygulama başlatıcısını indirme

Azure deposu için açık kaynak FHIR Sunucusu, basit bir FHIR üzerinde SMART uygulama başlatıcısı ve FHIR üzerinde SMART uygulaması içerir. Bu öğreticide, kurulumu test etmek için bu SMART on FHIR uygulama başlatıcısını yerel olarak kullanın.

Aşağıdaki komutları kullanarak GitHub deposunu kopyalayabilir ve uygulamaya gidebilirsiniz.

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

Uygulamanın içinde ayarlayabileceğiniz appsettings.jsonbirkaç yapılandırma ayarına ihtiyacı vardır:

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

Şu özelliği kullanmanızı dotnet user-secrets öneririz:

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

Uygulamayı çalıştırmak için aşağıdaki komutu kullanın:

dotnet run

5. Adım: FHIR proxy'sinde SMART'ı test edin

FHIR uygulama başlatıcıda SMART'yi başlattıktan sonra tarayıcınızı https://localhost:5001adresine işaret edebilirsiniz; burada aşağıdakileri görmeniz gerekir:

Patient, Encounter veya Practitioner bilgilerini girdiğinizde, Başlatma bağlamıngüncelleştirildiğini fark edeceksiniz. FHIR hizmetini kullanırken başlatma bağlamı hasta, uygulayıcı ve daha fazlası hakkında bilgi içeren bir JSON belgesidir. Bu başlatma bağlamı base64 kodlanır ve sorgu parametresi olarak FHIR üzerinde SMART uygulamasına launch geçirilir. SMART on FHIR belirtimine göre, bu değişken FHIR üzerinde SMART uygulamasına göre opaktır ve kimlik sağlayıcısına geçirilir.

FHIR üzerinde SMART proxy'si, belirteç yanıtında alanları doldurmak için bu bilgileri kullanır. FHIR üzerinde SMART uygulaması, hangi hasta için veri isteğinde bulunduğu ve uygulamayı ekranda nasıl işlediği denetlemek için bu alanları kullanabilir. FHIR üzerinde SMART proxy'si aşağıdaki alanları destekler.

• patient
• encounter
• practitioner
• need_patient_banner
• smart_style_url

Bu alanlar uygulamaya rehberlik sağlamaya yöneliktir, ancak herhangi bir güvenlik bilgisi iletmez. FHIR üzerinde SMART uygulaması bunları yoksayabilir.

FHIR üzerinde SMART uygulama başlatıcısının sayfanın en altındaki Başlatma URL'si bilgilerini güncelleştirdiğini unutmayın. Örnek uygulamayı başlatmak için Başlat'ı seçtiğinizde aşağıdakine benzer bir şey görmeniz gerekir.

Başlatma bağlamı alanlarının uygulamaya nasıl geçirildiğini görmek için belirteç yanıtını inceleyin.