bhitsdev/context-handler repository overview

⁠Supported Source Code Tags and Current Dockerfile Link

2.0.0(latest)⁠, 1.11.0⁠, 1.8.0⁠

Current Dockerfile⁠

For more information about this image, the source code, and its history, please see the GitHub repository⁠.

⁠What is Context Handler?

The Context Handler API is a RESTful web service component of Consent2Share. It is responsible for sending XACML response context that includes authorization decisions along with applied policy obligations to Policy Enforcement Point (PEP) API components. The Context Handler sends the XACML request context to the Policy Decision Point (PDP). The PDP evaluates the applicable policies either from the Patient Consent Management (PCM) or a Fast Healthcare Interoperability Resource (FHIR) server against the request context, and returns the response context that includes authorization decisions along with obligations of applied policies to the Context Handler. The Context Handler sends XACML response context back to the PEP component. The PDP uses HERAS-AF⁠, an open source XACML 2.0 implementation, for XACML evaluation and uses either a PCM database as a local policy repository or a FHIR server to retrieve XACML policies that are generated from patients’ consents.

For more information and related downloads for Consent2Share, please visit Consent2Share⁠.

⁠How to use this Image

⁠Start a Context Handler Instance

Become familiar with the repository's README.md⁠ file before starting the instance.

docker run --name context-handler -d bhitsdev/context-handler:latest <additional program arguments>

NOTE: In order for this API to fully function as a microservice in the Consent2Share application, it is required to set up the dependency microservices and the support level infrastructure. Please refer to the Consent2Share Deployment Guide in the corresponding Consent2Share release (see Consent2Share Releases Page⁠) for instructions to set up the Consent2Share infrastructure.

⁠Configure

The Spring profiles application-default and docker are activated by default when building images.

This API can run with the default configuration which is from three places: bootstrap.yml, application.yml, and the data which the Configuration Server⁠ reads from the Configuration Data Git Repository. Both bootstrap.yml and application.yml files are located in the class path of the running application.

We recommend overriding the configuration as needed in the Configuration Data Git Repository, which is used by the Configuration Server.

Also, Spring Boot⁠ supports other ways to override the default configuration to configure the API for a certain deployment environment.

The following is an example to override the default database password:

docker run -d bhitsdev/context-handler:latest --spring.datasource.password=strongpassword

⁠Environment Variables

When you start the Context Handler image, you can edit the configuration of the Context Handler instance by passing one or more environment variables on the command line.

⁠JAR_FILE

This environment variable is used to set up which jar file will run. You need mount the jar file to the root of container.

docker run --name context-handler -e JAR_FILE="context-handler-latest.jar" -v "/path/on/dockerhost/context-handler-latest.jar:/context-handler-latest.jar" -d bhitsdev/context-handler:latest

⁠JAVA_OPTS

This environment variable is used to set up a JVM argument, such as memory configuration.

docker run --name context-handler -e "JAVA_OPTS=-Xms512m -Xmx700m -Xss1m" -d bhitsdev/context-handler:latest

⁠DEFAULT_PROGRAM_ARGS

This environment variable is used to set up an application argument. The default value is "--spring.profiles.active=application-default, docker".

docker run --name context-handler -e DEFAULT_PROGRAM_ARGS="--spring.profiles.active=application-default,ssl,docker" -d bhitsdev/context-handler:latest

⁠Supported Docker versions

This image is officially supported on Docker version 1.12.1.

Support for older versions (down to 1.6) is provided on a best-effort basis.

Please see the Docker installation documentation⁠ for details on how to upgrade your Docker daemon.

⁠License

View license⁠ information for the software contained in this image.

⁠User Feedback

⁠Documentation

Documentation for this image is stored in the bhitsdev/context-handler⁠ GitHub repository. Be sure to familiarize yourself with the repository's README.md file before attempting a pull request.

⁠Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue⁠.