Example: SMART App Launch using Aidbox and Keycloak
This example showcases the Smart App EHR and Patient launch flows.
Components
Aidbox FHIR server with SMART-on-FHIR support.
Keycloak Identity and Access Management solution that integrates with Aidbox through the IdentityProvider resource.
Growth Chart Smart App A SMART pediatric web application that displays patient growth charts based on their observations.
Demo Launcher Page A web page that emulates EHR patient context selection.
Prerequisites
Cloned repository: Github: Aidbox/examples
Working directory:
smart-app-launch
To clone the repository and navigate to the smart-app-launch directory, run:
Step 1: Run Demo Components
Start all the demo components by running:
Wait until all components are pulled and started. The components are accessible at:
Aidbox - http://localhost:8080
Keycloak - http://localhost:8888
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
Last updated