HSTSEnforcer


Object Hierarchy:

Soup.HSTSEnforcer Soup.HSTSEnforcer Soup.HSTSEnforcer GLib.Object GLib.Object GLib.Object->Soup.HSTSEnforcer Soup.SessionFeature Soup.SessionFeature Soup.SessionFeature->Soup.HSTSEnforcer

Description:

[ CCode ( type_id = "soup_hsts_enforcer_get_type ()" ) ]
public class HSTSEnforcer : Object, SessionFeature

Automatic HTTP Strict Transport Security enforcing for [class@Session].

A HSTSEnforcer stores HSTS policies and enforces them when required. HSTSEnforcer implements [iface@SessionFeature], so you can add an HSTS enforcer to a session with [method@Session.add_feature] or [ method@Session.add_feature_by_type].

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

When the [class@Session] the HSTSEnforcer is attached to queues or restarts a message, the HSTSEnforcer 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 HSTSEnforcer are advised to listen to changes in the [property@Message:uri] property in order to be aware of changes in the message URI.

Note that HSTSEnforcer does not support any form of long-term HSTS policy persistence. See [class@HSTSEnforcerDB] for a persistent enforcer.

All known sub-classes:

Namespace: Soup
Package: libsoup-3.0

Content:

Creation methods:

Methods:

Signals:

Inherited Members: