WebKit2.AuthenticationRequest
Description: Reference for WebKit2.AuthenticationRequest

### Class

# WebKit2AuthenticationRequest

#### Description [src]

    class WebKit2.AuthenticationRequest : GObject.Object {
      parent: GObject
    }

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.

#### Ancestors

- GObject

#### Instance methods

###### webkit_authentication_request_authenticate

Authenticate the `WebKitAuthenticationRequest`.

Available since: 2.2

###### webkit_authentication_request_can_save_credentials

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

Available since: 2.2

###### webkit_authentication_request_cancel

Cancel the authentication challenge.

Available since: 2.2

###### webkit_authentication_request_get_certificate_pin_flags

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

Available since: 2.34

###### webkit_authentication_request_get_host

Get the host that this authentication challenge is applicable to.

Available since: 2.2

###### webkit_authentication_request_get_port

Get the port that this authentication challenge is applicable to.

Available since: 2.2

###### webkit_authentication_request_get_proposed_credential

Get the `WebKitCredential` of the proposed authentication challenge.

Available since: 2.2

###### webkit_authentication_request_get_realm

Get the realm that this authentication challenge is applicable to.

Available since: 2.2

###### webkit_authentication_request_get_scheme

Get the authentication scheme of the authentication challenge.

Available since: 2.2

###### webkit_authentication_request_get_security_origin

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

Available since: 2.30

###### webkit_authentication_request_is_for_proxy

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

Available since: 2.2

###### webkit_authentication_request_is_retry

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

Available since: 2.2

###### webkit_authentication_request_set_can_save_credentials

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

Available since: 2.30

###### webkit_authentication_request_set_proposed_credential

Set the `WebKitCredential` of the proposed authentication challenge.

Available since: 2.30

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

Please see GObject for a full list of methods.

#### Signals

###### WebKit2.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.

Available since: 2.30

###### WebKit2.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.

Available since: 2.2

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

###### GObject.Object::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.

#### Class structure

    struct WebKit2AuthenticationRequestClass {
      GObjectClass parent_class;
      void (* _webkit_reserved0) (
    void
      );
      void (* _webkit_reserved1) (
    void
      );
      void (* _webkit_reserved2) (
    void
      );
      void (* _webkit_reserved3) (
    void
      );

    }

###### Class members

`parent_class` |
    GObjectClass
| No description available.
`_webkit_reserved0` |
    void (* _webkit_reserved0) (
    void
      )
| No description available.
`_webkit_reserved1` |
    void (* _webkit_reserved1) (
    void
      )
| No description available.
`_webkit_reserved2` |
    void (* _webkit_reserved2) (
    void
      )
| No description available.
`_webkit_reserved3` |
    void (* _webkit_reserved3) (
    void
      )
| No description available.