Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

What is this?

This project illustrates how to use AcraCensor as SQL firewall to prevent SQL injections. Target application is a well-known vulnerable web application OWASP Mutillidae 2.

AcraCensor – is a built-in SQL firewall of Acra data protection suite. This project is one of numerous Acra's example applications. If you are curious about other Acra features, like transparent encryption, intrusion detection, load balancing support – Acra Example Applications.

What's inside?

The demo project has a Docker compose file that runs the following web infrastructure:

Acra works as a proxy between web and database. AcraCensor inspects every SQL query that runs from the web application to the database, and back.

Protecting OWASP web application: Acra architecture with AcraCensor

This is a slide from a talk by Cossack Labs' security software engineer Artem Storozhuk on building SQL firewalls, which illustrates how SQL firewalls can prevent more SQLi than WAF.


Watch the video

How to run the demo

  1. Use docker-compose command to set up and run the whole infrastructure:
docker-compose -f docker-compose.acra-censor-demo.yml up

  1. Check that the containers are up and running:
docker ps -a

  1. Open Mutillidae web portal at localhost:8080:

  1. The database is still empty so we need to fill it first by clicking on setup/reset the DB.

In the Docker console you should see SQL queries in Acra logs. After resetting the database, the main page of Mutillidae application looks like this:

How to perform SQL injections

  1. Start with selecting a vulnerable web page. In the menu on the left, go to "OWASP 2017" -> "A1 - Injection (SQL)" -> "SQLi - Extract data" -> User Info (SQL).

  1. Now, let's run an SQL injection. Try to login any name and password ' or 1='1.

This will construct an SQL query SELECT * FROM accounts WHERE username='' AND password='' or 1='1' — containing a typical SQL injection — to the database.

How AcraCensor prevents SQL injections

  1. Now, let's fine-tune AcraCensor for preventing this injection.

There are configuration files in ./.acraconfigs/acra-server/ folder:

  • acra-censor.norules.yaml (minimal configuration that simply creates valueless AcraCensor);
  • acra-censor.ruleset01.yaml (example: ruleset based on typical allowlist - allow some / deny any other);
  • acra-censor.ruleset02.yaml (example: ruleset based on typical denylist - deny some / allow any other);
  • acra-censor.yaml (active config, used by AcraCensor).

AcraCensor uses empty configuration file by default (no rules setup at all). We need to update the configuration file to change that.

Replace the active config with acra-censor.ruleset01.yaml (or acra-censor.ruleset02.yaml) and restart the acra-server container:

cp ./.acraconfigs/acra-server/acra-censor.ruleset01.yaml ./.acraconfigs/acra-server/acra-censor.yaml
docker restart <name or ID of acra-censor-demo_acra-server container>

In the docker log, you will see that AcraServer has restarted with an updated configuration file:

acra-server_1_979c50cd7b3e | time="2019-02-05T18:53:22Z" level=info msg="Server graceful shutdown completed, bye PID: 1"
acra-censor-demo-master_acra-server_1_979c50cd7b3e exited with code 0
  1. Test if the new AcraCensor configuration prevents injections.

On the same web page, try to login again using the password ' or 1='1.

You should see that the response from MySQL server is blocked. In Acra's console, you can see that the malicious query is forbidden:

  1. Try other SQL injections.

You can also test the process of blocking other injections (if applies to any of the provided rulesets):

  • into Name or Password textbox: qwerty' OR 6=6 -- ;
  • into Password textbox: ' union select ccid,ccnumber,ccv,expiration,null,null,null from credit_cards -- .
  1. Try other vulnerable web pages. Select one of the following:
  • OWASP 2017 -> A1 Injection (SQL) -> SQLi Bypass Authentication -> Login
  • OWASP 2017 -> A1 Injection (SQL) -> Blind SQL via Timing -> Login
  • OWASP 2017 -> A2 Broken authentication ... -> Authentication bypass -> via SQL injection -> Login

and try to use admin as a username and ' or 1='1 as a password.

Learn more

  1. Read more about how SQL firewall works and how it is different from WAF.
  2. Read out blog post how we built AcraCensor.
  3. Watch the slides about the developers' perspective on building SQL firewall.
  4. Check Mutillidae repository.
  5. Check Mutillidae docker image by @edoz90.

Further steps

Let us know if you have any questions by dropping an email to

  1. Acra features – check out full features set and available licenses.
  2. Other Acra example applications – try other Acra features, like transparent encryption, SQL firewall, load balancing support.

Need help?

Need help in configuring Acra? Our support is available for Acra Pro and Acra Enterprise versions.


AcraCensor (SQL firewall) example project: see how to configure AcraCensor to prevent SQL injections in vulnerable OWASP web application.




No releases published


No packages published

Contributors 4