struct WebKitAuthenticationRequest

struct WebKitAuthenticationRequest;

enum WebKitAuthenticationScheme

typedef enum {
    WEBKIT_AUTHENTICATION_SCHEME_DEFAULT = 1,
    WEBKIT_AUTHENTICATION_SCHEME_HTTP_BASIC = 2,
    WEBKIT_AUTHENTICATION_SCHEME_HTTP_DIGEST = 3,
    WEBKIT_AUTHENTICATION_SCHEME_HTML_FORM = 4,
    WEBKIT_AUTHENTICATION_SCHEME_NTLM = 5,
    WEBKIT_AUTHENTICATION_SCHEME_NEGOTIATE = 6,
    WEBKIT_AUTHENTICATION_SCHEME_CLIENT_CERTIFICATE_REQUESTED = 7,
    WEBKIT_AUTHENTICATION_SCHEME_SERVER_TRUST_EVALUATION_REQUESTED = 8,
    WEBKIT_AUTHENTICATION_SCHEME_UNKNOWN = 100,
} WebKitAuthenticationScheme;

Enum values representing the authentication scheme.

Since 2.2

webkit_authentication_request_authenticate ()

void                webkit_authentication_request_authenticate
                                                        (WebKitAuthenticationRequest *request,
                                                         WebKitCredential *credential);

Authenticate the WebKitAuthenticationRequest using the WebKitCredential supplied. To continue without credentials, pass NULL as credential.

Since 2.2

webkit_authentication_request_cancel ()

void                webkit_authentication_request_cancel
                                                        (WebKitAuthenticationRequest *request);

Cancel the authentication challenge. This will also cancel the page loading and result in a "load-failed" signal with a WebKitNetworkError of type WEBKIT_NETWORK_ERROR_CANCELLED being emitted.

Since 2.2

webkit_authentication_request_can_save_credentials ()

gboolean            webkit_authentication_request_can_save_credentials
                                                        (WebKitAuthenticationRequest *request);

Determine whether the authentication method associated with this WebKitAuthenticationRequest should allow the storage of credentials. This will return FALSE if webkit doesn't support credential storing or if private browsing is enabled.

Since 2.2

webkit_authentication_request_get_host ()

const gchar *       webkit_authentication_request_get_host
                                                        (WebKitAuthenticationRequest *request);

Get the host that this authentication challenge is applicable to.

Since 2.2

webkit_authentication_request_get_port ()

guint               webkit_authentication_request_get_port
                                                        (WebKitAuthenticationRequest *request);

Get the port that this authentication challenge is applicable to.

Since 2.2

webkit_authentication_request_is_retry ()

gboolean            webkit_authentication_request_is_retry
                                                        (WebKitAuthenticationRequest *request);

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

Since 2.2

webkit_authentication_request_get_proposed_credential ()

WebKitCredential *  webkit_authentication_request_get_proposed_credential
                                                        (WebKitAuthenticationRequest *request);

Get the WebKitCredential of the proposed authentication challenge that was stored from a previous session. The client can use this directly for authentication or construct their own WebKitCredential.

Since 2.2

webkit_authentication_request_get_realm ()

const gchar *       webkit_authentication_request_get_realm
                                                        (WebKitAuthenticationRequest *request);

Get the realm that this authentication challenge is applicable to.

Since 2.2

webkit_authentication_request_get_scheme ()

WebKitAuthenticationScheme webkit_authentication_request_get_scheme
                                                        (WebKitAuthenticationRequest *request);

Get the authentication scheme of the authentication challenge.

Since 2.2

webkit_authentication_request_is_for_proxy ()

gboolean            webkit_authentication_request_is_for_proxy
                                                        (WebKitAuthenticationRequest *request);

Determine whether the authentication challenge is associated with a proxy server rather than an "origin" server.

Since 2.2

WebKitCredential

typedef struct _WebKitCredential WebKitCredential;

enum WebKitCredentialPersistence

typedef enum {
    WEBKIT_CREDENTIAL_PERSISTENCE_NONE,
    WEBKIT_CREDENTIAL_PERSISTENCE_FOR_SESSION,
    WEBKIT_CREDENTIAL_PERSISTENCE_PERMANENT
} WebKitCredentialPersistence;

Enum values representing the duration for which a credential persists.

Since 2.2

webkit_credential_new ()

WebKitCredential *  webkit_credential_new               (const gchar *username,
                                                         const gchar *password,
                                                         WebKitCredentialPersistence persistence);

Create a new credential from the provided username, password and persistence mode.

Since 2.2

webkit_credential_copy ()

WebKitCredential *  webkit_credential_copy              (WebKitCredential *credential);

Make a copy of the WebKitCredential.

Since 2.2

webkit_credential_free ()

void                webkit_credential_free              (WebKitCredential *credential);

Free the WebKitCredential.

Since 2.2

webkit_credential_get_password ()

const gchar *       webkit_credential_get_password      (WebKitCredential *credential);

Get the password currently held by this WebKitCredential.

Since 2.2

webkit_credential_get_persistence ()

WebKitCredentialPersistence webkit_credential_get_persistence
                                                        (WebKitCredential *credential);

Get the persistence mode currently held by this WebKitCredential.

Since 2.2

webkit_credential_get_username ()

const gchar *       webkit_credential_get_username      (WebKitCredential *credential);

Get the username currently held by this WebKitCredential.

Since 2.2

webkit_credential_has_password ()

gboolean            webkit_credential_has_password      (WebKitCredential *credential);

Determine whether this credential has a password stored.

Since 2.2

The "cancelled" signal

void                user_function                      (WebKitAuthenticationRequest *request,
                                                        gpointer                     user_data)      : Run Last

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