GI.Soup.Objects.HSTSEnforcer

No description available in the introspection data.

Exported types

newtype HSTSEnforcer

Memory-managed wrapper type.

Constructors

HSTSEnforcer (ManagedPtr HSTSEnforcer)

Instances

Eq HSTSEnforcer

Defined in GI.Soup.Objects.HSTSEnforcer

Methods

(==) :: HSTSEnforcer -> HSTSEnforcer -> Bool

(/=) :: HSTSEnforcer -> HSTSEnforcer -> Bool

GObject HSTSEnforcer

Defined in GI.Soup.Objects.HSTSEnforcer

ManagedPtrNewtype HSTSEnforcer

Defined in GI.Soup.Objects.HSTSEnforcer

Methods

toManagedPtr :: HSTSEnforcer -> ManagedPtr HSTSEnforcer

TypedObject HSTSEnforcer

Defined in GI.Soup.Objects.HSTSEnforcer

Methods

glibType :: IO GType

HasParentTypes HSTSEnforcer

Defined in GI.Soup.Objects.HSTSEnforcer

IsGValue (Maybe HSTSEnforcer)

Convert HSTSEnforcer to and from GValue. See toGValue and fromGValue.

Defined in GI.Soup.Objects.HSTSEnforcer

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe HSTSEnforcer -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe HSTSEnforcer)

type ParentTypes HSTSEnforcer

Defined in GI.Soup.Objects.HSTSEnforcer

type ParentTypes HSTSEnforcer = '[Object, SessionFeature]

class (GObject o, IsDescendantOf HSTSEnforcer o) => IsHSTSEnforcer o

Type class for types which can be safely cast to HSTSEnforcer, for instance with toHSTSEnforcer.

Instances

(GObject o, IsDescendantOf HSTSEnforcer o) => IsHSTSEnforcer o

Defined in GI.Soup.Objects.HSTSEnforcer

toHSTSEnforcer :: (MonadIO m, IsHSTSEnforcer o) => o -> m HSTSEnforcer

Cast to HSTSEnforcer, for types for which this is known to be safe. For general casts, use castTo.

Methods

Click to display all available methods, including inherited ones

Methods

addFeature, attach, bindProperty, bindPropertyFull, detach, forceFloating, freezeNotify, getv, hasFeature, hasValidPolicy, isFloating, isPersistent, notify, notifyByPspec, ref, refSink, removeFeature, runDispose, stealData, stealQdata, thawNotify, unref, watchClosure.

Getters

getData, getDomains, getPolicies, getProperty, getQdata.

Setters

setData, setDataFull, setPolicy, setProperty, setSessionPolicy.

getDomains

hSTSEnforcerGetDomains

Arguments

:: (HasCallStack, MonadIO m, IsHSTSEnforcer a)

=> a

hstsEnforcer: a HSTSEnforcer

-> Bool

sessionPolicies: whether to include session policies

-> m [Text]

Returns: a newly allocated list of domains. Use g_list_free_full() and free to free the list.

Gets a list of domains for which there are policies in enforcer.

Since: 2.68

getPolicies

hSTSEnforcerGetPolicies

Arguments

:: (HasCallStack, MonadIO m, IsHSTSEnforcer a)

=> a

hstsEnforcer: a HSTSEnforcer

-> Bool

sessionPolicies: whether to include session policies

-> m [HSTSPolicy]

Returns: a newly allocated list of policies. Use g_list_free_full() and hSTSPolicyFree to free the list.

Gets a list with the policies in enforcer.

Since: 2.68

hasValidPolicy

hSTSEnforcerHasValidPolicy

Arguments

:: (HasCallStack, MonadIO m, IsHSTSEnforcer a)

=> a

hstsEnforcer: a HSTSEnforcer

-> Text

domain: a domain.

-> m Bool

Returns: True if access to domain should happen over HTTPS, false otherwise.

Gets whether hstsEnforcer has a currently valid policy for domain.

Since: 2.68

