Flask-Paranoid
Simple user session protection
Decision gist · record as of 2026-08-14
Yes, if you need lightweight session hijacking detection in a Flask app and can accept that legitimate IP changes (mobile networks, VPNs) will trigger session invalidation. The package is actively maintained, has no known vulnerabilities, and installs with minimal friction. It's a reasonable choice for adding a simple, IP-based session binding layer, though you should verify whether its approach fits your threat model and user base.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.6 or later and a Flask application with a configured SECRET_KEY.
- Low install friction with a single Flask dependency.
- Maintenance is active with a recent commit in 2026, though the latest release was in 2022; the repository remains unarchived and receives ongoing attention.
License · maintenance · safety
permissive license (permissive) — Licensed under MIT (permissive), so you can use, modify, and distribute this package freely with minimal restrictions.
last release 2022-04-02 (1595 days) · last repo commit 2026-08-05 · 79 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 77,829 downloads/mo, #14,489 on PyPI
Alternatives
Verify before relying
pip install Flask-Paranoid
from flask import Flask
from flask_paranoid import Paranoid
app = Flask(__name__)
app.config['SECRET_KEY'] = 'top-secret!'
paranoid = Paranoid(app)
paranoid.redirect_view = '/'- Whether the IP/user-agent validation approach is effective against modern session-stealing techniques or proxies.
- Current test coverage and whether the package handles edge cases like legitimate IP changes (mobile networks, VPNs).
- Performance impact of token recalculation on every request.
What it is and what it does
Flask-Paranoid is a Flask extension that adds session hijacking detection by binding each user session to the IP address and user agent from the first request. On every subsequent request, it recalculates a token based on the current IP and user agent and compares it to the one from the initial session. If either the IP or user agent changes—indicating the session cookie may have been stolen and used from a different location—the extension clears the session and blocks the request, redirecting to a configurable view.
The package is designed as a lightweight, transparent layer that requires minimal setup: instantiate Paranoid with your Flask app, optionally set a redirect_view, and the protection activates automatically. It depends only on Flask and supports current Python versions (3.6+). With low install friction and a permissive MIT license, it's straightforward to integrate into existing Flask applications.
Use it for
- Protect web applications from attackers using stolen session cookies by detecting IP or user-agent mismatches.
- Add an extra layer of session security to Flask apps handling sensitive user data without complex custom middleware.
- Detect and block requests from compromised sessions that originate from unexpected geographic locations or devices.
- Implement automatic session invalidation when a user's network or browser environment changes unexpectedly.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need lightweight session hijacking detection in a Flask app and can accept that legitimate IP changes (mobile networks, VPNs) will trigger session invalidation.
The package is actively maintained, has no known vulnerabilities, and installs with minimal friction. It's a reasonable choice for adding a simple, IP-based session binding layer, though you should verify whether its approach fits your threat model and user base.
Install
flask-paranoid on PyPI
Before you install
Low install friction with a single Flask dependency. Maintenance is active with a recent commit in 2026, though the latest release was in 2022; the repository remains unarchived and receives ongoing attention.
Requires Python 3.6 or later and a Flask application with a configured SECRET_KEY.
License in practice
Licensed under MIT (permissive), so you can use, modify, and distribute this package freely with minimal restrictions.
Quickstart
pip install Flask-Paranoid
from flask import Flask
from flask_paranoid import Paranoid
app = Flask(__name__)
app.config['SECRET_KEY'] = 'top-secret!'
paranoid = Paranoid(app)
paranoid.redirect_view = '/'Verify before relying
- Whether the IP/user-agent validation approach is effective against modern session-stealing techniques or proxies.
- Current test coverage and whether the package handles edge cases like legitimate IP changes (mobile networks, VPNs).
- Performance impact of token recalculation on every request.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.6 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packageFlask |
| Maintenance | Actively maintained 1,595 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 77,829 / month, #14,489 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: Flask_Paranoid-0.3.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “flask session hijacking protection”
- Flask-ParanoidFlask-Paranoid detects and blocks session hijacking by validating…
- flask-talismanFlask extension that automatically sets HTTP security headers to…
- Flask-HTTPAuthAdds HTTP Basic, Digest, and Token authentication decorators to Flask…
Give your agent the search over MCP, or paste the wish link into any chat.
More Security packages
Provides Python bindings to the FreeDesktop.org Secret Service API for securely storing and retrieving passwords and secrets through GNOME Keyring, KWallet, or KeePassXC.
MSAL for Python handles OAuth2 and OpenID Connect authentication with Microsoft identity services, managing token acquisition, caching, and refresh for applications integrating with Microsoft Entra ID, Microsoft Accounts, and Azure AD B2C.
joserfc implements JOSE standards (JWS, JWE, JWK, JWT, and related RFCs) for signing, encrypting, and managing JSON-based cryptographic tokens in Python.
Authlib provides a complete implementation of OAuth 1.0, OAuth 2.0, and OpenID Connect 1.0 for building both authentication clients and servers, with built-in support for JWS, JWK, JWA, and JWT standards.
Provides low-level CFFI bindings to the official Argon2 password hashing algorithm for use by libraries and applications that need direct access to Argon2 without higher-level abstractions.
ADAL for Python authenticates applications with Azure Active Directory to obtain tokens for accessing Azure AD-protected resources.
Install only if maintaining existing code that already depends on it, and plan a migration.
See also Flask-WTF · Flask-HTTPAuth · flask-talisman · asgi-csrf · Flask-BasicAuth · flask-unsign · Flask-AWSCognito · Flask-JWT-Extended · starlette-csrf · flask-cors