### Class

# WebKit AuthenticationRequest

unstable since: 6.0

#### Description [src]

    final class WebKit.AuthenticationRequest : GObject.Object
    {
      /* No available fields */
    }

Represents an authentication request.

Whenever a client attempts to load a page protected by HTTP authentication, credentials will need to be provided to authorize access. To allow the client to decide how it wishes to handle authentication, WebKit will fire a `WebKitWebView::authenticate` signal with a WebKitAuthenticationRequest object to provide client side authentication support. Credentials are exposed through the `WebKitCredential` object.

In case the client application does not wish to handle this signal WebKit will provide a default handler. To handle authentication asynchronously, simply increase the reference count of the WebKitAuthenticationRequest object.

Available since: 6.0

#### Ancestors

- GObject

#### Instance methods

###### webkit_authentication_request_authenticate

Authenticate the `WebKitAuthenticationRequest`.

since: 2.2

###### webkit_authentication_request_can_save_credentials

Determine whether this `WebKitAuthenticationRequest` should allow the storage of credentials.

since: 2.2

###### webkit_authentication_request_cancel

Cancel the authentication challenge.

since: 2.2

###### webkit_authentication_request_get_certificate_pin_flags

Get the `GTlsPasswordFlags` of the `WEBKIT_AUTHENTICATION_SCHEME_CLIENT_CERTIFICATE_PIN_REQUESTED` authentication challenge.

since: 2.34

###### webkit_authentication_request_get_host

Get the host that this authentication challenge is applicable to.

since: 2.2

###### webkit_authentication_request_get_port

Get the port that this authentication challenge is applicable to.

since: 2.2

###### webkit_authentication_request_get_proposed_credential

Get the `WebKitCredential` of the proposed authentication challenge.

since: 2.2

###### webkit_authentication_request_get_realm

Get the realm that this authentication challenge is applicable to.

since: 2.2

###### webkit_authentication_request_get_scheme

Get the authentication scheme of the authentication challenge.

since: 2.2

###### webkit_authentication_request_get_security_origin

Get the `WebKitSecurityOrigin` that this authentication challenge is applicable to.

since: 2.30

###### webkit_authentication_request_is_for_proxy

Determine whether the authentication challenge is associated with a proxy server.

since: 2.2

###### webkit_authentication_request_is_retry

Determine whether this this is a first attempt or a retry for this authentication challenge.

since: 2.2

###### webkit_authentication_request_set_can_save_credentials

Set whether the authentication method associated with `request` should allow the storage of credentials.

since: 2.30

###### webkit_authentication_request_set_proposed_credential

Set the `WebKitCredential` of the proposed authentication challenge.

since: 2.30

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Signals

###### WebKit.AuthenticationRequest::authenticated

This signal is emitted when the user authentication request succeeded. Applications handling their own credential storage should connect to this signal to save the credentials.

since: 2.30

###### WebKit.AuthenticationRequest::cancelled

This signal is emitted when the user authentication request is cancelled. It allows the application to dismiss its authentication dialog in case of page load failure for example.

since: 2.2

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

since: 2.0

#### Class structure

    struct WebKitAuthenticationRequestClass {
      GObjectClass parent_class;

    }

No description available.

###### Class members

`parent_class: GObjectClass`
  No description available.