health-apis-smart-cards
A Spring Boot application that issues verifiable health cards in accordance with the SMART Health Cards Framework. The underlying data is provided by the Data Query API.
System Components
The API Gateway handles authentication and rate limiting before traffic is received by Smart Cards.
- Kong is responsible for token validation and SMART-on-FHIR OAuth scope enforcement
- Smart Cards processes consumer requests for the
/Patient/<<id>>/$health-cards-issueendpoint - Data Query provides FHIR-compliant health data for the Patient, enforces additional authorization, and handles processing of private data
- Datamart is a database within the Corporate Data Warehouse that provides read-only data for Data Query (originating from VistA)
Modules
- pem-to-jwk - Simple utility to convert PEM-encoded keys to JWK
- smart-cards - Main API implementation
- smart-cards-mock-services - Mock FHIR server to support local development and integration tests
- smart-cards-tests - Integration tests
Local Development
Refer to health-apis-parent
for basic environment setup. (Java, Maven, Docker, etc.)
Execute mvn clean install to build all of the modules, then follow the local development
instructions for mock-services
and smart-cards.