docs/reference/html/SignonIdentity.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>libgsignon-glib Reference Manual: SignonIdentity</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
   7 <link rel="home" href="index.html" title="libgsignon-glib Reference Manual">
   8 <link rel="up" href="credential-management.html" title="Credential management">
   9 <link rel="prev" href="SignonAuthService.html" title="SignonAuthService">
  10 <link rel="next" href="SignonIdentityInfo.html" title="SignonIdentityInfo">
  11 <meta name="generator" content="GTK-Doc V1.20 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
  16 <td width="100%" align="left" class="shortcuts">
  17 <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
  18                   <a href="#SignonIdentity.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
  19                   <a href="#SignonIdentity.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span>
  20                   <a href="#SignonIdentity.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
  21                   <a href="#SignonIdentity.signals" class="shortcut">Signals</a></span>
  22 </td>
  23 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
  24 <td><a accesskey="u" href="credential-management.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
  25 <td><a accesskey="p" href="SignonAuthService.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
  26 <td><a accesskey="n" href="SignonIdentityInfo.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
  27 </tr></table>
  28 <div class="refentry">
  29 <a name="SignonIdentity"></a><div class="titlepage"></div>
  30 <div class="refnamediv"><table width="100%"><tr>
  31 <td valign="top">
  32 <h2><span class="refentrytitle"><a name="SignonIdentity.top_of_page"></a>SignonIdentity</span></h2>
  33 <p>SignonIdentity — client side presentation of a credential.</p>
  34 </td>
  35 <td class="gallery_image" valign="top" align="right"></td>
  36 </tr></table></div>
  37 <div class="refsect1">
  38 <a name="SignonIdentity.functions"></a><h2>Functions</h2>
  39 <div class="informaltable"><table width="100%" border="0">
  40 <colgroup>
  41 <col width="150px" class="functions_return">
  42 <col class="functions_name">
  43 </colgroup>
  44 <tbody>
  45 <tr>
  46 <td class="function_type">
  47 <span class="returnvalue">void</span>
  48 </td>
  49 <td class="function_name">
  50 <span class="c_punctuation">(</span><a class="link" href="SignonIdentity.html#SignonIdentityInfoCb" title="SignonIdentityInfoCb ()">*SignonIdentityInfoCb</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
  51 </td>
  52 </tr>
  53 <tr>
  54 <td class="function_type">
  55 <span class="returnvalue">void</span>
  56 </td>
  57 <td class="function_name">
  58 <span class="c_punctuation">(</span><a class="link" href="SignonIdentity.html#SignonIdentitySessionReadyCb" title="SignonIdentitySessionReadyCb ()">*SignonIdentitySessionReadyCb</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
  59 </td>
  60 </tr>
  61 <tr>
  62 <td class="function_type">
  63 <span class="returnvalue">void</span>
  64 </td>
  65 <td class="function_name">
  66 <span class="c_punctuation">(</span><a class="link" href="SignonIdentity.html#SignonIdentityStoreCredentialsCb" title="SignonIdentityStoreCredentialsCb ()">*SignonIdentityStoreCredentialsCb</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
  67 </td>
  68 </tr>
  69 <tr>
  70 <td class="function_type">
  71 <span class="returnvalue">void</span>
  72 </td>
  73 <td class="function_name">
  74 <span class="c_punctuation">(</span><a class="link" href="SignonIdentity.html#SignonIdentityVerifyCb" title="SignonIdentityVerifyCb ()">*SignonIdentityVerifyCb</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
  75 </td>
  76 </tr>
  77 <tr>
  78 <td class="function_type">
  79 <span class="returnvalue">void</span>
  80 </td>
  81 <td class="function_name">
  82 <span class="c_punctuation">(</span><a class="link" href="SignonIdentity.html#SignonIdentityVoidCb" title="SignonIdentityVoidCb ()">*SignonIdentityVoidCb</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
  83 </td>
  84 </tr>
  85 <tr>
  86 <td class="function_type">
  87 <span class="returnvalue">void</span>
  88 </td>
  89 <td class="function_name">
  90 <a class="link" href="SignonIdentity.html#signon-identity-add-reference" title="signon_identity_add_reference ()">signon_identity_add_reference</a> <span class="c_punctuation">()</span>
  91 </td>
  92 </tr>
  93 <tr>
  94 <td class="function_type">
  95 <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="returnvalue">SignonAuthSession</span></a> *
  96 </td>
  97 <td class="function_name">
  98 <a class="link" href="SignonIdentity.html#signon-identity-create-session" title="signon_identity_create_session ()">signon_identity_create_session</a> <span class="c_punctuation">()</span>
  99 </td>
 100 </tr>
 101 <tr>
 102 <td class="function_type">
 103 <span class="returnvalue">void</span>
 104 </td>
 105 <td class="function_name">
 106 <a class="link" href="SignonIdentity.html#signon-identity-get-auth-session" title="signon_identity_get_auth_session ()">signon_identity_get_auth_session</a> <span class="c_punctuation">()</span>
 107 </td>
 108 </tr>
 109 <tr>
 110 <td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *
 111 </td>
 112 <td class="function_name">
 113 <a class="link" href="SignonIdentity.html#signon-identity-get-last-error" title="signon_identity_get_last_error ()">signon_identity_get_last_error</a> <span class="c_punctuation">()</span>
 114 </td>
 115 </tr>
 116 <tr>
 117 <td class="function_type">
 118 <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="returnvalue">SignonIdentity</span></a> *
 119 </td>
 120 <td class="function_name">
 121 <a class="link" href="SignonIdentity.html#signon-identity-new" title="signon_identity_new ()">signon_identity_new</a> <span class="c_punctuation">()</span>
 122 </td>
 123 </tr>
 124 <tr>
 125 <td class="function_type">
 126 <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="returnvalue">SignonIdentity</span></a> *
 127 </td>
 128 <td class="function_name">
 129 <a class="link" href="SignonIdentity.html#signon-identity-new-from-db" title="signon_identity_new_from_db ()">signon_identity_new_from_db</a> <span class="c_punctuation">()</span>
 130 </td>
 131 </tr>
 132 <tr>
 133 <td class="function_type">
 134 <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="returnvalue">SignonIdentity</span></a> *
 135 </td>
 136 <td class="function_name">
 137 <a class="link" href="SignonIdentity.html#signon-identity-new-with-context" title="signon_identity_new_with_context ()">signon_identity_new_with_context</a> <span class="c_punctuation">()</span>
 138 </td>
 139 </tr>
 140 <tr>
 141 <td class="function_type">
 142 <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="returnvalue">SignonIdentity</span></a> *
 143 </td>
 144 <td class="function_name">
 145 <a class="link" href="SignonIdentity.html#signon-identity-new-with-context-from-db" title="signon_identity_new_with_context_from_db ()">signon_identity_new_with_context_from_db</a> <span class="c_punctuation">()</span>
 146 </td>
 147 </tr>
 148 <tr>
 149 <td class="function_type">
 150 <span class="returnvalue">void</span>
 151 </td>
 152 <td class="function_name">
 153 <a class="link" href="SignonIdentity.html#signon-identity-query-info" title="signon_identity_query_info ()">signon_identity_query_info</a> <span class="c_punctuation">()</span>
 154 </td>
 155 </tr>
 156 <tr>
 157 <td class="function_type">
 158 <span class="returnvalue">void</span>
 159 </td>
 160 <td class="function_name">
 161 <a class="link" href="SignonIdentity.html#signon-identity-remove" title="signon_identity_remove ()">signon_identity_remove</a> <span class="c_punctuation">()</span>
 162 </td>
 163 </tr>
 164 <tr>
 165 <td class="function_type">
 166 <span class="returnvalue">void</span>
 167 </td>
 168 <td class="function_name">
 169 <a class="link" href="SignonIdentity.html#signon-identity-remove-reference" title="signon_identity_remove_reference ()">signon_identity_remove_reference</a> <span class="c_punctuation">()</span>
 170 </td>
 171 </tr>
 172 <tr>
 173 <td class="function_type">
 174 <span class="returnvalue">void</span>
 175 </td>
 176 <td class="function_name">
 177 <a class="link" href="SignonIdentity.html#signon-identity-signout" title="signon_identity_signout ()">signon_identity_signout</a> <span class="c_punctuation">()</span>
 178 </td>
 179 </tr>
 180 <tr>
 181 <td class="function_type">
 182 <span class="returnvalue">void</span>
 183 </td>
 184 <td class="function_name">
 185 <a class="link" href="SignonIdentity.html#signon-identity-store-credentials-with-args" title="signon_identity_store_credentials_with_args ()">signon_identity_store_credentials_with_args</a> <span class="c_punctuation">()</span>
 186 </td>
 187 </tr>
 188 <tr>
 189 <td class="function_type">
 190 <span class="returnvalue">void</span>
 191 </td>
 192 <td class="function_name">
 193 <a class="link" href="SignonIdentity.html#signon-identity-store-credentials-with-info" title="signon_identity_store_credentials_with_info ()">signon_identity_store_credentials_with_info</a> <span class="c_punctuation">()</span>
 194 </td>
 195 </tr>
 196 <tr>
 197 <td class="function_type">
 198 <span class="returnvalue">void</span>
 199 </td>
 200 <td class="function_name">
 201 <a class="link" href="SignonIdentity.html#signon-identity-verify-secret" title="signon_identity_verify_secret ()">signon_identity_verify_secret</a> <span class="c_punctuation">()</span>
 202 </td>
 203 </tr>
 204 </tbody>
 205 </table></div>
 206 </div>
 207 <div class="refsect1">
 208 <a name="SignonIdentity.properties"></a><h2>Properties</h2>
 209 <div class="informaltable"><table border="0">
 210 <colgroup>
 211 <col width="150px" class="properties_type">
 212 <col width="300px" class="properties_name">
 213 <col width="200px" class="properties_flags">
 214 </colgroup>
 215 <tbody>
 216 <tr>
 217 <td class="property_type">
 218 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
 219 <td class="property_name"><a class="link" href="SignonIdentity.html#SignonIdentity--app-ctx" title="The “app-ctx” property">app-ctx</a></td>
 220 <td class="property_flags">Read / Write</td>
 221 </tr>
 222 <tr>
 223 <td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
 224 <td class="property_name"><a class="link" href="SignonIdentity.html#SignonIdentity--id" title="The “id” property">id</a></td>
 225 <td class="property_flags">Read / Write</td>
 226 </tr>
 227 </tbody>
 228 </table></div>
 229 </div>
 230 <div class="refsect1">
 231 <a name="SignonIdentity.signals"></a><h2>Signals</h2>
 232 <div class="informaltable"><table border="0">
 233 <colgroup>
 234 <col width="150px" class="signals_return">
 235 <col width="300px" class="signals_name">
 236 <col width="200px" class="signals_flags">
 237 </colgroup>
 238 <tbody><tr>
 239 <td class="signal_type"><span class="returnvalue">void</span></td>
 240 <td class="signal_name"><a class="link" href="SignonIdentity.html#SignonIdentity-signout" title="The “signout” signal">signout</a></td>
 241 <td class="signal_flags"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-NO-HOOKS:CAPS">No Hooks</a></td>
 242 </tr></tbody>
 243 </table></div>
 244 </div>
 245 <div class="refsect1">
 246 <a name="SignonIdentity.other"></a><h2>Types and Values</h2>
 247 <div class="informaltable"><table width="100%" border="0">
 248 <colgroup>
 249 <col width="150px" class="name">
 250 <col class="description">
 251 </colgroup>
 252 <tbody>
 253 <tr>
 254 <td class="datatype_keyword">struct</td>
 255 <td class="function_name"><a class="link" href="SignonIdentity.html#SignonIdentity-struct" title="struct SignonIdentity">SignonIdentity</a></td>
 256 </tr>
 257 <tr>
 258 <td class="datatype_keyword">struct</td>
 259 <td class="function_name"><a class="link" href="SignonIdentity.html#SignonIdentityClass" title="struct SignonIdentityClass">SignonIdentityClass</a></td>
 260 </tr>
 261 <tr>
 262 <td class="typedef_keyword">typedef</td>
 263 <td class="function_name"><a class="link" href="SignonIdentity.html#SignonIdentityReferenceAddedCb" title="SignonIdentityReferenceAddedCb">SignonIdentityReferenceAddedCb</a></td>
 264 </tr>
 265 <tr>
 266 <td class="typedef_keyword">typedef</td>
 267 <td class="function_name"><a class="link" href="SignonIdentity.html#SignonIdentityReferenceRemovedCb" title="SignonIdentityReferenceRemovedCb">SignonIdentityReferenceRemovedCb</a></td>
 268 </tr>
 269 <tr>
 270 <td class="typedef_keyword">typedef</td>
 271 <td class="function_name"><a class="link" href="SignonIdentity.html#SignonIdentityRemovedCb" title="SignonIdentityRemovedCb">SignonIdentityRemovedCb</a></td>
 272 </tr>
 273 <tr>
 274 <td class="typedef_keyword">typedef</td>
 275 <td class="function_name"><a class="link" href="SignonIdentity.html#SignonIdentitySignedOutCb" title="SignonIdentitySignedOutCb">SignonIdentitySignedOutCb</a></td>
 276 </tr>
 277 </tbody>
 278 </table></div>
 279 </div>
 280 <div class="refsect1">
 281 <a name="SignonIdentity.object-hierarchy"></a><h2>Object Hierarchy</h2>
 282 <pre class="screen">    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 283     <span class="lineart">╰──</span> SignonIdentity
 284 </pre>
 285 </div>
 286 <div class="refsect1">
 287 <a name="SignonIdentity.description"></a><h2>Description</h2>
 288 <p>The <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> objects represent identities and provide operations that
 289 can be performed on them such as identity creation, removal, starting an authentication
 290 session, and so on. </p>
 291 <p>Identities can also be stored and retrieved from a gSSO database, in which
 292 case they also contain a number of properties that can be retrieved
 293 using <a class="link" href="SignonIdentity.html#signon-identity-query-info" title="signon_identity_query_info ()"><code class="function">signon_identity_query_info()</code></a> and are represented via <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>.
 294 Such identities are identified by a numeric id number and they are subject
 295 to access control.</p>
 296 <div class="refsect1">
 297 <a name="id-1.3.3.3.8.4"></a><h2>Operations on an identity</h2>
 298 </div>
 299 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 300 <li class="listitem"><p>a new identity can be created with <a class="link" href="SignonIdentity.html#signon-identity-new" title="signon_identity_new ()"><code class="function">signon_identity_new()</code></a> or
 301 <a class="link" href="SignonIdentity.html#signon-identity-new-with-context" title="signon_identity_new_with_context ()"><code class="function">signon_identity_new_with_context()</code></a>. This operation does not store the
 302 identity to the database, the identity is not visible to other applications,
 303 and accordingly it is not subject to access control.</p></li>
 304 <li class="listitem"><p>an authentication session can be started from an identity using
 305 <a class="link" href="SignonIdentity.html#signon-identity-create-session" title="signon_identity_create_session ()"><code class="function">signon_identity_create_session()</code></a> or <a class="link" href="SignonAuthSession.html#signon-auth-session-new" title="signon_auth_session_new ()"><code class="function">signon_auth_session_new()</code></a>. If the identity
 306 has been retrieved from a database, only the authentication methods listed
 307 in associated <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> are allowed to be used.</p></li>
 308 <li class="listitem"><p>identites stored in a database can be enumerated using
 309 <a class="link" href="SignonAuthService.html#signon-auth-service-query-identities" title="signon_auth_service_query_identities ()"><code class="function">signon_auth_service_query_identities()</code></a>. Only the identites owned by the
 310 requesting application are returned.</p></li>
 311 <li class="listitem"><p>identities stored in a database can be retrieved using <a class="link" href="SignonIdentity.html#signon-identity-new-from-db" title="signon_identity_new_from_db ()"><code class="function">signon_identity_new_from_db()</code></a>
 312 or <a class="link" href="SignonIdentity.html#signon-identity-new-with-context-from-db" title="signon_identity_new_with_context_from_db ()"><code class="function">signon_identity_new_with_context_from_db()</code></a>, subject to access control (an
 313 application performing that operation has to be either the identity's owner,
 314 or it has to be on the ACL list).</p></li>
 315 <li class="listitem"><p>newly created identities can be stored to the database, and identities already
 316 in the database can be updated using <a class="link" href="SignonIdentity.html#signon-identity-store-credentials-with-info" title="signon_identity_store_credentials_with_info ()"><code class="function">signon_identity_store_credentials_with_info()</code></a>
 317 (with <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>)
 318 or <a class="link" href="SignonIdentity.html#signon-identity-store-credentials-with-args" title="signon_identity_store_credentials_with_args ()"><code class="function">signon_identity_store_credentials_with_args()</code></a> (with separate arguments that
 319 together form the contents of <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>). Only the owners can update
 320 identites.</p></li>
 321 <li class="listitem"><p>identites in the database can be removed by their owners using
 322 <a class="link" href="SignonIdentity.html#signon-identity-remove" title="signon_identity_remove ()"><code class="function">signon_identity_remove()</code></a>.</p></li>
 323 <li class="listitem"><p>identity owners can request to close all authentication sessions and
 324 remove all secrets and tokens using <a class="link" href="SignonIdentity.html#signon-identity-signout" title="signon_identity_signout ()"><code class="function">signon_identity_signout()</code></a>.</p></li>
 325 </ul></div>
 326 <div class="refsect1">
 327 <a name="id-1.3.3.3.8.6"></a><h2>Data fields in <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>
 328 </h2>
 329 </div>
 330 <p>These are the data fields that are stored into the database as a part of an
 331 identity record using <a class="link" href="SignonIdentity.html#signon-identity-store-credentials-with-args" title="signon_identity_store_credentials_with_args ()"><code class="function">signon_identity_store_credentials_with_args()</code></a> or
 332 <a class="link" href="SignonIdentity.html#signon-identity-store-credentials-with-info" title="signon_identity_store_credentials_with_info ()"><code class="function">signon_identity_store_credentials_with_info()</code></a> and can be retrieved using
 333 <a class="link" href="SignonIdentity.html#signon-identity-query-info" title="signon_identity_query_info ()"><code class="function">signon_identity_query_info()</code></a> or <a class="link" href="SignonAuthService.html#signon-auth-service-query-identities" title="signon_auth_service_query_identities ()"><code class="function">signon_auth_service_query_identities()</code></a>:</p>
 334 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 335 <li class="listitem"><p>Caption is a display name for the identity, presented to the user. Default
 336 value is an empty caption. </p></li>
 337 <li class="listitem"><p>Realms is a list of realms that the identity can be used in.
 338 Interpretation of this field is up to the method. Typically it is
 339 a list of internet domains allowed for an authentication request.
 340 Default value is an empty list.</p></li>
 341 <li class="listitem"><p>Type is a <a class="link" href="SignonIdentityInfo.html#SignonIdentityType" title="enum SignonIdentityType"><span class="type">SignonIdentityType</span></a>. Interpretation of this field is up to the application;
 342 gSSO does not use it. Default value is <a class="link" href="SignonIdentityInfo.html#SIGNON-IDENTITY-TYPE-OTHER:CAPS"><span class="type">SIGNON_IDENTITY_TYPE_OTHER</span></a></p></li>
 343 <li class="listitem"><p>Owner is a <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> object, which specifies the identity
 344 owner. Owners are allowed to perform all of the operations on the identity
 345 specified above. By default an identity's owner is determined by gSSO daemon
 346 using system services for the system context, and a string supplied in
 347 <a class="link" href="SignonIdentity.html#signon-identity-new-with-context" title="signon_identity_new_with_context ()"><code class="function">signon_identity_new_with_context()</code></a> for the application context.</p></li>
 348 <li class="listitem"><p>ACL is a list of <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> objects, that specifies applications
 349 that can access the identity to perform authentication sessions. They're not
 350 allowed to make any changes to the identity. Default value is an empty list,
 351 and depending on how gSSO is configured it's also possible to provide a list
 352 with a wildcard item to relax the access control restriction
 353 (see <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>).</p></li>
 354 <li class="listitem"><p>Methods is a <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> containing method names as keys, and lists of
 355 allowed mechanisms as values (also, a special value "*" means that any
 356 mechanism is allowed). Only those methods and mechanisms that are in the table
 357 are allowed to be used in authentication sessions. Default is an empty list.</p></li>
 358 <li class="listitem"><p>Id is a numeric identification of the identity record in the database. The
 359 application cannot set this, as it's determined by the daemon.</p></li>
 360 <li class="listitem"><p>Username is used to provide a username to authentication plugins after
 361 issuing <a class="link" href="SignonAuthSession.html#signon-auth-session-process-async" title="signon_auth_session_process_async ()"><code class="function">signon_auth_session_process_async()</code></a>. Applications can override this
 362 by providing a username explicitly in the <em class="parameter"><code>session_data</code></em>
 363  parameter to that
 364 function. By default there is no username.</p></li>
 365 <li class="listitem"><p>Secret is used in the same way as username, but it is write-only (cannot
 366 be retrieved from a <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a>). It is also possible to prevent
 367 secret from being stored in the database.</p></li>
 368 </ul></div>
 369 </div>
 370 <div class="refsect1">
 371 <a name="SignonIdentity.functions_details"></a><h2>Functions</h2>
 372 <div class="refsect2">
 373 <a name="SignonIdentityInfoCb"></a><h3>SignonIdentityInfoCb ()</h3>
 374 <pre class="programlisting"><span class="returnvalue">void</span>
 375 <span class="c_punctuation">(</span>*SignonIdentityInfoCb<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
 376                          <em class="parameter"><code><a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
 377                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 378                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 379 <p>Callback to be passed to <a class="link" href="SignonIdentity.html#signon-identity-query-info" title="signon_identity_query_info ()"><code class="function">signon_identity_query_info()</code></a>.</p>
 380 <div class="refsect3">
 381 <a name="id-1.3.3.3.9.2.5"></a><h4>Parameters</h4>
 382 <div class="informaltable"><table width="100%" border="0">
 383 <colgroup>
 384 <col width="150px" class="parameters_name">
 385 <col class="parameters_description">
 386 <col width="200px" class="parameters_annotations">
 387 </colgroup>
 388 <tbody>
 389 <tr>
 390 <td class="parameter_name"><p>self</p></td>
 391 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
 392 <td class="parameter_annotations"> </td>
 393 </tr>
 394 <tr>
 395 <td class="parameter_name"><p>info</p></td>
 396 <td class="parameter_description"><p> the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> for <em class="parameter"><code>self</code></em>
 397 . </p></td>
 398 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
 399 </tr>
 400 <tr>
 401 <td class="parameter_name"><p>error</p></td>
 402 <td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> if an error occurred, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> otherwise.</p></td>
 403 <td class="parameter_annotations"> </td>
 404 </tr>
 405 <tr>
 406 <td class="parameter_name"><p>user_data</p></td>
 407 <td class="parameter_description"><p>the user data that was passed when installing this callback.</p></td>
 408 <td class="parameter_annotations"> </td>
 409 </tr>
 410 </tbody>
 411 </table></div>
 412 </div>
 413 </div>
 414 <hr>
 415 <div class="refsect2">
 416 <a name="SignonIdentitySessionReadyCb"></a><h3>SignonIdentitySessionReadyCb ()</h3>
 417 <pre class="programlisting"><span class="returnvalue">void</span>
 418 <span class="c_punctuation">(</span>*SignonIdentitySessionReadyCb<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> *self</code></em>,
 419                                  <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 420                                  <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
 421                                  <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *bus_name</code></em>,
 422                                  <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>);</pre>
 423 <p>Callback to be passed to <a class="link" href="SignonIdentity.html#signon-identity-get-auth-session" title="signon_identity_get_auth_session ()"><code class="function">signon_identity_get_auth_session()</code></a>.</p>
 424 <div class="refsect3">
 425 <a name="id-1.3.3.3.9.3.5"></a><h4>Parameters</h4>
 426 <div class="informaltable"><table width="100%" border="0">
 427 <colgroup>
 428 <col width="150px" class="parameters_name">
 429 <col class="parameters_description">
 430 <col width="200px" class="parameters_annotations">
 431 </colgroup>
 432 <tbody>
 433 <tr>
 434 <td class="parameter_name"><p>self</p></td>
 435 <td class="parameter_description"><p>the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>.</p></td>
 436 <td class="parameter_annotations"> </td>
 437 </tr>
 438 <tr>
 439 <td class="parameter_name"><p>error</p></td>
 440 <td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> if an error occurred, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> otherwise.</p></td>
 441 <td class="parameter_annotations"> </td>
 442 </tr>
 443 <tr>
 444 <td class="parameter_name"><p>connection</p></td>
 445 <td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> for the session.</p></td>
 446 <td class="parameter_annotations"> </td>
 447 </tr>
 448 <tr>
 449 <td class="parameter_name"><p>bus_name</p></td>
 450 <td class="parameter_description"><p>a D-Bus bus name for the session.</p></td>
 451 <td class="parameter_annotations"> </td>
 452 </tr>
 453 <tr>
 454 <td class="parameter_name"><p>object_path</p></td>
 455 <td class="parameter_description"><p>a D-Bus object path for the session.</p></td>
 456 <td class="parameter_annotations"> </td>
 457 </tr>
 458 </tbody>
 459 </table></div>
 460 </div>
 461 </div>
 462 <hr>
 463 <div class="refsect2">
 464 <a name="SignonIdentityStoreCredentialsCb"></a><h3>SignonIdentityStoreCredentialsCb ()</h3>
 465 <pre class="programlisting"><span class="returnvalue">void</span>
 466 <span class="c_punctuation">(</span>*SignonIdentityStoreCredentialsCb<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
 467                                      <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> id</code></em>,
 468                                      <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 469                                      <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 470 <p>Callback to be passed to <a class="link" href="SignonIdentity.html#signon-identity-store-credentials-with-args" title="signon_identity_store_credentials_with_args ()"><code class="function">signon_identity_store_credentials_with_args()</code></a> or
 471 <a class="link" href="SignonIdentity.html#signon-identity-store-credentials-with-info" title="signon_identity_store_credentials_with_info ()"><code class="function">signon_identity_store_credentials_with_info()</code></a>.</p>
 472 <div class="refsect3">
 473 <a name="id-1.3.3.3.9.4.5"></a><h4>Parameters</h4>
 474 <div class="informaltable"><table width="100%" border="0">
 475 <colgroup>
 476 <col width="150px" class="parameters_name">
 477 <col class="parameters_description">
 478 <col width="200px" class="parameters_annotations">
 479 </colgroup>
 480 <tbody>
 481 <tr>
 482 <td class="parameter_name"><p>self</p></td>
 483 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
 484 <td class="parameter_annotations"> </td>
 485 </tr>
 486 <tr>
 487 <td class="parameter_name"><p>id</p></td>
 488 <td class="parameter_description"><p>the numeric ID of the identity in the database.</p></td>
 489 <td class="parameter_annotations"> </td>
 490 </tr>
 491 <tr>
 492 <td class="parameter_name"><p>error</p></td>
 493 <td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> if an error occurred, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> otherwise.</p></td>
 494 <td class="parameter_annotations"> </td>
 495 </tr>
 496 <tr>
 497 <td class="parameter_name"><p>user_data</p></td>
 498 <td class="parameter_description"><p>the user data that was passed when installing this callback.</p></td>
 499 <td class="parameter_annotations"> </td>
 500 </tr>
 501 </tbody>
 502 </table></div>
 503 </div>
 504 </div>
 505 <hr>
 506 <div class="refsect2">
 507 <a name="SignonIdentityVerifyCb"></a><h3>SignonIdentityVerifyCb ()</h3>
 508 <pre class="programlisting"><span class="returnvalue">void</span>
 509 <span class="c_punctuation">(</span>*SignonIdentityVerifyCb<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
 510                            <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> valid</code></em>,
 511                            <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 512                            <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 513 <p>Callback to be passed to <a class="link" href="SignonIdentity.html#signon-identity-verify-secret" title="signon_identity_verify_secret ()"><code class="function">signon_identity_verify_secret()</code></a>.</p>
 514 <div class="refsect3">
 515 <a name="id-1.3.3.3.9.5.5"></a><h4>Parameters</h4>
 516 <div class="informaltable"><table width="100%" border="0">
 517 <colgroup>
 518 <col width="150px" class="parameters_name">
 519 <col class="parameters_description">
 520 <col width="200px" class="parameters_annotations">
 521 </colgroup>
 522 <tbody>
 523 <tr>
 524 <td class="parameter_name"><p>self</p></td>
 525 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
 526 <td class="parameter_annotations"> </td>
 527 </tr>
 528 <tr>
 529 <td class="parameter_name"><p>valid</p></td>
 530 <td class="parameter_description"><p>whether the secret is valid.</p></td>
 531 <td class="parameter_annotations"> </td>
 532 </tr>
 533 <tr>
 534 <td class="parameter_name"><p>error</p></td>
 535 <td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> if an error occurred, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> otherwise.</p></td>
 536 <td class="parameter_annotations"> </td>
 537 </tr>
 538 <tr>
 539 <td class="parameter_name"><p>user_data</p></td>
 540 <td class="parameter_description"><p>the user data that was passed when installing this callback.</p></td>
 541 <td class="parameter_annotations"> </td>
 542 </tr>
 543 </tbody>
 544 </table></div>
 545 </div>
 546 </div>
 547 <hr>
 548 <div class="refsect2">
 549 <a name="SignonIdentityVoidCb"></a><h3>SignonIdentityVoidCb ()</h3>
 550 <pre class="programlisting"><span class="returnvalue">void</span>
 551 <span class="c_punctuation">(</span>*SignonIdentityVoidCb<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
 552                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 553                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 554 <p>Generic callback to be passed to several <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> methods.</p>
 555 <div class="refsect3">
 556 <a name="id-1.3.3.3.9.6.5"></a><h4>Parameters</h4>
 557 <div class="informaltable"><table width="100%" border="0">
 558 <colgroup>
 559 <col width="150px" class="parameters_name">
 560 <col class="parameters_description">
 561 <col width="200px" class="parameters_annotations">
 562 </colgroup>
 563 <tbody>
 564 <tr>
 565 <td class="parameter_name"><p>self</p></td>
 566 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
 567 <td class="parameter_annotations"> </td>
 568 </tr>
 569 <tr>
 570 <td class="parameter_name"><p>error</p></td>
 571 <td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> if an error occurred, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> otherwise.</p></td>
 572 <td class="parameter_annotations"> </td>
 573 </tr>
 574 <tr>
 575 <td class="parameter_name"><p>user_data</p></td>
 576 <td class="parameter_description"><p>the user data that was passed when installing this callback.</p></td>
 577 <td class="parameter_annotations"> </td>
 578 </tr>
 579 </tbody>
 580 </table></div>
 581 </div>
 582 </div>
 583 <hr>
 584 <div class="refsect2">
 585 <a name="signon-identity-add-reference"></a><h3>signon_identity_add_reference ()</h3>
 586 <pre class="programlisting"><span class="returnvalue">void</span>
 587 signon_identity_add_reference (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
 588                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *reference</code></em>,
 589                                <em class="parameter"><code><a class="link" href="SignonIdentity.html#SignonIdentityReferenceAddedCb" title="SignonIdentityReferenceAddedCb"><span class="type">SignonIdentityReferenceAddedCb</span></a> cb</code></em>,
 590                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 591 <p>Adds named reference to identity. Not currently supported by gSSO.</p>
 592 <div class="refsect3">
 593 <a name="id-1.3.3.3.9.7.5"></a><h4>Parameters</h4>
 594 <div class="informaltable"><table width="100%" border="0">
 595 <colgroup>
 596 <col width="150px" class="parameters_name">
 597 <col class="parameters_description">
 598 <col width="200px" class="parameters_annotations">
 599 </colgroup>
 600 <tbody>
 601 <tr>
 602 <td class="parameter_name"><p>self</p></td>
 603 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
 604 <td class="parameter_annotations"> </td>
 605 </tr>
 606 <tr>
 607 <td class="parameter_name"><p>reference</p></td>
 608 <td class="parameter_description"><p>reference to be added</p></td>
 609 <td class="parameter_annotations"> </td>
 610 </tr>
 611 <tr>
 612 <td class="parameter_name"><p>cb</p></td>
 613 <td class="parameter_description"><p>callback</p></td>
 614 <td class="parameter_annotations"> </td>
 615 </tr>
 616 <tr>
 617 <td class="parameter_name"><p>user_data</p></td>
 618 <td class="parameter_description"><p>user_data.</p></td>
 619 <td class="parameter_annotations"> </td>
 620 </tr>
 621 </tbody>
 622 </table></div>
 623 </div>
 624 </div>
 625 <hr>
 626 <div class="refsect2">
 627 <a name="signon-identity-create-session"></a><h3>signon_identity_create_session ()</h3>
 628 <pre class="programlisting"><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="returnvalue">SignonAuthSession</span></a> *
 629 signon_identity_create_session (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
 630                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
 631                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 632 <p>Creates an authentication session for this identity. If the identity has been
 633 retrieved from the database, the authentication method must be one of those
 634 listed in <a class="link" href="SignonIdentityInfo.html#signon-identity-info-get-methods" title="signon_identity_info_get_methods ()"><code class="function">signon_identity_info_get_methods()</code></a>, otherwise it can be any method
 635 supported by gSSO.</p>
 636 <div class="refsect3">
 637 <a name="id-1.3.3.3.9.8.5"></a><h4>Parameters</h4>
 638 <div class="informaltable"><table width="100%" border="0">
 639 <colgroup>
 640 <col width="150px" class="parameters_name">
 641 <col class="parameters_description">
 642 <col width="200px" class="parameters_annotations">
 643 </colgroup>
 644 <tbody>
 645 <tr>
 646 <td class="parameter_name"><p>self</p></td>
 647 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
 648 <td class="parameter_annotations"> </td>
 649 </tr>
 650 <tr>
 651 <td class="parameter_name"><p>method</p></td>
 652 <td class="parameter_description"><p>authentication method.</p></td>
 653 <td class="parameter_annotations"> </td>
 654 </tr>
 655 <tr>
 656 <td class="parameter_name"><p>error</p></td>
 657 <td class="parameter_description"><p>pointer to a location which will receive the error, if any.</p></td>
 658 <td class="parameter_annotations"> </td>
 659 </tr>
 660 </tbody>
 661 </table></div>
 662 </div>
 663 <div class="refsect3">
 664 <a name="id-1.3.3.3.9.8.6"></a><h4>Returns</h4>
 665 <p> a new <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a>. </p>
 666 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 667 </div>
 668 </div>
 669 <hr>
 670 <div class="refsect2">
 671 <a name="signon-identity-get-auth-session"></a><h3>signon_identity_get_auth_session ()</h3>
 672 <pre class="programlisting"><span class="returnvalue">void</span>
 673 signon_identity_get_auth_session (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
 674                                   <em class="parameter"><code><a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> *session</code></em>,
 675                                   <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>,
 676                                   <em class="parameter"><code><a class="link" href="SignonIdentity.html#SignonIdentitySessionReadyCb" title="SignonIdentitySessionReadyCb ()"><span class="type">SignonIdentitySessionReadyCb</span></a> cb</code></em>);</pre>
 677 <p>Obtain a remote object for a local session object. Should not be used by
 678 applications.</p>
 679 <div class="refsect3">
 680 <a name="id-1.3.3.3.9.9.5"></a><h4>Parameters</h4>
 681 <div class="informaltable"><table width="100%" border="0">
 682 <colgroup>
 683 <col width="150px" class="parameters_name">
 684 <col class="parameters_description">
 685 <col width="200px" class="parameters_annotations">
 686 </colgroup>
 687 <tbody>
 688 <tr>
 689 <td class="parameter_name"><p>self</p></td>
 690 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
 691 <td class="parameter_annotations"> </td>
 692 </tr>
 693 <tr>
 694 <td class="parameter_name"><p>session</p></td>
 695 <td class="parameter_description"><p>the <a class="link" href="SignonAuthSession.html" title="SignonAuthSession"><span class="type">SignonAuthSession</span></a> object to get the remote object for.</p></td>
 696 <td class="parameter_annotations"> </td>
 697 </tr>
 698 <tr>
 699 <td class="parameter_name"><p>method</p></td>
 700 <td class="parameter_description"><p>method name for the session.</p></td>
 701 <td class="parameter_annotations"> </td>
 702 </tr>
 703 <tr>
 704 <td class="parameter_name"><p>cb</p></td>
 705 <td class="parameter_description"><p> completion callback. </p></td>
 706 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
 707 </tr>
 708 </tbody>
 709 </table></div>
 710 </div>
 711 </div>
 712 <hr>
 713 <div class="refsect2">
 714 <a name="signon-identity-get-last-error"></a><h3>signon_identity_get_last_error ()</h3>
 715 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *
 716 signon_identity_get_last_error (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *identity</code></em>);</pre>
 717 <p>Get the most recent error that occurred on <em class="parameter"><code>identity</code></em>
 718 .</p>
 719 <div class="refsect3">
 720 <a name="id-1.3.3.3.9.10.5"></a><h4>Parameters</h4>
 721 <div class="informaltable"><table width="100%" border="0">
 722 <colgroup>
 723 <col width="150px" class="parameters_name">
 724 <col class="parameters_description">
 725 <col width="200px" class="parameters_annotations">
 726 </colgroup>
 727 <tbody><tr>
 728 <td class="parameter_name"><p>identity</p></td>
 729 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
 730 <td class="parameter_annotations"> </td>
 731 </tr></tbody>
 732 </table></div>
 733 </div>
 734 <div class="refsect3">
 735 <a name="id-1.3.3.3.9.10.6"></a><h4>Returns</h4>
 736 <p> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> containing the most recent error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure.</p>
 737 <p></p>
 738 </div>
 739 </div>
 740 <hr>
 741 <div class="refsect2">
 742 <a name="signon-identity-new"></a><h3>signon_identity_new ()</h3>
 743 <pre class="programlisting"><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="returnvalue">SignonIdentity</span></a> *
 744 signon_identity_new ();</pre>
 745 <p>Construct a new, empty, identity object.
 746 This is essentially equivalent to calling <a class="link" href="SignonIdentity.html#signon-identity-new-with-context" title="signon_identity_new_with_context ()"><code class="function">signon_identity_new_with_context()</code></a>
 747 and passing <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> as the application context.</p>
 748 <div class="refsect3">
 749 <a name="id-1.3.3.3.9.11.5"></a><h4>Returns</h4>
 750 <p> an instance of an <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p>
 751 <p></p>
 752 </div>
 753 </div>
 754 <hr>
 755 <div class="refsect2">
 756 <a name="signon-identity-new-from-db"></a><h3>signon_identity_new_from_db ()</h3>
 757 <pre class="programlisting"><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="returnvalue">SignonIdentity</span></a> *
 758 signon_identity_new_from_db (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> id</code></em>);</pre>
 759 <p>Construct an identity object associated with an existing identity
 760 record.
 761 This is essentially equivalent to calling
 762 <a class="link" href="SignonIdentity.html#signon-identity-new-with-context-from-db" title="signon_identity_new_with_context_from_db ()"><code class="function">signon_identity_new_with_context_from_db()</code></a> and passing <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> as the
 763 application context.</p>
 764 <p>Applications can determine the <em class="parameter"><code>id</code></em>
 765  either by enumerating the identities with
 766 <a class="link" href="SignonAuthService.html#signon-auth-service-query-identities" title="signon_auth_service_query_identities ()"><code class="function">signon_auth_service_query_identities()</code></a> (if they're the owner of the identity)
 767 or via other means (such as the system's accounts service, or an application
 768 configuration).</p>
 769 <div class="refsect3">
 770 <a name="id-1.3.3.3.9.12.6"></a><h4>Parameters</h4>
 771 <div class="informaltable"><table width="100%" border="0">
 772 <colgroup>
 773 <col width="150px" class="parameters_name">
 774 <col class="parameters_description">
 775 <col width="200px" class="parameters_annotations">
 776 </colgroup>
 777 <tbody><tr>
 778 <td class="parameter_name"><p>id</p></td>
 779 <td class="parameter_description"><p>identity ID.</p></td>
 780 <td class="parameter_annotations"> </td>
 781 </tr></tbody>
 782 </table></div>
 783 </div>
 784 <div class="refsect3">
 785 <a name="id-1.3.3.3.9.12.7"></a><h4>Returns</h4>
 786 <p> an instance of a <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p>
 787 <p></p>
 788 </div>
 789 </div>
 790 <hr>
 791 <div class="refsect2">
 792 <a name="signon-identity-new-with-context"></a><h3>signon_identity_new_with_context ()</h3>
 793 <pre class="programlisting"><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="returnvalue">SignonIdentity</span></a> *
 794 signon_identity_new_with_context (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *application_context</code></em>);</pre>
 795 <p>Construct a new, empty, identity object. See <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> for a
 796 discussion of <em class="parameter"><code>application_context</code></em>
 797  contents. <em class="parameter"><code>application_context</code></em>
 798  is used to set the identity's owner
 799 if the identity is stored to the database with <a class="link" href="SignonIdentity.html#signon-identity-store-credentials-with-args" title="signon_identity_store_credentials_with_args ()"><code class="function">signon_identity_store_credentials_with_args()</code></a>
 800 or <a class="link" href="SignonIdentity.html#signon-identity-store-credentials-with-info" title="signon_identity_store_credentials_with_info ()"><code class="function">signon_identity_store_credentials_with_info()</code></a>.</p>
 801 <div class="refsect3">
 802 <a name="id-1.3.3.3.9.13.5"></a><h4>Parameters</h4>
 803 <div class="informaltable"><table width="100%" border="0">
 804 <colgroup>
 805 <col width="150px" class="parameters_name">
 806 <col class="parameters_description">
 807 <col width="200px" class="parameters_annotations">
 808 </colgroup>
 809 <tbody><tr>
 810 <td class="parameter_name"><p>application_context</p></td>
 811 <td class="parameter_description"><p>application security context, can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
 812 <td class="parameter_annotations"> </td>
 813 </tr></tbody>
 814 </table></div>
 815 </div>
 816 <div class="refsect3">
 817 <a name="id-1.3.3.3.9.13.6"></a><h4>Returns</h4>
 818 <p> an instance of an <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p>
 819 <p></p>
 820 </div>
 821 </div>
 822 <hr>
 823 <div class="refsect2">
 824 <a name="signon-identity-new-with-context-from-db"></a><h3>signon_identity_new_with_context_from_db ()</h3>
 825 <pre class="programlisting"><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="returnvalue">SignonIdentity</span></a> *
 826 signon_identity_new_with_context_from_db
 827                                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> id</code></em>,
 828                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *application_context</code></em>);</pre>
 829 <p>Construct an identity object associated with an existing identity
 830 record. See <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> for a discussion of <em class="parameter"><code>application_context</code></em>
 831  contents.
 832 Together with the system context it is used to determine by the gSSO daemon
 833 if the application can access the identity (the application needs to be either the
 834 identity's owner or to be present on the ACL).</p>
 835 <p>Applications can determine the <em class="parameter"><code>id</code></em>
 836  either by enumerating the identities with
 837 <a class="link" href="SignonAuthService.html#signon-auth-service-query-identities" title="signon_auth_service_query_identities ()"><code class="function">signon_auth_service_query_identities()</code></a> (if they're the owner of the identity)
 838 or via other means (such as the system's accounts service, or an application
 839 configuration).</p>
 840 <div class="refsect3">
 841 <a name="id-1.3.3.3.9.14.6"></a><h4>Parameters</h4>
 842 <div class="informaltable"><table width="100%" border="0">
 843 <colgroup>
 844 <col width="150px" class="parameters_name">
 845 <col class="parameters_description">
 846 <col width="200px" class="parameters_annotations">
 847 </colgroup>
 848 <tbody>
 849 <tr>
 850 <td class="parameter_name"><p>id</p></td>
 851 <td class="parameter_description"><p>identity ID.</p></td>
 852 <td class="parameter_annotations"> </td>
 853 </tr>
 854 <tr>
 855 <td class="parameter_name"><p>application_context</p></td>
 856 <td class="parameter_description"><p>application security context, can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
 857 <td class="parameter_annotations"> </td>
 858 </tr>
 859 </tbody>
 860 </table></div>
 861 </div>
 862 <div class="refsect3">
 863 <a name="id-1.3.3.3.9.14.7"></a><h4>Returns</h4>
 864 <p> an instance of a <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p>
 865 <p></p>
 866 </div>
 867 </div>
 868 <hr>
 869 <div class="refsect2">
 870 <a name="signon-identity-query-info"></a><h3>signon_identity_query_info ()</h3>
 871 <pre class="programlisting"><span class="returnvalue">void</span>
 872 signon_identity_query_info (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
 873                             <em class="parameter"><code><a class="link" href="SignonIdentity.html#SignonIdentityInfoCb" title="SignonIdentityInfoCb ()"><span class="type">SignonIdentityInfoCb</span></a> cb</code></em>,
 874                             <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 875 <p>Fetches the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> data associated with this
 876 identity.</p>
 877 <div class="refsect3">
 878 <a name="id-1.3.3.3.9.15.5"></a><h4>Parameters</h4>
 879 <div class="informaltable"><table width="100%" border="0">
 880 <colgroup>
 881 <col width="150px" class="parameters_name">
 882 <col class="parameters_description">
 883 <col width="200px" class="parameters_annotations">
 884 </colgroup>
 885 <tbody>
 886 <tr>
 887 <td class="parameter_name"><p>self</p></td>
 888 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
 889 <td class="parameter_annotations"> </td>
 890 </tr>
 891 <tr>
 892 <td class="parameter_name"><p>cb</p></td>
 893 <td class="parameter_description"><p> callback. </p></td>
 894 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
 895 </tr>
 896 <tr>
 897 <td class="parameter_name"><p>user_data</p></td>
 898 <td class="parameter_description"><p>user_data.</p></td>
 899 <td class="parameter_annotations"> </td>
 900 </tr>
 901 </tbody>
 902 </table></div>
 903 </div>
 904 </div>
 905 <hr>
 906 <div class="refsect2">
 907 <a name="signon-identity-remove"></a><h3>signon_identity_remove ()</h3>
 908 <pre class="programlisting"><span class="returnvalue">void</span>
 909 signon_identity_remove (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
 910                         <em class="parameter"><code><a class="link" href="SignonIdentity.html#SignonIdentityRemovedCb" title="SignonIdentityRemovedCb"><span class="type">SignonIdentityRemovedCb</span></a> cb</code></em>,
 911                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 912 <p>Removes the corresponding credentials record from the database.</p>
 913 <div class="refsect3">
 914 <a name="id-1.3.3.3.9.16.5"></a><h4>Parameters</h4>
 915 <div class="informaltable"><table width="100%" border="0">
 916 <colgroup>
 917 <col width="150px" class="parameters_name">
 918 <col class="parameters_description">
 919 <col width="200px" class="parameters_annotations">
 920 </colgroup>
 921 <tbody>
 922 <tr>
 923 <td class="parameter_name"><p>self</p></td>
 924 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
 925 <td class="parameter_annotations"> </td>
 926 </tr>
 927 <tr>
 928 <td class="parameter_name"><p>cb</p></td>
 929 <td class="parameter_description"><p> callback to be called when the operation has completed. </p></td>
 930 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
 931 </tr>
 932 <tr>
 933 <td class="parameter_name"><p>user_data</p></td>
 934 <td class="parameter_description"><p>user_data to pass to the callback.</p></td>
 935 <td class="parameter_annotations"> </td>
 936 </tr>
 937 </tbody>
 938 </table></div>
 939 </div>
 940 </div>
 941 <hr>
 942 <div class="refsect2">
 943 <a name="signon-identity-remove-reference"></a><h3>signon_identity_remove_reference ()</h3>
 944 <pre class="programlisting"><span class="returnvalue">void</span>
 945 signon_identity_remove_reference (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
 946                                   <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *reference</code></em>,
 947                                   <em class="parameter"><code><a class="link" href="SignonIdentity.html#SignonIdentityReferenceRemovedCb" title="SignonIdentityReferenceRemovedCb"><span class="type">SignonIdentityReferenceRemovedCb</span></a> cb</code></em>,
 948                                   <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 949 <p>Removes named reference from identity. Not currently supported by gSSO.</p>
 950 <div class="refsect3">
 951 <a name="id-1.3.3.3.9.17.5"></a><h4>Parameters</h4>
 952 <div class="informaltable"><table width="100%" border="0">
 953 <colgroup>
 954 <col width="150px" class="parameters_name">
 955 <col class="parameters_description">
 956 <col width="200px" class="parameters_annotations">
 957 </colgroup>
 958 <tbody>
 959 <tr>
 960 <td class="parameter_name"><p>self</p></td>
 961 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
 962 <td class="parameter_annotations"> </td>
 963 </tr>
 964 <tr>
 965 <td class="parameter_name"><p>reference</p></td>
 966 <td class="parameter_description"><p>reference to be removed</p></td>
 967 <td class="parameter_annotations"> </td>
 968 </tr>
 969 <tr>
 970 <td class="parameter_name"><p>cb</p></td>
 971 <td class="parameter_description"><p>callback</p></td>
 972 <td class="parameter_annotations"> </td>
 973 </tr>
 974 <tr>
 975 <td class="parameter_name"><p>user_data</p></td>
 976 <td class="parameter_description"><p>user_data.</p></td>
 977 <td class="parameter_annotations"> </td>
 978 </tr>
 979 </tbody>
 980 </table></div>
 981 </div>
 982 </div>
 983 <hr>
 984 <div class="refsect2">
 985 <a name="signon-identity-signout"></a><h3>signon_identity_signout ()</h3>
 986 <pre class="programlisting"><span class="returnvalue">void</span>
 987 signon_identity_signout (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
 988                          <em class="parameter"><code><a class="link" href="SignonIdentity.html#SignonIdentitySignedOutCb" title="SignonIdentitySignedOutCb"><span class="type">SignonIdentitySignedOutCb</span></a> cb</code></em>,
 989                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 990 <p>Asks signond to close all authentication sessions for this
 991 identity, and to remove any stored secrets associated with it (password and
 992 authentication tokens).</p>
 993 <div class="refsect3">
 994 <a name="id-1.3.3.3.9.18.5"></a><h4>Parameters</h4>
 995 <div class="informaltable"><table width="100%" border="0">
 996 <colgroup>
 997 <col width="150px" class="parameters_name">
 998 <col class="parameters_description">
 999 <col width="200px" class="parameters_annotations">
1000 </colgroup>
1001 <tbody>
1002 <tr>
1003 <td class="parameter_name"><p>self</p></td>
1004 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
1005 <td class="parameter_annotations"> </td>
1006 </tr>
1007 <tr>
1008 <td class="parameter_name"><p>cb</p></td>
1009 <td class="parameter_description"><p> callback. </p></td>
1010 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
1011 </tr>
1012 <tr>
1013 <td class="parameter_name"><p>user_data</p></td>
1014 <td class="parameter_description"><p>user_data.</p></td>
1015 <td class="parameter_annotations"> </td>
1016 </tr>
1017 </tbody>
1018 </table></div>
1019 </div>
1020 </div>
1021 <hr>
1022 <div class="refsect2">
1023 <a name="signon-identity-store-credentials-with-args"></a><h3>signon_identity_store_credentials_with_args ()</h3>
1024 <pre class="programlisting"><span class="returnvalue">void</span>
1025 signon_identity_store_credentials_with_args
1026                                (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
1027                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *username</code></em>,
1028                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *secret</code></em>,
1029                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> store_secret</code></em>,
1030                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *methods</code></em>,
1031                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *caption</code></em>,
1032                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *realms</code></em>,
1033                                 <em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *owner</code></em>,
1034                                 <em class="parameter"><code><a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> *access_control_list</code></em>,
1035                                 <em class="parameter"><code><a class="link" href="SignonIdentityInfo.html#SignonIdentityType" title="enum SignonIdentityType"><span class="type">SignonIdentityType</span></a> type</code></em>,
1036                                 <em class="parameter"><code><a class="link" href="SignonIdentity.html#SignonIdentityStoreCredentialsCb" title="SignonIdentityStoreCredentialsCb ()"><span class="type">SignonIdentityStoreCredentialsCb</span></a> cb</code></em>,
1037                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1038 <p>Stores the given data into the identity. See above for the meaning
1039 of the specific fields.</p>
1040 <div class="refsect3">
1041 <a name="id-1.3.3.3.9.19.5"></a><h4>Parameters</h4>
1042 <div class="informaltable"><table width="100%" border="0">
1043 <colgroup>
1044 <col width="150px" class="parameters_name">
1045 <col class="parameters_description">
1046 <col width="200px" class="parameters_annotations">
1047 </colgroup>
1048 <tbody>
1049 <tr>
1050 <td class="parameter_name"><p>self</p></td>
1051 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
1052 <td class="parameter_annotations"> </td>
1053 </tr>
1054 <tr>
1055 <td class="parameter_name"><p>username</p></td>
1056 <td class="parameter_description"><p> username. </p></td>
1057 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1058 </tr>
1059 <tr>
1060 <td class="parameter_name"><p>secret</p></td>
1061 <td class="parameter_description"><p> secret. </p></td>
1062 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1063 </tr>
1064 <tr>
1065 <td class="parameter_name"><p>store_secret</p></td>
1066 <td class="parameter_description"><p>whether gSSO should save the password in secret storage.</p></td>
1067 <td class="parameter_annotations"> </td>
1068 </tr>
1069 <tr>
1070 <td class="parameter_name"><p>methods</p></td>
1071 <td class="parameter_description"><p> allowed methods. </p></td>
1072 <td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GStrv]</span></td>
1073 </tr>
1074 <tr>
1075 <td class="parameter_name"><p>caption</p></td>
1076 <td class="parameter_description"><p> caption. </p></td>
1077 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1078 </tr>
1079 <tr>
1080 <td class="parameter_name"><p>realms</p></td>
1081 <td class="parameter_description"><p> allowed realms. </p></td>
1082 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1083 </tr>
1084 <tr>
1085 <td class="parameter_name"><p>owner</p></td>
1086 <td class="parameter_description"><p> owner. </p></td>
1087 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1088 </tr>
1089 <tr>
1090 <td class="parameter_name"><p>access_control_list</p></td>
1091 <td class="parameter_description"><p> access control list. </p></td>
1092 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1093 </tr>
1094 <tr>
1095 <td class="parameter_name"><p>type</p></td>
1096 <td class="parameter_description"><p>the type of the identity.</p></td>
1097 <td class="parameter_annotations"> </td>
1098 </tr>
1099 <tr>
1100 <td class="parameter_name"><p>cb</p></td>
1101 <td class="parameter_description"><p> callback. </p></td>
1102 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
1103 </tr>
1104 <tr>
1105 <td class="parameter_name"><p>user_data</p></td>
1106 <td class="parameter_description"><p>user_data.</p></td>
1107 <td class="parameter_annotations"> </td>
1108 </tr>
1109 </tbody>
1110 </table></div>
1111 </div>
1112 </div>
1113 <hr>
1114 <div class="refsect2">
1115 <a name="signon-identity-store-credentials-with-info"></a><h3>signon_identity_store_credentials_with_info ()</h3>
1116 <pre class="programlisting"><span class="returnvalue">void</span>
1117 signon_identity_store_credentials_with_info
1118                                (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
1119                                 <em class="parameter"><code>const <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> *info</code></em>,
1120                                 <em class="parameter"><code><a class="link" href="SignonIdentity.html#SignonIdentityStoreCredentialsCb" title="SignonIdentityStoreCredentialsCb ()"><span class="type">SignonIdentityStoreCredentialsCb</span></a> cb</code></em>,
1121                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1122 <p>Stores the data contained in <em class="parameter"><code>info</code></em>
1123  into the identity record in the database.
1124 See above for the detailed discussion of the meaning of various fields and
1125 their defaults.</p>
1126 <div class="refsect3">
1127 <a name="id-1.3.3.3.9.20.5"></a><h4>Parameters</h4>
1128 <div class="informaltable"><table width="100%" border="0">
1129 <colgroup>
1130 <col width="150px" class="parameters_name">
1131 <col class="parameters_description">
1132 <col width="200px" class="parameters_annotations">
1133 </colgroup>
1134 <tbody>
1135 <tr>
1136 <td class="parameter_name"><p>self</p></td>
1137 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
1138 <td class="parameter_annotations"> </td>
1139 </tr>
1140 <tr>
1141 <td class="parameter_name"><p>info</p></td>
1142 <td class="parameter_description"><p>the <a class="link" href="SignonIdentityInfo.html" title="SignonIdentityInfo"><span class="type">SignonIdentityInfo</span></a> data to store.</p></td>
1143 <td class="parameter_annotations"> </td>
1144 </tr>
1145 <tr>
1146 <td class="parameter_name"><p>cb</p></td>
1147 <td class="parameter_description"><p> callback. </p></td>
1148 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
1149 </tr>
1150 <tr>
1151 <td class="parameter_name"><p>user_data</p></td>
1152 <td class="parameter_description"><p>user_data.</p></td>
1153 <td class="parameter_annotations"> </td>
1154 </tr>
1155 </tbody>
1156 </table></div>
1157 </div>
1158 </div>
1159 <hr>
1160 <div class="refsect2">
1161 <a name="signon-identity-verify-secret"></a><h3>signon_identity_verify_secret ()</h3>
1162 <pre class="programlisting"><span class="returnvalue">void</span>
1163 signon_identity_verify_secret (<em class="parameter"><code><a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *self</code></em>,
1164                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *secret</code></em>,
1165                                <em class="parameter"><code><a class="link" href="SignonIdentity.html#SignonIdentityVerifyCb" title="SignonIdentityVerifyCb ()"><span class="type">SignonIdentityVerifyCb</span></a> cb</code></em>,
1166                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1167 <p>Verifies the given secret. Not currently supported by gSSO.</p>
1168 <div class="refsect3">
1169 <a name="id-1.3.3.3.9.21.5"></a><h4>Parameters</h4>
1170 <div class="informaltable"><table width="100%" border="0">
1171 <colgroup>
1172 <col width="150px" class="parameters_name">
1173 <col class="parameters_description">
1174 <col width="200px" class="parameters_annotations">
1175 </colgroup>
1176 <tbody>
1177 <tr>
1178 <td class="parameter_name"><p>self</p></td>
1179 <td class="parameter_description"><p>the <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></td>
1180 <td class="parameter_annotations"> </td>
1181 </tr>
1182 <tr>
1183 <td class="parameter_name"><p>secret</p></td>
1184 <td class="parameter_description"><p>the secret (password) to be verified.</p></td>
1185 <td class="parameter_annotations"> </td>
1186 </tr>
1187 <tr>
1188 <td class="parameter_name"><p>cb</p></td>
1189 <td class="parameter_description"><p> callback. </p></td>
1190 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
1191 </tr>
1192 <tr>
1193 <td class="parameter_name"><p>user_data</p></td>
1194 <td class="parameter_description"><p>user_data.</p></td>
1195 <td class="parameter_annotations"> </td>
1196 </tr>
1197 </tbody>
1198 </table></div>
1199 </div>
1200 </div>
1201 </div>
1202 <div class="refsect1">
1203 <a name="SignonIdentity.other_details"></a><h2>Types and Values</h2>
1204 <div class="refsect2">
1205 <a name="SignonIdentity-struct"></a><h3>struct SignonIdentity</h3>
1206 <pre class="programlisting">struct SignonIdentity;</pre>
1207 <p>Opaque struct. Use the accessor functions below.</p>
1208 </div>
1209 <hr>
1210 <div class="refsect2">
1211 <a name="SignonIdentityClass"></a><h3>struct SignonIdentityClass</h3>
1212 <pre class="programlisting">struct SignonIdentityClass {
1213     GObjectClass parent_class;
1214 };
1215 </pre>
1216 <p>Opaque struct. Use the accessor functions below.</p>
1217 <div class="refsect3">
1218 <a name="id-1.3.3.3.10.3.5"></a><h4>Members</h4>
1219 <div class="informaltable"><table width="100%" border="0">
1220 <colgroup>
1221 <col width="300px" class="struct_members_name">
1222 <col class="struct_members_description">
1223 <col width="200px" class="struct_members_annotations">
1224 </colgroup>
1225 <tbody><tr>
1226 <td class="struct_member_name"><p><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> <em class="structfield"><code><a name="SignonIdentityClass.parent-class"></a>parent_class</code></em>;</p></td>
1227 <td class="struct_member_description"><p>reference to a parent class</p></td>
1228 <td class="struct_member_annotations"> </td>
1229 </tr></tbody>
1230 </table></div>
1231 </div>
1232 </div>
1233 <hr>
1234 <div class="refsect2">
1235 <a name="SignonIdentityReferenceAddedCb"></a><h3>SignonIdentityReferenceAddedCb</h3>
1236 <pre class="programlisting">typedef SignonIdentityVoidCb SignonIdentityReferenceAddedCb;
1237 </pre>
1238 <p>Callback to be passed to <a class="link" href="SignonIdentity.html#signon-identity-add-reference" title="signon_identity_add_reference ()"><code class="function">signon_identity_add_reference()</code></a>.</p>
1239 </div>
1240 <hr>
1241 <div class="refsect2">
1242 <a name="SignonIdentityReferenceRemovedCb"></a><h3>SignonIdentityReferenceRemovedCb</h3>
1243 <pre class="programlisting">typedef SignonIdentityVoidCb SignonIdentityReferenceRemovedCb;
1244 </pre>
1245 <p>Callback to be passed to <a class="link" href="SignonIdentity.html#signon-identity-remove-reference" title="signon_identity_remove_reference ()"><code class="function">signon_identity_remove_reference()</code></a>.</p>
1246 </div>
1247 <hr>
1248 <div class="refsect2">
1249 <a name="SignonIdentityRemovedCb"></a><h3>SignonIdentityRemovedCb</h3>
1250 <pre class="programlisting">typedef SignonIdentityVoidCb SignonIdentityRemovedCb;
1251 </pre>
1252 <p>Callback to be passed to <a class="link" href="SignonIdentity.html#signon-identity-remove" title="signon_identity_remove ()"><code class="function">signon_identity_remove()</code></a>.</p>
1253 </div>
1254 <hr>
1255 <div class="refsect2">
1256 <a name="SignonIdentitySignedOutCb"></a><h3>SignonIdentitySignedOutCb</h3>
1257 <pre class="programlisting">typedef SignonIdentityVoidCb SignonIdentitySignedOutCb;
1258 </pre>
1259 <p>Callback to be passed to <a class="link" href="SignonIdentity.html#signon-identity-signout" title="signon_identity_signout ()"><code class="function">signon_identity_signout()</code></a>.</p>
1260 </div>
1261 </div>
1262 <div class="refsect1">
1263 <a name="SignonIdentity.property-details"></a><h2>Property Details</h2>
1264 <div class="refsect2">
1265 <a name="SignonIdentity--app-ctx"></a><h3>The <code class="literal">“app-ctx”</code> property</h3>
1266 <pre class="programlisting">  “app-ctx”                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
1267 <p>Set/Get Application Security Context.</p>
1268 <p>Flags: Read / Write</p>
1269 <p>Default value: ""</p>
1270 </div>
1271 <hr>
1272 <div class="refsect2">
1273 <a name="SignonIdentity--id"></a><h3>The <code class="literal">“id”</code> property</h3>
1274 <pre class="programlisting">  “id”                       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
1275 <p>Set/Get Identity ID.</p>
1276 <p>Flags: Read / Write</p>
1277 <p>Default value: 0</p>
1278 </div>
1279 </div>
1280 <div class="refsect1">
1281 <a name="SignonIdentity.signal-details"></a><h2>Signal Details</h2>
1282 <div class="refsect2">
1283 <a name="SignonIdentity-signout"></a><h3>The <code class="literal">“signout”</code> signal</h3>
1284 <pre class="programlisting"><span class="returnvalue">void</span>
1285 user_function (<a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a> *arg0,
1286                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>        user_data)</pre>
1287 <p>Emitted when the identity was signed out.</p>
1288 <div class="refsect3">
1289 <a name="id-1.3.3.3.12.2.5"></a><h4>Parameters</h4>
1290 <div class="informaltable"><table width="100%" border="0">
1291 <colgroup>
1292 <col width="150px" class="parameters_name">
1293 <col class="parameters_description">
1294 <col width="200px" class="parameters_annotations">
1295 </colgroup>
1296 <tbody><tr>
1297 <td class="parameter_name"><p>user_data</p></td>
1298 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
1299 <td class="parameter_annotations"> </td>
1300 </tr></tbody>
1301 </table></div>
1302 </div>
1303 <p>Flags: <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-NO-HOOKS:CAPS">No Hooks</a></p>
1304 </div>
1305 </div>
1306 </div>
1307 <div class="footer">
1308 <hr>
1309           Generated by GTK-Doc V1.20</div>
1310 </body>
1311 </html>