Launch Filter via the AWS Marketplace or the Microsoft Azure Marketplace. Note that EC2 instances and Azure VMs launched from the marketplaces are not immediately usable in a HIPAA-controlled environment. For example, when launched from one of the marketplaces, the underlying VM is not configured for full-disk encryption. Refer to your compliance officer for your organization’s requirements to satisfy all relevant regulations.
Interact with Filter
To begin, you can access Philter’s REST API via the
curl command. Philter, by default, will be configured with an HTTPS listener using a self-signed certificate. (It is recommended that prior to use in a production environment the self-signed certificate is replaced by a valid certificate owned by your organization.) See Philter’s full API for more details on the following commands.
Philter’s REST API, by default, listens on port
8080. This port can be changed in Philter’s configuration.
Removing PHI from Text
We can send text to filter to Philter with the command:
curl -k -X POST https://localhost:8080/api/filter -d @file.txt -H Content-Type "plain/text"
This command sends the contents of the file
file.txt to Philter. Philter will apply the enabled filters and return a JSON response containing the filtered text. (You can switch between JSON and plain text responses in Philter’s configuration.) Replace
localhost with the IP address or hostname of Philter if needed.
You can also send text directly in the request:
curl -k -X POST https://localhost:8080/api/filter --data "Your text goes here..." -H "Content-type: plain/text"
If you just want to detect PHI and not modify the text, the command is:
curl -k -X POST https://localhost:8080/api/detect -d @file.txt -H Content-Type "plain/text"
Like the previous command, this command sends the contents of the file
file.txt to Philter. However, with this command Philter only analyzes the text for PHI and returns a numeric response. The numeric response will have a minimum value of zero. The higher the value the more likely the text contains PHI. Replace
localhost with the IP address or hostname of Philter if needed. (The weighted values assigned to each type of PII/PHI can be customized in Philter’s configuration.)
You can also send the text directly in the request:
curl -k -X POST https://localhost:8080/api/detect --data "Your text goes here..." -H "Content-type: plain/text"
The following Philter API clients are available: