mirror of
https://github.com/kennethreitz/flask-sslify.git
synced 2026-06-05 06:46:18 +00:00
97 lines
2.8 KiB
Python
97 lines
2.8 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
from flask import request, redirect, current_app
|
|
|
|
|
|
YEAR_IN_SECS = 31536000
|
|
|
|
|
|
class SSLify(object):
|
|
"""Secures your Flask App."""
|
|
|
|
def __init__(self, app=None, age=YEAR_IN_SECS, subdomains=False,
|
|
permanent=False, skips=None):
|
|
self.app = app or current_app
|
|
self.defaults = {
|
|
'subdomains': subdomains,
|
|
'permanent': permanent,
|
|
'skips': skips,
|
|
'age': age,
|
|
}
|
|
|
|
if app is not None:
|
|
self.init_app(app)
|
|
|
|
@property
|
|
def hsts_age(self):
|
|
return self.app.config['SSLIFY_AGE']
|
|
|
|
@property
|
|
def hsts_include_subdomains(self):
|
|
return self.app.config['SSLIFY_SUBDOMAINS']
|
|
|
|
@property
|
|
def permanent(self):
|
|
return self.app.config['SSLIFY_PERMANENT']
|
|
|
|
@property
|
|
def skip_list(self):
|
|
return self.app.config['SSLIFY_SKIPS']
|
|
|
|
def init_app(self, app):
|
|
"""Configures the specified Flask app to enforce SSL."""
|
|
app.config.setdefault('SSLIFY_AGE', self.defaults['age'])
|
|
app.config.setdefault('SSLIFY_SUBDOMAINS', self.defaults['subdomains'])
|
|
app.config.setdefault('SSLIFY_PERMANENT', self.defaults['permanent'])
|
|
app.config.setdefault('SSLIFY_SKIPS', self.defaults['skips'])
|
|
|
|
app.before_request(self.redirect_to_ssl)
|
|
app.after_request(self.set_hsts_header)
|
|
|
|
@property
|
|
def hsts_header(self):
|
|
"""Returns the proper HSTS policy."""
|
|
hsts_policy = 'max-age={0}'.format(self.hsts_age)
|
|
|
|
if self.hsts_include_subdomains:
|
|
hsts_policy += '; includeSubDomains'
|
|
|
|
return hsts_policy
|
|
|
|
@property
|
|
def skip(self):
|
|
"""Checks the skip list."""
|
|
# Should we skip?
|
|
if self.skip_list and isinstance(self.skip_list, list):
|
|
for skip in self.skip_list:
|
|
if request.path.startswith('/{0}'.format(skip)):
|
|
return True
|
|
return False
|
|
|
|
def redirect_to_ssl(self):
|
|
"""Redirect incoming requests to HTTPS."""
|
|
# Should we redirect?
|
|
criteria = [
|
|
request.is_secure,
|
|
current_app.debug,
|
|
current_app.testing,
|
|
request.headers.get('X-Forwarded-Proto', 'http') == 'https'
|
|
]
|
|
|
|
if not any(criteria) and not self.skip:
|
|
if request.url.startswith('http://'):
|
|
url = request.url.replace('http://', 'https://', 1)
|
|
code = 302
|
|
if self.permanent:
|
|
code = 301
|
|
r = redirect(url, code=code)
|
|
return r
|
|
|
|
def set_hsts_header(self, response):
|
|
"""Adds HSTS header to each response."""
|
|
# Should we add STS header?
|
|
if request.is_secure and not self.skip:
|
|
response.headers.setdefault(
|
|
'Strict-Transport-Security', self.hsts_header)
|
|
return response
|