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 Authentication header
All other FHIR R4 requests should contain the Authentication header with the Bearer token.
Authentication: Bearer [token] HTTP 401 Response when: if Authentication header is missing if Bearer prefix is missing if error on decoding Authentication header if token is expired
FHIR Authorisation
Related pages: