PH Registry Anonymizing Data Upload Utility
The following are prerequisites to be able to install and use this
data upload utility:
- PHMS needs to be installed on the computer that will run
this utility and be able to access the database
- Any firewall must allow outbound TCP connections to port 8437 of host
phreg.galsoft.net (66.51.111.41)
Summary
- Installation
- Configuration
- PH Registry Certificates
- Inner workings of the utility
Assuming that PHMS installation is complete and database access is
successful, install the PH Registry data upload utility by using the
MSI installation package and following the prompts. The installer
will configure and start the service. This will upload anonymized PH
data to the central registry once a day once configured.
Fig 1. Main configuration page of the service. These
are required settings for the service to function
correctly
Main configuration utility page is shown to the right. It contains
all the required settings that need to be specified for the
utility to function correctly.
- Hospital ID: Hospital ID is a unique number supplied by the
PH Registry administrators
- Patient Type: PH Diagnosis Patients Only will only send
patient data to the central registry that is associated with
a valid PH Diagnosis. Patients without a valid PH Diagnosis
will be skipped. You may select to send all patient data if
your database only has PH patients but not all of them
have a specified PH diagnosis entered.
- Client Certificate Path/Key/Passphrase: Location of the
special encryption certificates is entered here. For more
information how to obtain these important files, see PH Registry Certificates. You must
also supply the passphrase (password) for the private
key.
- DB Username/Password: This is where you should enter the
username and password for the PHMS database. You may verify
that these values are correct by clicking on the "Number of
Patients Estimate" button. This utility uses the same ODBC
database connection as PHMS and the PH Registry data upload
service. If you receive an error that the data source cannot
be found, please (re-)install your PHMS installation on the
machine.
The second page of the configuration utility allows each center to
opt out from additional fields that will be sent to the
registry. Only numeric data fields are sent to the registry
with a few exceptions (see last section), so additional
opt-outs should not be required.
The certificate/key pair refers to files that hold setup data for
encryption connections. These files may be considered to be
special, very long passwords that identify you as a valid supplier
of data to the PH Registry. They also play an important role in
encrypting the data transfer connection between the local PH
database and the central registry.
The recommended procedure for obtaining and using the certificates
is as follows.
- Create a non-shared, safe folder on the PH database server
called PhRegCert
- Go to the certificate request page, and generate a certificate
request. The certificate request will be automatically forwarded
to the PH Registry operator. Make sure you save the Private Key
in the PhRegCert folder.
- The certificate should arrive in your e-mail after it was
verified and signed by the PH Registry staff. Save the
certificate file in the PhRegCert folder.
- Use the PH Upload Service configuration utility (see Start
Menu) to configure the PH Registry upload service specifying the
certificate location (step #3) and the private key location and
passphrase (step #2)
- Verify that the configuration by either restarting the PH
Upload Service or waiting a an hour or so. The service will log
information and errors in the Event Viewer.
The job of the data upload utility is to anonymize and upload the
data to the central registry. Only anonymous patient data is
sent. This is ensured though the following steps,
- Patient Id is scrambled with a random salt and passed
through a MD5 one-way-hash function. This anonymizes the
hospital patient ID while retaining the uniqueness of the record
in the data transfer.
- Patient birth date (age) has the day removed (reset to 1)
- With the exception of medication/allergy/secondary disease
name, only numeric data is transfered.
In addition data transfer and PH Registry is protected from rogue data
insertion through utilization of Public
Key Cryptography for encryption and authentication.
|