Hacking the Gira HomeServer

by Marcel Garus · 2021-10-05 · 8 minute read · tinkering with the Gira HomeServer · code · available at mgar.us/gira-hack

Our home has an intelligent electric grid controllable using KNX. A Gira HomeServer connects to the physical KNX wires and our WiFi network and enables us to control all devices using an app. In my previous article, I looked at how the Gira HomeServer communicates with the app. As a reminder, this is how the authentication phase works:


More specifically, the process works like this:

  1. The app asks to sign in using a username. (The first three comic boxes.)

  2. The server sends a salt, a random string of characters (for example, 245013621).

  3. The app calculates a mathematical hash function, using the salt, username, and password as inputs: hash(salt, username, password) Critically, the hash function is irreversible, so having the result doesn't allow you to make predictions about the inputs. In the previous article, we already discovered that the app uses the insecure MD5 hash function for parts of the password hash. The app sends the result to the server. The result is pretty long (something like A335F32830EAFB1534DE46EFEECF1A8C), so it's unlikely that the app gets this right by chance if it doesn't know the password.

  4. The server does the same hash calculation itself and checks if the results match. If they do, the app is authenticated and can control the devices in the home.

This process protects against other devices listening in on the communication. If a malicious device wants to sign in, it's given a different random salt and can't calculate the corresponding hash because it doesn't know the password.

While developing the app and tinkering with the authentication flow, I discovered a glaring security flaw: The server ignores step 4! Regardless of whether the password hash was correct, the server lets the app control all devices! 🤦

Exploiting this behavior looks like this in the comic version:


Note that the server doesn't send anything to the app, but it still executes commands. Such a simple and preventable bug indicates a fundamental flaw in Gira's organizational approach to security. A working security process doesn't let something like this happen.

Do you own a Gira HomeServer and want to see if you're affected? On GitHub, I published a program written in Dart that toggles all devices off (including alarm systems). You should please only test this in your own home.

How bad is it?

Let's take a step back and look at the impact of this hack. To be able to use it maliciously on other people's homes, they need to meet these preconditions:

If a home fulfills these criteria, you can control all devices in it. That includes not only lights but also critical devices, like blinds, thermostats, and alarm systems. The fact that I can turn off our alarm system without knowing the password is frightening.

To mitigate the risk for us, I turned off port forwarding in our router settings. Until Gira fixes the bug, having the public internet not reach the HomeServer is a good idea.

Communicating with Gira

At this point, it's relatively obvious that I need to contact Gira about this. Thankfully, there's a process for reporting security vulnerabilities: Responsible disclosure. This process works like this:

  1. Contact the responsible company privately.

  2. After a sufficient waiting period (hopefully after the vulnerability is fixed), make the vulnerability public so that others can learn from it.

So, in November 2017, I contacted Gira using their contact form:

(corrected typography and grammar)

To whom it may concern!

Since we got a Gira HomeServer, I thought it would be nice to control devices in our house with a simple programming interface. […] I realized you don't need the password hash to change device states. If you use a proper username and answer the password hash request with a random 32 character long string of hexadecimal digits, you are still logged in. In this case, you don't get notified about state changes of devices, but you can still change device states. […]

I took the GitHub repository offline, but I wanted to inform you about the problem so that you can fix the flaw.

Marcel, a 17 y/o hobby programmer

PS: Exploit as ZIP: https://drive.google.com/███████

On the next day, I promptly got a response:

Hi Marcel,

Thank you for this information.

Currently, we're working on the next version of HomeServer software. It will provide encrypted communication.

With kind regards

█████ ████████
Advanced Support Hotline Agent

To 17-year-old me, this sounded promising! A fix is already in the works, so it's probably okay to lean back and relax.

About half a year later, the bug still existed. Naturally, in May 2018, I contacted Gira again:

(translated from German)


pretty much half a year ago, I reported a critical security vulnerability in the Gira HomeServer 4 software (Gira message ██████), which allows attackers to turn off alarm systems if port forwarding is activated in the router's settings (for us, this was enabled by default). I have been assured that you are working on new software that supports encryption and closes this gaping security vulnerability.

Christmas has now passed; I turned 18 and graduated from high school. Since I now have free time again, I wanted to find out how the development of the new software is going.


The next day, a Gira spokesperson called me (the contact form had asked for a phone number) and personally assured me that the software would be published "in next year" (which would mean 2019).

Fast-forward to 2021. So much has happened in my life: I moved to Potsdam, started studying, and finished my Bachelor's. I recently visited my family, and while I was at home, I confirmed that the security flaw is still present. It's been multiple years and there are probably still vulnerable buildings out there – that's unacceptable. So, I published the vulnerability exploit on GitHub. Because of Corona, I have some spare time right now, so let's get to it:

(translated from German)

Hello again,

In 2017, I reported a critical security vulnerability in the Gira HomeServer. You can find a proof of concept exploit here: github.com/MarcelGarus/girahomeserver

After my last email, you assured me by phone in mid-2018 that a software update was being worked on, which should then be published "in the new year" (2019). It's now 2021, I've finished my Bachelor's degree, and the problem still exists with our Gira HomeServer. What is the status of the software update? In the meantime, I've written a blog article about the vulnerability that explains the problem in more detail: mgar.us/gira-hack

Best regards,

Update: Fair enough, I immediately got a response. Apparently, the behavior was fixed:

(translated from German)

Hello Mr. Garus,

Thank you very much for your email. Basically, we take such emails very seriously, and it goes without saying that we are interested in keeping the HomeServer and other products at a high-security standard.

In September 2018, we released version 4.7. It was clear to us that the unencrypted communication on port 80 can be read out, as you did in the end. In version 4.7, we could still activate tls1.0 as an option, but this has not worked for some versions because we no longer allow it for security reasons.

In the current version 4.11.1, communication via HTTP (port 80) can be used, but the standard is HTTPS (port 443). Unfortunately, it is not clear from your reports which firmware you ran the test with. In any case, a current, secure system would not be accessible on port 80. The way you described via port forwarding is no longer state of the art, and we openly declare it to be unsafe. We have the Gira S1 (order no. 208900), which is used to communicate from the WAN via an encrypted tunnel via the device portal.

Thank you very much for your commitment, and we look forward to further information like this one!

If you have any further questions, please do not hesitate to contact us on ████████████.

Kind regards,
██████████ ███████████
Technical hotline