openSenseMap MQTT Integration

MQTT client service for openSenseMap API. Connects to remote MQTT brokers and stores incoming messages in the database of openSenseMap. Communication with the main openSenseMap API is done through gRPC calls. You can find the .proto file in the osem-protos repository.

Configuration

Configuration is handled by node-config.

See config/default.json. You should at least configure the connection to the database and the certificates for GRPC. Certificates can either configured directly as strings or can take a path to a file in pem format.

{
  "grpc": {
    "certificates": {
      // example for path
      "ca_cert": "/etc/ssl/certs/My_CA.pem",
      // example for stringified certificate (sed -z 's/\n/\\n/g' < certificate.crt)
      "server_cert": "-----BEGIN CERTIFICATE-----\nMIIE9DCCAtygAwIBA ... ",
      "server_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIJKQIBAAKCAg ..."
    }
  },
  "openSenseMap-API-models": {
    "db": {
      // See example config json of @sensebox/opensensemap-api-models
      "mongo_uri"
    }
  }
}

Development

To get up and running for development run the following steps:

• Run npm install
• Run ./scripts/setup_certs.sh for generating development certificates.
• Set the MQTT URL in row 23 in ./seeds/devices.json
• Run docker-compose up -d

Environment variables

Its possible to supply your configuration json through the NODE_CONFIG environment variable. It is also possible to configure through custom environment variables:

Config key	Environment Variable	Description
mqtt_client.num_retries	OSEM_MQTT_NUM_RETRIES	Number of retries which the MQTT client takes until backing off
mqtt_client.retry_after_minutes	OSEM_MQTT_RETRY_AFTER_MINUTES	Minutes after the MQTT clients restarts connecting after errors
grpc.port	OSEM_MQTT_GRPC_PORT	Port on which the gRPC server listens
grpc.certificates.ca_cert	OSEM_MQTT_GRPC_CA_CERT	CA certificate for gRPC TLS client authentication. Can be specified either as path to a certificate file or the certificate directly.
grpc.certificates.server_cert	OSEM_MQTT_GRPC_SERVER_CERT	Server certificate for gRPC TLS client authentication. Can be specified either as path to a certificate file or the certificate directly.
grpc.certificates.server_key	OSEM_MQTT_GRPC_SERVER_KEY	Server certificate key for gRPC TLS client authentication. Can be specified either as path to a key file or the key directly.

Container images and Versions

Container images for this service are created on each push on Github Container Registry.

Stable versions should be tagged using npm version and git push --follow-tags origin master