Skip to content

Process Report Configuration v1.0.x.x

Jump to bottom
Reto Wettstein edited this page Jun 11, 2024 · 1 revision

The report process can be configured using the following mandatory and optional environment variables depending on the organization's role. Add the necessary environment variables to the /opt/bpe/docker-compose.yml file of your BPE.

Important:

To receive eMail notifications, configure the e-mail environment variables described as part of the DSF BPE deployment starting with DEV_DSF_BPE_MAIL_....

DIC Mandatory

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_BASE_URL

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.base.url
  • Required: Yes
  • Processes: medizininformatik-initiativede_reportSend
  • Description: The base address of the FHIR server to read/store FHIR resources
  • Example: http://foo.bar/fhir

DIC as Needed

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_HRP_IDENTIFIER

  • Property: de.medizininformatik.initiative.report.dic.hrp.identifier
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: The identifier of the HRP which should receive the report
  • Recommendation: Only configure if more than one HRP exists in your network
  • Example: forschen-fuer-gesundheit.de

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_DATALOGGINGENABLED

  • Property: de.medizininformatik.initiative.report.dic.fhir.dataLoggingEnabled
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: To enable debug logging of FHIR resources set to true
  • Default: false

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_TRUST_CERTIFICATES

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.trust.certificates
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: PEM encoded file with one or more trusted root certificate to validate the FHIR server certificate when connecting via https
  • Recommendation: Use docker secret file to configure
  • Example: /run/secrets/hospital_ca.pem

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_BASICAUTH_USERNAME

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.basicauth.username
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: Basic authentication username, set if the server containing the FHIR data requests authentication using basic auth

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_BASICAUTH_PASSWORD or DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_BASICAUTH_PASSWORD_FILE

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.basicauth.password
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: Basic authentication password, set if the server containing the FHIR data requests authentication using basic auth
  • Recommendation: Use docker secret file to configure by using DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_BASICAUTH_PASSWORD_FILE
  • Example: /run/secrets/fhir_server_basicauth.password

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_BEARER_TOKEN

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.bearer.token
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: Bearer token for authentication, set if the server containing the FHIR data requests authentication using a bearer token, cannot be set using docker secrets

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_CERTIFICATE

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.certificate
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: PEM encoded file with client-certificate, if FHIR server requires mutual TLS authentication
  • Recommendation: Use docker secret file to configure
  • Example: /run/secrets/fhir_server_client_certificate.pem

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_PRIVATE_KEY

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.private.key
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: Private key corresponding to the FHIR server client-certificate as PEM encoded file. Use DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_PRIVATE_KEY_PASSWORD or DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_PRIVATE_KEY_PASSWORD_FILE if private key is encrypted
  • Recommendation: Use docker secret file to configure
  • Example: /run/secrets/fhir_server_private_key.pem

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_PRIVATE_KEY_PASSWORD or DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_PRIVATE_KEY_PASSWORD_FILE

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.private.key.password
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: Password to decrypt the FHIR server client-certificate encrypted private key
  • Recommendation: Use docker secret file to configure by using DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_PRIVATE_KEY_PASSWORD_FILE
  • Example: /run/secrets/fhir_server_private_key.pem.password

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_PROXY_URL

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.proxy.url
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: Proxy location, set if the server containing the FHIR data can only be reached through a proxy
  • Example: http://proxy.foo:8080

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_PROXY_USERNAME

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.proxy.username
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: Proxy username, set if the server containing the FHIR data can only be reached through a proxy which requests authentication

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_PROXY_PASSWORD or DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_PROXY_PASSWORD_FILE

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.proxy.password
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: Proxy password, set if the server containing the FHIR data can only be reached through a proxy which requests authentication
  • Recommendation: Use docker secret file to configure by using DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_PROXY_PASSWORD_FILE

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_CLIENT_VERBOSE

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.client.verbose
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: The client will log additional debug output
  • Recommendation: Change default value only if exceptions occur
  • Default: false

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_TIMEOUT_CONNECT

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.timeout.connect
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: The timeout in milliseconds until a connection is established between the client and the FHIR server
  • Recommendation: Change default value only if timeout exceptions occur
  • Default: 20000

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_TIMEOUT_CONNECTION_REQUEST

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.timeout.connection.request
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: The timeout in milliseconds used when requesting a connection from the connection manager between the client and the FHIR server
  • Recommendation: Change default value only if timeout exceptions occur
  • Default: 20000

DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_TIMEOUT_SOCKET

  • Property: de.medizininformatik.initiative.report.dic.fhir.server.timeout.socket
  • Required: No
  • Processes: medizininformatik-initiativede_reportSend
  • Description: Maximum period of inactivity in milliseconds between two consecutive data packets of the client and the FHIR server
  • Recommendation: Change default value only if timeout exceptions occur
  • Default: 60000

HRP Mandatory / as Needed

There are no mandatory or optional configuration parameters for the HRP.

Clone this wiki locally