From 7895bb8989684b4bec6e3a05c1287c94b47ee65e Mon Sep 17 00:00:00 2001 From: Imran Zaman Date: Mon, 25 Nov 2013 17:08:24 +0200 Subject: [PATCH] Release 2.0.3 Change-Id: I53c8ff52f4ebab8b0b3ae2c28a2ed00121460226 --- ChangeLog | 116 ++++ Makefile.in | 27 +- configure | 50 +- configure.ac | 5 +- dists/debian/rules | 0 dists/rpm/libgsignon-glib-suse.spec | 9 +- dists/rpm/libgsignon-glib-tizen.changes | 3 + dists/rpm/libgsignon-glib-tizen.spec | 8 +- docs/reference/Makefile.am | 2 +- docs/reference/Makefile.in | 16 +- docs/reference/html/SignonAuthSession.html | 99 ++- docs/reference/html/SignonIdentityInfo.html | 200 +++++- docs/reference/html/SignonSecurityContext.html | 319 +++++---- docs/reference/html/annotation-glossary.html | 2 +- docs/reference/html/api-index-1-8.html | 2 +- docs/reference/html/api-index-deprecated.html | 2 +- docs/reference/html/api-index-full.html | 100 +-- docs/reference/html/appendices.html | 8 +- docs/reference/html/credential-management.html | 16 +- ...code.AccountsSSO.gSingleSignOn.AuthService.html | 264 ------- ...code.AccountsSSO.gSingleSignOn.AuthSession.html | 167 ----- ...le.code.AccountsSSO.gSingleSignOn.Identity.html | 305 --------- docs/reference/html/gsso-examples.html | 199 ++++++ docs/reference/html/gsso-intro.html | 104 +++ docs/reference/html/index.html | 45 +- docs/reference/html/index.sgml | 318 ++++----- ...html => libgsignon-glib-SignonAuthService.html} | 250 ++++--- ...Error.html => libgsignon-glib-SignonError.html} | 54 +- ...ty.html => libgsignon-glib-SignonIdentity.html} | 759 ++++++++++----------- docs/reference/html/libgsignon-glib-objects.html | 16 +- docs/reference/html/libgsignon-glib-overview.html | 24 +- docs/reference/html/libgsignon-glib.devhelp2 | 269 ++++---- docs/reference/html/object-tree.html | 7 - docs/reference/html/signond-dbus-api.html | 52 -- docs/reference/libgsignon-glib-sections.txt | 162 +++++ docs/reference/libgsignon-glib.types | 3 - examples/Makefile.in | 590 ++++++++++++++++ tests/check_signon.c | 5 +- tools/prepare-tizen.sh | 4 +- 39 files changed, 2580 insertions(+), 2001 deletions(-) mode change 100644 => 100755 dists/debian/rules delete mode 100644 docs/reference/html/gdbus-com.google.code.AccountsSSO.gSingleSignOn.AuthService.html delete mode 100644 docs/reference/html/gdbus-com.google.code.AccountsSSO.gSingleSignOn.AuthSession.html delete mode 100644 docs/reference/html/gdbus-com.google.code.AccountsSSO.gSingleSignOn.Identity.html create mode 100644 docs/reference/html/gsso-examples.html create mode 100644 docs/reference/html/gsso-intro.html rename docs/reference/html/{SignonAuthService.html => libgsignon-glib-SignonAuthService.html} (62%) rename docs/reference/html/{SignonError.html => libgsignon-glib-SignonError.html} (81%) rename docs/reference/html/{SignonIdentity.html => libgsignon-glib-SignonIdentity.html} (56%) delete mode 100644 docs/reference/html/signond-dbus-api.html create mode 100644 docs/reference/libgsignon-glib-sections.txt create mode 100644 examples/Makefile.in diff --git a/ChangeLog b/ChangeLog index bd017e5..0efed50 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,119 @@ +2013-11-25 Imran Zaman + +Release 2.0.3 + +2013-11-25 Jussi Laako + +test: update test to better test access control cases + +2013-11-25 Jussi Laako + +configure: depend on gthread (needed on Debian Jessie at least) + +2013-11-22 Alexander Kanavin + +docs: added missing files to dist tarball + +2013-11-22 Imran Zaman + +Release 2.0.2 + +2013-11-06 Jussi Laako + +doc: change a sentence to say what it was intended to say... + +2013-11-05 Alexander Kanavin + +docs: fix up grammar + +2013-11-05 Jussi Laako + +example: fix function prototypes + +2013-11-05 Jussi Laako + +doc: fix documentation to match intended behavior + +2013-09-05 Alexander Kanavin + +docs: remove all autogenerated files with 'make clean' + +2013-09-04 Alexander Kanavin + +docs: rearrange APIs in more logical order + +2013-09-04 Alexander Kanavin + +docs: update documentation of SignonSecurityContext + +2013-09-04 Alexander Kanavin + +docs: update documentation of SignonIdentityInfo + +2013-09-04 Alexander Kanavin + +docs: update documentation of SignonIdentity + +2013-09-04 Alexander Kanavin + +docs: fix assorted warnings + +2013-09-04 Alexander Kanavin + +docs: fix up SignonError + +2013-09-04 Alexander Kanavin + +docs: fix up SignonAuthSession + +2013-09-04 Alexander Kanavin + +docs: fix up SignonAuthService docs + +2013-09-04 Alexander Kanavin + +docs: remove autogenerated libgsignon-glib-sections.txt file + +2013-09-04 Alexander Kanavin + +docs: drop irrelevant d-bus api reference + +2013-09-04 Alexander Kanavin + +docs: add introduction chapter + +2013-08-28 Alexander Kanavin + +docs: add a gSSO examples chapter + +2013-08-28 Alexander Kanavin + +examples: initial commit + +2013-08-23 Alexander Kanavin + +docs: add the documentation URL and a makefile recipe for documentation updates + +2013-07-10 Jussi Laako + +packaging: build debuginfo and debugsource packages on suse + +2013-07-10 Jussi Laako + +packaging: create debug package on debian/ubuntu + +2013-07-04 Jussi Laako + +packaging: add ubuntu/debian packaging + +2013-06-28 Jussi Laako + +packaging: require feature "gsignon" and update license tag + +2013-06-24 Imran Zaman + +Removes the stale files if deleted from the git repo + 2013-06-24 Imran Zaman Release 2.0.1 diff --git a/Makefile.in b/Makefile.in index 9c457e7..88cf522 100644 --- a/Makefile.in +++ b/Makefile.in @@ -109,7 +109,7 @@ AM_RECURSIVE_TARGETS = $(RECURSIVE_TARGETS:-recursive=) \ distdir dist dist-all distcheck ETAGS = etags CTAGS = ctags -DIST_SUBDIRS = libgsignon-glib docs pygobject tests +DIST_SUBDIRS = libgsignon-glib docs examples pygobject tests DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) distdir = $(PACKAGE)-$(VERSION) top_distdir = $(distdir) @@ -302,7 +302,8 @@ AM_DISTCHECK_CONFIGURE_FLAGS = \ --enable-gtk-doc \ --enable-introspection=yes -SUBDIRS = libgsignon-glib docs $(am__append_1) $(am__append_2) +SUBDIRS = libgsignon-glib docs examples $(am__append_1) \ + $(am__append_2) pkgconfigdir = $(libdir)/pkgconfig pkgconfig_in_files = libgsignon-glib.pc.in pkgconfig_DATA = $(pkgconfig_in_files:.pc.in=.pc) @@ -856,6 +857,9 @@ uninstall-am: uninstall-pkgconfigDATA dist-hook: git-changelog-hook + @echo + @echo "==== Run 'make update-online-doc' to update online documentation ====" + @echo git-changelog-hook: Makefile $(AM_V_at)if $(top_srcdir)/build-aux/missing --run git \ @@ -870,6 +874,25 @@ valgrind: .PHONY: git-changelog-hook +update-online-doc: + @tar zxf $(PACKAGE)-$(VERSION).tar.gz && \ + pushd . > /dev/null && \ + cd .. && \ + git clone https://code.google.com/p/accounts-sso.gsignon-docs/ ; \ + cd accounts-sso.gsignon-docs && \ + git pull ; \ + mkdir -p $(PACKAGE) && \ + rm -rf $(PACKAGE)/* && \ + popd > /dev/null && \ + cp -rf $(PACKAGE)-$(VERSION)/docs/reference/html/* ../accounts-sso.gsignon-docs/$(PACKAGE)/ && \ + pushd . > /dev/null && \ + cd ../accounts-sso.gsignon-docs && \ + git add $(PACKAGE)/* && \ + git commit -m "Updated documentation for $(PACKAGE) to version $(VERSION)" && \ + git push ; \ + popd > /dev/null && \ + rm -rf $(PACKAGE)-$(VERSION) + # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. .NOEXPORT: diff --git a/configure b/configure index 1a774ab..9e06377 100755 --- a/configure +++ b/configure @@ -1,6 +1,6 @@ #! /bin/sh # Guess values for system-dependent variables and create Makefiles. -# Generated by GNU Autoconf 2.68 for libgsignon-glib 2.0.1. +# Generated by GNU Autoconf 2.68 for libgsignon-glib 2.0.3. # # Report bugs to . # @@ -571,8 +571,8 @@ MAKEFLAGS= # Identity of this package. PACKAGE_NAME='libgsignon-glib' PACKAGE_TARNAME='libgsignon-glib' -PACKAGE_VERSION='2.0.1' -PACKAGE_STRING='libgsignon-glib 2.0.1' +PACKAGE_VERSION='2.0.3' +PACKAGE_STRING='libgsignon-glib 2.0.3' PACKAGE_BUGREPORT='http://code.google.com/p/accounts-sso/issues/entry' PACKAGE_URL='http://code.google.com/p/accounts-sso/' @@ -1369,7 +1369,7 @@ if test "$ac_init_help" = "long"; then # Omit some internal or obsolete options to make the list less imposing. # This message is too long to be a string in the A/UX 3.1 sh. cat <<_ACEOF -\`configure' configures libgsignon-glib 2.0.1 to adapt to many kinds of systems. +\`configure' configures libgsignon-glib 2.0.3 to adapt to many kinds of systems. Usage: $0 [OPTION]... [VAR=VALUE]... @@ -1439,7 +1439,7 @@ fi if test -n "$ac_init_help"; then case $ac_init_help in - short | recursive ) echo "Configuration of libgsignon-glib 2.0.1:";; + short | recursive ) echo "Configuration of libgsignon-glib 2.0.3:";; esac cat <<\_ACEOF @@ -1579,7 +1579,7 @@ fi test -n "$ac_init_help" && exit $ac_status if $ac_init_version; then cat <<\_ACEOF -libgsignon-glib configure 2.0.1 +libgsignon-glib configure 2.0.3 generated by GNU Autoconf 2.68 Copyright (C) 2010 Free Software Foundation, Inc. @@ -1857,7 +1857,7 @@ cat >config.log <<_ACEOF This file contains any messages produced by compilers while running configure, to aid debugging if configure makes a mistake. -It was created by libgsignon-glib $as_me 2.0.1, which was +It was created by libgsignon-glib $as_me 2.0.3, which was generated by GNU Autoconf 2.68. Invocation command line was $ $0 $@ @@ -2717,7 +2717,7 @@ fi # Define the identity of the package. PACKAGE='libgsignon-glib' - VERSION='2.0.1' + VERSION='2.0.3' cat >>confdefs.h <<_ACEOF @@ -12230,18 +12230,21 @@ if test -n "$DEPS_CFLAGS"; then { { $as_echo "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"gio-2.0 >= 2.30 gio-unix-2.0 glib-2.0 >= 2.32 - gobject-2.0\""; } >&5 + gobject-2.0, + gthread-2.0\""; } >&5 ($PKG_CONFIG --exists --print-errors "gio-2.0 >= 2.30 gio-unix-2.0 glib-2.0 >= 2.32 - gobject-2.0") 2>&5 + gobject-2.0, + gthread-2.0") 2>&5 ac_status=$? $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5 test $ac_status = 0; }; then pkg_cv_DEPS_CFLAGS=`$PKG_CONFIG --cflags "gio-2.0 >= 2.30 gio-unix-2.0 glib-2.0 >= 2.32 - gobject-2.0" 2>/dev/null` + gobject-2.0, + gthread-2.0" 2>/dev/null` test "x$?" != "x0" && pkg_failed=yes else pkg_failed=yes @@ -12256,18 +12259,21 @@ if test -n "$DEPS_LIBS"; then { { $as_echo "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"gio-2.0 >= 2.30 gio-unix-2.0 glib-2.0 >= 2.32 - gobject-2.0\""; } >&5 + gobject-2.0, + gthread-2.0\""; } >&5 ($PKG_CONFIG --exists --print-errors "gio-2.0 >= 2.30 gio-unix-2.0 glib-2.0 >= 2.32 - gobject-2.0") 2>&5 + gobject-2.0, + gthread-2.0") 2>&5 ac_status=$? $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5 test $ac_status = 0; }; then pkg_cv_DEPS_LIBS=`$PKG_CONFIG --libs "gio-2.0 >= 2.30 gio-unix-2.0 glib-2.0 >= 2.32 - gobject-2.0" 2>/dev/null` + gobject-2.0, + gthread-2.0" 2>/dev/null` test "x$?" != "x0" && pkg_failed=yes else pkg_failed=yes @@ -12291,12 +12297,14 @@ fi DEPS_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "gio-2.0 >= 2.30 gio-unix-2.0 glib-2.0 >= 2.32 - gobject-2.0" 2>&1` + gobject-2.0, + gthread-2.0" 2>&1` else DEPS_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "gio-2.0 >= 2.30 gio-unix-2.0 glib-2.0 >= 2.32 - gobject-2.0" 2>&1` + gobject-2.0, + gthread-2.0" 2>&1` fi # Put the nasty error message in config.log where it belongs echo "$DEPS_PKG_ERRORS" >&5 @@ -12304,7 +12312,8 @@ fi as_fn_error $? "Package requirements (gio-2.0 >= 2.30 gio-unix-2.0 glib-2.0 >= 2.32 - gobject-2.0) were not met: + gobject-2.0, + gthread-2.0) were not met: $DEPS_PKG_ERRORS @@ -13172,7 +13181,7 @@ else fi -ac_config_files="$ac_config_files Makefile libgsignon-glib/Makefile libgsignon-glib.pc docs/Makefile docs/reference/Makefile docs/reference/version.xml tests/Makefile pygobject/Makefile" +ac_config_files="$ac_config_files Makefile libgsignon-glib/Makefile libgsignon-glib.pc docs/Makefile docs/reference/Makefile docs/reference/version.xml tests/Makefile pygobject/Makefile examples/Makefile" cat >confcache <<\_ACEOF # This file is a shell script that caches the results of configure @@ -13744,7 +13753,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1 # report actual input values of CONFIG_FILES etc. instead of their # values after options handling. ac_log=" -This file was extended by libgsignon-glib $as_me 2.0.1, which was +This file was extended by libgsignon-glib $as_me 2.0.3, which was generated by GNU Autoconf 2.68. Invocation command line was CONFIG_FILES = $CONFIG_FILES @@ -13811,7 +13820,7 @@ _ACEOF cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1 ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`" ac_cs_version="\\ -libgsignon-glib config.status 2.0.1 +libgsignon-glib config.status 2.0.3 configured by $0, generated by GNU Autoconf 2.68, with options \\"\$ac_cs_config\\" @@ -14228,6 +14237,7 @@ do "docs/reference/version.xml") CONFIG_FILES="$CONFIG_FILES docs/reference/version.xml" ;; "tests/Makefile") CONFIG_FILES="$CONFIG_FILES tests/Makefile" ;; "pygobject/Makefile") CONFIG_FILES="$CONFIG_FILES pygobject/Makefile" ;; + "examples/Makefile") CONFIG_FILES="$CONFIG_FILES examples/Makefile" ;; *) as_fn_error $? "invalid argument: \`$ac_config_target'" "$LINENO" 5;; esac diff --git a/configure.ac b/configure.ac index 6c1be71..2cf6a8b 100644 --- a/configure.ac +++ b/configure.ac @@ -1,7 +1,7 @@ dnl Process this file with autoconf to produce a configure script. AC_PREREQ([2.64]) AC_INIT([libgsignon-glib], - [2.0.2], + [2.0.3], [http://code.google.com/p/accounts-sso/issues/entry], [libgsignon-glib], [http://code.google.com/p/accounts-sso/]) @@ -33,7 +33,8 @@ PKG_CHECK_MODULES( [gio-2.0 >= 2.30 gio-unix-2.0 glib-2.0 >= 2.32 - gobject-2.0]) + gobject-2.0, + gthread-2.0]) AC_SUBST(DEPS_CFLAGS) AC_SUBST(DEPS_LIBS) diff --git a/dists/debian/rules b/dists/debian/rules old mode 100644 new mode 100755 diff --git a/dists/rpm/libgsignon-glib-suse.spec b/dists/rpm/libgsignon-glib-suse.spec index c8cb082..ab84170 100644 --- a/dists/rpm/libgsignon-glib-suse.spec +++ b/dists/rpm/libgsignon-glib-suse.spec @@ -3,10 +3,10 @@ Name: libgsignon-glib Summary: GLib API for the SSO framework -Version: 2.0.2 -Release: 4 +Version: 2.0.3 +Release: 1 Group: System/Libraries -License: LGPL-2.1+ +License: LGPL-2.1 Source: %{name}-%{version}.tar.gz URL: https://01.org/gsso Requires: dbus-1 @@ -82,6 +82,9 @@ rm -rf %{buildroot} %changelog +* Mon Nov 25 2013 Imran Zaman +- Release 2.0.3 that fixes unit test and spec file bugs + * Fri Nov 22 2013 Imran Zaman - Release 2.0.2 that fixes package licensing info and added docs diff --git a/dists/rpm/libgsignon-glib-tizen.changes b/dists/rpm/libgsignon-glib-tizen.changes index 6ed2244..edbbf20 100644 --- a/dists/rpm/libgsignon-glib-tizen.changes +++ b/dists/rpm/libgsignon-glib-tizen.changes @@ -1,3 +1,6 @@ +* Mon Nov 25 2013 Imran Zaman +- Release 2.0.3 that fixes unit test and spec file bugs + * Fri Nov 22 2013 Imran Zaman - Release 2.0.2 that fixes package licensing info and added docs diff --git a/dists/rpm/libgsignon-glib-tizen.spec b/dists/rpm/libgsignon-glib-tizen.spec index 51c76cd..739c158 100644 --- a/dists/rpm/libgsignon-glib-tizen.spec +++ b/dists/rpm/libgsignon-glib-tizen.spec @@ -3,10 +3,10 @@ Name: libgsignon-glib Summary: GLib API for the SSO framework -Version: 2.0.2 -Release: 4 +Version: 2.0.3 +Release: 1 Group: System/Libraries -License: LGPL-2.1+ +License: LGPL-2.1 Source: %{name}-%{version}.tar.gz URL: https://01.org/gsso Requires: dbus-1 @@ -69,8 +69,6 @@ rm -rf %{buildroot} %{_includedir}/%{name}/*.h %{_libdir}/%{name}.so %{_libdir}/pkgconfig/%{name}.pc -%{_libdir}/girepository-1.0/gSignon-1.0.typelib -%{_datadir}/gir-1.0/gSignon-1.0.gir %{_datadir}/gtk-doc/html/%{name}/* %{_bindir}/gsso-example diff --git a/docs/reference/Makefile.am b/docs/reference/Makefile.am index 8790bb0..77140c8 100644 --- a/docs/reference/Makefile.am +++ b/docs/reference/Makefile.am @@ -67,7 +67,7 @@ HTML_IMAGES= # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE). # e.g. content_files=running.sgml building.sgml changes-2.0.sgml -content_files= +content_files=examples.xml introduction.xml # CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library. # Only needed if you are using gtkdoc-scangobj to dynamically query widget diff --git a/docs/reference/Makefile.in b/docs/reference/Makefile.in index 352716e..4adcb65 100644 --- a/docs/reference/Makefile.in +++ b/docs/reference/Makefile.in @@ -242,11 +242,13 @@ SCAN_OPTIONS = --rebuild-types --deprecated-guards="SIGNON_DISABLE_DEPRECATED" # Extra options to supply to gtkdoc-mkdb. # e.g. MKDB_OPTIONS=--sgml-mode --output-format=xml -MKDB_OPTIONS = --source-dir=$(top_srcdir)/libgsignon-glib --sgml-mode --output-format=xml --name-space=signon +MKDB_OPTIONS = --source-dir=$(top_srcdir)/libgsignon-glib --sgml-mode --output-format=xml --name-space=signon \ +--ignore-files="sso-auth-service-gen.c sso-auth-session-gen.c sso-identity-gen.c" + # Extra options to supply to gtkdoc-fixref. Not normally needed. # e.g. FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html -FIXXREF_OPTIONS = +FIXXREF_OPTIONS = --extra-dir=../../../accounts-sso.gsignond/docs/html # Used for dependencies. The docs will be rebuilt if any of these change. # e.g. HFILE_GLOB=$(top_srcdir)/gtk/*.h @@ -261,14 +263,17 @@ IGNORE_HFILES = \ signon-client-glib-gen.h \ signon-identity-glib-gen.h \ signon-dbus-queue.h \ + signon-enum-types.h \ signon-internals.h \ signon-proxy.h \ + signon-types.h \ signon-utils.h \ signon-marshal.h \ sso-auth-service-gen.h \ sso-auth-service.h \ sso-auth-session-gen.h \ - sso-identity-gen.h + sso-identity-gen.h \ + stamp-signon-enum-types.h # Images to copy into HTML directory. @@ -277,7 +282,7 @@ HTML_IMAGES = # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE). # e.g. content_files=running.sgml building.sgml changes-2.0.sgml -content_files = +content_files = examples.xml introduction.xml # CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library. # Only needed if you are using gtkdoc-scangobj to dynamically query widget @@ -326,7 +331,8 @@ REPORT_FILES = \ $(DOC_MODULE)-undeclared.txt \ $(DOC_MODULE)-unused.txt -CLEANFILES = $(SCANOBJ_FILES) $(REPORT_FILES) $(DOC_STAMPS) +CLEANFILES = $(SCANOBJ_FILES) $(REPORT_FILES) $(DOC_STAMPS) \ + $(DOC_MODULE)-*.txt $(DOC_MODULE).types @ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_HTML_FALSE@HTML_BUILD_STAMP = @ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_HTML_TRUE@HTML_BUILD_STAMP = html-build.stamp @ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_PDF_FALSE@PDF_BUILD_STAMP = diff --git a/docs/reference/html/SignonAuthSession.html b/docs/reference/html/SignonAuthSession.html index 2f8df17..4e6ad53 100644 --- a/docs/reference/html/SignonAuthSession.html +++ b/docs/reference/html/SignonAuthSession.html @@ -6,19 +6,19 @@ - - + + - + - + - + @@ -224,6 +218,24 @@ Opaque struct. Use the accessor functions below.
+

struct SignonAuthSessionClass

+
struct SignonAuthSessionClass {
+    GObjectClass parent;
+};
+
+

+Opaque struct. Use the accessor functions below. +

+
++ + + + +

GObjectClass parent;

reference to the parent class
+
+
+

SignonAuthSessionProcessCb ()

void                (*SignonAuthSessionProcessCb)       (SignonAuthSession *self,
                                                          GHashTable *session_data,
@@ -297,7 +309,7 @@ Callback to be passed to 
-
enum SignonSessionDataUiPolicy

+
enum SignonSessionDataUiPolicy

 
typedef enum {
     SIGNON_POLICY_DEFAULT = 0,
     SIGNON_POLICY_REQUEST_PASSWORD,
@@ -306,7 +318,7 @@ Callback to be passed to @@ -387,7 +399,7 @@ the specified method.
 
+SignonIdentity parent object.
@@ -418,11 +430,11 @@ function fails.
signon_auth_session_process has been deprecated since version 1.8 and should not be used in newly-written code. Use signon_auth_session_process_async() instead.

-Performs one step of the authentication process. If the SignonAuthSession
-object is bound to an existing identity, the identity properties such as
-username and password will be also passed to the authentication plugin, so
-there's no need to fill them into session_data.
-session_data can be used to add additional authentication parameters to the
+Performs one step of the authentication process. If the SignonIdentity that
+this session belongs to contains a username and a password, they will be also 
+passed to the authentication plugin, otherwise they should be set directly in
+session_data.
+session_data should be used to add additional authentication parameters to the
 session, or to override the parameters otherwise taken from the identity.
 

 


 
parent :

 
-SignonIdentity parent object.
 

 

 
method_name :

 
 
 
 

@@ -463,13 +475,19 @@ session, or to override the parameters otherwise taken from the identity.
                                                          GAsyncReadyCallback callback,
                                                          gpointer user_data);

-Performs one step of the authentication process. If the SignonAuthSession
-object is bound to an existing identity, the identity properties such as
-username and password will be also passed to the authentication plugin, so
-there's no need to fill them into session_data.
-session_data can be used to add additional authentication parameters to the
+Performs one step of the authentication process. If the SignonIdentity that
+this session belongs to contains a username and a password, the daemon will
+pass them to the authentication plugin, otherwise they should be set directly in
+session_data.
+session_data should be used to add additional authentication parameters to the
 session, or to override the parameters otherwise taken from the identity.
 

+

+What specific parameters should be used can be found from authentication plugins'
+documentation (look for parameters that are expected in gsignond_plugin_request_initial()
+for the first step, and parameters that are expected in gsignond_plugin_request() for
+the subsequent steps). See, for example, GSignondPasswordPlugin and GSignondDigestPlugin.
+

 
 

@@ -479,7 +497,7 @@ session, or to override the parameters otherwise taken from the identity.
 
-
@@ -533,7 +551,11 @@ Collect the result of the Returns :

 
+authentication reply. As with signon_auth_session_process_async(), specific
+parameters contained in the GVariant can be found from plugins' documentation:
+"response-final" for the final response, and "response"
+for the intermediate responses. See, for example, GSignondPasswordPlugin
+and GSignondDigestPlugin.

 
 
 

 
session_data :
a dictionary of parameters. [transfer floating]
+a dictionary of parameters. [transfer full]
 
 

 
a GVariant of type G_VARIANT_TYPE_VARDICT containing the
-authentication reply.
@@ -548,9 +570,10 @@ authentication reply. SignonAuthSessionQueryAvailableMechanismsCb cb, gpointer user_data);

-Queries the mechanisms available for this authentication session. the result +Queries the mechanisms available for this authentication session. The result will be the intersection between wanted_mechanisms and the mechanisms -supported by the authentication plugin. +supported by the authentication plugin (and allowed by the SignonIdentity that this +session belongs to).

@@ -580,7 +603,7 @@ supported by the authentication plugin.

Property Details

The "identity" property

-
  "identity"                 SignonIdentity*       : Read / Write / Construct Only
+
  "identity"                 SignonIdentity*       : Read / Write / Construct Only

Identity Object construct parameter.

@@ -594,6 +617,8 @@ supported by the authentication plugin. gpointer user_data) : Action

Emitted when the state of the SignonAuthSession changes. +FIXME: state should be registered as a GLib type (or use one from +libgsignond-common)

diff --git a/docs/reference/html/SignonIdentityInfo.html b/docs/reference/html/SignonIdentityInfo.html index 5d573a4..b04cf1e 100644 --- a/docs/reference/html/SignonIdentityInfo.html +++ b/docs/reference/html/SignonIdentityInfo.html @@ -6,7 +6,7 @@ - + @@ -14,7 +14,7 @@
- + @@ -33,23 +33,28 @@

SignonIdentityInfo

-

SignonIdentityInfo — Extra data for a SignonIdentity.

+

SignonIdentityInfo — data contained in a SignonIdentity.

Synopsis

-
                    SignonIdentityInfo;
-enum                SignonIdentityType;
+
                    SignonIdentityInfo;
+enum                SignonIdentityType;
+void                signon_identity_info_access_control_list_append
+                                                        (SignonIdentityInfo *info,
+                                                         SignonSecurityContext *security_context);
 SignonIdentityInfo * signon_identity_info_copy          (const SignonIdentityInfo *other);
 void                signon_identity_info_free           (SignonIdentityInfo *info);
 const SignonSecurityContextList * signon_identity_info_get_access_control_list
                                                         (const SignonIdentityInfo *info);
 const gchar *       signon_identity_info_get_caption    (const SignonIdentityInfo *info);
 gint                signon_identity_info_get_id         (const SignonIdentityInfo *info);
-SignonIdentityType  signon_identity_info_get_identity_type
+SignonIdentityType  signon_identity_info_get_identity_type
                                                         (const SignonIdentityInfo *info);
 const GHashTable *  signon_identity_info_get_methods    (const SignonIdentityInfo *info);
+const SignonSecurityContext * signon_identity_info_get_owner
+                                                        (const SignonIdentityInfo *info);
 const gchar * const * signon_identity_info_get_realms   (const SignonIdentityInfo *info);
 gboolean            signon_identity_info_get_storing_secret
                                                         (const SignonIdentityInfo *info);
@@ -64,10 +69,18 @@ const const gchar *caption);
 void                signon_identity_info_set_identity_type
                                                         (SignonIdentityInfo *info,
-                                                         SignonIdentityType type);
+                                                         SignonIdentityType type);
 void                signon_identity_info_set_method     (SignonIdentityInfo *info,
                                                          const gchar *method,
                                                          const gchar * const *mechanisms);
+void                signon_identity_info_set_methods    (SignonIdentityInfo *info,
+                                                         const GHashTable *methods);
+void                signon_identity_info_set_owner      (SignonIdentityInfo *info,
+                                                         const SignonSecurityContext *owner);
+void                signon_identity_info_set_owner_from_values
+                                                        (SignonIdentityInfo *info,
+                                                         const gchar *system_context,
+                                                         const gchar *application_context);
 void                signon_identity_info_set_realms     (SignonIdentityInfo *info,
                                                          const gchar * const *realms);
 void                signon_identity_info_set_secret     (SignonIdentityInfo *info,
@@ -83,15 +96,16 @@ const 
-  GFlags
-   +----SignonIdentityType
-

Description

-Extra data retreived from a SignonIdentity. +SignonIdentityInfo represents data contained in a database record for an identity +and provides getters and setters for individual items. +

+

+See SignonIdentity for a detailed discussion +of what each item means and how and when it's used.

@@ -105,7 +119,7 @@ Opaque struct. Use the accessor functions below.
-

enum SignonIdentityType

+

enum SignonIdentityType

typedef enum {
     SIGNON_IDENTITY_TYPE_OTHER = 0,
     SIGNON_IDENTITY_TYPE_APP = 1 << 0,
@@ -114,7 +128,7 @@ Opaque struct. Use the accessor functions below.
 } SignonIdentityType;

-Types used in SignonIdentityInfo. +Identity types used in SignonIdentityInfo.

@@ -144,6 +158,30 @@ Types used in +

signon_identity_info_access_control_list_append ()

+
void                signon_identity_info_access_control_list_append
+                                                        (SignonIdentityInfo *info,
+                                                         SignonSecurityContext *security_context);
+

+Appends a new SignonSecurityContext item to the access control list. +

+
++ + + + + + + + + + +

info :

the SignonIdentityInfo.

security_context :

a security context to be appended. [transfer full] +
+
+
+

signon_identity_info_copy ()

SignonIdentityInfo * signon_identity_info_copy          (const SignonIdentityInfo *other);

@@ -184,7 +222,7 @@ Destroys the given const SignonSecurityContextList * signon_identity_info_get_access_control_list (const SignonIdentityInfo *info);

-Get an array of ACL statements of the identity. +Get an access control list associated with an identity.

@@ -227,7 +265,7 @@ Get the display name of info.

signon_identity_info_get_id ()

gint                signon_identity_info_get_id         (const SignonIdentityInfo *info);

-Get the numeric ID of info. +Get the numeric identity ID of info.

@@ -246,7 +284,7 @@ Get the numeric ID of info.

signon_identity_info_get_identity_type ()

-
SignonIdentityType  signon_identity_info_get_identity_type
+
SignonIdentityType  signon_identity_info_get_identity_type
                                                         (const SignonIdentityInfo *info);

 

 Get the type of the identity.
@@ -270,7 +308,8 @@ Get the type of the identity.
 
signon_identity_info_get_methods ()

 
const GHashTable *  signon_identity_info_get_methods    (const SignonIdentityInfo *info);

 

-Get a hash table of the methods and mechanisms of info.
+Get a hash table of the methods and mechanisms of info. See 
+signon_identity_info_set_methods().
@@ -281,8 +320,31 @@ Get a hash table of the methods and mechanisms of in - + + +

Returns :

the table of allowed -methods and mechanisms. [transfer none][element-type utf8 GStrv] +(element-type utf8 GStrv): the table of allowed +methods and mechanisms. [transfer none] +
+
+
+
+

signon_identity_info_get_owner ()

+
const SignonSecurityContext * signon_identity_info_get_owner
+                                                        (const SignonIdentityInfo *info);
+

+Get identity owner's security context. +

+
++ + + + + + + + @@ -316,7 +378,7 @@ Get an array of the realms of info. 
gboolean            signon_identity_info_get_storing_secret
                                                         (const SignonIdentityInfo *info);

-Get whether the secret of info should be stored. +Get whether the secret of info should be stored by gSSO in the secret database.

info :

the SignonIdentityInfo.

Returns :

a security context. [transfer none]
@@ -328,7 +390,7 @@ Get whether the secret of info should be +TRUE if gSSO must store the secret, FALSE otherwise.

Returns :

 -TRUE if Signon must store the secret, FALSE otherwise.
@@ -338,7 +400,7 @@ Get whether the secret of info should be

signon_identity_info_get_username ()

const gchar *       signon_identity_info_get_username   (const SignonIdentityInfo *info);

-Get the username of info. +Get the username associated with an identity.

@@ -375,8 +437,7 @@ Creates a new void signon_identity_info_remove_method (SignonIdentityInfo *info, const gchar *method);

-Remove method from the list of allowed authentication methods. If all -methods are removed, then all methods are allowed. +Remove method from the list of allowed authentication methods.

@@ -399,8 +460,7 @@ methods are removed, then all methods are allowed. (SignonIdentityInfo *info, const SignonSecurityContextList *access_control_list);

-Specifies the ACL for this identity. The actual meaning of the ACL depends -on the security framework used by signond. Ownership of the list is trans +Set an access control list associated with an identity.

@@ -411,7 +471,8 @@ on the security framework used by signond. Ownership of the list is trans - +

access_control_list :

(transfer none) a list of ACL security contexts.a list of ACL security contexts. [transfer none] +
@@ -443,7 +504,7 @@ Sets the caption (display name) for the identity.

signon_identity_info_set_identity_type ()

void                signon_identity_info_set_identity_type
                                                         (SignonIdentityInfo *info,
-                                                         SignonIdentityType type);
+ SignonIdentityType type);

Specifies the type of this identity.

@@ -468,8 +529,7 @@ Specifies the type of this identity. const gchar *method, const gchar * const *mechanisms);

-Adds a method to the list of allowed methods. -Mechanisms are method-specific functions. +Adds a method to the list of allowed authentication methods.

@@ -484,7 +544,81 @@ Mechanisms are method-specific functions. - + + + +

mechanisms :

a NULL-termianted list of mechanisms.a NULL-terminated list of mechanisms.
+
+
+
+

signon_identity_info_set_methods ()

+
void                signon_identity_info_set_methods    (SignonIdentityInfo *info,
+                                                         const GHashTable *methods);
+

+Set authentication methods that are allowed to be used with this identity. +

+
++ + + + + + + + + + +

info :

the SignonIdentityInfo.

methods :

(element-type utf8 GStrv): methods. [transfer none] +
+
+
+
+

signon_identity_info_set_owner ()

+
void                signon_identity_info_set_owner      (SignonIdentityInfo *info,
+                                                         const SignonSecurityContext *owner);
+

+Set identity owner's security context. +

+
++ + + + + + + + + + +

info :

the SignonIdentityInfo.

owner :

a security context of owner. [transfer none] +
+
+
+
+

signon_identity_info_set_owner_from_values ()

+
void                signon_identity_info_set_owner_from_values
+                                                        (SignonIdentityInfo *info,
+                                                         const gchar *system_context,
+                                                         const gchar *application_context);
+

+Set identity owner's security context. +

+
++ + + + + + + + + + + +

info :

the SignonIdentityInfo.

system_context :

owner's system context.

application_context :

owner's application context.
@@ -518,7 +652,7 @@ Specify what realms this identity can be used in. const gchar *secret, gboolean store_secret);

-Sets the secret (password) for the identity, and whether the signon daemon +Sets the secret (password) for the identity, and whether the gSSO daemon should remember it.

diff --git a/docs/reference/html/SignonSecurityContext.html b/docs/reference/html/SignonSecurityContext.html index cc58972..d980fda 100644 --- a/docs/reference/html/SignonSecurityContext.html +++ b/docs/reference/html/SignonSecurityContext.html @@ -7,7 +7,7 @@ - + @@ -18,7 +18,7 @@ - + - +
Up Home libgsignon-glib Reference ManualNextNext
Top @@ -33,7 +33,7 @@

SignonSecurityContext

-

SignonSecurityContext — Representation of a security context.

+

SignonSecurityContext — representation of a security context.
@@ -41,33 +41,33 @@

Synopsis

struct              SignonSecurityContext;
 typedef             SignonSecurityContextList;
-SignonSecurityContext * signon_security_context_new     ();
-SignonSecurityContext * signon_security_context_new_from_values
-                                                        (const gchar *system_context,
-                                                         const gchar *application_context);
+GVariant *          signon_security_context_build_variant
+                                                        (const SignonSecurityContext *ctx);
 SignonSecurityContext * signon_security_context_copy    (const SignonSecurityContext *src_ctx);
+SignonSecurityContext * signon_security_context_deconstruct_variant
+                                                        (GVariant *variant);
 void                signon_security_context_free        (SignonSecurityContext *ctx);
-void                signon_security_context_set_system_context
-                                                        (SignonSecurityContext *ctx,
-                                                         const gchar *system_context);
-const gchar *       signon_security_context_get_system_context
-                                                        (const SignonSecurityContext *ctx);
-void                signon_security_context_set_application_context
-                                                        (SignonSecurityContext *ctx,
-                                                         const gchar *application_context);
 const gchar *       signon_security_context_get_application_context
                                                         (const SignonSecurityContext *ctx);
-GVariant *          signon_security_context_build_variant
+const gchar *       signon_security_context_get_system_context
                                                         (const SignonSecurityContext *ctx);
-SignonSecurityContext * signon_security_context_deconstruct_variant
-                                                        (GVariant *variant);
 GVariant *          signon_security_context_list_build_variant
                                                         (const SignonSecurityContextList *list);
-SignonSecurityContextList * signon_security_context_list_deconstruct_variant
-                                                        (GVariant *variant);
 SignonSecurityContextList * signon_security_context_list_copy
                                                         (const SignonSecurityContextList *src_list);
