loxwebhook

README

Loxwebhook

Make selected Loxone virtual inputs securely available to any service that can send http requests.

State of development

Loxwebhook is in early development but it works stable for me without major issues like crashing service or messed up request. There are still some essential features missing so expect bigger changes that might change the request path, token handling or config values. All changes will be documented in the change log.

Features

• HTTPS encryption (LetsEncrypt)
• Token authorization

Overview example setup

Background

The Loxone Miniserver is able to accept http requests and many services are able to send them. This would be a nice, flexible and de facto standard way to connect different services to the Miniserver. Unfortunately, due to limited hardware ressources, the Miniserver only supports http basic auth over unencrypted connections and a quite complicated "hand crafted" encryption that no service I know supports.

Loxwebhook runs on a seperate server (a very low level device like a Raspberry Pi is more than sufficient) to offload the http encryption, protect the Miniserver against DOS attacks (Rate limit the requests) and adds an authentication layer based on tokens to authorize request.

Targets

• Config from config files, environment variables, and flags
• HTTPS encryption with LetsEncrypt
• Token authorization
• Support vitual inputs
• Support other inputs
• Rate limiting
• Run as systemd service
• Run as Windows service
• Provide binaries for Raspberry
• Provide binaries for x86 Linux
• Provide binaries for Windows
• Provide .deb packages for Raspian
• Encrypt Miniserver Communication and get rid of basic auth