Falcon middleware for sanity-checking that HTTPS was used for the request.
Project description
The falcon-require-https package provides a middleware component for sanity-checking that the incoming request was received over HTTPS. While the web server is primarily responsibile for enforcing the HTTPS protocol, misconfiguration is still a leading cause of security vulnerabilities, and so it can be helpful to perform certain additional checks, such as this one, within the application layer itself.
Installation
$ pip install falcon-require-https
Usage
The RequireHTTPS middleware class verifies each incoming request. To use it, simply pass an instance to the falcon.API() initializer:
from falcon_require_https import RequireHTTPS app = falcon.API(middleware=[RequireHTTPS()])
At least one of the following sources must indicate the use of HTTPS:
- The schema of the requested URL
- The X-Forwarded-Proto header
- The Forwarded header (only the first hop is checked)
Otherwise, an instance of falcon.HTTPBadRequest is raised.
Caution
This middleware is not meant to replace proper security controls in your web server or load balancer. It is simply meant as a final backstop to guard against inadvertent misconfiguration at the networking layer.
Credits
This middleware component is based on paul291’s original proof of concept, which was originally submitted as a PR to the falconry/falcon repo.
About Falcon
Falcon is a bare-metal Python web framework for building lean and mean cloud APIs and app backends. It encourages the REST architectural style, and tries to do as little as possible while remaining highly effective.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size falcon_require_https-0.1.0-py2.py3-none-any.whl (6.3 kB) | File type Wheel | Python version py2.py3 | Upload date | Hashes View |
Filename, size falcon-require-https-0.1.0.tar.gz (3.4 kB) | File type Source | Python version None | Upload date | Hashes View |
Hashes for falcon_require_https-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0057b8b5fa6606b3f0bc9eb2a3124da58408839cb9d3978255a6f89c6a2775a6 |
|
MD5 | 43a09738d18e82db575b58ea48e34793 |
|
BLAKE2-256 | baf6afb943e22ca35209dd776a6ef0e07ebb785b48ca87d1c9498a2a0c44d6e6 |
Hashes for falcon-require-https-0.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ef26e22d1a30753d9f6cb44fdab329152d6673a9e3ea8d54b27427877e986597 |
|
MD5 | 8bb8e0d58fe97feeae601cc4727903b9 |
|
BLAKE2-256 | d4454879b774ec585768966882351d7be5c441eae133a3262bed72aa7a6c00b1 |