Middleware designed to improve interactions with the Withings (Nokia Health) API, and thus Withings devices.
Operates as part of the CONSULT architecture (device-intergration_nokia), a collaborative mobile decision-support system to help patients suffering from chronic diseases with multiple morbidities self-manage their treatment:
Cite as Computational argumentation-based clinical decision support. Chapman, Martin et al.. Proceedings of the 18th International Conference on Autonomous Agents and MultiAgent Systems. 2019.
Try a live demo.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
Before starting, download and install python, pip, virtualenv and Node.js.
Sends messages to: sensor-fhir-converter (install).
(Recommended) Create an SSH key and clone this repository.
git clone [email protected]:kclconsult/withings.git
(Alternative) Clone this repository using HTTPs, suppling username and password:
git clone https://github.com/kclconsult/withings.git
Configure submodules:
git submodule init
git submodule update
NB. If cloning over HTTPS, edit .gitmodules to reflect the HTTPS URL before running update, and then sync with git submodule sync
before updating.
View.
This is an express (lightweight server) project. The majority of the logic is contained within app.js, and in the routes and lib folders.
Once a file is edited, stage, commit and push changes from the root folder as follows:
git add .
git commit -m "[details of changes]"
git push
Modify config/default.js
to include the address of the sensor-fhir-converter service, callback base and other API endpoints, e.g.:
SENSOR_TO_FHIR_URL: '[sensor-fhir-converter service]'
If using a queue, also specify this in the config file, and supply the queue name.
Create an environment file:
touch .env
Add the following information to this environment file using a text editor:
USERNAME="[username]"
PASSWORD="[password]"
NOKIA_CONSUMER_KEY="[key]"
NOKIA_SECRET="[secret]"
NOKIA_CLIENT_ID="[client]"
NOKIA_CONSUMER_SECRET="[consumer]"
MYSQL_ROOT_PASSWORD="[mysql_root_password]"
MYSQL_DATABASE="[mysql_database]"
MYSQL_USER="[mysql_user]"
MYSQL_PASSWORD="[mysql_password]"
Where [username] and [password] are credentials to secure this service; [key], [secret], [client] and [consumer] are your Nokia details; and [mysql_*] refers to DB credentials.
Run db/encrypt/keys/db-encryption.sh.
Migrations can be reverse engineered from model updates using the makemigration command.
Ensure you are in the root folder. Create a node virtual environment (within a python virtual environment), and activate it:
virtualenv env
. env/bin/activate
pip install nodeenv
nodeenv nenv
. nenv/bin/activate
Install dependencies:
cat requirements.txt | xargs npm install -g
Run server:
npm start
The server runs by default on port 3000. Visit localhost:3000/[route] to test changes to GET endpoints and use software such as Postman to test changes to POST (and other) endpoints.
Run both unit and lint tests using npm
:
npm test
Deployment is via Docker, and includes containers for this application, a production SQL database and an optional reverse proxy. If using the reverse proxy, fill in the appropriate configuration.
Build these containers:
docker-compose build
Run these containers:
docker-compose up
(Optional) Run without proxy:
docker-compose up --scale proxy=0
Different docker-compose files exist to accomodate different service configurations.
To use custom private certificates for communication with this service's proxy, reference them in the proxy's Dockerfile. The gen-domain-cert script can be used to generate custom certs (e.g. 'grey.crt') using a CA root cert (e.g. 'consult.crt') and accompanying keys. If distributing an image outside of an organisation, edit Dockerfile and docker-compose to mount a volume on the host containing the certs instead, so that images are not transferred with the certs inside then.
For public certificates, certificate generation is via LetsEncrypt. Generate as follows:
- Remove references to certificates from Nginx HTTPS configuration, as running HTTP server is required for challenge.
- Change Cerbot command in docker-compose from
--force-renewal
to--dry-run
. - Build and run, and upon successful call of HTTP challenge, change back to
--force-renewal
and build and run again in order to generate certificates. - Re-add certificae configuration, build and run.
Renewal can be done on re-build, or by setting up a cron.
- Express - Web framework.
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
We use SemVer for versioning. For the versions available, see the tags on this repository.
Produced as part of the CONSULT project.
This project is licensed under the MIT License - see the LICENSE.md file for details.
- Nokia's original health API: https://developer.health.nokia.com/api.
- MaraiDB encryption guide: https://mariadb.com/kb/en/library/file-key-management-encryption-plugin/.