+SignonSecurityContextList * signon_security_context_list_deconstruct_variant
+                                                        (GVariant *variant);
 void                signon_security_context_list_free   (SignonSecurityContextList *seclist);
+SignonSecurityContext * signon_security_context_new     ();
+SignonSecurityContext * signon_security_context_new_from_values
+                                                        (const gchar *system_context,
+                                                         const gchar *application_context);
+void                signon_security_context_set_application_context
+                                                        (SignonSecurityContext *ctx,
+                                                         const gchar *application_context);
+void                signon_security_context_set_system_context
+                                                        (SignonSecurityContext *ctx,
+                                                         const gchar *system_context);
@@ -81,7 +81,41 @@ const

Description

The SignonSecurityContext represents a security context within -system and also within application. +system and also within application. Security contexts are used: +

+

+

+
    +

  • within identities to specify the owner of the identity, and +users of the identity (items on the access control list). See SignonIdentity.

    • +

  • by gSSO daemon to identify the application accessing the gSSO service and +to determine if the application is an identity's owner, or is on the identity's access +control list, and make access control decisions accordingly.

    • +
+

+

+

+SignonSecurityContext contains two strings: a system context and an +application context. +

+

+System context can be a binary path, SMACK-label, or MSSF token. Specific +interpretation of the system context value is performed by a gSSO extension module. +The default gSSO extension expects binary paths. +

+

+Application context identifies a script or a webpage within an application, +and it's used for providing access control to runtime environments (when making an access +control decision requires not only a binary identifier, but also information +about what the binary is doing). +

+

+System context and application context can contain a wildcard +operator "*" to match 'any', while "" matches 'none' when a default +gSSO extension is used. The system context is always evaluated first +and if a match is found, only then the application context is evaluated. +Check the documentation of a platform specific extension to determine +any particular match rules used by a custom ACM (Access Control Manager).

@@ -94,7 +128,7 @@ system and also within application. };

-Security context descriptor. Practically a string tuple. +Security context descriptor used for access control checks.

@@ -122,63 +156,70 @@ GList of -

signon_security_context_new ()

-
SignonSecurityContext * signon_security_context_new     ();
+

signon_security_context_build_variant ()

+
GVariant *          signon_security_context_build_variant
+                                                        (const SignonSecurityContext *ctx);

-Allocates a new security context item. +Build a GVariant of type "(ss)" from a SignonSecurityContext item.

- + + + + + + - - + + +

ctx :

 +SignonSecurityContext item.

Returns :

(transfer full) allocated SignonSecurityContext.
GVariant construct of a SignonSecurityContext. [transfer full] +
-

signon_security_context_new_from_values ()

-
SignonSecurityContext * signon_security_context_new_from_values
-                                                        (const gchar *system_context,
-                                                         const gchar *application_context);
+

signon_security_context_copy ()

+
SignonSecurityContext * signon_security_context_copy    (const SignonSecurityContext *src_ctx);

-Allocates and initializes a new security context item. +Copy a security context item.

- - - - - - + + - +

system_context :

system security context (such as SMACK/MSSF label/token).

application_context :

application security context (such as a script name).

src_ctx :

source security context to copy.

Returns :

(transfer full) allocated SignonSecurityContext.a copy of the SignonSecurityContext item. [transfer full] +
-

signon_security_context_copy ()

-
SignonSecurityContext * signon_security_context_copy    (const SignonSecurityContext *src_ctx);
+

signon_security_context_deconstruct_variant ()

+
SignonSecurityContext * signon_security_context_deconstruct_variant
+                                                        (GVariant *variant);

-Copy a security context item. +Builds a SignonSecurityContext item from a GVariant of type "(ss)".

- - + + - +

src_ctx :

source security context to copy.

variant :

GVariant item with a SignonSecurityContext construct.

Returns :

(transfer full) a copy of the SignonSecurityContext item. +SignonSecurityContext item. [transfer full] +
@@ -201,13 +242,12 @@ Frees a security context item.
-

signon_security_context_set_system_context ()

-
void                signon_security_context_set_system_context
-                                                        (SignonSecurityContext *ctx,
-                                                         const gchar *system_context);
+

signon_security_context_get_application_context ()

+
const gchar *       signon_security_context_get_application_context
+                                                        (const SignonSecurityContext *ctx);

-Sets the system context part (such as SMACK label or MSSF token) of the -SignonSecurityContext. +Get the application context part (such as script name or a web page) of +the SignonSecurityContext.

@@ -218,8 +258,9 @@ Sets the system context part (such as SMACK label or MSSF token) of the SignonSecurityContext item. - - + +

system_context :

system security context.

Returns :

application context. [transfer none] +
@@ -243,149 +284,142 @@ Get the system context part (such as SMACK label or MSSF token) of the

Returns :

(transfer none) system context.system context. [transfer none] +
-

signon_security_context_set_application_context ()

-
void                signon_security_context_set_application_context
-                                                        (SignonSecurityContext *ctx,
-                                                         const gchar *application_context);
+

signon_security_context_list_build_variant ()

+
GVariant *          signon_security_context_list_build_variant
+                                                        (const SignonSecurityContextList *list);

-Sets the application context part (such as a script name or a web page) of -the SignonSecurityContext. +Builds a GVariant of type "a(ss)" from a GList of SignonSecurityContext +items.

- + +SignonSecurityContextList item. - - + +

ctx :

list :

 -SignonSecurityContext item.

application_context :

application security context.

Returns :

GVariant construct of a SignonSecurityContextList. [transfer full] +
-

signon_security_context_get_application_context ()

-
const gchar *       signon_security_context_get_application_context
-                                                        (const SignonSecurityContext *ctx);
+

signon_security_context_list_copy ()

+
SignonSecurityContextList * signon_security_context_list_copy
+                                                        (const SignonSecurityContextList *src_list);

-Get the application context part (such as script name or a web page) of -the SignonSecurityContext. +Copies a GList of SignonSecurityContext items.

- - + + - +

ctx :

 -SignonSecurityContext item.

src_list :

source SignonSecurityContextList.

Returns :

(transfer none) application context. +SignonSecurityContextList item. [transfer full] +
-

signon_security_context_build_variant ()

-
GVariant *          signon_security_context_build_variant
-                                                        (const SignonSecurityContext *ctx);
+

signon_security_context_list_deconstruct_variant ()

+
SignonSecurityContextList * signon_security_context_list_deconstruct_variant
+                                                        (GVariant *variant);

-Build a GVariant of type "(ss)" from a SignonSecurityContext item. +Builds a GList of SignonSecurityContext items from a GVariant of type +"a(ss)".

- - + + - +

ctx :

 -SignonSecurityContext item.

variant :

GVariant item with a list of security context tuples.

Returns :

(transfer full) GVariant construct of a SignonSecurityContext. +SignonSecurityContextList item. [transfer full] +
-

signon_security_context_deconstruct_variant ()

-
SignonSecurityContext * signon_security_context_deconstruct_variant
-                                                        (GVariant *variant);
+

signon_security_context_list_free ()

+
void                signon_security_context_list_free   (SignonSecurityContextList *seclist);

-Builds a SignonSecurityContext item from a GVariant of type "(ss)". +Frees all items and the GList of SignonSecurityContext.

- - - - - - - - - - + + + +

variant :

GVariant item with a SignonSecurityContext construct.

Returns :

(transfer full) SignonSecurityContext item.

seclist :

 +SignonSecurityContextList item. [transfer full] +
-

signon_security_context_list_build_variant ()

-
GVariant *          signon_security_context_list_build_variant
-                                                        (const SignonSecurityContextList *list);
+

signon_security_context_new ()

+
SignonSecurityContext * signon_security_context_new     ();

-Builds a GVariant of type "a(ss)" from a GList of SignonSecurityContext -items. +Allocates a new security context item.

- - - - - - + - - - + +

list :

 -SignonSecurityContextList item.

Returns :

(transfer full) GVariant construct of a SignonSecurityContextList.
allocated SignonSecurityContext. [transfer full] +
-

signon_security_context_list_deconstruct_variant ()

-
SignonSecurityContextList * signon_security_context_list_deconstruct_variant
-                                                        (GVariant *variant);
+

signon_security_context_new_from_values ()

+
SignonSecurityContext * signon_security_context_new_from_values
+                                                        (const gchar *system_context,
+                                                         const gchar *application_context);

-Builds a GList of SignonSecurityContext items from a GVariant of type -"a(ss)". +Allocates and initializes a new security context item.

- - + + + + + + - @@ -393,41 +427,52 @@ Builds a GList of -

signon_security_context_list_copy ()

-
SignonSecurityContextList * signon_security_context_list_copy
-                                                        (const SignonSecurityContextList *src_list);
+

signon_security_context_set_application_context ()

+
void                signon_security_context_set_application_context
+                                                        (SignonSecurityContext *ctx,
+                                                         const gchar *application_context);

-Copies a GList of SignonSecurityContext items. +Sets the application context part (such as a script name or a web page) of +the SignonSecurityContext.

variant :

GVariant item with a list of security context tuples.

system_context :

system security context (such as SMACK/MSSF label/token).

application_context :

application security context (such as a script name).

Returns :

 -SignonSecurityContextList item. [transfer full] +allocated SignonSecurityContext. [transfer full]
- - + + - - + +

src_list :

source SignonSecurityContextList.

ctx :

 +SignonSecurityContext item.

Returns :

 -SignonSecurityContextList item. [transfer full] -

application_context :

application security context.
-

signon_security_context_list_free ()

-
void                signon_security_context_list_free   (SignonSecurityContextList *seclist);
+

signon_security_context_set_system_context ()

+
void                signon_security_context_set_system_context
+                                                        (SignonSecurityContext *ctx,
+                                                         const gchar *system_context);

-Frees all items and the GList of SignonSecurityContext. +Sets the system context part (such as SMACK label or MSSF token) of the +SignonSecurityContext.

- - - - + + + + + + + + + +

seclist :

(transfer full) SignonSecurityContextList item.

ctx :

 +SignonSecurityContext item.

system_context :

system security context.
diff --git a/docs/reference/html/annotation-glossary.html b/docs/reference/html/annotation-glossary.html index 3b7b303..e6044a1 100644 --- a/docs/reference/html/annotation-glossary.html +++ b/docs/reference/html/annotation-glossary.html @@ -5,7 +5,7 @@ Annotation Glossary - + diff --git a/docs/reference/html/api-index-1-8.html b/docs/reference/html/api-index-1-8.html index 951f05f..de0e9bb 100644 --- a/docs/reference/html/api-index-1-8.html +++ b/docs/reference/html/api-index-1-8.html @@ -5,7 +5,7 @@ Index of new symbols in 1.8 - + diff --git a/docs/reference/html/api-index-deprecated.html b/docs/reference/html/api-index-deprecated.html index 233ec90..07b2829 100644 --- a/docs/reference/html/api-index-deprecated.html +++ b/docs/reference/html/api-index-deprecated.html @@ -5,7 +5,7 @@ Index of deprecated symbols - + diff --git a/docs/reference/html/api-index-full.html b/docs/reference/html/api-index-full.html index 5766612..140fa9d 100644 --- a/docs/reference/html/api-index-full.html +++ b/docs/reference/html/api-index-full.html @@ -5,8 +5,8 @@ API Index - - + + @@ -37,7 +37,7 @@ API Index

A

-SignonAuthService, struct in SignonAuthService +SignonAuthServiceClass, struct in SignonAuthService
@@ -53,6 +53,10 @@
+SignonAuthSessionClass, struct in SignonAuthSession +
+
+
SignonAuthSessionProcessCb, user_function in SignonAuthSession
@@ -61,19 +65,19 @@
-signon_auth_service_new, function in SignonAuthService +signon_auth_service_new, function in SignonAuthService
-signon_auth_service_query_identities, function in SignonAuthService +signon_auth_service_query_identities, function in SignonAuthService
-signon_auth_service_query_mechanisms, function in SignonAuthService +signon_auth_service_query_mechanisms, function in SignonAuthService
-signon_auth_service_query_methods, function in SignonAuthService +signon_auth_service_query_methods, function in SignonAuthService
@@ -106,28 +110,24 @@

E

-SignonError, enum in SignonError -
-
-

I

-
-SignonIdentity, struct in SignonIdentity +SignonError, enum in SignonError
-SignonIdentity::signout, object signal in SignonIdentity +SIGNON_ERROR, macro in SignonError
-SignonIdentity:app-ctx, object property in SignonIdentity +signon_error_quark, function in SignonError
+

I

-SignonIdentity:id, object property in SignonIdentity +SignonIdentityClass, struct in SignonIdentity
-SignonIdentityFilter, typedef in SignonIdentity +SignonIdentityFilter, typedef in SignonAuthService
@@ -135,67 +135,67 @@
-SignonIdentityInfoCb, user_function in SignonIdentity +SignonIdentityInfoCb, user_function in SignonIdentity
-SignonIdentityList, typedef in SignonIdentity +SignonIdentityList, typedef in SignonAuthService
-SignonIdentityReferenceAddedCb, typedef in SignonIdentity +SignonIdentityReferenceAddedCb, typedef in SignonIdentity
-SignonIdentityReferenceRemovedCb, typedef in SignonIdentity +SignonIdentityReferenceRemovedCb, typedef in SignonIdentity
-SignonIdentityRemovedCb, typedef in SignonIdentity +SignonIdentityRemovedCb, typedef in SignonIdentity
-SignonIdentitySessionReadyCb, user_function in SignonIdentity +SignonIdentitySessionReadyCb, user_function in SignonIdentity
-SignonIdentitySignedOutCb, typedef in SignonIdentity +SignonIdentitySignedOutCb, typedef in SignonIdentity
-SignonIdentityStoreCredentialsCb, user_function in SignonIdentity +SignonIdentityStoreCredentialsCb, user_function in SignonIdentity
-SignonIdentityType, enum in SignonIdentityInfo +SignonIdentityType, enum in SignonIdentityInfo
-SignonIdentityVerifyCb, user_function in SignonIdentity +SignonIdentityVerifyCb, user_function in SignonIdentity
-SignonIdentityVoidCb, user_function in SignonIdentity +SignonIdentityVoidCb, user_function in SignonIdentity
-signon_identity_add_reference, function in SignonIdentity +signon_identity_add_reference, function in SignonIdentity
-signon_identity_create_session, function in SignonIdentity +signon_identity_create_session, function in SignonIdentity
-signon_identity_get_auth_session, function in SignonIdentity +signon_identity_get_auth_session, function in SignonIdentity
-signon_identity_get_last_error, function in SignonIdentity +signon_identity_get_last_error, function in SignonIdentity
-signon_identity_info_access_control_list_append, function in SignonIdentity +signon_identity_info_access_control_list_append, function in SignonIdentityInfo
@@ -227,7 +227,7 @@
-signon_identity_info_get_owner, function in SignonIdentity +signon_identity_info_get_owner, function in SignonIdentityInfo
@@ -267,15 +267,15 @@
-signon_identity_info_set_methods, function in SignonIdentity +signon_identity_info_set_methods, function in SignonIdentityInfo
-signon_identity_info_set_owner, function in SignonIdentity +signon_identity_info_set_owner, function in SignonIdentityInfo
-signon_identity_info_set_owner_from_values, function in SignonIdentity +signon_identity_info_set_owner_from_values, function in SignonIdentityInfo
@@ -291,52 +291,52 @@
-signon_identity_new, function in SignonIdentity +signon_identity_new, function in SignonIdentity
-signon_identity_new_from_db, function in SignonIdentity +signon_identity_new_from_db, function in SignonIdentity
-signon_identity_query_info, function in SignonIdentity +signon_identity_query_info, function in SignonIdentity
-signon_identity_remove, function in SignonIdentity +signon_identity_remove, function in SignonIdentity
-signon_identity_remove_reference, function in SignonIdentity +signon_identity_remove_reference, function in SignonIdentity
-signon_identity_signout, function in SignonIdentity +signon_identity_signout, function in SignonIdentity
-signon_identity_store_credentials_with_args, function in SignonIdentity +signon_identity_store_credentials_with_args, function in SignonIdentity
-signon_identity_store_credentials_with_info, function in SignonIdentity +signon_identity_store_credentials_with_info, function in SignonIdentity
-signon_identity_verify_secret, function in SignonIdentity +signon_identity_verify_secret, function in SignonIdentity

Q

-SignonQueryIdentitiesCb, user_function in SignonAuthService +SignonQueryIdentitiesCb, user_function in SignonAuthService
-SignonQueryMechanismCb, user_function in SignonAuthService +SignonQueryMechanismCb, user_function in SignonAuthService
-SignonQueryMethodsCb, user_function in SignonAuthService +SignonQueryMethodsCb, user_function in SignonAuthService

S

@@ -405,7 +405,7 @@
-SignonSessionDataUiPolicy, enum in SignonAuthSession +SignonSessionDataUiPolicy, enum in SignonAuthSession
diff --git a/docs/reference/html/appendices.html b/docs/reference/html/appendices.html index f68f145..e53479c 100644 --- a/docs/reference/html/appendices.html +++ b/docs/reference/html/appendices.html @@ -2,18 +2,18 @@ -Part IV. Appendices +Part III. Appendices - + - + @@ -21,7 +21,7 @@

-Part IV. Appendices

+Part III. Appendices

Table of Contents

diff --git a/docs/reference/html/credential-management.html b/docs/reference/html/credential-management.html index 7f831e5..7ca3b20 100644 --- a/docs/reference/html/credential-management.html +++ b/docs/reference/html/credential-management.html @@ -7,7 +7,7 @@ - + @@ -17,29 +17,29 @@ Up Home libgsignon-glib Reference Manual -Next +Next

Credential management

-SignonAuthService — The authorization service object +SignonAuthService — the authorization service object
-SignonAuthSession — Authentication session handler. +SignonIdentity — client side presentation of a credential.
-SignonError — Possible errors from Signon. +SignonIdentityInfo — data contained in a SignonIdentity.
-SignonIdentity — Client side presentation of a credential. +SignonSecurityContext — representation of a security context.
-SignonIdentityInfo — Extra data for a SignonIdentity. +SignonAuthSession — the authentication session object
-SignonSecurityContext — Representation of a security context. +SignonError — possible gSSO errors
diff --git a/docs/reference/html/gdbus-com.google.code.AccountsSSO.gSingleSignOn.AuthService.html b/docs/reference/html/gdbus-com.google.code.AccountsSSO.gSingleSignOn.AuthService.html deleted file mode 100644 index c9522ae..0000000 --- a/docs/reference/html/gdbus-com.google.code.AccountsSSO.gSingleSignOn.AuthService.html +++ /dev/null @@ -1,264 +0,0 @@ - - - - -com.google.code.AccountsSSO.gSingleSignOn.AuthService - - - - - - - - - - - - - - - - - - - -
-
-
- - -
-

com.google.code.AccountsSSO.gSingleSignOn.AuthService

-

com.google.code.AccountsSSO.gSingleSignOn.AuthService

-
-
-

Methods

-
-registerNewIdentity (IN  s      applicationContext,
-                     OUT o      objectPath);
-getIdentity         (IN  u      id,
-                     IN  s      applicationContext,
-                     OUT o      objectPath,
-                     OUT a{sv}  identityData);
-queryMethods        (OUT as     authMethods);
-queryMechanisms     (IN  s      method,
-                     OUT as     mechanisms);
-queryIdentities     (IN  a{sv}  filter,
-                     IN  s      applicationContext,
-                     OUT aa{sv} identities);
-clear               (OUT b      unnamed_arg0);
-backupStarts        (OUT y      unnamed_arg0);
-backupFinished      (OUT y      unnamed_arg0);
-restoreStarts       (OUT y      unnamed_arg0);
-restoreFinished     (OUT y      unnamed_arg0);
-
-
-
-

