Example: SMART App Launch using Smartbox and Keycloak

This example showcases the Smart App EHR and Patient launch flows.

Components

1. Smartbox FHIR server with SMART-on-FHIR support.

2. Keycloak Identity and Access Management solution that integrates with Aidbox through the IdentityProvider resource.

3. Growth Chart Smart App A SMART pediatric web application that displays patient growth charts based on their observations.

4. Demo Launcher Page A web page that emulates EHR patient context selection.

Prerequisites

• Docker

• Cloned repository: Github: Aidbox/examples

• Working directory: smart-app-launch-smartbox

To clone the repository and navigate to the smart-app-launch-smartbox directory, run:

git clone [e-mail]:Aidbox/examples.git && cd examples/smart-app-launch-smartbox

Edit a docker-compose.yaml file and paste there your license keys.

# docker-compose.yaml
...
services:
  portal:
    environment:
      AIDBOX_LICENSE: <YOUR_PORTAL_LICENSE>
...
  sandbox:
    environment:
      AIDBOX_LICENSE: <YOUR_SANDBOX_LICENSE>

Step 1: Run Demo Components

Start all the demo components by running:

docker compose up

Wait until all components are pulled and started. The components are accessible at:

• Aidbox - http://localhost:8888
• Keycloak - http://localhost:7777
• Growth Chart - http://localhost:9000
• Demo Launcher Page - http://localhost:7070/launcher.html

Step 2: Open launcher Page

Open the Demo Launcher Page.

• Left Side: A list of patients retrieved from Aidbox, simulating EHR patient context selection.

• Right Side: A Patient Standalone Launch with a pre-selected patient context, simulating a launch directly from the SMART App.

Step 3: Perform EHR Launch

3.1 Select a patient from the list on the left side and click the Launch Growth Chart App button to start the launch process. 3.2 On the Aidbox login screen, click the Sign in with Keycloak button. 3.3 Log in to Keycloak with username patient and password password 3.4 On the consent screen, allow all requested scopes. 3.5 View the patient's data in the Growth Chart app.

Step 4: Perform Patient Standalone Launch

4.1 Go back to the Demo Launcher 4.2 On the right side of the screen, click the Launch Growth Chart App button under Patient Standalone Launch. 4.2 On the consent screen, allow all requested scopes. 4.3 View the patient's data in the Growth Chart app.

EHR Launch Interaction Diagram