Back to Seed Clases

Soup

Classes

Interfaces

Structs

Unions

Enums

GObject.Object
parent-child marker Soup.Auth

Class Soup.Auth

Import line:	Soup = imports.gi.Soup;
GIR File:	Soup-2.4.gir
C documentation:	SoupAuth
Class :	Auth
Extends:	GObject.Object
	Show / Hide Inherited methods, properties and signals

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.

Properties
Properties		Defined By
	host : String	Soup.Auth
	is_authenticated : Boolean read only	Soup.Auth
	is_for_proxy : Boolean	Soup.Auth
	parent : GObject.Object read only	Soup.Auth
	realm : String	Soup.Auth
	realm : String read only	Soup.Auth
	scheme_name : String read only	Soup.Auth

Methods / Constructors
Method / Constructor		Defined By
	new Soup.Auth (Object *properties) Create a new Soup.Auth Create a new Soup.Auth Parameters: Object properties*
	new Soup.Auth.c_new (Number *type, Message msg, String auth_header) : Soup.Auth Create a new Soup.Auth Create a new Soup.Auth Parameters: Number type* Required (not null) Soup.Message msg Required (not null) String auth_header Required (not null) Returns: Soup.Auth
	authenticate (String *username, String password) : none Call this on an auth to authenticate it; normally this will cause the auth's message to be requeued with the new authentication info. Call this on an auth to authenticate it; normally this will cause the auth's message to be requeued with the new authentication info. This does not cause the password to be saved to persistent storage; see soup_auth_save_password() for that. Parameters: String username* Required (not null) String password Required (not null) Returns: none	Soup.Auth
	get_authorization (Message *msg) : String Generates an appropriate "Authorization" header for msg. Generates an appropriate "Authorization" header for msg. (The session will only call this if soup_auth_is_authenticated() returned TRUE.) Parameters: Soup.Message msg* Required (not null) Returns: String	Soup.Auth
	get_host () : String Returns the host that auth is associated with. Returns the host that auth is associated with. Returns: String	Soup.Auth
	get_info () : String Gets an opaque identifier for auth, for use as a hash key or the like. Gets an opaque identifier for auth, for use as a hash key or the like. SoupAuth 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). Returns: String	Soup.Auth
	get_protection_space (URI *source_uri) : Array response to. response to. 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.) soup_auth_free_protection_space(). Parameters: Soup.URI source_uri Required (not null) Returns: Array the list of paths, which can be freed with	Soup.Auth
	get_realm () : String Returns auth's realm. 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.) Returns: String	Soup.Auth
	get_scheme_name () : String Returns auth's scheme name. Returns auth's scheme name. (Eg, "Basic", "Digest", or "NTLM") Returns: String	Soup.Auth
	is_authenticated () : Boolean Tests if auth has been given a username and password Tests if auth has been given a username and password Returns: Boolean	Soup.Auth
	is_for_proxy () : Boolean Tests whether or not auth is associated with a proxy server rather than an "origin" server. Tests whether or not auth is associated with a proxy server rather than an "origin" server. Returns: Boolean	Soup.Auth
	ntlm_get_password () : String Returns: String	Soup.Auth
	ntlm_get_username () : String Returns: String	Soup.Auth
	update (Message *msg, String auth_header) : Boolean Updates auth* with the information from msg and auth_header, possibly un-authenticating it. Updates auth with the information from msg and auth_header, possibly un-authenticating it. As with soup_auth_new(), this is normally only used by SoupSession. unauthenticated) SoupAuth. FALSE if something about auth_params could not be parsed or incorporated into auth at all. Parameters: Soup.Message msg Required (not null) String auth_header Required (not null) Returns: Boolean	Soup.Auth

Events - usage syntax: this.signals.EVENTNAME.connect( Function )
Event		Defined By
	save_password (Auth *self, String object, String p0) : none Parameters: Soup.Auth self* String object String p0 Returns: {none}	Soup.Auth

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
Soup.AuthManager Signal	authenticate (AuthManager *self, Message object*, Auth p0, Boolean p1) : none
Soup.AuthManager Method	emit_authenticate (Message *msg, Auth auth, Boolean retrying*) : none
Soup.Message Method	set_auth (Auth *auth) : none Sets msg* to authenticate to its destination using auth, which must have already been fully authenticated.
Soup.Message Method	get_auth () : Soup.Auth Gets the SoupAuth used by msg for authentication.
Soup.Message Method	set_proxy_auth (Auth *auth) : none Sets msg* to authenticate to its proxy using auth, which must have already been fully authenticated.
Soup.Message Method	get_proxy_auth () : Soup.Auth Gets the SoupAuth used by msg for authentication to its proxy.
Soup.Session Signal	authenticate (Session *self, Message object*, Auth p0, Boolean p1) : none

Documentation generated by Introspection Doc Generator Loosely Based on JsDoc Toolkit on Tue Jun 22 2010 16:34:59 GMT+0800 (HKT)