oitc/acs.smtp-bridge-service

By oitc

•Updated 4 months ago

OITC Access Control System: service to send access notifications by mail.

Image

Security

Message queues

454

Overview Tags

oitc/acs.smtp-bridge-service repository overview

⁠OITC Access Control System: SMTP bridge service

⁠Quick reference

Maintained by: Michael Oberdorf IT-Consulting⁠

Source code: GitHub⁠

Container image: DockerHub⁠

Access Control System documentation: ACS Documentation⁠

⁠Supported tags and respective `Dockerfile` links

latest, 1.0.0⁠

⁠Description

This service is part of the Michael Oberdorf IT-Consulting (OITC) Access Control System (ACS).

On accessing entry points, this information is available in the internal bus system. This service listens on these events and send them via Mail.

This service is NO standalone service. It requires an OITC ACS system to be running.

⁠Configuration

⁠Container configuration

The container get's the configuration from environment variables.

Variable name	Description	Required	Default value
`MQTT_SERVER`	The MQTT server hostname or IP address.	OPTIONAL	`localhost`
`MQTT_PORT`	The TCP port of the MQTT server.	OPTIONAL	`1883`
`MQTT_PROTOCOL_VERSION`	The MQTT protocol version to use. Currently supported `3` (means 3.1.1) and `5`.	OPTIONAL	`3`
`MQTT_TLS`	Should SSL communication be enabled (`true`) or not (`false`).	OPTIONAL	`false`
`MQTT_CACERT_FILE`	If TLS is enabled, the path to the CA certificate file to validate the MQTT server certificate.	OPTIONAL	`/etc/ssl/certs/ca-certificates.crt`
`MQTT_TLS_INSECURE`	If TLS is enabled, skip the hostname validation of the TLS certificate.	OPTIONAL	`false`
`MQTT_CLIENT_ID`	The MQTT client id to use for the MQTT connection.	OPTIONAL
`MQTT_USERNAME`	The MQTT username for MQTT authentication.	OPTIONAL
`MQTT_PASSWORD`	The MQTT password for MQTT authentication.	OPTIONAL
`MQTT_PASSWORD_FILE`	The filepath where the MQTT password is stored for MQTT authentication.	OPTIONAL
`MQTT_TOPIC_ACS_STATUS`	The MQTT topic to subscribe that contains the status messages of the ACS.	MANDATORY
`MQTT_TOPIC_DOOR_ACCESS`	The MQTT topic to subscribe that contains the door access information.	MANDATORY
`SMTP_SERVER`	The SMTP mailserver.	OPTIONAL	`localhost`
`SMTP_PORT`	The SMTP mailserver TCP port.	OPTIONAL	`25`
`SMTP_TLS`	Should SSL communication be enabled (`true`) or not (`false`).	OPTIONAL	`false`
`SMTP_USERNAME`	The SMTP username for SMTP authentication.	OPTIONAL
`SMTP_PASSWORD`	The SMTP password for SMTP authentication.	OPTIONAL
`SMTP_PASSWORD_FILE`	The filepath where the SMTP password is stored for SMTP authentication.	OPTIONAL
`SMTP_SENDER_ADDRESS`	The envelope sender address.	OPTIONAL	`acs@<hostname>`
`SMTP_RECIPIENTS_ADDRESSES`	Comma separated list of SMTP recipents.	MANDATORY
`SMTP_SUBJECT_PREFIX`	A prefic that will be always added to the SMTP subject.	OPTIONAL	`[OITC Access Control System]`
`SMTP_SEND_MAIL_BY_DEFAULT`	Overwrite send mail configuration and always send a mail notification.	OPTIONAL	`false`
`PROMETHEUS_LISTENER_ADDR`	The listener address to expose the prometheus exporter.	OPTIONAL	`0.0.0.0`
`PROMETHEUS_LISTENER_PORT`	The TCP listener port to expose the prometheus exporter.	OPTIONAL	`8080`
`TZ`	Timezone	OPTIONAL	`UTC`

HINT:

MQTT_PASSWORD_FILE will be priorized before MQTT_PASSWORD
SMTP_PASSWORD_FILE will be priorized before SMTP_PASSWORD

⁠Docker compose configuration

services:
  smtp-bridge-service:
    restart: always
    user: 2200:2200
    image: oitc/acs.smtp-bridge-service:latest
    environment:
      MQTT_SERVER: test.mosquitto.org
      MQTT_PORT: 1883
      MQTT_PROTOCOL_VERSION: 3
      MQTT_TOPIC_ACS_STATUS: location/oitc-acs/general/status
      MQTT_TOPIC_DOOR_ACCESS: location/oitc-acs/entrypoints/+/access
      SMTP_RECIPIENTS_ADDRESSES: "[email protected]"

A bigger example can be found here: docker-compose.yaml⁠

⁠MQTT message formats

Please have a look to the main documentation: MQTT message reference⁠

⁠Donate

I would appreciate a small donation to support the further development of my open source projects.

Tag summary

Recent tags

Content type

Image

Digest

sha256:18b76bd5c…

Size

28.5 MB

Last updated

4 months ago

docker pull oitc/acs.smtp-bridge-service