Digital Square E0 proposal: openIMIS Shelf Readiness
Teams:
Swiss TPH (Dragos Dobre Patrick Delcroix Marco Antonio Guimaraes Pereira)
SolDevelo (Kamil Madej (Deactivated) Damian Borowiecki Seweryn Niedzielski)
Timelines: 08.04.2021 -> 31.12.2021
Jira board: https://openimis.atlassian.net/jira/software/projects/OE0/boards/35
Objectives
The goal of this project is to improve the open-source Insurance Management Information System (openIMIS) interoperability layer for easier and more efficient integration with other health-related systems within OpenHIE (Open Health Information Exchange) architecture, and to allow an efficient installation procedure through enhanced packaging and documentation, and thus, to align the solution with the Instant OpenHIE project and initiative.
This page is dedicated to the Digital Square Notice E0 project and will be used to specify the developments and the realizations from this project.
From the initial proposal, only two Work Packages were awarded within this project:
The following sections will specify the changes and enhancements brought by this project to the two components from each WP.
openIMIS FHIR Module
FHIR release four (R4) integration
FHIR R4 extensions development
FHIR Authentication and Authorisation
FHIR Authentication
The objective is to manage User authentication directly from the FHIR module. The JWT authentication mechanism is used. FHIR module is using the authentication services so the token can be used in both FHIR REST API and GraphQL queries.
FHIR REST API Login endpoint
POST /api_fhir_r4/login Request body: { "username": [username], "password": [password] } HTTP 200 Response body: { "token": [token] "exp": [expire_date] } HTTP 401 Response if credentials are not valid
FHIR REST API Authorization header
All other FHIR R4 requests should contain the Authorization header with the Bearer token.
Authorization: Bearer [token] HTTP 200 Response when token validated (the actual resource payload is returned) HTTP 401 Response when: if Authorization header is missing if Bearer prefix is missing if error on decoding Authorization header if token is expired
FHIR Authorisation
Related pages: