Skip to main content

aiohttp additional security layer

Project description


Library implements CSP and HSTS headers. In future CSRF token and maybe some other default security handlers will be added.


Way for web site to tell browsers that it should only be accessed using HTTPS, instead of using HTTP. Which is usually used for connection, even if web site enables HTTPS. Helps to avoid man in the middle attack.(source) You can learn more here:

Avaliable parameters: | Parameter | Defenition | Default | |------------------------|-------------------------------------------------------------------|--------------------| | hsts | should HSTS header be added | True | | hsts_max_age | for how long in seconds browser should redirect directly to HTTPS | 31536000(one year) | | hsts_inclue_subdomains | should include subdomains | True | | hsts_preload | should use preload | True |


Content Security Policy (CSP) is an added layer of security that helps to detect and mitigate certain types of attacks, including Cross Site Scripting (XSS) and data injection attacks. These attacks are used for everything from data theft to site defacement to distribution of malware.(source) Basically it block all sources for front-end libraries/images/objects... that are not specified in whitelist to avoid downloading malicious code that can gather sensetive user data. You can learn more here:

Avaliable parameters: | Parameter | Defenition | Default | |----------------|-------------------------------------------------------------------|-------------------------------| | csp | Should CSP header be added and if yes - what it should include | None | | csp_testing | Enable CSP in report only mode, without actually blocking sources | False | | scp_report_uri | Where browser should send CSP reports | /secureaiohttp-csp-report-uri |

csp parameter can be either:

  • None to avoid using CSP header at all
  • default|same-origin|google-analitycs to use predifined CSP header
  • dict with custom CSP parameters, example:

'myCSP': {
    'connect-src': 'self',
    'default-src': 'none',
    'img-src': 'self',
    'script-src': 'self',
    'style-src': 'self',
    'report-uri': '/my-csp-report-handler',
    'block-all-mixed-content': None

You need to pass None for parameters that require no values, like block-all-mixed-content.

Predifined CPS header variants are taken from and include:

  • default: This policy allows images, scripts, AJAX, and CSS from the same origin, and does not allow any other resources to load (eg object, frame, media, etc). It is a good starting point for many sites.
  • google-analitycs: Allow Google Analytics, Google AJAX CDN and Same Origin.
  • same-origin: Only Allow Scripts from the same origin.


You can see some simple examples in example folder.


Any contributions are welcome! Take action in securing your users! ;)


secure-aiohttp is offered under the Apache 2 license.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for secure-aiohttp, version 0.0.24
Filename, size File type Python version Upload date Hashes
Filename, size secure_aiohttp-0.0.24-py3-none-any.whl (9.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size secure-aiohttp-0.0.24.tar.gz (4.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page