aikido-zen

Zen, in-app firewall for Python 3 | by Aikido

Zen, your in-app firewall for peace of mind– at runtime.

Zen is an embedded Web Application Firewall that autonomously protects your Python apps against common and critical attacks.

Zen protects your Python apps by preventing user input containing dangerous strings, which allow SQL injections. It runs on the same server as your Python app for simple installation and zero maintenance.

Features

Zen will autonomously protect your Python applications from the inside against:

• 🛡️ NoSQL injection attacks
• 🛡️ SQL injection attacks
• 🛡️ Command injection attacks
• 🛡️ Path traversal attacks
• 🛡️ Server-side request forgery (SSRF)

Zen operates autonomously on the same server as your Python app to:

• ✅ Secure your app like a classic web application firewall (WAF), but with none of the infrastructure or cost.

Supported libraries and frameworks

Zen for Python 3 is compatible with:

Web frameworks

• ✅ Django
• ✅ Flask ^2.2.4
• ✅ Quart
• ✅ Starlette
• ✅ FastAPI

WSGI servers

• ✅ Gunicorn
• ✅ uWSGI

Database drivers

• ✅ mysqlclient ^1.5
• ✅ PyMySQL ^0.9
• ✅ pymongo ^3.10
• ✅ psycopg2 ^2.9.2
• ✅ psycopg ^3.1
• ✅ asyncpg ^0.27
• ✅ motor (See pymongo version)
• ✅ clickhouse-driver

AI SDKs

Zen instruments the following AI SDKs to track which models are used and how many tokens are consumed, allowing you to monitor your AI usage and costs:

• ✅ openai ^1.0
• ✅ anthropic
• ✅ mistralai ^1.0.0

Zen is compatible with Python 3.8-3.13 and can run on Windows, Linux, and Mac OS X.

Reporting to your Aikido Security dashboard

Aikido is your no nonsense application security platform. One central system that scans your source code & cloud, shows you what vulnerabilities matter, and how to fix them - fast. So you can get back to building.

Zen is a new product by Aikido. Built for developers to level up their security. While Aikido scans, get Zen for always-on protection.

You can use some of Zen’s features without Aikido, of course. Peace of mind is just a few lines of code away.

But you will get the most value by reporting your data to Aikido.

You will need an Aikido account and a token to report events to Aikido. If you don't have an account, you can sign up for free.

Here's how:

• Log in to your Aikido account.
• Go to Zen.
• Go to apps.
• Click on Add app.
• Choose a name for your app.
• Click Generate token.
• Copy the token.
• Set the token as an environment variable, AIKIDO_TOKEN

Running in production (blocking) mode

By default, Zen will only detect and report attacks to Aikido.

To block requests, set the AIKIDO_BLOCK environment variable to true.

See Reporting to Aikido to learn how to send events to Aikido.

Additional configuration

Configure Zen using environment variables for authentication, mode settings, debugging, and more.

Benchmarks

The following table summarizes the performance of both a typical SQL Query and a typical NoSQL Query with and without the Zen, measured in milliseconds :

Operation	Avg. time w/o Zen	Avg. time w/ Zen	Delta	Delta in %
SQL Query	1.222 ms	1.257 ms	+0.035 ms	+3%
NoSQL Query	1.090 ms	1.110 ms	+0.020 ms	+2%

See benchmarks folder for more.

Bug bounty program

Our bug bounty program is public and can be found by all registered Intigriti users here

Contributing

See CONTRIBUTING.md for more information.

Code of Conduct

See CODE_OF_CONDUCT.md for more information.

Security

See SECURITY.md for more information.