Skip to content

BloomFilter Support

Compare
Choose a tag to compare
@hhund hhund released this 03 Jun 22:13
· 348 commits to main since this release
v0.3.1
2037952

Second Test Release of the codex data-transfer processes for use with data integration centers, the GECCO transfer hub and the central research repository. This release adds the support to resolve Bloom Filters from the data integration center at the federated Trusted Third Party (fTTP). Bloom Filters can be added to Patient resources as Identifier using the system http://www.netzwerk-universitaetsmedizin.de/sid/bloom-filter and the BloomFilter Base64 encoded as the value.

Example Task-Resources to start the trigger and send processes can be found here. Transaction-Bundles with example Patient-Resources amongst others can be found here. The Patient-Resources have either an identifier with a DIC pseudonym or Bloom Filter. The BPMN diagrams for the data transfer processes can be found here.

Upgrading from 0.2.2: 1.) Stop BPE, 2.) Delete codex-process-data-transfer-0.2.2.jar, 3.) Start BPE, 4.) Stop BPE, 5.) Add codex-process-data-transfer-0.3.1.jar, 6.) Start BPE.

The DSF process plugin can be found here: codex-process-data-transfer-0.3.1.jar This process-plugin requires hapi-fhir-client-5.1.0.jar to be installed as a regular DSF BPE plugin. Access to non DSF systems is simulated if not configured or implemented. The following configuration properties can or need to be set:

DIC - Data Integration Center

  • Prerequisite: DSF BPE Plugin: hapi-fhir-client-5.1.0.jar
  • CRR public-key location (4096 Bit RSA PEM encoded file expected)
    de.netzwerk_universitaetsmedizin.codex.crr.publicKey
    Ask CRR for public-key
  • Local FHIR store
    de.netzwerk_universitaetsmedizin.codex.fhir.serverBase (http...)
    de.netzwerk_universitaetsmedizin.codex.fhir.username (if needed)
    de.netzwerk_universitaetsmedizin.codex.fhir.password (if needed)
    de.netzwerk_universitaetsmedizin.codex.fhir.bearerToken (if needed)
  • fTTP connection to resolve Bloom Filters (only needed if Patient resources in the local FHIR store contain a Bloom Filter)
    de.netzwerk_universitaetsmedizin.codex.fttp.serverBase(http...)
    de.netzwerk_universitaetsmedizin.codex.fttp.trustStore
    de.netzwerk_universitaetsmedizin.codex.fttp.certificate
    de.netzwerk_universitaetsmedizin.codex.fttp.privateKey
    de.netzwerk_universitaetsmedizin.codex.fttp.basicAuthUsername (if second factor is not based on IP address)
    de.netzwerk_universitaetsmedizin.codex.fttp.basicAuthPassword (if second factor is not based on IP address)
    de.netzwerk_universitaetsmedizin.codex.fttp.apiKey
    de.netzwerk_universitaetsmedizin.codex.fttp.target (e.g. dic_heidelberg)
  • Local consent provider
    No implementation yet.
  • Process exclude config
    org.highmed.dsf.bpe.process.excluded=dataTranslate/0.3.1,dataReceive/0.3.1

GTH - GECCO Transfer Hub

  • fTTP
    de.netzwerk_universitaetsmedizin.codex.fttp.trustStore (PEM encoded file with one or more certificates)
    de.netzwerk_universitaetsmedizin.codex.fttp.certificate (PEM encoded file with single certificate)
    de.netzwerk_universitaetsmedizin.codex.fttp.privateKey (PEM encoded, not encrypted key file)
    de.netzwerk_universitaetsmedizin.codex.fttp.serverBase (http...)
    de.netzwerk_universitaetsmedizin.codex.fttp.apiKey
  • Process exclude config
    org.highmed.dsf.bpe.process.excluded=dataTrigger/0.3.1,dataSend/0.3.1,dataReceive/0.3.1

CRR - Central Research Repository

  • Prerequisite: DSF BPE Plugin: hapi-fhir-client-5.1.0.jar
  • CRR private-key location (4096 Bit RSA PEM encoded, not encrypted file expected)
    de.netzwerk_universitaetsmedizin.codex.crr.privateKey
    Generate key-pair using:
    openssl genrsa -out keypair.pem 4096
    openssl rsa -in keypair.pem -pubout -out crr_public-key.pem
    openssl pkcs8 -topk8 -inform PEM -outform PEM -nocrypt -in keypair.pem -out crr_private-key.pem
  • Local FHIR store
    de.netzwerk_universitaetsmedizin.codex.fhir.serverBase (http...)
    de.netzwerk_universitaetsmedizin.codex.fhir.username (if needed)
    de.netzwerk_universitaetsmedizin.codex.fhir.password (if needed)
    de.netzwerk_universitaetsmedizin.codex.fhir.bearerToken (if needed)
  • Process exclude config
    org.highmed.dsf.bpe.process.excluded=dataTrigger/0.3.1,dataSend/0.3.1,dataTranslate/0.3.1