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 {
	/* Can actually contain LassoSamlAssertion or LassoSaml2Assertion */
	GHashTable *assertions; /* of LassoSamlAssertion */
	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 but NOT 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