GI.Soup.Objects.Auth

The abstract base class for handling authentication. Specific HTTP Authentication mechanisms are implemented by its subclasses, but applications never need to be aware of the specific subclasses being used.

Exported types

newtype Auth

Constructors

Auth (ManagedPtr Auth)

Instances

GObject Auth

Methods

gobjectType :: Auth -> IO GType

IsObject Auth

IsAuth Auth

class GObject o => IsAuth o

Instances

(GObject a, UnknownAncestorError Constraint Auth a) => IsAuth a

IsAuth Auth

IsAuth AuthBasic

IsAuth AuthDigest

IsAuth AuthNTLM

IsAuth AuthNegotiate

toAuth :: (MonadIO m, IsAuth o) => o -> m Auth

noAuth :: Maybe Auth

Methods

authenticate

authAuthenticate

Arguments

:: (HasCallStack, MonadIO m, IsAuth a)

=> a

auth: a Auth

-> Text

username: the username provided by the user or client

-> Text

password: the password provided by the user or client

-> m ()

Call this on an auth to authenticate it; normally this will cause the auth's message to be requeued with the new authentication info.

canAuthenticate

authCanAuthenticate

Arguments

:: (HasCallStack, MonadIO m, IsAuth a)

=> a

auth: a Auth

-> m Bool

Returns: True if auth is able to accept credentials.

Tests if auth is able to authenticate by providing credentials to the authAuthenticate.

Since: 2.54

getAuthorization

authGetAuthorization

Arguments

:: (HasCallStack, MonadIO m, IsAuth a, IsMessage b)

=> a

auth: a Auth

-> b

msg: the Message to be authorized

-> m Text

Returns: the "Authorization" header, which must be freed.

Generates an appropriate "Authorization" header for msg. (The session will only call this if authIsAuthenticated returned True.)

getHost

authGetHost

Arguments

:: (HasCallStack, MonadIO m, IsAuth a)

=> a

auth: a Auth

-> m Text

Returns: the hostname

Returns the host that auth is associated with.

getInfo

authGetInfo

Arguments

:: (HasCallStack, MonadIO m, IsAuth a)

=> a

auth: a Auth

-> m Text

Returns: the identifier

Gets an opaque identifier for auth, for use as a hash key or the like. Auth objects from the same server with the same identifier refer to the same authentication domain (eg, the URLs associated with them take the same usernames and passwords).

getProtectionSpace

authGetProtectionSpace

Arguments

:: (HasCallStack, MonadIO m, IsAuth a)

=> a

auth: a Auth

-> URI

sourceUri: the URI of the request that auth was generated in response to.

-> m [Text]

Returns: the list of paths, which can be freed with soup_auth_free_protection_space().

Returns a list of paths on the server which auth extends over. (All subdirectories of these paths are also assumed to be part of auth's protection space, unless otherwise discovered not to be.)

getRealm

authGetRealm

Arguments

:: (HasCallStack, MonadIO m, IsAuth a)

=> a

auth: a Auth

-> m Text

Returns: the realm name

Returns auth's realm. This is an identifier that distinguishes separate authentication spaces on a given server, and may be some string that is meaningful to the user. (Although it is probably not localized.)

getSavedPassword

authGetSavedPassword :: (HasCallStack, MonadIO m, IsAuth a) => a -> Text -> m Text

No description available in the introspection data.

getSavedUsers

authGetSavedUsers :: (HasCallStack, MonadIO m, IsAuth a) => a -> m [Text]

No description available in the introspection data.

getSchemeName

authGetSchemeName

Arguments

:: (HasCallStack, MonadIO m, IsAuth a)

=> a

auth: a Auth

-> m Text

Returns: the scheme name

Returns auth's scheme name. (Eg, "Basic", "Digest", or "NTLM")

hasSavedPassword

authHasSavedPassword :: (HasCallStack, MonadIO m, IsAuth a) => a -> Text -> Text -> m ()

No description available in the introspection data.

isAuthenticated

authIsAuthenticated

Arguments

:: (HasCallStack, MonadIO m, IsAuth a)

=> a

auth: a Auth

-> m Bool

Returns: True if auth has been given a username and password

Tests if auth has been given a username and password

isForProxy

authIsForProxy

Arguments

:: (HasCallStack, MonadIO m, IsAuth a)

=> a

auth: a Auth

-> m Bool

Returns: True or False

Tests whether or not auth is associated with a proxy server rather than an "origin" server.

isReady

authIsReady

Arguments

:: (HasCallStack, MonadIO m, IsAuth a, IsMessage b)

=> a

auth: a Auth

-> b

msg: a Message

-> m Bool

Returns: True if auth is ready to make a request with.

Tests if auth is ready to make a request for msg with. For most auths, this is equivalent to authIsAuthenticated, but for some auth types (eg, NTLM), the auth may be sendable (eg, as an authentication request) even before it is authenticated.

Since: 2.42

new

authNew

Arguments

:: (HasCallStack, MonadIO m, IsMessage a)

=> GType

type: the type of auth to create (a subtype of Auth)

-> a

msg: the Message the auth is being created for

-> Text

authHeader: the WWW-Authenticate/Proxy-Authenticate header

-> m (Maybe Auth)

Returns: the new Auth, or Nothing if it could not be created

Creates a new Auth of type type with the information from msg and authHeader.

This is called by Session; you will normally not create auths yourself.

savePassword

authSavePassword :: (HasCallStack, MonadIO m, IsAuth a) => a -> Text -> Text -> m ()

No description available in the introspection data.

update

authUpdate

Arguments

:: (HasCallStack, MonadIO m, IsAuth a, IsMessage b)

=> a

auth: a Auth

-> b

msg: the Message auth is being updated for

-> Text

authHeader: the WWW-Authenticate/Proxy-Authenticate header

-> m Bool

Returns: True if auth is still a valid (but potentially unauthenticated) Auth. False if something about authParams could not be parsed or incorporated into auth at all.

Updates auth with the information from msg and authHeader, possibly un-authenticating it. As with authNew, this is normally only used by Session.

Properties

host

clearAuthHost :: (MonadIO m, IsAuth o) => o -> m ()

constructAuthHost :: IsAuth o => Text -> IO (GValueConstruct o)

getAuthHost :: (MonadIO m, IsAuth o) => o -> m Text

setAuthHost :: (MonadIO m, IsAuth o) => o -> Text -> m ()

isAuthenticated

getAuthIsAuthenticated :: (MonadIO m, IsAuth o) => o -> m Bool

isForProxy

constructAuthIsForProxy :: IsAuth o => Bool -> IO (GValueConstruct o)

getAuthIsForProxy :: (MonadIO m, IsAuth o) => o -> m Bool

setAuthIsForProxy :: (MonadIO m, IsAuth o) => o -> Bool -> m ()

realm

clearAuthRealm :: (MonadIO m, IsAuth o) => o -> m ()

constructAuthRealm :: IsAuth o => Text -> IO (GValueConstruct o)

getAuthRealm :: (MonadIO m, IsAuth o) => o -> m Text

setAuthRealm :: (MonadIO m, IsAuth o) => o -> Text -> m ()

schemeName

getAuthSchemeName :: (MonadIO m, IsAuth o) => o -> m Text