View a markdown version of this page

在啟用 FHIR 的 HealthLake 資料存放區上建立 SMART - AWS HealthLake
建立資料存放區

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在啟用 FHIR 的 HealthLake 資料存放區上建立 SMART

若要搭配 HealthLake 使用 FHIR 上的 SMART 架構，請使用CreateFHIRDatastore請求中指定的 IdentityProviderConfiguration 參數建立 HealthLake 資料存放區。在 IdentityProviderConfiguration 參數中，您可以指定下列資訊：

  • 將 AuthorizationStrategy 設定為等於 SMART_ON_FHIR_V1。

  • 將 IdpLambdaArn 設定為等於 AWS Lambda 您建立的 ARN，以使用授權伺服器管理字符解碼。

  • 將授權伺服器中指定的中繼資料元素定義為 JSON 區塊。探索文件中會傳回這些中繼資料元素。

  • 選用：啟用 FineGrainedAuthorizationEnabled。指定 True 使用 HealthLake 提供的精細授權

注意

建立資料存放區之後，您可以使用 變更其身分提供者組態，包括 AuthorizationStrategy、Metadata、 IdpLambdaArn和 FineGrainedAuthorizationEnabled值UpdateFHIRDatastore。更新身分提供者組態會將其完全取代，因此請包含您要保留的每個欄位；您省略的任何欄位都會清除。身分提供者更新會立即生效，而且不會將資料存放區移至 UPDATING 狀態。如需詳細資訊，請參閱更新 HealthLake 資料存放區。

您可以使用 AWS Command Line Interface (AWS CLI) 或透過其中一個 AWS 支援的 SDKs 在啟用 FHIR 的資料存放區上建立 SMART。不支援使用 HealthLake 主控台在啟用 FHIR 的 HealthLake 資料存放區上建立 SMART。

使用 AWS CLI 在啟用 FHIR 的 HealthLake 資料存放區上建立 SMART

您可以使用下列程式碼範例，使用 在啟用 FHIR 的 HealthLake 資料存放區上建立 SMART AWS CLI。在啟用 FHIR 的 HealthLake 資料存放區上建立 SMART 時，您必須指定 identity-provider-configuration 參數。

在 identity-provider-configuration 參數中，您可以選擇性地啟用精細授權，方法是將 設定為FineGrainedAuthorizationEnabled等於 True。若要進一步了解精細授權，請參閱 在啟用 FHIR 的 HealthLake 資料存放區上搭配 SMART 使用精細授權。以下範例包含一個特殊字元\，用來表示換行或做為逸出字元。這是為了清楚起見。

aws healthlake create-fhir-datastore \
  --region us-east-1 \
  --datastore-name "your-data-store-name" \
  --datastore-type-version R4 \
  --preload-data-config PreloadDataType="SYNTHEA" \
  --sse-configuration '{ "KmsEncryptionConfig": { \
    "CmkType": "customer-managed-kms-key1",
    "KmsKeyId": "arn:aws:kms:us-east-1:your-account-id:key/your-key-id" } }' \
  --identity-provider-configuration  \
      '{"AuthorizationStrategy": "SMART_ON_FHIR_V1", \
      "FineGrainedAuthorizationEnabled": boolean-false-by-default, \
      "IdpLambdaArn": "arn:aws:lambda:your-region:your-account-id:function:your-lambda-name", \
      "Metadata": "{\"issuer\":\"https://ehr.example.com\",\"jwks_uri\":\"https://ehr.example.com/.well-known/jwks.json\",\"authorization_endpoint\":\"https://ehr.example.com/auth/authorize\",\"token_endpoint\":\"https://ehr.token.com/auth/token\",\"token_endpoint_auth_methods_supported\":[\"client_secret_basic\",\"foo\"],\"grant_types_supported\":[\"client_credentials\",\"foo\"],\"registration_endpoint\":\"https://ehr.example.com/auth/register\",\"scopes_supported\":[\"openid\",\"profile\",\"launch\"],\"response_types_supported\":[\"code\"],\"management_endpoint\":\"https://ehr.example.com/user/manage\",\"introspection_endpoint\":\"https://ehr.example.com/user/introspect\",\"revocation_endpoint\":\"https://ehr.example.com/user/revoke\",\"code_challenge_methods_supported\":[\"S256\"],\"capabilities\":[\"launch-ehr\",\"sso-openid-connect\",\"client-public\"]}"}'

成功時，您會收到下列 JSON 回應：

{
  "DatastoreArn": "arn:aws:healthlake:your-region:111122223333:datastore/fhir/your-datastore-id",
  "DatastoreEndpoint": "https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/",
  "DatastoreId": "your-data-store-id",
  "DatastoreStatus": "data-store-creation-status"
}