soup.hstsenforcer

Module for [HSTSEnforcer] class

class HSTSEnforcer HSTSEnforcerGidBuilder HSTSEnforcerGidBuilderImpl

Types 3

classHSTSEnforcer : gobject.object.ObjectWrap, soup.session_feature.SessionFeature

Automatic HTTP Strict Transport Security enforcing for soup.session.Session.

A #SoupHSTSEnforcer stores HSTS policies and enforces them when required. #SoupHSTSEnforcer implements soup.session_feature.SessionFeature, so you can add an HSTS enforcer to a session with soup.session.Session.addFeature or soup.session.Session.addFeatureByType.

#SoupHSTSEnforcer keeps track of all the HTTPS destinations that, when connected to, return the Strict-Transport-Security header with valid values. #SoupHSTSEnforcer will forget those destinations upon expiry or when the server requests it.

When the soup.session.Session the #SoupHSTSEnforcer is attached to queues or restarts a message, the #SoupHSTSEnforcer will rewrite the URI to HTTPS if the destination is a known HSTS host and is contacted over an insecure transport protocol (HTTP). Users of #SoupHSTSEnforcer are advised to listen to changes in the soup.message.Message.uri property in order to be aware of changes in the message URI.

Note that #SoupHSTSEnforcer does not support any form of long-term HSTS policy persistence. See soup.hstsenforcer_db.HSTSEnforcerDB for a persistent enforcer.

Methods

GType _getGType() static nothrow

GType _gType() @property nothrow

HSTSEnforcer self() nothrowReturns `this`, for use in `with` statements.

HSTSEnforcerGidBuilder builder() static nothrowGet builder for [soup.hstsenforcer.HSTSEnforcer] Returns: New builder object

string[] getDomains(bool sessionPolicies) nothrowGets a list of domains for which there are policies in enforcer.

soup.hstspolicy.HSTSPolicy[] getPolicies(bool sessionPolicies) nothrowGets a list with the policies in enforcer.

bool hasValidPolicy(string domain) nothrowGets whether hsts_enforcer has a currently valid policy for domain.

bool isPersistent() nothrowGets whether hsts_enforcer stores policies persistenly. Returns: true if hsts_enforcer storage is persistent or false otherwise.

void setPolicy(soup.hstspolicy.HSTSPolicy policy) nothrowSets policy to hsts_enforcer.

void setSessionPolicy(string domain, bool includeSubdomains) nothrowSets a session policy for domain.

gulong connectChanged(T)(T callback,  Flag!"After" after =  No.After) if (isCallable!T
    &&  is(ReturnType!T ==  void)
   && (Parameters!T.length <  1 || (ParameterStorageClassTuple!T[0]  ==  ParameterStorageClass.none &&  is(Parameters!T[0]  ==  soup.hstspolicy.HSTSPolicy)))
   && (Parameters!T.length <  2 || (ParameterStorageClassTuple!T[1]  ==  ParameterStorageClass.none &&  is(Parameters!T[1]  ==  soup.hstspolicy.HSTSPolicy)))
   && (Parameters!T.length <  3 || (ParameterStorageClassTuple!T[2]  ==  ParameterStorageClass.none &&  is(Parameters!T[2] :  soup.hstsenforcer.HSTSEnforcer)))
   &&  Parameters!T.length <  4)

nothrowConnect to `Changed` signal.

Constructors

this(void * ptr, Flag!"Take" take)

this()Creates a new #SoupHSTSEnforcer.

classHSTSEnforcerGidBuilderImpl(T) : gobject.object.ObjectWrapGidBuilderImpl!T, soup.session_feature.SessionFeatureGidBuilderImpl!T

Fluent builder implementation template for soup.hstsenforcer.HSTSEnforcer

classHSTSEnforcerGidBuilder : HSTSEnforcerGidBuilderImpl!HSTSEnforcerGidBuilder

Fluent builder for soup.hstsenforcer.HSTSEnforcer

Methods

HSTSEnforcer build() nothrowCreate object from builder. Returns: New object