Description

-

-
-
-

Method Details

-
-

The registerNewIdentity() method

-
-registerNewIdentity (IN  s applicationContext,
-                     OUT o objectPath);
-
-

-
-- - - - - - - - - - -

IN s applicationContext:

OUT o objectPath:

-
-
-
-

The getIdentity() method

-
-getIdentity (IN  u     id,
-             IN  s     applicationContext,
-             OUT o     objectPath,
-             OUT a{sv} identityData);
-
-

-
-- - - - - - - - - - - - - - - - - - -

IN u id:

IN s applicationContext:

OUT o objectPath:

OUT a{sv} identityData:

-
-
-
-

The queryMethods() method

-
-queryMethods (OUT as authMethods);
-
-

-
-- - - - -

OUT as authMethods:

-
-
-
-

The queryMechanisms() method

-
-queryMechanisms (IN  s  method,
-                 OUT as mechanisms);
-
-

-
-- - - - - - - - - - -

IN s method:

OUT as mechanisms:

-
-
-
-

The queryIdentities() method

-
-queryIdentities (IN  a{sv}  filter,
-                 IN  s      applicationContext,
-                 OUT aa{sv} identities);
-
-

-
-- - - - - - - - - - - - - - -

IN a{sv} filter:

IN s applicationContext:

OUT aa{sv} identities:

-
-
-
-

The clear() method

-
-clear (OUT b unnamed_arg0);
-
-

-
-- - - - -

OUT b unnamed_arg0:

-
-
-
-

The backupStarts() method

-
-backupStarts (OUT y unnamed_arg0);
-
-

-
-- - - - -

OUT y unnamed_arg0:

-
-
-
-

The backupFinished() method

-
-backupFinished (OUT y unnamed_arg0);
-
-

-
-- - - - -

OUT y unnamed_arg0:

-
-
-
-

The restoreStarts() method

-
-restoreStarts (OUT y unnamed_arg0);
-
-

-
-- - - - -

OUT y unnamed_arg0:

-
-
-
-

The restoreFinished() method

-
-restoreFinished (OUT y unnamed_arg0);
-
-

-
-- - - - -

OUT y unnamed_arg0:

-
-
-
-
-
- Generated by GTK-Doc V1.18
- - \ No newline at end of file diff --git a/docs/reference/html/gdbus-com.google.code.AccountsSSO.gSingleSignOn.AuthSession.html b/docs/reference/html/gdbus-com.google.code.AccountsSSO.gSingleSignOn.AuthSession.html deleted file mode 100644 index 0994236..0000000 --- a/docs/reference/html/gdbus-com.google.code.AccountsSSO.gSingleSignOn.AuthSession.html +++ /dev/null @@ -1,167 +0,0 @@ - - - - -com.google.code.AccountsSSO.gSingleSignOn.AuthSession - - - - - - - - - - - - - - - - - - - -
-
-
- - -
-

com.google.code.AccountsSSO.gSingleSignOn.AuthSession

-

com.google.code.AccountsSSO.gSingleSignOn.AuthSession

-
-
-

Methods

-
-queryAvailableMechanisms (IN  as    wantedMechanisms,
-                          OUT as    unnamed_arg1);
-process                  (IN  a{sv} sessionDataVa,
-                          IN  s     mechanism,
-                          OUT a{sv} unnamed_arg2);
-cancel                   ();
-
-
-
-

Signals

-
-stateChanged (i state,
-              s message);
-unregistered ();
-
-
-
-

Description

-

-
-
-

Method Details

-
-

The queryAvailableMechanisms() method

-
-queryAvailableMechanisms (IN  as wantedMechanisms,
-                          OUT as unnamed_arg1);
-
-

-
-- - - - - - - - - - -

IN as wantedMechanisms:

OUT as unnamed_arg1:

-
-
-
-

The process() method

-
-process (IN  a{sv} sessionDataVa,
-         IN  s     mechanism,
-         OUT a{sv} unnamed_arg2);
-
-

-
-- - - - - - - - - - - - - - -

IN a{sv} sessionDataVa:

IN s mechanism:

OUT a{sv} unnamed_arg2:

-
-
-
-

The cancel() method

-
-cancel ();
-
-

-
-- -
-
-
-
-

Signal Details

-
-

The "stateChanged" signal

-
-stateChanged (i state,
-              s message);
-
-

-
-- - - - - - - - - - -

i state:

s message:

-
-
-
-

The "unregistered" signal

-
-unregistered ();
-
-

-
-- -
-
-
-
-
-
- Generated by GTK-Doc V1.18
- - \ No newline at end of file diff --git a/docs/reference/html/gdbus-com.google.code.AccountsSSO.gSingleSignOn.Identity.html b/docs/reference/html/gdbus-com.google.code.AccountsSSO.gSingleSignOn.Identity.html deleted file mode 100644 index f418cfd..0000000 --- a/docs/reference/html/gdbus-com.google.code.AccountsSSO.gSingleSignOn.Identity.html +++ /dev/null @@ -1,305 +0,0 @@ - - - - -com.google.code.AccountsSSO.gSingleSignOn.Identity - - - - - - - - - - - - - - - - - - - -
-
-
- - -
-

com.google.code.AccountsSSO.gSingleSignOn.Identity

-

com.google.code.AccountsSSO.gSingleSignOn.Identity

-
-
-

Methods

-
-requestCredentialsUpdate (IN  s     message,
-                          OUT u     unnamed_arg1);
-getInfo                  (OUT a{sv} identityInfo);
-getAuthSession           (IN  s     method,
-                          OUT o     objectPath);
-verifyUser               (IN  a{sv} params,
-                          OUT b     unnamed_arg1);
-verifySecret             (IN  s     secret,
-                          OUT b     unnamed_arg1);
-remove                   ();
-signOut                  (OUT b     unnamed_arg0);
-store                    (IN  a{sv} unnamed_arg0,
-                          OUT u     unnamed_arg1);
-addReference             (IN  s     reference,
-                          OUT i     unnamed_arg1);
-removeReference          (IN  s     reference,
-                          OUT i     unnamed_arg1);
-
-
-
-

Signals

-
-unregistered ();
-infoUpdated  (i unnamed_arg0);
-
-
-
-

Description

-

-
-
-

Method Details

-
-

The requestCredentialsUpdate() method

-
-requestCredentialsUpdate (IN  s message,
-                          OUT u unnamed_arg1);
-
-

-
-- - - - - - - - - - -

IN s message:

OUT u unnamed_arg1:

-
-
-
-

The getInfo() method

-
-getInfo (OUT a{sv} identityInfo);
-
-

-
-- - - - -

OUT a{sv} identityInfo:

-
-
-
-

The getAuthSession() method

-
-getAuthSession (IN  s method,
-                OUT o objectPath);
-
-

-
-- - - - - - - - - - -

IN s method:

OUT o objectPath:

-
-
-
-

The verifyUser() method

-
-verifyUser (IN  a{sv} params,
-            OUT b     unnamed_arg1);
-
-

-
-- - - - - - - - - - -

IN a{sv} params:

OUT b unnamed_arg1:

-
-
-
-

The verifySecret() method

-
-verifySecret (IN  s secret,
-              OUT b unnamed_arg1);
-
-

-
-- - - - - - - - - - -

IN s secret:

OUT b unnamed_arg1:

-
-
-
-

The remove() method

-
-remove ();
-
-

-
-- -
-
-
-
-

The signOut() method

-
-signOut (OUT b unnamed_arg0);
-
-

-
-- - - - -

OUT b unnamed_arg0:

-
-
-
-

The store() method

-
-store (IN  a{sv} unnamed_arg0,
-       OUT u     unnamed_arg1);
-
-

-
-- - - - - - - - - - -

IN a{sv} unnamed_arg0:

OUT u unnamed_arg1:

-
-
-
-

The addReference() method

-
-addReference (IN  s reference,
-              OUT i unnamed_arg1);
-
-

-
-- - - - - - - - - - -

IN s reference:

OUT i unnamed_arg1:

-
-
-
-

The removeReference() method

-
-removeReference (IN  s reference,
-                 OUT i unnamed_arg1);
-
-

-
-- - - - - - - - - - -

IN s reference:

OUT i unnamed_arg1:

-
-
-
-

Signal Details

-
-

The "unregistered" signal

-
-unregistered ();
-
-

-
-- -
-
-
-
-

The "infoUpdated" signal

-
-infoUpdated (i unnamed_arg0);
-
-

-
-- - - - -

i unnamed_arg0:

-
-
-
-
-
- Generated by GTK-Doc V1.18
- - \ No newline at end of file diff --git a/docs/reference/html/gsso-examples.html b/docs/reference/html/gsso-examples.html new file mode 100644 index 0000000..ddd6958 --- /dev/null +++ b/docs/reference/html/gsso-examples.html @@ -0,0 +1,199 @@ + + + + +gSSO usage examples + + + + + + + + + + + + + + + + +
+
+
+

Introduction

+

+ libgsignond-glib comes with an example application gsso-example + that demonstrates the most common use cases: listing available authentication methods and + their mechanisms, creating and removing identities and performing authentication + sessions. +

+

+ Before running the example application, make sure that gSSO daemon and + gSSO UI (that is appropriate for your system) are installed and configured + correctly. +

+

+ The source code for the example application is available at + + http://code.google.com/p/accounts-sso/source/browse/examples/gsso-example.c?repo=libgsignon-glib&name=master +

+

+ The full list of available gsso-example options can be + obtained with gsso-example --help-all +

+
+
+

Authentication methods and mechanisms

+

+ The list of available authentication methods can be obtained with + --query-methods: +

+


+> gsso-example --query-methods:
+Available authentication methods:
+        password
+        oauth
+        digest
+        

+

+

+

+ For each of the available authentication methods it's possible to query + available authentication mechanisms with + gsso-example --query-mechanisms=method: +

+


+> gsso-example --query-mechanisms=oauth
+Available authentication mechanisms for method oauth:
+        oauth1
+        oauth2
+        

+

+

+
+
+

Identity management

+

+ The list of stored identities that the gsso-example application is allowed + to use can be obtained with gsso-example --query-identities: +

+


+> gsso-example --query-identities
+Available identities:
+        id=27 caption='My test identity'
+        id=28 caption='Another test identity'
+        

+

+

+

+ To create an identity, use --create-identity option + with identity caption (user-readable name) and --identity-method + with the authentication method that the identity will be using. +

+


+> gsso-example --create-identity="My test identity" --identity-method=password
+Identity stored with id 28            
+        

+

+

+

+ To remove an identity, use --remove-identity option + with identity id: +

+


+> gsso-example --remove-identity=28
+Identity removed
+        

+

+

+
+
+

Using 'password' authentication method

+

+ 'password' authentication simply returns to the application the username + and the password associated with an identity. If they haven't been stored + in gSSO secret database, they're asked from the user through gSSO UI. +

+

+ To use the method, first create an identity with authentication method + set to 'password' (as shown above), note its identitiy id and then run: +

+


+> gsso-example --get-password=27
+Geting password
+Got response: {'UserName': <'megauser'>, 'Secret': <'megapassword'>}
+        

+

+

+
+
+

Using 'oauth' authentication method

+

+ 'oauth' authentication method is used to obtain an OAuth1 or OAuth2 + authentication token from a remote service over HTTP. An application + needs to supply a few service-specific parameters when initiating the + authentication. gSSO example application supports obtaining an oauth + token from Google service (google-specific parameters are hardcoded + into the app source code). +

+

+ Obtaining an OAuth token may also include authorization of the application + by the user, which is done through user interaction with the service webpages + that are shown by gSSO UI. From the application point of view this authorization + happens completely transparently behind the scenes. +

+

+ Before trying the example, if you're behind a proxy, and are using + the Gtk-based gSSO UI, make sure that your GNOME proxy settings are + correctly configured, either via GNOME UI, or via command line: +

+


+> gsettings list-recursively org.gnome.system.proxy
+        

+

+ To set the proxy, use: +

+


+> gsettings set org.gnome.system.proxy mode 'manual'
+> gsettings set org.gnome.system.proxy.http port 8080
+> gsettings set org.gnome.system.proxy.http host 'myproxy.domain.lan'
+        

+

+ To disable the proxy, use +

+


+> gsettings set org.gnome.system.proxy mode 'none'
+        

+

+ See all available configurations keys here: + + http://developer.gnome.org/ProxyConfiguration/ +

+

+ You would also need a client identifier and key from Google. Instructions + about how to get them are available at + https://developers.google.com/console/help/#generatingoauth2 +

+

+ Once the above are settled, create an identity with 'oauth' method + (as shown above) and issue: +

+


+> gsso-example --get-google-token=12 --client-id=xxxxxxx.apps.googleusercontent.com --client-secret=yyyyyyyyyyyyy
+Geting token
+Got response: {'Scope': <'email'>, 'AccessToken': <'tokenvalue'>, 
+               'TokenParameters': <@a{sv} {}>, 'TokenType': <'Bearer'>, 
+               'RefreshToken': <'refreshtokenvalue'>, 'Duration': <int64 3600>, 
+               'Timestamp': <int64 1377707888>}                
+        

+

+

+
+
+
+
+ Generated by GTK-Doc V1.18
+ + \ No newline at end of file diff --git a/docs/reference/html/gsso-intro.html b/docs/reference/html/gsso-intro.html new file mode 100644 index 0000000..7328400 --- /dev/null +++ b/docs/reference/html/gsso-intro.html @@ -0,0 +1,104 @@ + + + + +gSSO introduction + + + + + + + + + + + + + + + + +
+
+
+

What is gSSO?

+

+ gSSO is a framework for centrally storing authentication credentials + and handling authentication on behalf of applications as requested by + them. It consists of a gSSO daemon that implements secure storage of + login credentials (for example usernames and passwords), plugins for + different authentication systems and a client library (libgsignond-glib) + for applications to communicate with this system. +

+

+ By using this client library, an application can authenticate to a + (usually remote) service using an existing set of credentials, and manage + the credentials database as well (subject to access restrictions). +

+

+ Some authentication methods require interaction with the user, for example + to request a username and password, or to show a webpage with which the + user is expected to interact. This functionality is provided by gSSO UI + component, and it's completely invisible from the applications' point + of view. +

+

+ The client library (libgsignond-glib) interacts with gSSO daemon through + D-Bus. These D-Bus APIs should not be used directly as they are not documented, subject + to change and don't come with backwards compatibility guarantees. +

+
+
+

Terminology

+

+ gSSO is built around a few key concepts which are explained below: +

+
    +

  • + Authentication service: the top level + object representing the gSSO service. It can be used to query + existing identities, available + authentication menthods and their mechanisms. Authentication + service is represented in the client library by + SignonAuthService objects. +

    • +

  • + Identity: This is a local object representing a record in the + credentials DB. It contains information about the username and password (the + latter is write-only), plus some metadata such as a descriptive caption, access + control list, reference count, and other metadata. Identities are identified by + numeric identity IDs and represented in the client library by + SignonIdentity objects. +

    • +

  • + Security context: The information that is used by gSSO daemon + to make access control decisions when applications try to access identities + for reading, writing, or starting authentication sessions. Security contexts + consist of two strings: the system context which identifies the application process, + and application context which identifies what the application process is doing. Security + contexts are represented in the client library by + SignonSecurityContext objects. +

    • +

  • + Authentication method: the SSO daemon supports different + authentication methods, each implemented by a plugin. Well known examples of + authentication methods include SASL, + or OAuth. Authentication methods + might support different authentication mechanisms, which are method-specific variants of authentication process. +

    • +

  • + Authentication session: the process of performing the authentication. + It is represented in the client library by SignonAuthSession objects. + Authentication sessions are started from existing identites. +

    • +
+

+

+
+
+
+
+ Generated by GTK-Doc V1.18
+ + \ No newline at end of file diff --git a/docs/reference/html/index.html b/docs/reference/html/index.html index 6db3ee0..528c995 100644 --- a/docs/reference/html/index.html +++ b/docs/reference/html/index.html @@ -5,7 +5,7 @@ libgsignon-glib Reference Manual - + @@ -15,54 +15,51 @@

- This document is for libgsignon-glib, version 2.0.1 + This document is for libgsignon-glib, version 2.0.3 . The latest - version of this documentation can be built from the source code at - https://code.google.com/p/accounts-sso/source/checkout?repo=libgsignon-glib. + version of this documentation can be found on-line at + + http://gsignon-docs.accounts-sso.googlecode.com/git/libgsignon-glib/index.html.

-
I. libgsignon-glib Overview
+
I. gSSO Overview
+
+
+gSSO introduction +
+
+gSSO usage examples +
+
II. libgsignon-glib Objects
Object Hierarchy
Credential management
-SignonAuthService — The authorization service object +SignonAuthService — the authorization service object
-SignonAuthSession — Authentication session handler. +SignonIdentity — client side presentation of a credential.
-SignonError — Possible errors from Signon. +SignonIdentityInfo — data contained in a SignonIdentity.
-SignonIdentity — Client side presentation of a credential. +SignonSecurityContext — representation of a security context.
-SignonIdentityInfo — Extra data for a SignonIdentity. +SignonAuthSession — the authentication session object
-SignonSecurityContext — Representation of a security context. +SignonError — possible gSSO errors
-
III. signond D-Bus API
-
-
-com.google.code.AccountsSSO.gSingleSignOn.AuthService -
-
-com.google.code.AccountsSSO.gSingleSignOn.AuthSession -
-
-com.google.code.AccountsSSO.gSingleSignOn.Identity -
-
-
IV. Appendices
+
III. Appendices
API Index
Index of deprecated symbols
diff --git a/docs/reference/html/index.sgml b/docs/reference/html/index.sgml index b743c7c..8238d1f 100644 --- a/docs/reference/html/index.sgml +++ b/docs/reference/html/index.sgml @@ -1,148 +1,60 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + @@ -150,6 +62,7 @@ + @@ -159,6 +72,9 @@ + + + @@ -169,58 +85,98 @@ - - + + - - - - - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/reference/html/SignonAuthService.html b/docs/reference/html/libgsignon-glib-SignonAuthService.html similarity index 62% rename from docs/reference/html/SignonAuthService.html rename to docs/reference/html/libgsignon-glib-SignonAuthService.html index 0849d22..bf46132 100644 --- a/docs/reference/html/SignonAuthService.html +++ b/docs/reference/html/libgsignon-glib-SignonAuthService.html @@ -7,7 +7,7 @@ - + @@ -18,105 +18,123 @@ Up Home libgsignon-glib Reference Manual -Next +Next -Top +Top  |  - Description -  |  - Object Hierarchy + Description
-
+
-

SignonAuthService

-

SignonAuthService — The authorization service object

+

SignonAuthService

+

SignonAuthService — the authorization service object
-

Synopsis

-
                    SignonAuthService;
