Configure FHIR Bridge

FHIR Bridge application uses HAPI FHIR validation API to perform the validation of FHIR resources.

Using the default configuration, the terminology validation is disabled and there is no control over the vocabulary used in the submitted resources.

However the application supports 3 different modes that might be activated using the following configuration property: fhir-bridge.fhir.validation.terminology.mode. The value of the property should be one of the enum values defines in the TerminologyValidationMode enumartion.

TerminologyValidationMode.NONE (default value)

No terminology checks executed on the submitted FHIR resources.

fhir-bridge:
  fhir:
    validation:
      terminology:
        mode: none

TerminologyValidationMode.INTERNAL

This mode enables the InMemoryTerminologyServerValidationSupport and CommonCodeSystemsTerminologyService provided by HAPI FHIR in order to perform the validation.

INFO: This mode allows to validate most of the terminologies defined as part of the FHIR specification. Other CodeSystems and ValueSets are ignored.

fhir-bridge:
  fhir:
    validation:
      terminology:
        mode: internal

TerminologyValidationMode.REMOTE

This mode validates the content of the submitted resources using a remote FHIR-based terminology server.

This last version of the FHIR-Bridge is now using the RemoteTerminologyServiceValidationSupport when the remote terminology validation is enabled.

WARNING: When this mode is enabled, the FHIR-Brdige validates all the terminology content using the remote server. Consequently, please make sure that the instance of the remote terminology server contains the mandatory CodeSystems and ValueSets.

fhir-bridge:
  fhir:
    validation:
      terminology:
        mode: remote
        server-base-url: https://fhir-terminology-server.ehrbase.org/fhir

WARNING: Do not forget to configure the remote terminology server URL using the property: fhir-bridge.fhir.validation.terminology.server-base-url

TerminologyValidationMode.MIXED

This mode combines the features of the TerminologyValidationMode.INTERNAL and the TerminologyValidationMode.REMOTE, as described above.

fhir-bridge:
  fhir:
    validation:
      terminology:
        mode: mixed
        server-base-url: https://fhir-terminology-server.ehrbase.org/fhir

WARNING: Do not forget to configure the remote terminology server URL using the property: fhir-bridge.fhir.validation.terminology.server-base-url

Two-Way SSL authentication

If the remote terminology server requires to establish a Two-Way SSL (Mutual Authentication) connection, the FHIR Bridge can setup the SSL context using few additional configuration properties:

fhir-bridge:
  fhir:
    validation:
      terminology:
        mode: mixed
        server-base-url: https://two-way-ssl.terminology-server.ehrbase.org/fhir
  http-client:
    ssl:
      enabled: true
      key-password:                        # Password used to access the key in the key store
      key-store:                           # Path to the key store that holds the SSL certificate
      key-store-password:                  # Password used to access the key store
      key-store-type:                      # Type of the key store
      trust-store:                         # Trust store that holds SSL certificates
      trust-store-password:                # Password used to access the trust store
      trust-store-type:                    # Type of the trust store