/
Register Your App in the Logica Sandbox

Register Your App in the Logica Sandbox


Introduction

This guide walks you through the process of registering your SMART on FHIR app with your Logica Sandbox.After your app has been successfully launched using a custom launch, you may register it.  When you register your application, you will receive your Logica Sandbox client_id.  You will also be able to supply an app logo, redirect URL, and scopes for your application.  Typically an application is hosted on a company server before registering it.


Inbound (Dynamic) Registration

Manual Registration

Precondition: Create an app manifest

A SMART app manifest is an emerging standard that allows an app to declare registration information within the app bundle or hosting.  A registering system, such as a sandbox or EHR, is able to use the manifest to dynamically register the app. See https://bitbucket.org/hspconsortium/registration for details.

/.well-known/smart/manifest.json
{
  "software_id": "org.logicahealth.bilirubin:bilirubin-risk-chart:1.0-SNAPSHOT",
  "client_name": "Bilirubin Risk Chart",
  "client_uri": "https://apps.logicahealth.org/hspc-bilirubin-risk-chart/index.html",
  "logo_uri": "https://apps.logicahealth.org/hspc-bilirubin-risk-chart/static/bilirubin-chart/images/bilirubin.png",
  "launch_url": "https://apps.logicahealth.org/hspc-bilirubin-risk-chart/static/bilirubin-chart/launch.html",
  "redirect_uris": [
    "https://apps.logicahealth.org/hspc-bilirubin-risk-chart/static/bilirubin-chart/index.html"
  ],
  "scope": "launch online_access patient/Patient.read patient/Observation.read patient/Observation.write",
  "token_endpoint_auth_method": "none",
  "grant_types": [
    "authorization_code"
  ],
  "fhir_versions": [
    "1.0.2", "1.4", "1.6", "1.8"
  ]
}

Precondition: None

Step 1: Select Register Inbound App

From your sandbox instance, select "Apps" - "Register Manifest".

Step 2: Enter Your App Base URL

Enter the base URL of your hosted application.  The hosted app must meet these criteria:

  1. Contains .well-known/smart/manifest.json at the Base URL path
  2. Is hosted on HTTPS
  3. Contains proper CORS headers

Notice that your manifest is used to register your application!


Step 1: Select Register New App Manually

From your sandbox instance, select "Apps" - "Register Manually".

Step 2: Enter Information for Your App



Related content

Quick Start
Quick Start
More like this
Build Your App using the Logica Sandbox
Build Your App using the Logica Sandbox
More like this
FAQs
More like this
OAuth2 Authorization Walk-through
OAuth2 Authorization Walk-through
Read with this
Launch Your App from the Logica Sandbox
Launch Your App from the Logica Sandbox
More like this
Samples
Read with this