isPersistent

hSTSEnforcerIsPersistent

Arguments

:: (HasCallStack, MonadIO m, IsHSTSEnforcer a)

=> a

hstsEnforcer: a HSTSEnforcer

-> m Bool

Returns: True if hstsEnforcer storage is persistent or False otherwise.

Gets whether hstsEnforcer stores policies persistenly.

Since: 2.68

new

hSTSEnforcerNew

Arguments

:: (HasCallStack, MonadIO m)

=> m HSTSEnforcer

Returns: a new HSTSEnforcer

Creates a new HSTSEnforcer. The base HSTSEnforcer class does not support persistent storage of HSTS policies, see HSTSEnforcerDB for that.

Since: 2.68

setPolicy

hSTSEnforcerSetPolicy

Arguments

:: (HasCallStack, MonadIO m, IsHSTSEnforcer a)

=> a

hstsEnforcer: a HSTSEnforcer

-> HSTSPolicy

policy: the policy of the HSTS host

-> m ()

Sets policy to hstsEnforcer. If policy is expired, any existing HSTS policy for its host will be removed instead. If a policy existed for this host, it will be replaced. Otherwise, the new policy will be inserted. If the policy is a session policy, that is, one created with hSTSPolicyNewSessionPolicy, the policy will not expire and will be enforced during the lifetime of hstsEnforcer's Session.

Since: 2.68

setSessionPolicy

hSTSEnforcerSetSessionPolicy

Arguments

:: (HasCallStack, MonadIO m, IsHSTSEnforcer a)

=> a

hstsEnforcer: a HSTSEnforcer

-> Text

domain: policy domain or hostname

-> Bool

includeSubdomains: True if the policy applies on sub domains

-> m ()

Sets a session policy for domain. A session policy is a policy that is permanent to the lifetime of hstsEnforcer's Session and doesn't expire.

Since: 2.68

Signals

changed

type HSTSEnforcerChangedCallback

Arguments

 = HSTSPolicy

oldPolicy: the old HSTSPolicy value

-> HSTSPolicy

newPolicy: the new HSTSPolicy value

-> IO ()

Emitted when hstsEnforcer changes. If a policy has been added, newPolicy will contain the newly-added policy and oldPolicy will be Nothing. If a policy has been deleted, oldPolicy will contain the to-be-deleted policy and newPolicy will be Nothing. If a policy has been changed, oldPolicy will contain its old value, and newPolicy its new value.

Note that you shouldn't modify the policies from a callback to this signal.

afterHSTSEnforcerChanged :: (IsHSTSEnforcer a, MonadIO m) => a -> ((?self :: a) => HSTSEnforcerChangedCallback) -> m SignalHandlerId

Connect a signal handler for the changed signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after hSTSEnforcer #changed callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onHSTSEnforcerChanged :: (IsHSTSEnforcer a, MonadIO m) => a -> ((?self :: a) => HSTSEnforcerChangedCallback) -> m SignalHandlerId

Connect a signal handler for the changed signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on hSTSEnforcer #changed callback

hstsEnforced

type HSTSEnforcerHstsEnforcedCallback

Arguments

 = Message

message: the message for which HSTS is being enforced

-> IO ()

Emitted when hstsEnforcer has upgraded the protocol for message to HTTPS as a result of matching its domain with a HSTS policy.

afterHSTSEnforcerHstsEnforced :: (IsHSTSEnforcer a, MonadIO m) => a -> ((?self :: a) => HSTSEnforcerHstsEnforcedCallback) -> m SignalHandlerId

Connect a signal handler for the hstsEnforced signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after hSTSEnforcer #hstsEnforced callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onHSTSEnforcerHstsEnforced :: (IsHSTSEnforcer a, MonadIO m) => a -> ((?self :: a) => HSTSEnforcerHstsEnforcedCallback) -> m SignalHandlerId

Connect a signal handler for the hstsEnforced signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on hSTSEnforcer #hstsEnforced callback