Smile CDR can be used as a host for deploying SMART on FHIR Apps.
On this page, we will be using Smile CDR to launch a SMART on FHIR App (or SMART App). To accomplish this, we will be using Smile CDR to perform in three primary roles:
First we need to sign into the Web Admin Console. This console can be used by administrators to configure almost all aspects of the system. Access the console using the appropriate URL:
To log into the console, enter your admin credentials.
To support launching and authorizing a SMART App, we will need to create a client definition.
In the Web Admin Console, click on Config
-> OpenID Connect Client
. You should now see a window like the following:
If you do not see the growth_chart
client in the list, you will need to create it.
Note: Alternatively, you may choose to create a client definition with Smile CDR's JSON Admin API.
Create a new client definition by clicking on Create Client
. Set the following details:
Client ID |
|
Client Name |
|
Client Secret | (none) |
Authorized Grant Types |
Implicit Authorization Code |
Access Token Validity |
|
Refresh Token Validity |
|
– Authorized Redirect URLs |
|
– Authorized Redirect URLs |
|
SMART Scopes: Scopes |
|
SMART Scopes: Auto-Approve Scopes | (none) |
Instead of manually creating the client definition, you can also use the JSON Admin API to create a client definition with the following cURL command:
Now that we've created a client definition, we're ready to launch a SMART on FHIR App.
The following URL is a SMART Launch URL. Note the following parameters:
iss
– The base URL for the FHIR endpoint. The app will load the server capability statement from this endpoint, which allows it to figure out where to authorize.launch
– This is intended to be a one-time nonce. In a real scenario this would be randomly generated.patientId
– The ID of the patient whose data is being accessed.You may open the following URL in a browser:
This URL will immediately redirect you to a Smile CDR login screen. The user whose credentials you use to log in must have the appropriate permission to read clinical data from the repository.
Use your admin credentials to sign in. You will be presented with a screen asking you to confirm that you wish to grant permission to the app.
Grant the app permission by clicking Authorize
. The SMART on FHIR Growth Chart App will then launch. Neat!