LassoSession

LassoSession — Principal Session

Synopsis


#include <lasso/lasso.h>


            LassoSession;
LassoSession* lasso_session_new             (void);
LassoSession* lasso_session_new_from_dump   (const gchar *dump);
void        lasso_session_destroy           (LassoSession *session);
gchar*      lasso_session_dump              (LassoSession *session);
GList*      lasso_session_get_assertions    (LassoSession *session,
                                             const char *provider_id);
gchar*      lasso_session_get_provider_index
                                            (LassoSession *session,
                                             gint index);
gboolean    lasso_session_is_empty          (LassoSession *session);

Object Hierarchy


  GObject
   +----LassoNode
         +----LassoSession

Description

Details

LassoSession

typedef struct {
	GHashTable *assertions;
	gboolean is_dirty;
} LassoSession;

lasso_session_new ()

LassoSession* lasso_session_new             (void);

Creates a new LassoSession.

Returns :

a newly created LassoSession

lasso_session_new_from_dump ()

LassoSession* lasso_session_new_from_dump   (const gchar *dump);

Restores the dump to a new LassoSession.

`dump` :	XML server dump
Returns :	a newly created LassoSession; or NULL if an error occured

lasso_session_destroy ()

void        lasso_session_destroy           (LassoSession *session);

Destroys a session.

session : a LassoSession

lasso_session_dump ()

gchar*      lasso_session_dump              (LassoSession *session);

Dumps session content to an XML string.

`session` :	a LassoSession
Returns :	the dump string. It must be freed by the caller.

lasso_session_get_assertions ()

GList*      lasso_session_get_assertions    (LassoSession *session,
                                             const char *provider_id);

Gets the assertions for the given provider_id.

`session` :	a LassoSession
`provider_id` :	the provider ID
Returns :	a GList* of LassoSamlAssertion. Caller must free the GList and the assertions it contains.

lasso_session_get_provider_index ()

gchar*      lasso_session_get_provider_index
                                            (LassoSession *session,
                                             gint index);

Looks up and returns the nth provider id.

`session` :	a LassoSession
`index` :	index of requested provider
Returns :	the provider id; or NULL if there were no nth provider. This string must be freed by the caller.

lasso_session_is_empty ()

gboolean    lasso_session_is_empty          (LassoSession *session);

Returns TRUE if session is empty.

`session` :	a LassoSession
Returns :	`TRUE` if empty