# -*- 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