-void                (*SignonQueryMechanismCb)           (SignonAuthService *auth_service,
+
Synopsis

+
struct              SignonAuthServiceClass;
+typedef             SignonIdentityFilter;
+typedef             SignonIdentityList;
+void                (*SignonQueryIdentitiesCb)          (SignonAuthService *auth_service,
+                                                         SignonIdentityList *identities,
+                                                         const GError *error,
+                                                         gpointer user_data);
+void                (*SignonQueryMechanismCb)           (SignonAuthService *auth_service,
                                                          const gchar *method,
                                                          gchar **mechanisms,
                                                          const GError *error,
                                                          gpointer user_data);
-void                (*SignonQueryMethodsCb)             (SignonAuthService *auth_service,
+void                (*SignonQueryMethodsCb)             (SignonAuthService *auth_service,
                                                          gchar **methods,
                                                          const GError *error,
                                                          gpointer user_data);
-void                (*SignonQueryIdentitiesCb)          (SignonAuthService *auth_service,
-                                                         SignonIdentityList *identities,
-                                                         const GError *error,
+SignonAuthService * signon_auth_service_new             ();
+void                signon_auth_service_query_identities
+                                                        (SignonAuthService *auth_service,
+                                                         SignonIdentityFilter *filter,
+                                                         const gchar *application_context,
+                                                         SignonQueryIdentitiesCb cb,
                                                          gpointer user_data);
-SignonAuthService * signon_auth_service_new             ();
-void                signon_auth_service_query_mechanisms
-                                                        (SignonAuthService *auth_service,
+void                signon_auth_service_query_mechanisms
+                                                        (SignonAuthService *auth_service,
                                                          const gchar *method,
-                                                         SignonQueryMechanismCb cb,
-                                                         gpointer user_data);
-void                signon_auth_service_query_methods   (SignonAuthService *auth_service,
-                                                         SignonQueryMethodsCb cb,
+                                                         SignonQueryMechanismCb cb,
                                                          gpointer user_data);
-void                signon_auth_service_query_identities
-                                                        (SignonAuthService *auth_service,
-                                                         SignonIdentityFilter *filter,
-                                                         const gchar *application_context,
-                                                         SignonQueryIdentitiesCb cb,
+void                signon_auth_service_query_methods   (SignonAuthService *auth_service,
+                                                         SignonQueryMethodsCb cb,
                                                          gpointer user_data);
-

Object Hierarchy

-
-  GObject
-   +----SignonAuthService
-
-
-
-

Description

+

Description

-The SignonAuthService is the main object in this library. +The SignonAuthService is the main object in this library. It provides top-level +functions to query existing identities, available methods and their mechanisms.

-

Details

+

Details

-

SignonAuthService

-
typedef struct _SignonAuthService SignonAuthService;
+

struct SignonAuthServiceClass

+
struct SignonAuthServiceClass {
+    GObjectClass parent_class;
+};
+

Opaque struct. Use the accessor functions below.

+
++ + + + +

GObjectClass parent_class;

a reference to the parent class
-

SignonQueryMechanismCb ()

-
void                (*SignonQueryMechanismCb)           (SignonAuthService *auth_service,
-                                                         const gchar *method,
-                                                         gchar **mechanisms,
+
SignonIdentityFilter

+
typedef GHashTable SignonIdentityFilter;
+

+

+GHashTable based filter variant dictionary.
+

+
+
+
+

SignonIdentityList

+
typedef GList SignonIdentityList;
+
+

+GList of SignonIdentity items. +

+
+
+
+

SignonQueryIdentitiesCb ()

+
void                (*SignonQueryIdentitiesCb)          (SignonAuthService *auth_service,
+                                                         SignonIdentityList *identities,
                                                          const GError *error,
                                                          gpointer user_data);

-Callback to be passed to signon_auth_service_query_mechanisms(). +Callback to be passed to signon_auth_service_query_identities().

- + - - - - - - + @@ -132,24 +150,29 @@ Callback to be passed to -

SignonQueryMethodsCb ()

-
void                (*SignonQueryMethodsCb)             (SignonAuthService *auth_service,
-                                                         gchar **methods,
+
SignonQueryMechanismCb ()

+
void                (*SignonQueryMechanismCb)           (SignonAuthService *auth_service,
+                                                         const gchar *method,
+                                                         gchar **mechanisms,
                                                          const GError *error,
                                                          gpointer user_data);

 

-Callback to be passed to signon_auth_service_query_methods().
+Callback to be passed to signon_auth_service_query_mechanisms().

auth_service :

the SignonAuthService.the SignonAuthService.

method :

the authentication method being inspected.

mechanisms :

list of available mechanisms. [transfer full][type GStrv] +

identities :

 +GList based list of SignonIdentityInfo. [transfer full]
- + - - + + + + + @@ -165,25 +188,24 @@ Callback to be passed to -

SignonQueryIdentitiesCb ()

-
void                (*SignonQueryIdentitiesCb)          (SignonAuthService *auth_service,
-                                                         SignonIdentityList *identities,
+
SignonQueryMethodsCb ()

+
void                (*SignonQueryMethodsCb)             (SignonAuthService *auth_service,
+                                                         gchar **methods,
                                                          const GError *error,
                                                          gpointer user_data);

 

-Callback to be passed to signon_auth_service_query_identities().
+Callback to be passed to signon_auth_service_query_methods().

auth_service :

the SignonAuthService.the SignonAuthService.

methods :

list of available methods. [transfer full][type GStrv] +

method :

the authentication method being inspected.

mechanisms :

list of available mechanisms. [transfer full][type GStrv]
- + - - + @@ -200,40 +222,70 @@ Callback to be passed to

signon_auth_service_new ()

-
SignonAuthService * signon_auth_service_new             ();
+
SignonAuthService * signon_auth_service_new             ();

-Create a new SignonAuthService. +Create a new SignonAuthService.

auth_service :

the SignonAuthService.the SignonAuthService.

identities :

 -GList based list of SignonIdentityInfo. [transfer full] +

methods :

list of available methods. [transfer full][type GStrv]
- +

Returns :

an instance of an SignonAuthService.an instance of an SignonAuthService.
-

signon_auth_service_query_mechanisms ()

-
void                signon_auth_service_query_mechanisms
-                                                        (SignonAuthService *auth_service,
-                                                         const gchar *method,
-                                                         SignonQueryMechanismCb cb,
+
signon_auth_service_query_identities ()

+
void                signon_auth_service_query_identities
+                                                        (SignonAuthService *auth_service,
+                                                         SignonIdentityFilter *filter,
+                                                         const gchar *application_context,
+                                                         SignonQueryIdentitiesCb cb,
                                                          gpointer user_data);

 

-Lists all the available mechanisms.
+Query available identities, possibly applying a filter. 
+

+

+filter is a GHashTable that contains filter conditions in the form of 
+string keys and GVariant values. Currently the following keys are supported:
+

+

+

+
    
+
  • "Owner". The value should be a SignonSecurityContext (use 
+signon_security_context_build_variant() to create a GVariant). 
+Identites whose owner doesn't match will be filtered out. This key has
+effect only if the requesting application is a keychain application as determined
+by GSignondAccessControlManager.
    • 
+
  • "Type". The value should be a SignonIdentityType.
    • 
+
  • "Caption". The value is a string, and only those identites whose caption
+begins with the supplied value will be returned.
    • 
+

+

+

+

+The meaning of application_context is explained in SignonSecurityContext.
+It is used by GSignondAccessControlManager to determine if the requesting 
+application is a keychain application. If it is, then all identites will be
+returned (subject to "Owner" key in filter). If it's not, then only the
+identites which the application owns will be returned (but "Type" and "Caption"
+can still be set in the filter).
 

 

-
+
-
-
+
+
+
+
+
+
@@ -249,19 +301,26 @@ retrieved.

-
signon_auth_service_query_methods ()

-
void                signon_auth_service_query_methods   (SignonAuthService *auth_service,
-                                                         SignonQueryMethodsCb cb,
+
signon_auth_service_query_mechanisms ()

+
void                signon_auth_service_query_mechanisms
+                                                        (SignonAuthService *auth_service,
+                                                         const gchar *method,
+                                                         SignonQueryMechanismCb cb,
                                                          gpointer user_data);

 

-Lists all the available methods.
+Lists all the available mechanisms for an authentication method.
 

 

 
 
 

 
auth_service :
the SignonAuthService.the SignonAuthService.
 

 
method :
the name of the method whose mechanisms must be
-retrieved.
filter :
filter variant dictionary based on GHashTable.
application_context :
application security context, can be NULL.
 

 

 
cb :

 
 
 

-
+
+
+
+
+
@@ -277,30 +336,19 @@ Lists all the available methods.
 

-
signon_auth_service_query_identities ()

-
void                signon_auth_service_query_identities
-                                                        (SignonAuthService *auth_service,
-                                                         SignonIdentityFilter *filter,
-                                                         const gchar *application_context,
-                                                         SignonQueryIdentitiesCb cb,
+
signon_auth_service_query_methods ()

+
void                signon_auth_service_query_methods   (SignonAuthService *auth_service,
+                                                         SignonQueryMethodsCb cb,
                                                          gpointer user_data);

 

-Query identities.
+Lists all the available authentication methods.
 

 

 
 
 

 
auth_service :
the SignonAuthService.the SignonAuthService.
method :
the name of the method whose mechanisms must be
+retrieved.
 

 

 
cb :

 
 

-
-
-
-
-
-
-
-
-
+
diff --git a/docs/reference/html/SignonError.html b/docs/reference/html/libgsignon-glib-SignonError.html
similarity index 81%
rename from docs/reference/html/SignonError.html
rename to docs/reference/html/libgsignon-glib-SignonError.html
index 9371b3f..6847d07 100644
--- a/docs/reference/html/SignonError.html
+++ b/docs/reference/html/libgsignon-glib-SignonError.html
@@ -7,7 +7,7 @@
 
-
+
@@ -18,47 +18,49 @@
 
-
+

 
 
 

 
auth_service :
the SignonAuthService.
filter :
filter variant dictionary based on GHashTable.
application_context :
application security context, can be NULL.the SignonAuthService.
 

 

 
cb :

 
 
 
 
 Up
 Home
 libgsignon-glib Reference ManualNextNext
 

 

-Top
+Top
                    | 
-                  Description
-                   | 
-                  Object Hierarchy
+                  Description
 

 

 

-

+

 

 
-
SignonError

-
SignonError — Possible errors from Signon.

+
SignonError

+
SignonError — possible gSSO errors

 		
 
 

 

-
Synopsis

-
enum                SignonError;
+
Synopsis

+
#define             SIGNON_ERROR
+enum                SignonError;
+GQuark              signon_error_quark                  (void);
 

 

 

-
Object Hierarchy

-
-  GEnum
-   +----SignonError
-

+
Description

+

+An enumeration of errors that are possible when using gSSO
+

 

 

-
Description

+
Details

+

+
SIGNON_ERROR

+
#define SIGNON_ERROR (signon_error_quark())
+

 

-An enumeration of errors that are possible from Signon.
+This macro is used when creating a GError in libgsignond-glib library
 

 

-

-
Details

+

 

-
enum SignonError

+
enum SignonError

 
typedef enum {
     SIGNON_ERROR_UNKNOWN = 1,
     SIGNON_ERROR_INTERNAL_SERVER = 2,
@@ -149,7 +151,7 @@ insufficient client permissions.
 
 
 
SIGNON_ERROR_IDENTITY_NOT_FOUND

-The identity mathching the SignonIdentity
+The identity mathching the SignonIdentity
 was not found on the service.
 
 
@@ -296,6 +298,14 @@ specific.
 
 

 

+

+

+
signon_error_quark ()

+
GQuark              signon_error_quark                  (void);

+

+Creates and returns a domain for gSSO errors.
+

+

 

 

 

diff --git a/docs/reference/html/SignonIdentity.html b/docs/reference/html/libgsignon-glib-SignonIdentity.html
similarity index 56%
rename from docs/reference/html/SignonIdentity.html
rename to docs/reference/html/libgsignon-glib-SignonIdentity.html
index 825d68b..d494987 100644
--- a/docs/reference/html/SignonIdentity.html
+++ b/docs/reference/html/libgsignon-glib-SignonIdentity.html
@@ -6,7 +6,7 @@
 
 
 
-
+
 
 
 
@@ -14,88 +14,84 @@
 
 
-
+
 

-

+

 

 
-
SignonIdentity

-
SignonIdentity — Client side presentation of a credential.

+
SignonIdentity

+
SignonIdentity — client side presentation of a credential.

 		
 
 

 

-
Synopsis

-
                    SignonIdentity;
-typedef             SignonIdentityFilter;
-typedef             SignonIdentityList;
-void                (*SignonIdentityInfoCb)             (SignonIdentity *self,
+
Synopsis

+
struct              SignonIdentityClass;
+void                (*SignonIdentityInfoCb)             (SignonIdentity *self,
                                                          const SignonIdentityInfo *info,
                                                          const GError *error,
                                                          gpointer user_data);
-typedef             SignonIdentityReferenceAddedCb;
-typedef             SignonIdentityReferenceRemovedCb;
-typedef             SignonIdentityRemovedCb;
-typedef             SignonIdentitySignedOutCb;
-void                (*SignonIdentityStoreCredentialsCb) (SignonIdentity *self,
+typedef             SignonIdentityReferenceAddedCb;
+typedef             SignonIdentityReferenceRemovedCb;
+typedef             SignonIdentityRemovedCb;
+void                (*SignonIdentitySessionReadyCb)     (SignonAuthSession *self,
+                                                         GError *error,
+                                                         GDBusConnection *connection,
+                                                         const gchar *bus_name,
+                                                         const gchar *object_path);
+typedef             SignonIdentitySignedOutCb;
+void                (*SignonIdentityStoreCredentialsCb) (SignonIdentity *self,
                                                          guint32 id,
                                                          const GError *error,
                                                          gpointer user_data);
-void                (*SignonIdentityVerifyCb)           (SignonIdentity *self,
+void                (*SignonIdentityVerifyCb)           (SignonIdentity *self,
                                                          gboolean valid,
                                                          const GError *error,
                                                          gpointer user_data);
-void                (*SignonIdentityVoidCb)             (SignonIdentity *self,
+void                (*SignonIdentityVoidCb)             (SignonIdentity *self,
                                                          const GError *error,
                                                          gpointer user_data);
-void                (*SignonIdentitySessionReadyCb)     (SignonAuthSession *self,
-                                                         GError *error,
-                                                         GDBusConnection *connection,
-                                                         const gchar *bus_name,
-                                                         const gchar *object_path);
-void                signon_identity_add_reference       (SignonIdentity *self,
+void                signon_identity_add_reference       (SignonIdentity *self,
                                                          const gchar *reference,
-                                                         SignonIdentityReferenceAddedCb cb,
+                                                         SignonIdentityReferenceAddedCb cb,
                                                          gpointer user_data);
-SignonAuthSession * signon_identity_create_session      (SignonIdentity *self,
+SignonAuthSession * signon_identity_create_session      (SignonIdentity *self,
                                                          const gchar *method,
                                                          GError **error);
-const GError *      signon_identity_get_last_error      (SignonIdentity *identity);
-SignonIdentity *    signon_identity_new                 (const gchar *application_context);
-SignonIdentity *    signon_identity_new_from_db         (guint32 id,
+void                signon_identity_get_auth_session    (SignonIdentity *self,
+                                                         SignonAuthSession *session,
+                                                         const gchar *method,
+                                                         SignonIdentitySessionReadyCb cb);
+const GError *      signon_identity_get_last_error      (SignonIdentity *identity);
+SignonIdentity *    signon_identity_new                 (const gchar *application_context);
+SignonIdentity *    signon_identity_new_from_db         (guint32 id,
                                                          const gchar *application_context);
-void                signon_identity_query_info          (SignonIdentity *self,
-                                                         SignonIdentityInfoCb cb,
+void                signon_identity_query_info          (SignonIdentity *self,
+                                                         SignonIdentityInfoCb cb,
                                                          gpointer user_data);
-void                signon_identity_remove              (SignonIdentity *self,
-                                                         SignonIdentityRemovedCb cb,
+void                signon_identity_remove              (SignonIdentity *self,
+                                                         SignonIdentityRemovedCb cb,
                                                          gpointer user_data);
-void                signon_identity_remove_reference    (SignonIdentity *self,
+void                signon_identity_remove_reference    (SignonIdentity *self,
                                                          const gchar *reference,
-                                                         SignonIdentityReferenceRemovedCb cb,
+                                                         SignonIdentityReferenceRemovedCb cb,
                                                          gpointer user_data);
-void                signon_identity_signout             (SignonIdentity *self,
-                                                         SignonIdentitySignedOutCb cb,
+void                signon_identity_signout             (SignonIdentity *self,
+                                                         SignonIdentitySignedOutCb cb,
                                                          gpointer user_data);
-void                signon_identity_store_credentials_with_args
-                                                        (SignonIdentity *self,
+void                signon_identity_store_credentials_with_args
+                                                        (SignonIdentity *self,
                                                          const gchar *username,
                                                          const gchar *secret,
                                                          const gboolean store_secret,
@@ -104,106 +100,210 @@ const const gchar * const *realms,
                                                          const SignonSecurityContext *owner,
                                                          const SignonSecurityContextList *access_control_list,
-                                                         SignonIdentityType type,
-                                                         SignonIdentityStoreCredentialsCb cb,
+                                                         SignonIdentityType type,
+                                                         SignonIdentityStoreCredentialsCb cb,
                                                          gpointer user_data);
-void                signon_identity_store_credentials_with_info
-                                                        (SignonIdentity *self,
+void                signon_identity_store_credentials_with_info
+                                                        (SignonIdentity *self,
                                                          const SignonIdentityInfo *info,
-                                                         SignonIdentityStoreCredentialsCb cb,
+                                                         SignonIdentityStoreCredentialsCb cb,
                                                          gpointer user_data);
-void                signon_identity_verify_secret       (SignonIdentity *self,
+void                signon_identity_verify_secret       (SignonIdentity *self,
                                                          const gchar *secret,
-                                                         SignonIdentityVerifyCb cb,
+                                                         SignonIdentityVerifyCb cb,
                                                          gpointer user_data);
-void                signon_identity_get_auth_session    (SignonIdentity *self,
-                                                         SignonAuthSession *session,
-                                                         const gchar *method,
-                                                         SignonIdentitySessionReadyCb cb);
-void                signon_identity_info_access_control_list_append
-                                                        (SignonIdentityInfo *info,
-                                                         SignonSecurityContext *security_context);
-const SignonSecurityContext * signon_identity_info_get_owner
-                                                        (const SignonIdentityInfo *info);
-void                signon_identity_info_set_methods    (SignonIdentityInfo *info,
-                                                         const GHashTable *methods);
-void                signon_identity_info_set_owner      (SignonIdentityInfo *info,
-                                                         const SignonSecurityContext *owner);
-void                signon_identity_info_set_owner_from_values
-                                                        (SignonIdentityInfo *info,
-                                                         const gchar *system_context,
-                                                         const gchar *application_context);
 

 

 

-
Object Hierarchy

-
-  GObject
-   +----SignonIdentity
-

-

+
Description

+

+The SignonIdentity objects represent identities and provide operations that 
+can be performed on them such as identity creation, removal, starting an authentication 
+session, and so on. 
+

+

+Identities can also be stored and retrieved from a gSSO database, in which
+case they also contain a number of properties that can be retrieved
+using signon_identity_query_info() and are represented via SignonIdentityInfo.
+Such identities are identified by a numeric id number and they are subject
+to access control.
+

+

+

 

-
Properties

-
-  "app-ctx"                  gchar*                : Read / Write
-  "id"                       guint                 : Read / Write
-

+
Operations on an identity

 

+

+

+

+

+
  • a new identity can be created with signon_identity_new(). This operation
+does not store the identity to the database, the identity is not visible
+to other applications, and accordingly it is not subject to access control.

+

+

+

+

+

+

+

+

+

+

+

+

+

+

+
  • identities stored in a database can be retrieved using signon_identity_new_from_db(),
+subject to access control (an application performing that operation has to be
+either the identity's owner, or it has to be on the ACL list).

+

+

+

+

+

+

+

+

+

+

+

+

+

+

+
  • identity owners can request to close all authentication sessions and
+remove all secrets and tokens using signon_identity_signout().

+

+

+

+

 

-
Signals

-
-  "signout"                                        : No Hooks
-

+
Data fields in SignonIdentityInfo
+

 

-

-
Description

 

-The SignonIdentity represents a database entry for a single identity.
 

-

-

-
Details

-

-
SignonIdentity

-
typedef struct _SignonIdentity SignonIdentity;

 

-Opaque struct. Use the accessor functions below.
+These are the data fields that are stored into the database as a part of an
+identity record using signon_identity_store_credentials_with_args() or
+signon_identity_store_credentials_with_info() and can be retrieved using
+signon_identity_query_info() or signon_auth_service_query_identities():
 

-

-

-

-
SignonIdentityFilter

-
typedef GHashTable SignonIdentityFilter;
-

 

-GHashTable based filter variant dictionary.
+

+
  • Caption is a display name for the identity, presented to the user. Default
+value is an empty caption. 

+

+

+

+

+
  • Realms is a list of realms that the identity can be used in.
+  Interpretation of this field is up to the method. Typically it is
+  a list of internet domains allowed for an authentication request.
+  Default value is an empty list.

+

+

+

+

+

+

+

+

+

+
  • Owner is a SignonSecurityContext object, which specifies the identity
+owner. Owners are allowed to perform all of the operations on the identity
+specified above. By default an identity's owner is determined by gSSO daemon
+using system services for the system context, and a string supplied in 
+signon_identity_new() for the application context.

+

+

+

+

+
  • ACL is a list of SignonSecurityContext objects, that specifies applications
+that can access the identity to perform authentication sessions. They're not
+allowed to make any changes to the identity. Default value is an empty list,
+and depending on how gSSO is configured it's also possible to provide a list 
+with a wildcard item to relax the access control restriction 
+(see SignonSecurityContext).

+

+

+

+

+
  • Methods is a GHashTable containing method names as keys, and lists of 
+allowed mechanisms as values (also, a special value "*" means that any 
+mechanism is allowed). Only those methods and mechanisms that are in the table
+are allowed to be used in authentication sessions. Default is an empty list.

+

+

+

+

+
  • Id is a numeric identification of the identity record in the database. The
+application cannot set this, as it's determined by the daemon.

+

+

+

+

+
  • Username is used to provide a username to authentication plugins after 
+issuing signon_auth_session_process_async(). Applications can override this
+by providing a username explicitly in the session_data parameter to that 
+function. By default there is no username.

+

+

+

+

+
  • Secret is used in the same way as username, but it is write-only (cannot
+be retrieved from a SignonIdentityInfo). It is also possible to prevent
+secret from being stored in the database.

+

 

 

-

+

+
Details

 

-
SignonIdentityList

-
typedef GList SignonIdentityList;
+
struct SignonIdentityClass

+
struct SignonIdentityClass {
+    GObjectClass parent_class;
+};
 

 

-GList of SignonIdentity items.
+Opaque struct. Use the accessor functions below.
 

+

++
+
+
+
+


GObjectClass parent_class;
reference to a parent class

 

 

 

 
SignonIdentityInfoCb ()

-
void                (*SignonIdentityInfoCb)             (SignonIdentity *self,
+
void                (*SignonIdentityInfoCb)             (SignonIdentity *self,
                                                          const SignonIdentityInfo *info,
                                                          const GError *error,
                                                          gpointer user_data);

 

-Callback to be passed to signon_identity_query_info().
+Callback to be passed to signon_identity_query_info().
 

 

-
+
@@ -226,7 +326,7 @@ Callback to be passed to typedef SignonIdentityVoidCb SignonIdentityReferenceAddedCb;
 
 

-Callback to be passed to signon_identity_add_reference().
+Callback to be passed to signon_identity_add_reference().
 

@@ -235,7 +335,7 @@ Callback to be passed to typedef SignonIdentityVoidCb SignonIdentityReferenceRemovedCb;
 
 

-Callback to be passed to signon_identity_remove_reference().
+Callback to be passed to signon_identity_remove_reference().
 

@@ -244,35 +344,72 @@ Callback to be passed to typedef SignonIdentityVoidCb SignonIdentityRemovedCb;
 
 

-Callback to be passed to signon_identity_remove().
+Callback to be passed to signon_identity_remove().
 

+
SignonIdentitySessionReadyCb ()

+
void                (*SignonIdentitySessionReadyCb)     (SignonAuthSession *self,
+                                                         GError *error,
+                                                         GDBusConnection *connection,
+                                                         const gchar *bus_name,
+                                                         const gchar *object_path);

+

+Callback to be passed to signon_identity_get_auth_session().
+

+

 
 
 

 
self :
the SignonIdentity.the SignonIdentity.
 

 

 
info :

 
 
 
 
 
 
 

++
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+


self :
the SignonAuthSession.
error :
a GError if an error occurred, or NULL otherwise.
connection :
a GDBusConnection for the session.
bus_name :
a D-Bus bus name for the session.
object_path :
a D-Bus object path for the session.

+

+

+

 
SignonIdentitySignedOutCb

 
typedef SignonIdentityVoidCb SignonIdentitySignedOutCb;
 

 

-Callback to be passed to signon_identity_signout().
+Callback to be passed to signon_identity_signout().
 

 

 

 

 
SignonIdentityStoreCredentialsCb ()

-
void                (*SignonIdentityStoreCredentialsCb) (SignonIdentity *self,
+
void                (*SignonIdentityStoreCredentialsCb) (SignonIdentity *self,
                                                          guint32 id,
                                                          const GError *error,
                                                          gpointer user_data);

 

-Callback to be passed to signon_identity_store_credentials_with_args() or
-signon_identity_store_credentials_with_info().
+Callback to be passed to signon_identity_store_credentials_with_args() or
+signon_identity_store_credentials_with_info().
 

 

-
+
@@ -292,19 +429,19 @@ Callback to be passed to 
 
SignonIdentityVerifyCb ()

-
void                (*SignonIdentityVerifyCb)           (SignonIdentity *self,
+
void                (*SignonIdentityVerifyCb)           (SignonIdentity *self,
                                                          gboolean valid,
                                                          const GError *error,
                                                          gpointer user_data);

 

-Callback to be passed to signon_identity_verify_secret().
+Callback to be passed to signon_identity_verify_secret().
 

 

 
 
 

 
self :
the SignonIdentity.the SignonIdentity.
 

 

 
id :

-
+
@@ -324,18 +461,18 @@ Callback to be passed to 
 
SignonIdentityVoidCb ()

-
void                (*SignonIdentityVoidCb)             (SignonIdentity *self,
+
void                (*SignonIdentityVoidCb)             (SignonIdentity *self,
                                                          const GError *error,
                                                          gpointer user_data);

 

-Generic callback to be passed to several SignonIdentity methods.
+Generic callback to be passed to several SignonIdentity methods.
 

 

 
 
 

 
self :
the SignonIdentity.the SignonIdentity.
 

 

 
valid :

-
+
@@ -350,100 +487,100 @@ Generic callback to be passed to several 
-
SignonIdentitySessionReadyCb ()

-
void                (*SignonIdentitySessionReadyCb)     (SignonAuthSession *self,
-                                                         GError *error,
-                                                         GDBusConnection *connection,
-                                                         const gchar *bus_name,
-                                                         const gchar *object_path);

+
signon_identity_add_reference ()

+
void                signon_identity_add_reference       (SignonIdentity *self,
+                                                         const gchar *reference,
+                                                         SignonIdentityReferenceAddedCb cb,
+                                                         gpointer user_data);

-Callback to be passed to signon_identity_get_auth_session().
+Adds named reference to identity. Not currently supported by gSSO.
 

 
 
 

 
self :
the SignonIdentity.the SignonIdentity.
 

 

 
error :

 
 

-
+
-
-
-
-
-
-
+
+
-
-
+
+
-
-
+
+

 
 
 

 
self :
the SignonAuthSession.the SignonIdentity.
 

 
error :
a GError if an error occurred, or NULL otherwise.
connection :
a GDBusConnection for the session.
reference :
reference to be added
 

 
bus_name :
a D-Bus bus name for the session.
cb :
callback
 

 
object_path :
a D-Bus object path for the session.
user_data :
user_data.
 

 
 

 

 

 

-
signon_identity_add_reference ()

-
void                signon_identity_add_reference       (SignonIdentity *self,
-                                                         const gchar *reference,
-                                                         SignonIdentityReferenceAddedCb cb,
-                                                         gpointer user_data);

+
signon_identity_create_session ()

+
SignonAuthSession * signon_identity_create_session      (SignonIdentity *self,
+                                                         const gchar *method,
+                                                         GError **error);

 

-Adds named reference to identity
+Creates an authentication session for this identity. If the identity has been
+retrieved from the database, the authentication method must be one of those 
+listed in signon_identity_info_get_methods(), otherwise it can be any method
+supported by gSSO.
 

 

-
+
-
-
+
+
-
-
+
+
-
-
+
+

 
 
 

 
self :
the SignonIdentity.the SignonIdentity.
 

 
reference :
reference to be added
method :
authentication method.
 

 
cb :
callback
error :
pointer to a location which will receive the error, if any.
 

 
user_data :
user_data.
Returns :
a new SignonAuthSession. [transfer full]
+
 

 
 

 

 

 

-
signon_identity_create_session ()

-
SignonAuthSession * signon_identity_create_session      (SignonIdentity *self,
+
signon_identity_get_auth_session ()

+
void                signon_identity_get_auth_session    (SignonIdentity *self,
+                                                         SignonAuthSession *session,
                                                          const gchar *method,
-                                                         GError **error);

+                                                         SignonIdentitySessionReadyCb cb);

 

-Creates an authentication session for this identity.
+Obtain a remote object for a local session object. Should not be used by
+applications.
 

 

-
+
-
-
+
+
-
-
+
+
-
-
+
@@ -452,7 +589,7 @@ Creates an authentication session for this identity.
 

 
signon_identity_get_last_error ()

-
const GError *      signon_identity_get_last_error      (SignonIdentity *identity);

+
const GError *      signon_identity_get_last_error      (SignonIdentity *identity);

 

 Get the most recent error that occurred on identity.
 

@@ -461,7 +598,7 @@ Get the most recent error that occurred on identity<
 

-
+
@@ -473,9 +610,12 @@ Get the most recent error that occurred on identity<
 

 

 
signon_identity_new ()

-
SignonIdentity *    signon_identity_new                 (const gchar *application_context);

+
SignonIdentity *    signon_identity_new                 (const gchar *application_context);

 

-Construct new, empty, identity object.
+Construct a new, empty, identity object. See SignonSecurityContext for a 
+discussion of application_context contents. application_context is used to set the identity's owner
+if the identity is stored to the database with signon_identity_store_credentials_with_args()
+or signon_identity_store_credentials_with_info().
 

 

 
 
 

 
self :
the SignonIdentity.the SignonIdentity.
 

 
method :
method.
session :
the SignonAuthSession object to get the remote object for.
 

 
error :
pointer to a location which will receive the error, if any.
method :
method name for the session.
 

 
Returns :
a new SignonAuthSession. [transfer full]
+
cb :
completion callback. [scope async]
 
 

 
 
 

 
identity :
the SignonIdentity.the SignonIdentity.
 

 

 
Returns :
@@ -486,7 +626,7 @@ Construct new, empty, identity object.
 
 
-
+

 


 
Returns :
an instance of an SignonIdentity.an instance of an SignonIdentity.
 

 
 

@@ -494,11 +634,20 @@ Construct new, empty, identity object.
 

 

 
signon_identity_new_from_db ()

-
SignonIdentity *    signon_identity_new_from_db         (guint32 id,
+
SignonIdentity *    signon_identity_new_from_db         (guint32 id,
                                                          const gchar *application_context);

 

 Construct an identity object associated with an existing identity
-record.
+record. See SignonSecurityContext for a discussion of application_context contents.
+Together with the system context it is used to determine by the gSSO daemon 
+if the application can access the identity (the application needs to be either the 
+identity's owner or to be present on the ACL).
+

+

+Applications can determine the id either by enumerating the identities with 
+signon_auth_service_query_identities() (if they're the owner of the identity) 
+or via other means (such as the system's accounts service, or an application 
+configuration).
 

 
@@ -513,7 +662,7 @@ record.
 
-
+

 

 

 
Returns :
an instance of a SignonIdentity.an instance of a SignonIdentity.
 

 
 

@@ -521,8 +670,8 @@ record.
 

 

 
signon_identity_query_info ()

-
void                signon_identity_query_info          (SignonIdentity *self,
-                                                         SignonIdentityInfoCb cb,
+
void                signon_identity_query_info          (SignonIdentity *self,
+                                                         SignonIdentityInfoCb cb,
                                                          gpointer user_data);

 

 Fetches the SignonIdentityInfo data associated with this
@@ -533,7 +682,7 @@ identity.
 
 
 
self :

-the SignonIdentity.
+the SignonIdentity.
 
 
 
cb :

@@ -550,8 +699,8 @@ identity.
 

 

 
signon_identity_remove ()

-
void                signon_identity_remove              (SignonIdentity *self,
-                                                         SignonIdentityRemovedCb cb,
+
void                signon_identity_remove              (SignonIdentity *self,
+                                                         SignonIdentityRemovedCb cb,
                                                          gpointer user_data);

 

 Removes the corresponding credentials record from the database.
@@ -561,7 +710,7 @@ Removes the corresponding credentials record from the database.
 
 
 
self :

-the SignonIdentity.
+the SignonIdentity.
 
 
 
cb :

@@ -578,19 +727,19 @@ Removes the corresponding credentials record from the database.
 

 

 
signon_identity_remove_reference ()

-
void                signon_identity_remove_reference    (SignonIdentity *self,
+
void                signon_identity_remove_reference    (SignonIdentity *self,
                                                          const gchar *reference,
-                                                         SignonIdentityReferenceRemovedCb cb,
+                                                         SignonIdentityReferenceRemovedCb cb,
                                                          gpointer user_data);

 

-Removes named reference from identity
+Removes named reference from identity. Not currently supported by gSSO.
 

 

-
+
@@ -610,8 +759,8 @@ Removes named reference from identity
 

 
signon_identity_signout ()

-
void                signon_identity_signout             (SignonIdentity *self,
-                                                         SignonIdentitySignedOutCb cb,
+
void                signon_identity_signout             (SignonIdentity *self,
+                                                         SignonIdentitySignedOutCb cb,
                                                          gpointer user_data);

 

 Asks signond to close all authentication sessions for this
@@ -623,7 +772,7 @@ authentication tokens).
 

-
+
@@ -641,7 +790,7 @@ authentication tokens).
 

 
signon_identity_store_credentials_with_args ()

 
void                signon_identity_store_credentials_with_args
-                                                        (SignonIdentity *self,
+                                                        (SignonIdentity *self,
                                                          const gchar *username,
                                                          const gchar *secret,
                                                          const gboolean store_secret,
@@ -650,51 +799,58 @@ authentication tokens).
                                                          const gchar * const *realms,
                                                          const SignonSecurityContext *owner,
                                                          const SignonSecurityContextList *access_control_list,
-                                                         SignonIdentityType type,
-                                                         SignonIdentityStoreCredentialsCb cb,
+                                                         SignonIdentityType type,
+                                                         SignonIdentityStoreCredentialsCb cb,
                                                          gpointer user_data);

 

-Stores the given data into the identity.
+Stores the given data into the identity. See above for the meaning
+of the specific fields.
 

 

 
 
 

 
self :
the SignonIdentity.the SignonIdentity.
 

 

 
reference :

 

 

 
self :
the SignonIdentity.the SignonIdentity.
 

 

 
cb :

-
+
-
+
-
+
-
+
-
-
+
-
+
-
+
-
+
@@ -716,19 +872,21 @@ Stores the given data into the identity.
 

 
signon_identity_store_credentials_with_info ()

 
void                signon_identity_store_credentials_with_info
-                                                        (SignonIdentity *self,
+                                                        (SignonIdentity *self,
                                                          const SignonIdentityInfo *info,
-                                                         SignonIdentityStoreCredentialsCb cb,
+                                                         SignonIdentityStoreCredentialsCb cb,
                                                          gpointer user_data);

 

-Stores the data from info into the identity.
+Stores the data contained in info into the identity record in the database.
+See above for the detailed discussion of the meaning of various fields and
+their defaults.
 

 

 
 
 

 
self :
the SignonIdentity.the SignonIdentity.
 

 

 
username :
username.username. [allow-none]
+
 

 

 
secret :
secret.secret. [allow-none]
+
 

 

 
store_secret :
whether signond should store the password.whether gSSO should save the password in secret storage.
 

 

 
methods :
methods. [transfer none][element-type utf8 GStrv]
+allowed methods. [transfer none][element-type utf8 GStrv]
 
 

 

 
caption :
caption.caption. [allow-none]
+
 

 

 
realms :
realms.realms. [allow-none]
+
 

 

 
owner :
owner.owner. [allow-none]
+
 

 

 
access_control_list :
access control list.access control list. [allow-none]
+
 

 

 
type :

-
+
@@ -749,19 +907,19 @@ Stores the data from info into the ident
 

 
signon_identity_verify_secret ()

-
void                signon_identity_verify_secret       (SignonIdentity *self,
+
void                signon_identity_verify_secret       (SignonIdentity *self,
                                                          const gchar *secret,
-                                                         SignonIdentityVerifyCb cb,
+                                                         SignonIdentityVerifyCb cb,
                                                          gpointer user_data);

 

-Verifies the given secret.
+Verifies the given secret. Not currently supported by gSSO.
 

 

 
 
 

 
self :
the SignonIdentity.the SignonIdentity.
 

 

 
info :

 

-
+
@@ -779,193 +937,6 @@ Verifies the given secret.
 

 
 
 

 
self :
the SignonIdentity.the SignonIdentity.
 

 

 
secret :

 

 

-

-

-
signon_identity_get_auth_session ()

-
void                signon_identity_get_auth_session    (SignonIdentity *self,
-                                                         SignonAuthSession *session,
-                                                         const gchar *method,
-                                                         SignonIdentitySessionReadyCb cb);

-

-Obtain a remote object for a local session object.
-

-

--
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-


self :
the SignonIdentity.
session :
the SignonAuthSession object to get the remote object for.
method :
method name for the session.
cb :
completion callback. [scope async]
-

-

-

-

-
signon_identity_info_access_control_list_append ()

-
void                signon_identity_info_access_control_list_append
-                                                        (SignonIdentityInfo *info,
-                                                         SignonSecurityContext *security_context);

-

-Appends a new SignonSecurityContext item to the access control list.
-

-

--
-
-
-
-
-
-
-
-
-
-


info :
the SignonIdentityInfo.
security_context :
(transfer full) a security context to be appended.

-

-

-

-
signon_identity_info_get_owner ()

-
const SignonSecurityContext * signon_identity_info_get_owner
-                                                        (const SignonIdentityInfo *info);

-

-Get owner security context of info.
-

-

--
-
-
-
-
-
-
-
-
-
-


info :
the SignonIdentityInfo.
Returns :
a security context. [transfer none]
-

-

-

-

-
signon_identity_info_set_methods ()

-
void                signon_identity_info_set_methods    (SignonIdentityInfo *info,
-                                                         const GHashTable *methods);

-

-Set allowed methods.
-Mechanisms are method-specific functions.
-

-

--
-
-
-
-
-
-
-
-
-
-


info :
the SignonIdentityInfo.
methods :
methods. [transfer none][element-type utf8 GStrv]
-

-

-

-

-
signon_identity_info_set_owner ()

-
void                signon_identity_info_set_owner      (SignonIdentityInfo *info,
-                                                         const SignonSecurityContext *owner);

-

-Specify owner security context.
-

-

--
-
-
-
-
-
-
-
-
-
-


info :
the SignonIdentityInfo.
owner :
(transfer none) a security context of owner.

-

-

-

-
signon_identity_info_set_owner_from_values ()

-
void                signon_identity_info_set_owner_from_values
-                                                        (SignonIdentityInfo *info,
-                                                         const gchar *system_context,
-                                                         const gchar *application_context);

-

-Specify owner security context.
-

-

--
-
-
-
-
-
-
-
-
-
-
-
-
-
-


info :
the SignonIdentityInfo.
system_context :
owner's system context.
application_context :
owner's application context.

-

-

-

-
Property Details

-

-
The "app-ctx" property

-
  "app-ctx"                  gchar*                : Read / Write

-
Set/Get Application Security Context.

-
Default value: ""

-

-

-

-
The "id" property

-
  "id"                       guint                 : Read / Write

-
Set/Get Identity ID.

-
Default value: 0

-

-

-

-
Signal Details

-

-
The "signout" signal

-
void                user_function                      (SignonIdentity *arg0,
-                                                        gpointer        user_data)      : No Hooks

-

-Emitted when the identity was signed out.
-

-

--
-
-
-
-


user_data :
user data set when the signal handler was connected.

-

 

 

 

diff --git a/docs/reference/html/libgsignon-glib-objects.html b/docs/reference/html/libgsignon-glib-objects.html
index db72cb5..0eef979 100644
--- a/docs/reference/html/libgsignon-glib-objects.html
+++ b/docs/reference/html/libgsignon-glib-objects.html
@@ -6,14 +6,14 @@
 
 
 
-
+
 
 
 
 
 
 
-
+
@@ -29,22 +29,22 @@
 
Credential management

 

-SignonAuthService — The authorization service object
+SignonAuthService — the authorization service object
 

 

-SignonAuthSession — Authentication session handler.
+SignonIdentity — client side presentation of a credential.
 

 

-SignonError — Possible errors from Signon.
+SignonIdentityInfo — data contained in a SignonIdentity.
 

 

-SignonIdentity — Client side presentation of a credential.
+SignonSecurityContext — representation of a security context.
 

 

-SignonIdentityInfo — Extra data for a SignonIdentity.
+SignonAuthSession — the authentication session object
 

 

-SignonSecurityContext — Representation of a security context.
+SignonError — possible gSSO errors
 

 

diff --git a/docs/reference/html/libgsignon-glib-overview.html b/docs/reference/html/libgsignon-glib-overview.html
index 2d2e099..1a27ab6 100644
--- a/docs/reference/html/libgsignon-glib-overview.html
+++ b/docs/reference/html/libgsignon-glib-overview.html
@@ -2,12 +2,12 @@
 
-Part I. libgsignon-glib Overview
+Part I. gSSO Overview
-
+
@@ -17,17 +17,21 @@
 
-
+
 

 

-Part I. libgsignon-glib Overview

-

-

-

-      libgsignon-glib provides authorization and authentication management for
-      GLib applications.
-      

+Part I. gSSO Overview

+

+
Table of Contents

+

+

+gSSO introduction
+

+

+gSSO usage examples
+

+

 

 

 

diff --git a/docs/reference/html/libgsignon-glib.devhelp2 b/docs/reference/html/libgsignon-glib.devhelp2
index d025b89..dd85c5b 100644
--- a/docs/reference/html/libgsignon-glib.devhelp2
+++ b/docs/reference/html/libgsignon-glib.devhelp2
@@ -2,23 +2,21 @@
 
 
   
-    
+    
+      
+      
+    
     
       
       
-        
-        
-        
-        
+        
+        
         
         
+        
+        
       
     
-    
-      
-      
-      
-    
     
       
       
@@ -27,72 +25,42 @@
     
   
   
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
     
-    
+    
+    
     
     
     
@@ -100,6 +68,7 @@
     
     
     
+    
     
     
     
@@ -109,94 +78,96 @@
     
     
     
+    
+    
+    
     
     
     
     
     
-    
-    
+    
     
+    
     
-    
-    
-    
     
-    
-    
+    
     
-    
     
+    
     
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
     
     
     
     
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
+    
   
 
diff --git a/docs/reference/html/object-tree.html b/docs/reference/html/object-tree.html
index a3dc959..1f7ba64 100644
--- a/docs/reference/html/object-tree.html
+++ b/docs/reference/html/object-tree.html
@@ -24,17 +24,10 @@
 Object Hierarchy

 
     GObject
-        SignonAuthService
         SignonAuthSession
-        SignonIdentity
-    GEnum
-        SignonError
-        SignonSessionDataUiPolicy
     GBoxed
         SignonIdentityInfo
         SignonSecurityContext
-    GFlags
-        SignonIdentityType
 

 

 

diff --git a/docs/reference/html/signond-dbus-api.html b/docs/reference/html/signond-dbus-api.html
deleted file mode 100644
index 3b1a6de..0000000
--- a/docs/reference/html/signond-dbus-api.html
+++ /dev/null
@@ -1,52 +0,0 @@
-
-
-
-
-Part III. signond D-Bus API
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

-

-Part III. signond D-Bus API

-

-

-

-      The signond D-Bus APIs are unstable, subject to change and should not be
-      used by client applications, which should use libgsignon-glib or
-      libgsignon-qt instead.
-      

-

-
Table of Contents

-

-

-com.google.code.AccountsSSO.gSingleSignOn.AuthService
-

-

-com.google.code.AccountsSSO.gSingleSignOn.AuthSession
-

-

-com.google.code.AccountsSSO.gSingleSignOn.Identity
-

-

-

-

-

-

-

-          Generated by GTK-Doc V1.18

-
-
\ No newline at end of file
diff --git a/docs/reference/libgsignon-glib-sections.txt b/docs/reference/libgsignon-glib-sections.txt
new file mode 100644
index 0000000..4e34f8a
--- /dev/null
+++ b/docs/reference/libgsignon-glib-sections.txt
@@ -0,0 +1,162 @@
+

+signon-auth-service
+SignonAuthService
+SignonAuthServiceClass
+SignonIdentityFilter
+SignonIdentityList
+SignonQueryIdentitiesCb
+SignonQueryMechanismCb
+SignonQueryMethodsCb
+signon_auth_service_new
+signon_auth_service_query_identities
+signon_auth_service_query_mechanisms
+signon_auth_service_query_methods
+
+SIGNON_AUTH_SERVICE
+SIGNON_AUTH_SERVICE_CLASS
+SIGNON_AUTH_SERVICE_GET_CLASS
+SIGNON_IS_AUTH_SERVICE
+SIGNON_IS_AUTH_SERVICE_CLASS
+SIGNON_TYPE_AUTH_SERVICE
+SignonAuthServicePrivate
+signon_auth_service_get_type
+

+
+

+signon-auth-session
+SignonAuthSession
+SIGNON_SESSION_DATA_CAPTION
+SIGNON_SESSION_DATA_PROXY
+SIGNON_SESSION_DATA_REALM
+SIGNON_SESSION_DATA_RENEW_TOKEN
+SIGNON_SESSION_DATA_SECRET
+SIGNON_SESSION_DATA_TIMEOUT
+SIGNON_SESSION_DATA_UI_POLICY
+SIGNON_SESSION_DATA_USERNAME
+SIGNON_SESSION_DATA_WINDOW_ID
+SignonAuthSession
+SignonAuthSessionClass
+SignonAuthSessionProcessCb
+SignonAuthSessionQueryAvailableMechanismsCb
+SignonSessionDataUiPolicy
+signon_auth_session_cancel
+signon_auth_session_get_method
+signon_auth_session_new
+signon_auth_session_process
+signon_auth_session_process_async
+signon_auth_session_process_finish
+signon_auth_session_query_available_mechanisms
+
+SIGNON_AUTH_SESSION
+SIGNON_AUTH_SESSION_CLASS
+SIGNON_AUTH_SESSION_GET_CLASS
+SIGNON_IS_AUTH_SESSION
+SIGNON_IS_AUTH_SESSION_CLASS
+SIGNON_TYPE_AUTH_SESSION
+SignonAuthSessionPrivate
+signon_auth_session_get_type
+

+
+

+signon-errors
+SIGNON_ERROR
+SignonError
+signon_error_quark
+

+
+

+signon-glib
+
+

+
+

+signon-identity
+SignonIdentity
+SignonIdentityClass
+SignonIdentityInfoCb
+SignonIdentityReferenceAddedCb
+SignonIdentityReferenceRemovedCb
+SignonIdentityRemovedCb
+SignonIdentitySessionReadyCb
+SignonIdentitySignedOutCb
+SignonIdentityStoreCredentialsCb
+SignonIdentityVerifyCb
+SignonIdentityVoidCb
+signon_identity_add_reference
+signon_identity_create_session
+signon_identity_get_auth_session
+signon_identity_get_last_error
+signon_identity_new
+signon_identity_new_from_db
+signon_identity_query_info
+signon_identity_remove
+signon_identity_remove_reference
+signon_identity_signout
+signon_identity_store_credentials_with_args
+signon_identity_store_credentials_with_info
+signon_identity_verify_secret
+
+SIGNON_IDENTITY
+SIGNON_IDENTITY_CLASS
+SIGNON_IDENTITY_GET_CLASS
+SIGNON_IS_IDENTITY
+SIGNON_IS_IDENTITY_CLASS
+SIGNON_TYPE_IDENTITY
+SignonIdentityPrivate
+signon_identity_get_type
+

+
+

+signon-identity-info
+SignonIdentityInfo
+SignonIdentityType
+signon_identity_info_access_control_list_append
+signon_identity_info_copy
+signon_identity_info_free
+signon_identity_info_get_access_control_list
+signon_identity_info_get_caption
+signon_identity_info_get_id
+signon_identity_info_get_identity_type
+signon_identity_info_get_methods
+signon_identity_info_get_owner
+signon_identity_info_get_realms
+signon_identity_info_get_storing_secret
+signon_identity_info_get_username
+signon_identity_info_new
+signon_identity_info_remove_method
+signon_identity_info_set_access_control_list
+signon_identity_info_set_caption
+signon_identity_info_set_identity_type
+signon_identity_info_set_method
+signon_identity_info_set_methods
+signon_identity_info_set_owner
+signon_identity_info_set_owner_from_values
+signon_identity_info_set_realms
+signon_identity_info_set_secret
+signon_identity_info_set_username
+
+signon_identity_info_get_type
+

+
+

+signon-security-context
+SignonSecurityContext
+SignonSecurityContextList
+signon_security_context_build_variant
+signon_security_context_copy
+signon_security_context_deconstruct_variant
+signon_security_context_free
+signon_security_context_get_application_context
+signon_security_context_get_system_context
+signon_security_context_list_build_variant
+signon_security_context_list_copy
+signon_security_context_list_deconstruct_variant
+signon_security_context_list_free
+signon_security_context_new
+signon_security_context_new_from_values
+signon_security_context_set_application_context
+signon_security_context_set_system_context
+
+signon_security_context_get_type
+

+
diff --git a/docs/reference/libgsignon-glib.types b/docs/reference/libgsignon-glib.types
index 9f1ca61..776ad71 100644
--- a/docs/reference/libgsignon-glib.types
+++ b/docs/reference/libgsignon-glib.types
@@ -1,8 +1,5 @@
 signon_auth_service_get_type
 signon_auth_session_get_type
-signon_error_get_type
 signon_identity_get_type
 signon_identity_info_get_type
-signon_identity_type_get_type
 signon_security_context_get_type
-signon_session_data_ui_policy_get_type
diff --git a/examples/Makefile.in b/examples/Makefile.in
new file mode 100644
index 0000000..c1e9983
--- /dev/null
+++ b/examples/Makefile.in
@@ -0,0 +1,590 @@
+# Makefile.in generated by automake 1.11.3 from Makefile.am.
+# @configure_input@
+
+# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
+# 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software
+# Foundation, Inc.
+# This Makefile.in is free software; the Free Software Foundation
+# gives unlimited permission to copy and/or distribute it,
+# with or without modifications, as long as this notice is preserved.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
+# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+# PARTICULAR PURPOSE.
+
+@SET_MAKE@
+
+VPATH = @srcdir@
+pkgdatadir = $(datadir)/@PACKAGE@
+pkgincludedir = $(includedir)/@PACKAGE@
+pkglibdir = $(libdir)/@PACKAGE@
+pkglibexecdir = $(libexecdir)/@PACKAGE@
+am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
+install_sh_DATA = $(install_sh) -c -m 644
+install_sh_PROGRAM = $(install_sh) -c
+install_sh_SCRIPT = $(install_sh) -c
+INSTALL_HEADER = $(INSTALL_DATA)
+transform = $(program_transform_name)
+NORMAL_INSTALL = :
+PRE_INSTALL = :
+POST_INSTALL = :
+NORMAL_UNINSTALL = :
+PRE_UNINSTALL = :
+POST_UNINSTALL = :
+build_triplet = @build@
+host_triplet = @host@
+bin_PROGRAMS = gsso-example$(EXEEXT)
+subdir = examples
+DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in
+ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
+am__aclocal_m4_deps = $(top_srcdir)/m4/gtk-doc.m4 \
+	$(top_srcdir)/m4/introspection.m4 $(top_srcdir)/m4/libtool.m4 \
+	$(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \
+	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
+	$(top_srcdir)/configure.ac
+am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
+	$(ACLOCAL_M4)
+mkinstalldirs = $(install_sh) -d
+CONFIG_HEADER = $(top_builddir)/config.h
+CONFIG_CLEAN_FILES =
+CONFIG_CLEAN_VPATH_FILES =
+am__installdirs = "$(DESTDIR)$(bindir)"
+PROGRAMS = $(bin_PROGRAMS)
+am_gsso_example_OBJECTS = gsso_example-gsso-example.$(OBJEXT)
+gsso_example_OBJECTS = $(am_gsso_example_OBJECTS)
+am__DEPENDENCIES_1 =
+gsso_example_DEPENDENCIES = $(am__DEPENDENCIES_1) \
+	$(top_builddir)/libgsignon-glib/libgsignon-glib.la
+AM_V_lt = $(am__v_lt_@AM_V@)
+am__v_lt_ = $(am__v_lt_@AM_DEFAULT_V@)
+am__v_lt_0 = --silent
+DEFAULT_INCLUDES = 
+depcomp = $(SHELL) $(top_srcdir)/build-aux/depcomp
+am__depfiles_maybe = depfiles
+am__mv = mv -f
+COMPILE = $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) \
+	$(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)
+LTCOMPILE = $(LIBTOOL) $(AM_V_lt) --tag=CC $(AM_LIBTOOLFLAGS) \
+	$(LIBTOOLFLAGS) --mode=compile $(CC) $(DEFS) \
+	$(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) \
+	$(AM_CFLAGS) $(CFLAGS)
+AM_V_CC = $(am__v_CC_@AM_V@)
+am__v_CC_ = $(am__v_CC_@AM_DEFAULT_V@)
+am__v_CC_0 = @echo "  CC    " $@;
+AM_V_at = $(am__v_at_@AM_V@)
+am__v_at_ = $(am__v_at_@AM_DEFAULT_V@)
+am__v_at_0 = @
+CCLD = $(CC)
+LINK = $(LIBTOOL) $(AM_V_lt) --tag=CC $(AM_LIBTOOLFLAGS) \
+	$(LIBTOOLFLAGS) --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) \
+	$(AM_LDFLAGS) $(LDFLAGS) -o $@
+AM_V_CCLD = $(am__v_CCLD_@AM_V@)
+am__v_CCLD_ = $(am__v_CCLD_@AM_DEFAULT_V@)
+am__v_CCLD_0 = @echo "  CCLD  " $@;
+AM_V_GEN = $(am__v_GEN_@AM_V@)
+am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@)
+am__v_GEN_0 = @echo "  GEN   " $@;
+SOURCES = $(gsso_example_SOURCES)
+DIST_SOURCES = $(gsso_example_SOURCES)
+ETAGS = etags
+CTAGS = ctags
+DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
+ACLOCAL = @ACLOCAL@
+AMTAR = @AMTAR@
+AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@
+AR = @AR@
+AUTOCONF = @AUTOCONF@
+AUTOHEADER = @AUTOHEADER@
+AUTOMAKE = @AUTOMAKE@
+AWK = @AWK@
+CC = @CC@
+CCDEPMODE = @CCDEPMODE@
+CFLAGS = @CFLAGS@
+CHECK_CFLAGS = @CHECK_CFLAGS@
+CHECK_LIBS = @CHECK_LIBS@
+CPP = @CPP@
+CPPFLAGS = @CPPFLAGS@
+CYGPATH_W = @CYGPATH_W@
+DEFS = @DEFS@
+DEPDIR = @DEPDIR@
+DEPS_CFLAGS = @DEPS_CFLAGS@
+DEPS_LIBS = @DEPS_LIBS@
+DLLTOOL = @DLLTOOL@
+DSYMUTIL = @DSYMUTIL@
+DUMPBIN = @DUMPBIN@
+ECHO_C = @ECHO_C@
+ECHO_N = @ECHO_N@
+ECHO_T = @ECHO_T@
+EGREP = @EGREP@
+EXEEXT = @EXEEXT@
+FGREP = @FGREP@
+GREP = @GREP@
+GTKDOC_CHECK = @GTKDOC_CHECK@
+GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@
+GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@
+GTKDOC_MKPDF = @GTKDOC_MKPDF@
+GTKDOC_REBASE = @GTKDOC_REBASE@
+GTestDBus_CFLAGS = @GTestDBus_CFLAGS@
+GTestDBus_LIBS = @GTestDBus_LIBS@
+HTML_DIR = @HTML_DIR@
+INSTALL = @INSTALL@
+INSTALL_DATA = @INSTALL_DATA@
+INSTALL_PROGRAM = @INSTALL_PROGRAM@
+INSTALL_SCRIPT = @INSTALL_SCRIPT@
+INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
+INTROSPECTION_CFLAGS = @INTROSPECTION_CFLAGS@
+INTROSPECTION_COMPILER = @INTROSPECTION_COMPILER@
+INTROSPECTION_GENERATE = @INTROSPECTION_GENERATE@
+INTROSPECTION_GIRDIR = @INTROSPECTION_GIRDIR@
+INTROSPECTION_LIBS = @INTROSPECTION_LIBS@
+INTROSPECTION_MAKEFILE = @INTROSPECTION_MAKEFILE@
+INTROSPECTION_SCANNER = @INTROSPECTION_SCANNER@
+INTROSPECTION_TYPELIBDIR = @INTROSPECTION_TYPELIBDIR@
+LD = @LD@
+LDFLAGS = @LDFLAGS@
+LIBOBJS = @LIBOBJS@
+LIBS = @LIBS@
+LIBTOOL = @LIBTOOL@
+LIPO = @LIPO@
+LN_S = @LN_S@
+LTLIBOBJS = @LTLIBOBJS@
+MAKEINFO = @MAKEINFO@
+MANIFEST_TOOL = @MANIFEST_TOOL@
+MKDIR_P = @MKDIR_P@
+NM = @NM@
+NMEDIT = @NMEDIT@
+OBJDUMP = @OBJDUMP@
+OBJEXT = @OBJEXT@
+OTOOL = @OTOOL@
+OTOOL64 = @OTOOL64@
+PACKAGE = @PACKAGE@
+PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
+PACKAGE_NAME = @PACKAGE_NAME@
+PACKAGE_STRING = @PACKAGE_STRING@
+PACKAGE_TARNAME = @PACKAGE_TARNAME@
+PACKAGE_URL = @PACKAGE_URL@
+PACKAGE_VERSION = @PACKAGE_VERSION@
+PATH_SEPARATOR = @PATH_SEPARATOR@
+PKG_CONFIG = @PKG_CONFIG@
+PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@
+PKG_CONFIG_PATH = @PKG_CONFIG_PATH@
+PYTHON = @PYTHON@
+PYTHON_EXEC_PREFIX = @PYTHON_EXEC_PREFIX@
+PYTHON_PLATFORM = @PYTHON_PLATFORM@
+PYTHON_PREFIX = @PYTHON_PREFIX@
+PYTHON_VERSION = @PYTHON_VERSION@
+RANLIB = @RANLIB@
+SED = @SED@
+SET_MAKE = @SET_MAKE@
+SHELL = @SHELL@
+STRIP = @STRIP@
+VERSION = @VERSION@
+abs_builddir = @abs_builddir@
+abs_srcdir = @abs_srcdir@
+abs_top_builddir = @abs_top_builddir@
+abs_top_srcdir = @abs_top_srcdir@
+ac_ct_AR = @ac_ct_AR@
+ac_ct_CC = @ac_ct_CC@
+ac_ct_DUMPBIN = @ac_ct_DUMPBIN@
+am__include = @am__include@
+am__leading_dot = @am__leading_dot@
+am__quote = @am__quote@
+am__tar = @am__tar@
+am__untar = @am__untar@
+bindir = @bindir@
+build = @build@
+build_alias = @build_alias@
+build_cpu = @build_cpu@
+build_os = @build_os@
+build_vendor = @build_vendor@
+builddir = @builddir@
+datadir = @datadir@
+datarootdir = @datarootdir@
+docdir = @docdir@
+dvidir = @dvidir@
+exec_prefix = @exec_prefix@
+host = @host@
+host_alias = @host_alias@
+host_cpu = @host_cpu@
+host_os = @host_os@
+host_vendor = @host_vendor@
+htmldir = @htmldir@
+includedir = @includedir@
+infodir = @infodir@
+install_sh = @install_sh@
+libdir = @libdir@
+libexecdir = @libexecdir@
+localedir = @localedir@
+localstatedir = @localstatedir@
+mandir = @mandir@
+mkdir_p = @mkdir_p@
+oldincludedir = @oldincludedir@
+pdfdir = @pdfdir@
+pkgpyexecdir = @pkgpyexecdir@
+pkgpythondir = @pkgpythondir@
+prefix = @prefix@
+program_transform_name = @program_transform_name@
+psdir = @psdir@
+pyexecdir = @pyexecdir@
+pyoverridesdir = @pyoverridesdir@
+pythondir = @pythondir@
+sbindir = @sbindir@
+sharedstatedir = @sharedstatedir@
+srcdir = @srcdir@
+sysconfdir = @sysconfdir@
+target_alias = @target_alias@
+top_build_prefix = @top_build_prefix@
+top_builddir = @top_builddir@
+top_srcdir = @top_srcdir@
+gsso_example_SOURCES = gsso-example.c
+gsso_example_CPPFLAGS = \
+	-I$(top_srcdir) \
+	$(DEPS_CFLAGS)
+
+gsso_example_LDADD = \
+	$(DEPS_LIBS) \
+	$(top_builddir)/libgsignon-glib/libgsignon-glib.la
+
+all: all-am
+
+.SUFFIXES:
+.SUFFIXES: .c .lo .o .obj
+$(srcdir)/Makefile.in:  $(srcdir)/Makefile.am  $(am__configure_deps)
+	@for dep in $?; do \
+	  case '$(am__configure_deps)' in \
+	    *$$dep*) \
+	      ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \
+	        && { if test -f $@; then exit 0; else break; fi; }; \
+	      exit 1;; \
+	  esac; \
+	done; \
+	echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu examples/Makefile'; \
+	$(am__cd) $(top_srcdir) && \
+	  $(AUTOMAKE) --gnu examples/Makefile
+.PRECIOUS: Makefile
+Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
+	@case '$?' in \
+	  *config.status*) \
+	    cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \
+	  *) \
+	    echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \
+	    cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \
+	esac;
+
+$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
+	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
+
+$(top_srcdir)/configure:  $(am__configure_deps)
+	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
+$(ACLOCAL_M4):  $(am__aclocal_m4_deps)
+	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
+$(am__aclocal_m4_deps):
+install-binPROGRAMS: $(bin_PROGRAMS)
+	@$(NORMAL_INSTALL)
+	test -z "$(bindir)" || $(MKDIR_P) "$(DESTDIR)$(bindir)"
+	@list='$(bin_PROGRAMS)'; test -n "$(bindir)" || list=; \
+	for p in $$list; do echo "$$p $$p"; done | \
+	sed 's/$(EXEEXT)$$//' | \
+	while read p p1; do if test -f $$p || test -f $$p1; \
+	  then echo "$$p"; echo "$$p"; else :; fi; \
+	done | \
+	sed -e 'p;s,.*/,,;n;h' -e 's|.*|.|' \
+	    -e 'p;x;s,.*/,,;s/$(EXEEXT)$$//;$(transform);s/$$/$(EXEEXT)/' | \
+	sed 'N;N;N;s,\n, ,g' | \
+	$(AWK) 'BEGIN { files["."] = ""; dirs["."] = 1 } \
+	  { d=$$3; if (dirs[d] != 1) { print "d", d; dirs[d] = 1 } \
+	    if ($$2 == $$4) files[d] = files[d] " " $$1; \
+	    else { print "f", $$3 "/" $$4, $$1; } } \
+	  END { for (d in files) print "f", d, files[d] }' | \
+	while read type dir files; do \
+	    if test "$$dir" = .; then dir=; else dir=/$$dir; fi; \
+	    test -z "$$files" || { \
+	    echo " $(INSTALL_PROGRAM_ENV) $(LIBTOOL) $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) --mode=install $(INSTALL_PROGRAM) $$files '$(DESTDIR)$(bindir)$$dir'"; \
+	    $(INSTALL_PROGRAM_ENV) $(LIBTOOL) $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) --mode=install $(INSTALL_PROGRAM) $$files "$(DESTDIR)$(bindir)$$dir" || exit $$?; \
+	    } \
+	; done
+
+uninstall-binPROGRAMS:
+	@$(NORMAL_UNINSTALL)
+	@list='$(bin_PROGRAMS)'; test -n "$(bindir)" || list=; \
+	files=`for p in $$list; do echo "$$p"; done | \
+	  sed -e 'h;s,^.*/,,;s/$(EXEEXT)$$//;$(transform)' \
+	      -e 's/$$/$(EXEEXT)/' `; \
+	test -n "$$list" || exit 0; \
+	echo " ( cd '$(DESTDIR)$(bindir)' && rm -f" $$files ")"; \
+	cd "$(DESTDIR)$(bindir)" && rm -f $$files
+
+clean-binPROGRAMS:
+	@list='$(bin_PROGRAMS)'; test -n "$$list" || exit 0; \
+	echo " rm -f" $$list; \
+	rm -f $$list || exit $$?; \
+	test -n "$(EXEEXT)" || exit 0; \
+	list=`for p in $$list; do echo "$$p"; done | sed 's/$(EXEEXT)$$//'`; \
+	echo " rm -f" $$list; \
+	rm -f $$list
+gsso-example$(EXEEXT): $(gsso_example_OBJECTS) $(gsso_example_DEPENDENCIES) $(EXTRA_gsso_example_DEPENDENCIES) 
+	@rm -f gsso-example$(EXEEXT)
+	$(AM_V_CCLD)$(LINK) $(gsso_example_OBJECTS) $(gsso_example_LDADD) $(LIBS)
+
+mostlyclean-compile:
+	-rm -f *.$(OBJEXT)
+
+distclean-compile:
+	-rm -f *.tab.c
+
+@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/gsso_example-gsso-example.Po@am__quote@
+
+.c.o:
+@am__fastdepCC_TRUE@	$(AM_V_CC)depbase=`echo $@ | sed 's|[^/]*$$|$(DEPDIR)/&|;s|\.o$$||'`;\
+@am__fastdepCC_TRUE@	$(COMPILE) -MT $@ -MD -MP -MF $$depbase.Tpo -c -o $@ $< &&\
+@am__fastdepCC_TRUE@	$(am__mv) $$depbase.Tpo $$depbase.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ $<
+
+.c.obj:
+@am__fastdepCC_TRUE@	$(AM_V_CC)depbase=`echo $@ | sed 's|[^/]*$$|$(DEPDIR)/&|;s|\.obj$$||'`;\
+@am__fastdepCC_TRUE@	$(COMPILE) -MT $@ -MD -MP -MF $$depbase.Tpo -c -o $@ `$(CYGPATH_W) '$<'` &&\
+@am__fastdepCC_TRUE@	$(am__mv) $$depbase.Tpo $$depbase.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='$<' object='$@' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'`
+
+.c.lo:
+@am__fastdepCC_TRUE@	$(AM_V_CC)depbase=`echo $@ | sed 's|[^/]*$$|$(DEPDIR)/&|;s|\.lo$$||'`;\
+@am__fastdepCC_TRUE@	$(LTCOMPILE) -MT $@ -MD -MP -MF $$depbase.Tpo -c -o $@ $< &&\
+@am__fastdepCC_TRUE@	$(am__mv) $$depbase.Tpo $$depbase.Plo
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='$<' object='$@' libtool=yes @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(LTCOMPILE) -c -o $@ $<
+
+gsso_example-gsso-example.o: gsso-example.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(gsso_example_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -MT gsso_example-gsso-example.o -MD -MP -MF $(DEPDIR)/gsso_example-gsso-example.Tpo -c -o gsso_example-gsso-example.o `test -f 'gsso-example.c' || echo '$(srcdir)/'`gsso-example.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) $(DEPDIR)/gsso_example-gsso-example.Tpo $(DEPDIR)/gsso_example-gsso-example.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='gsso-example.c' object='gsso_example-gsso-example.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(gsso_example_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o gsso_example-gsso-example.o `test -f 'gsso-example.c' || echo '$(srcdir)/'`gsso-example.c
+
+gsso_example-gsso-example.obj: gsso-example.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(gsso_example_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -MT gsso_example-gsso-example.obj -MD -MP -MF $(DEPDIR)/gsso_example-gsso-example.Tpo -c -o gsso_example-gsso-example.obj `if test -f 'gsso-example.c'; then $(CYGPATH_W) 'gsso-example.c'; else $(CYGPATH_W) '$(srcdir)/gsso-example.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) $(DEPDIR)/gsso_example-gsso-example.Tpo $(DEPDIR)/gsso_example-gsso-example.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='gsso-example.c' object='gsso_example-gsso-example.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(gsso_example_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o gsso_example-gsso-example.obj `if test -f 'gsso-example.c'; then $(CYGPATH_W) 'gsso-example.c'; else $(CYGPATH_W) '$(srcdir)/gsso-example.c'; fi`
+
+mostlyclean-libtool:
+	-rm -f *.lo
+
+clean-libtool:
+	-rm -rf .libs _libs
+
+ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES)
+	list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \
+	unique=`for i in $$list; do \
+	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
+	  done | \
+	  $(AWK) '{ files[$$0] = 1; nonempty = 1; } \
+	      END { if (nonempty) { for (i in files) print i; }; }'`; \
+	mkid -fID $$unique
+tags: TAGS
+
+TAGS:  $(HEADERS) $(SOURCES)  $(TAGS_DEPENDENCIES) \
+		$(TAGS_FILES) $(LISP)
+	set x; \
+	here=`pwd`; \
+	list='$(SOURCES) $(HEADERS)  $(LISP) $(TAGS_FILES)'; \
+	unique=`for i in $$list; do \
+	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
+	  done | \
+	  $(AWK) '{ files[$$0] = 1; nonempty = 1; } \
+	      END { if (nonempty) { for (i in files) print i; }; }'`; \
+	shift; \
+	if test -z "$(ETAGS_ARGS)$$*$$unique"; then :; else \
+	  test -n "$$unique" || unique=$$empty_fix; \
+	  if test $$# -gt 0; then \
+	    $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
+	      "$$@" $$unique; \
+	  else \
+	    $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
+	      $$unique; \
+	  fi; \
+	fi
+ctags: CTAGS
+CTAGS:  $(HEADERS) $(SOURCES)  $(TAGS_DEPENDENCIES) \
+		$(TAGS_FILES) $(LISP)
+	list='$(SOURCES) $(HEADERS)  $(LISP) $(TAGS_FILES)'; \
+	unique=`for i in $$list; do \
+	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
+	  done | \
+	  $(AWK) '{ files[$$0] = 1; nonempty = 1; } \
+	      END { if (nonempty) { for (i in files) print i; }; }'`; \
+	test -z "$(CTAGS_ARGS)$$unique" \
+	  || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \
+	     $$unique
+
+GTAGS:
+	here=`$(am__cd) $(top_builddir) && pwd` \
+	  && $(am__cd) $(top_srcdir) \
+	  && gtags -i $(GTAGS_ARGS) "$$here"
+
+distclean-tags:
+	-rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags
+
+distdir: $(DISTFILES)
+	@srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
+	topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
+	list='$(DISTFILES)'; \
+	  dist_files=`for file in $$list; do echo $$file; done | \
+	  sed -e "s|^$$srcdirstrip/||;t" \
+	      -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \
+	case $$dist_files in \
+	  */*) $(MKDIR_P) `echo "$$dist_files" | \
+			   sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \
+			   sort -u` ;; \
+	esac; \
+	for file in $$dist_files; do \
+	  if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
+	  if test -d $$d/$$file; then \
+	    dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
+	    if test -d "$(distdir)/$$file"; then \
+	      find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
+	    fi; \
+	    if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
+	      cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \
+	      find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
+	    fi; \
+	    cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \
+	  else \
+	    test -f "$(distdir)/$$file" \
+	    || cp -p $$d/$$file "$(distdir)/$$file" \
+	    || exit 1; \
+	  fi; \
+	done
+check-am: all-am
+check: check-am
+all-am: Makefile $(PROGRAMS)
+installdirs:
+	for dir in "$(DESTDIR)$(bindir)"; do \
+	  test -z "$$dir" || $(MKDIR_P) "$$dir"; \
+	done
+install: install-am
+install-exec: install-exec-am
+install-data: install-data-am
+uninstall: uninstall-am
+
+install-am: all-am
+	@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
+
+installcheck: installcheck-am
+install-strip:
+	if test -z '$(STRIP)'; then \
+	  $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+	    install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+	      install; \
+	else \
+	  $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+	    install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+	    "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \
+	fi
+mostlyclean-generic:
+
+clean-generic:
+
+distclean-generic:
+	-test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES)
+	-test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES)
+
+maintainer-clean-generic:
+	@echo "This command is intended for maintainers to use"
+	@echo "it deletes files that may require special tools to rebuild."
+clean: clean-am
+
+clean-am: clean-binPROGRAMS clean-generic clean-libtool mostlyclean-am
+
+distclean: distclean-am
+	-rm -rf ./$(DEPDIR)
+	-rm -f Makefile
+distclean-am: clean-am distclean-compile distclean-generic \
+	distclean-tags
+
+dvi: dvi-am
+
+dvi-am:
+
+html: html-am
+
+html-am:
+
+info: info-am
+
+info-am:
+
+install-data-am:
+
+install-dvi: install-dvi-am
+
+install-dvi-am:
+
+install-exec-am: install-binPROGRAMS
+
+install-html: install-html-am
+
+install-html-am:
+
+install-info: install-info-am
+
+install-info-am:
+
+install-man:
+
+install-pdf: install-pdf-am
+
+install-pdf-am:
+
+install-ps: install-ps-am
+
+install-ps-am:
+
+installcheck-am:
+
+maintainer-clean: maintainer-clean-am
+	-rm -rf ./$(DEPDIR)
+	-rm -f Makefile
+maintainer-clean-am: distclean-am maintainer-clean-generic
+
+mostlyclean: mostlyclean-am
+
+mostlyclean-am: mostlyclean-compile mostlyclean-generic \
+	mostlyclean-libtool
+
+pdf: pdf-am
+
+pdf-am:
+
+ps: ps-am
+
+ps-am:
+
+uninstall-am: uninstall-binPROGRAMS
+
+.MAKE: install-am install-strip
+
+.PHONY: CTAGS GTAGS all all-am check check-am clean clean-binPROGRAMS \
+	clean-generic clean-libtool ctags distclean distclean-compile \
+	distclean-generic distclean-libtool distclean-tags distdir dvi \
+	dvi-am html html-am info info-am install install-am \
+	install-binPROGRAMS install-data install-data-am install-dvi \
+	install-dvi-am install-exec install-exec-am install-html \
+	install-html-am install-info install-info-am install-man \
+	install-pdf install-pdf-am install-ps install-ps-am \
+	install-strip installcheck installcheck-am installdirs \
+	maintainer-clean maintainer-clean-generic mostlyclean \
+	mostlyclean-compile mostlyclean-generic mostlyclean-libtool \
+	pdf pdf-am ps ps-am tags uninstall uninstall-am \
+	uninstall-binPROGRAMS
+
+
+# Tell versions [3.59,3.63) of GNU make to not export all variables.
+# Otherwise a system limit (for SysV at least) may be exceeded.
+.NOEXPORT:
diff --git a/tests/check_signon.c b/tests/check_signon.c
index 57b692c..264f29c 100644
--- a/tests/check_signon.c
+++ b/tests/check_signon.c
@@ -762,7 +762,7 @@ START_TEST(test_auth_session_process_after_store)
 
     info = signon_identity_info_new ();
     signon_identity_info_set_method (info, "ssotest", ssotest_mechanisms);
-    signon_identity_info_set_owner_from_values (info, "", "");
+    signon_identity_info_set_owner_from_values (info, "someone", "else");
     signon_identity_info_access_control_list_append (info,
         signon_security_context_new_from_values ("*", "*"));
     signon_identity_info_set_username (info, "Nice user");
@@ -1349,8 +1349,9 @@ void query_identities_cb (SignonAuthService *auth_service,
         SignonIdentityInfo *info = (SignonIdentityInfo *) iter->data;
         const gchar *caption = signon_identity_info_get_caption (info);
 
-        g_print ("\tid=%d caption='%s'\n",
+        g_print ("\tid=%d username='%s' caption='%s'\n",
                  signon_identity_info_get_id (info),
+                 signon_identity_info_get_username (info),
                  caption);
 
         fail_unless (g_strcmp0 (caption, "MI-6") == 0,
diff --git a/tools/prepare-tizen.sh b/tools/prepare-tizen.sh
index 5e00ac7..d9195ea 100755
--- a/tools/prepare-tizen.sh
+++ b/tools/prepare-tizen.sh
@@ -18,7 +18,7 @@ git rm -r * && \
 tar -xzvf $1 -C $2 --strip-components 1 && \
 mkdir -p packaging && \
 cd packaging && \
-cp -f ../dists/rpm/libgsignon-glib-tizen.spec libgsignon-glib.spec && \
-cp -f ../dists/rpm/libgsignon-glib-tizen.changes libgsignon-glib.changes && \
+ln -s ../dists/rpm/libgsignon-glib-tizen.spec libgsignon-glib.spec && \
+ln -s ../dists/rpm/libgsignon-glib-tizen.changes libgsignon-glib.changes && \
 cd .. && git add *;
 
-- 
2.7.4