← Back to branch summary

~ubuntu-branches/ubuntu/dapper/lasso/dapper

« back to all changes in this revision

Viewing changes to docs/reference/html/LassoLogin.html

  • Committer: Bazaar Package Importer
  • Author(s): Loic Pefferkorn
  • Date: 2005-11-25 19:20:59 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20051125192059-m4894lhpynmkrmwr
Tags: 0.6.3-4ubuntu1
Resynchronise with Debian.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/html/LassoLogin.html
1
 
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>LassoLogin</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Lasso Reference Manual"><link rel="up" href="idff.html" title="Identity Federation Framework"><link rel="prev" href="LassoProfile.html" title="LassoProfile"><link rel="next" href="LassoLecp.html" title="LassoLecp"><meta name="generator" content="GTK-Doc V1.3 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="chapter" href="lasso.html" title="Lasso &amp; Liberty Alliance Overview"><link rel="chapter" href="architecture.html" title="Lasso Architecture"><link rel="chapter" href="idff.html" title="Identity Federation Framework"><link rel="chapter" href="idwsf.html" title="Identity Web Services Framework"><link rel="chapter" href="xml.html" title="Schemas"><link rel="chapter" href="misc.html" title="Misc"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="LassoProfile.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="idff.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Lasso Reference Manual</th><td><a accesskey="n" href="LassoLecp.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry" lang="en"><a name="LassoLogin"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><span class="refentrytitle">LassoLogin</span></h2><p>LassoLogin &#8212; Single Sign-On and Federation Profile</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
 
1
<html>
 
2
<head>
 
3
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 
4
<title>LassoLogin</title>
 
5
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
 
6
<link rel="start" href="index.html" title="Lasso Reference Manual">
 
7
<link rel="up" href="idff.html" title="Identity Federation Framework">
 
8
<link rel="prev" href="LassoProfile.html" title="LassoProfile">
 
9
<link rel="next" href="LassoLecp.html" title="LassoLecp">
 
10
<meta name="generator" content="GTK-Doc V1.4 (XML mode)">
 
11
<link rel="stylesheet" href="style.css" type="text/css">
 
12
<link rel="chapter" href="lasso.html" title="Lasso &amp; Liberty Alliance Overview">
 
13
<link rel="chapter" href="architecture.html" title="Lasso Architecture">
 
14
<link rel="chapter" href="idff.html" title="Identity Federation Framework">
 
15
<link rel="chapter" href="idwsf.html" title="Identity Web Services Framework">
 
16
<link rel="chapter" href="xml.html" title="Schemas">
 
17
<link rel="chapter" href="misc.html" title="Misc">
 
18
</head>
 
19
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 
20
<table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
 
21
<td><a accesskey="p" href="LassoProfile.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
22
<td><a accesskey="u" href="idff.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
23
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
24
<th width="100%" align="center">Lasso Reference Manual</th>
 
25
<td><a accesskey="n" href="LassoLecp.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
26
</tr></table>
 
27
<div class="refentry" lang="en">
 
28
<a name="LassoLogin"></a><div class="titlepage"></div>
 
29
<div class="refnamediv"><table width="100%"><tr>
 
30
<td valign="top">
 
31
<h2><span class="refentrytitle">LassoLogin</span></h2>
 
32
<p>LassoLogin &#8212; Single Sign-On and Federation Profile</p>
 
33
</td>
 
34
<td valign="top" align="right"></td>
 
35
</tr></table></div>
 
36
<div class="refsynopsisdiv">
 
37
<h2>Synopsis</h2>
 
38
<pre class="synopsis">
2
39
 
3
40
#include &lt;lasso/lasso.h&gt;
4
41
 
59
96
<GTKDOCLINK HREF="int">int</GTKDOCLINK>         <a href="LassoLogin.html#lasso-login-set-resourceId">lasso_login_set_resourceId</a>      (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
60
97
                                             const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *content);
61
98
 
62
 
</pre></div><div class="refsect1" lang="en"><a name="id2545376"></a><h2>Object Hierarchy</h2><pre class="synopsis">
 
99
</pre>
 
100
</div>
 
101
<div class="refsect1" lang="en">
 
102
<a name="id2530090"></a><h2>Object Hierarchy</h2>
 
103
<pre class="synopsis">
63
104
 
64
105
  <GTKDOCLINK HREF="GObject">GObject</GTKDOCLINK>
65
106
   +----<a href="LassoNode.html" title="LassoNode">LassoNode</a>
66
107
         +----<a href="LassoProfile.html" title="LassoProfile">LassoProfile</a>
67
108
               +----LassoLogin
68
109
                     +----<a href="LassoLecp.html" title="LassoLecp">LassoLecp</a>
69
 
</pre></div><div class="refsect1" lang="en"><a name="id2545418"></a><h2>Description</h2><p>
 
110
</pre>
 
111
</div>
 
112
<div class="refsect1" lang="en">
 
113
<a name="id2530131"></a><h2>Description</h2>
 
114
<p>
70
115
The Single Sign On process allows a user to log in once to an identity provider
71
116
(IdP), and to be then transparently loged in to the required service providers
72
117
(SP) belonging to the IP "circle of trust".  Subordinating different identities
75
120
federation, strong and unique authentication coupled with control by the user
76
121
of his personnal informations. The explicit user agreement is necessary before
77
122
proceeding to Identity Federation.
78
 
</p><p>
 
123
</p>
 
124
<p>
79
125
The service provider must implement the following process:
80
 
</p><div class="itemizedlist"><ul type="disc"><li><p>creating an authentication request (<a href="LassoLibAuthnRequest.html" title="LassoLibAuthnRequest"><span class="type">LassoLibAuthnRequest</span></a>) with
81
 
 <a href="LassoLogin.html#lasso-login-init-authn-request"><code class="function">lasso_login_init_authn_request()</code></a>;</p></li><li><p>sending it to the identity provider with
82
 
 <a href="LassoLogin.html#lasso-login-build-authn-request-msg"><code class="function">lasso_login_build_authn_request_msg()</code></a>;</p></li><li><p>receiving and processing the answer:
83
 
   </p><div class="itemizedlist"><ul type="circle"><li>either an authentication response with
84
 
     <a href="LassoLogin.html#lasso-login-process-authn-response-msg"><code class="function">lasso_login_process_authn_response_msg()</code></a></li><li>or an artifact with <a href="LassoLogin.html#lasso-login-init-request"><code class="function">lasso_login_init_request()</code></a> then sending the
 
126
</p>
 
127
<div class="itemizedlist"><ul type="disc">
 
128
<li><p>creating an authentication request (<a href="LassoLibAuthnRequest.html" title="LassoLibAuthnRequest"><span class="type">LassoLibAuthnRequest</span></a>) with
 
129
 <a href="LassoLogin.html#lasso-login-init-authn-request"><code class="function">lasso_login_init_authn_request()</code></a>;</p></li>
 
130
<li><p>sending it to the identity provider with
 
131
 <a href="LassoLogin.html#lasso-login-build-authn-request-msg"><code class="function">lasso_login_build_authn_request_msg()</code></a>;</p></li>
 
132
<li>
 
133
<p>receiving and processing the answer:
 
134
   </p>
 
135
<div class="itemizedlist"><ul type="circle">
 
136
<li>either an authentication response with
 
137
     <a href="LassoLogin.html#lasso-login-process-authn-response-msg"><code class="function">lasso_login_process_authn_response_msg()</code></a>
 
138
</li>
 
139
<li>or an artifact with <a href="LassoLogin.html#lasso-login-init-request"><code class="function">lasso_login_init_request()</code></a> then sending the
85
140
     request to the IdP with <a href="LassoLogin.html#lasso-login-build-request-msg"><code class="function">lasso_login_build_request_msg()</code></a> and processing the
86
 
     new answer with <a href="LassoLogin.html#lasso-login-process-response-msg"><code class="function">lasso_login_process_response_msg()</code></a>.</li></ul></div><p>
87
 
   </p></li></ul></div><p>
88
 
</p><div class="example"><a name="id2545551"></a><p class="title"><b>Example�1.�Service Provider Login URL</b></p><pre class="programlisting">
 
141
     new answer with <a href="LassoLogin.html#lasso-login-process-response-msg"><code class="function">lasso_login_process_response_msg()</code></a>.</li>
 
142
</ul></div>
 
143
<p>
 
144
   </p>
 
145
</li>
 
146
</ul></div>
 
147
<p>
 
148
</p>
 
149
<div class="example">
 
150
<a name="id2530264"></a><p class="title"><b>Example&#160;1.&#160;Service Provider Login URL</b></p>
 
151
<pre class="programlisting">
89
152
LassoLogin *login;
90
153
 
91
154
login = lasso_login_new(server);
103
166
 
104
167
/* redirect user to identity provider */
105
168
printf("Location: <code class="literal">s</code>\n\nRedirected to IdP\n", LASSO_PROFILE(login)-&gt;msg_url);
106
 
</pre></div><div class="example"><a name="id2545579"></a><p class="title"><b>Example�2.�Service Provider Assertion Consumer Service URL</b></p><pre class="programlisting">
 
169
</pre>
 
170
</div>
 
171
<div class="example">
 
172
<a name="id2530292"></a><p class="title"><b>Example&#160;2.&#160;Service Provider Assertion Consumer Service URL</b></p>
 
173
<pre class="programlisting">
107
174
LassoLogin *login;
108
175
char *request_method = getenv("REQUEST_METHOD");
109
176
char *artifact_msg = NULL, *lares = NULL, *lareq = NULL;
164
231
 
165
232
/* redirect user anywhere */
166
233
printf("Location: /\n\nRedirected to site root\n");
167
 
</pre></div></div><div class="refsect1" lang="en"><a name="id2545660"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2545665"></a><h3><a name="LassoLogin-struct"></a>LassoLogin</h3><a class="indexterm" name="id2545676"></a><pre class="programlisting">typedef struct {
 
234
</pre>
 
235
</div>
 
236
</div>
 
237
<div class="refsect1" lang="en">
 
238
<a name="id2530372"></a><h2>Details</h2>
 
239
<div class="refsect2" lang="en">
 
240
<a name="id2530378"></a><h3>
 
241
<a name="LassoLogin-struct"></a>LassoLogin</h3>
 
242
<a class="indexterm" name="id2530388"></a><pre class="programlisting">typedef struct {
168
243
        LassoLoginProtocolProfile protocolProfile;
169
244
        gchar *assertionArtifact;
170
245
        LassoSamlAssertion *assertion;
171
246
} LassoLogin;
172
 
</pre><p>
 
247
</pre>
 
248
<p>
173
249
Single sign-on profile for the current transaction; possibly an
174
250
assertionArtifact to be used by the service provider in its
175
251
"assertionConsumerServiceURL" and the assertion created or received for the
176
252
principal.
177
 
</p></div><hr><div class="refsect2" lang="en"><a name="id2545696"></a><h3><a name="LassoLoginProtocolProfile"></a>enum LassoLoginProtocolProfile</h3><a class="indexterm" name="id2545708"></a><pre class="programlisting">typedef enum {
 
253
</p>
 
254
</div>
 
255
<hr>
 
256
<div class="refsect2" lang="en">
 
257
<a name="id2530409"></a><h3>
 
258
<a name="LassoLoginProtocolProfile"></a>enum LassoLoginProtocolProfile</h3>
 
259
<a class="indexterm" name="id2530420"></a><pre class="programlisting">typedef enum {
178
260
        LASSO_LOGIN_PROTOCOL_PROFILE_BRWS_ART = 1,
179
261
        LASSO_LOGIN_PROTOCOL_PROFILE_BRWS_POST,
180
262
        LASSO_LOGIN_PROTOCOL_PROFILE_BRWS_LECP,
181
263
} LassoLoginProtocolProfile;
182
 
</pre><p>
 
264
</pre>
 
265
<p>
183
266
Identifies the two possible profiles for Single Sign-On and Federation.
184
 
</p></div><hr><div class="refsect2" lang="en"><a name="id2545727"></a><h3><a name="lasso-login-new"></a>lasso_login_new ()</h3><a class="indexterm" name="id2545737"></a><pre class="programlisting"><a href="LassoLogin.html" title="LassoLogin">LassoLogin</a>* lasso_login_new                 (<a href="LassoServer.html" title="LassoServer">LassoServer</a> *server);</pre><p>
185
 
Creates a new <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>.</p><p>
 
267
</p>
 
268
</div>
 
269
<hr>
 
270
<div class="refsect2" lang="en">
 
271
<a name="id2530438"></a><h3>
 
272
<a name="lasso-login-new"></a>lasso_login_new ()</h3>
 
273
<a class="indexterm" name="id2530448"></a><pre class="programlisting"><a href="LassoLogin.html" title="LassoLogin">LassoLogin</a>* lasso_login_new                 (<a href="LassoServer.html" title="LassoServer">LassoServer</a> *server);</pre>
 
274
<p>
 
275
Creates a new <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>.</p>
 
276
<p>
186
277
 
187
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>server</code></em>�:</span></td><td> the <a href="LassoServer.html" title="LassoServer"><span class="type">LassoServer</span></a>
188
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> a newly created <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a> object; or NULL if an error
 
278
</p>
 
279
<div class="variablelist"><table border="0">
 
280
<col align="left" valign="top">
 
281
<tbody>
 
282
<tr>
 
283
<td>
 
284
<span class="term"><em class="parameter"><code>server</code></em>&#160;:</span></td>
 
285
<td> the <a href="LassoServer.html" title="LassoServer"><span class="type">LassoServer</span></a>
 
286
</td>
 
287
</tr>
 
288
<tr>
 
289
<td>
 
290
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
291
<td> a newly created <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a> object; or NULL if an error
189
292
    occured
190
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2545821"></a><h3><a name="lasso-login-destroy"></a>lasso_login_destroy ()</h3><a class="indexterm" name="id2545832"></a><pre class="programlisting"><GTKDOCLINK HREF="void">void</GTKDOCLINK>        lasso_login_destroy             (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre><p>
191
 
Destroys a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a> object.</p><p>
192
 
 
193
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
194
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2545897"></a><h3><a name="lasso-login-dump"></a>lasso_login_dump ()</h3><a class="indexterm" name="id2545908"></a><pre class="programlisting"><GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK>*      lasso_login_dump                (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre><p>
195
 
Dumps <em class="parameter"><code>login</code></em> content to an XML string.</p><p>
196
 
 
197
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
198
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> the dump string.  It must be freed by the caller.
199
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2545982"></a><h3><a name="lasso-login-new-from-dump"></a>lasso_login_new_from_dump ()</h3><a class="indexterm" name="id2545994"></a><pre class="programlisting"><a href="LassoLogin.html" title="LassoLogin">LassoLogin</a>* lasso_login_new_from_dump       (<a href="LassoServer.html" title="LassoServer">LassoServer</a> *server,
200
 
                                             const <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *dump);</pre><p>
201
 
Restores the <em class="parameter"><code>dump</code></em> to a new <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>.</p><p>
202
 
 
203
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>server</code></em>�:</span></td><td> the <a href="LassoServer.html" title="LassoServer"><span class="type">LassoServer</span></a>
204
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>dump</code></em>�:</span></td><td> XML login dump
205
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> a newly created <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>; or NULL if an error occured.
206
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2546105"></a><h3><a name="lasso-login-accept-sso"></a>lasso_login_accept_sso ()</h3><a class="indexterm" name="id2546116"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_accept_sso          (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre><p>
 
293
</td>
 
294
</tr>
 
295
</tbody>
 
296
</table></div>
 
297
</div>
 
298
<hr>
 
299
<div class="refsect2" lang="en">
 
300
<a name="id2530533"></a><h3>
 
301
<a name="lasso-login-destroy"></a>lasso_login_destroy ()</h3>
 
302
<a class="indexterm" name="id2530543"></a><pre class="programlisting"><GTKDOCLINK HREF="void">void</GTKDOCLINK>        lasso_login_destroy             (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre>
 
303
<p>
 
304
Destroys a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a> object.</p>
 
305
<p>
 
306
 
 
307
</p>
 
308
<div class="variablelist"><table border="0">
 
309
<col align="left" valign="top">
 
310
<tbody><tr>
 
311
<td>
 
312
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
313
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
314
</td>
 
315
</tr></tbody>
 
316
</table></div>
 
317
</div>
 
318
<hr>
 
319
<div class="refsect2" lang="en">
 
320
<a name="id2530608"></a><h3>
 
321
<a name="lasso-login-dump"></a>lasso_login_dump ()</h3>
 
322
<a class="indexterm" name="id2530618"></a><pre class="programlisting"><GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK>*      lasso_login_dump                (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre>
 
323
<p>
 
324
Dumps <em class="parameter"><code>login</code></em> content to an XML string.</p>
 
325
<p>
 
326
 
 
327
</p>
 
328
<div class="variablelist"><table border="0">
 
329
<col align="left" valign="top">
 
330
<tbody>
 
331
<tr>
 
332
<td>
 
333
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
334
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
335
</td>
 
336
</tr>
 
337
<tr>
 
338
<td>
 
339
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
340
<td> the dump string.  It must be freed by the caller.
 
341
</td>
 
342
</tr>
 
343
</tbody>
 
344
</table></div>
 
345
</div>
 
346
<hr>
 
347
<div class="refsect2" lang="en">
 
348
<a name="id2530693"></a><h3>
 
349
<a name="lasso-login-new-from-dump"></a>lasso_login_new_from_dump ()</h3>
 
350
<a class="indexterm" name="id2530704"></a><pre class="programlisting"><a href="LassoLogin.html" title="LassoLogin">LassoLogin</a>* lasso_login_new_from_dump       (<a href="LassoServer.html" title="LassoServer">LassoServer</a> *server,
 
351
                                             const <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *dump);</pre>
 
352
<p>
 
353
Restores the <em class="parameter"><code>dump</code></em> to a new <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>.</p>
 
354
<p>
 
355
 
 
356
</p>
 
357
<div class="variablelist"><table border="0">
 
358
<col align="left" valign="top">
 
359
<tbody>
 
360
<tr>
 
361
<td>
 
362
<span class="term"><em class="parameter"><code>server</code></em>&#160;:</span></td>
 
363
<td> the <a href="LassoServer.html" title="LassoServer"><span class="type">LassoServer</span></a>
 
364
</td>
 
365
</tr>
 
366
<tr>
 
367
<td>
 
368
<span class="term"><em class="parameter"><code>dump</code></em>&#160;:</span></td>
 
369
<td> XML login dump
 
370
</td>
 
371
</tr>
 
372
<tr>
 
373
<td>
 
374
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
375
<td> a newly created <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>; or NULL if an error occured.
 
376
</td>
 
377
</tr>
 
378
</tbody>
 
379
</table></div>
 
380
</div>
 
381
<hr>
 
382
<div class="refsect2" lang="en">
 
383
<a name="id2530815"></a><h3>
 
384
<a name="lasso-login-accept-sso"></a>lasso_login_accept_sso ()</h3>
 
385
<a class="indexterm" name="id2530826"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_accept_sso          (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre>
 
386
<p>
207
387
Gets the assertion of the response and adds it into the session.
208
388
Builds a federation with the 2 name identifiers of the assertion
209
389
and adds it into the identity.
210
 
If the session or the identity are NULL, they are created.</p><p>
 
390
If the session or the identity are NULL, they are created.</p>
 
391
<p>
211
392
 
212
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
213
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
214
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2546188"></a><h3><a name="lasso-login-build-artifact-msg"></a>lasso_login_build_artifact_msg ()</h3><a class="indexterm" name="id2546200"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_build_artifact_msg  (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
215
 
                                             <a href="LassoProvider.html#LassoHttpMethod">LassoHttpMethod</a> http_method);</pre><p>
 
393
</p>
 
394
<div class="variablelist"><table border="0">
 
395
<col align="left" valign="top">
 
396
<tbody>
 
397
<tr>
 
398
<td>
 
399
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
400
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
401
</td>
 
402
</tr>
 
403
<tr>
 
404
<td>
 
405
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
406
<td> 0 on success; or a negative value otherwise.
 
407
</td>
 
408
</tr>
 
409
</tbody>
 
410
</table></div>
 
411
</div>
 
412
<hr>
 
413
<div class="refsect2" lang="en">
 
414
<a name="id2530898"></a><h3>
 
415
<a name="lasso-login-build-artifact-msg"></a>lasso_login_build_artifact_msg ()</h3>
 
416
<a class="indexterm" name="id2530908"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_build_artifact_msg  (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
 
417
                                             <a href="LassoProvider.html#LassoHttpMethod">LassoHttpMethod</a> http_method);</pre>
 
418
<p>
216
419
Builds a SAML artifact. Depending of the HTTP method, the data for the sending of
217
420
the artifact are stored in <em class="parameter"><code>msg_url</code></em> (REDIRECT) or <em class="parameter"><code>msg_url</code></em>, <em class="parameter"><code>msg_body</code></em> and
218
 
<em class="parameter"><code>msg_relayState</code></em> (POST).</p><p>
 
421
<em class="parameter"><code>msg_relayState</code></em> (POST).</p>
 
422
<p>
219
423
 
220
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
221
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>http_method</code></em>�:</span></td><td> the HTTP method to send the artifact (REDIRECT or POST)
222
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
223
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2546317"></a><h3><a name="lasso-login-build-assertion"></a>lasso_login_build_assertion ()</h3><a class="indexterm" name="id2546329"></a><pre class="programlisting"><GTKDOCLINK HREF="int">int</GTKDOCLINK>         lasso_login_build_assertion     (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
 
424
</p>
 
425
<div class="variablelist"><table border="0">
 
426
<col align="left" valign="top">
 
427
<tbody>
 
428
<tr>
 
429
<td>
 
430
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
431
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
432
</td>
 
433
</tr>
 
434
<tr>
 
435
<td>
 
436
<span class="term"><em class="parameter"><code>http_method</code></em>&#160;:</span></td>
 
437
<td> the HTTP method to send the artifact (REDIRECT or POST)
 
438
</td>
 
439
</tr>
 
440
<tr>
 
441
<td>
 
442
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
443
<td> 0 on success; or a negative value otherwise.
 
444
</td>
 
445
</tr>
 
446
</tbody>
 
447
</table></div>
 
448
</div>
 
449
<hr>
 
450
<div class="refsect2" lang="en">
 
451
<a name="id2531026"></a><h3>
 
452
<a name="lasso-login-build-assertion"></a>lasso_login_build_assertion ()</h3>
 
453
<a class="indexterm" name="id2531038"></a><pre class="programlisting"><GTKDOCLINK HREF="int">int</GTKDOCLINK>         lasso_login_build_assertion     (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
224
454
                                             const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *authenticationMethod,
225
455
                                             const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *authenticationInstant,
226
456
                                             const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *reauthenticateOnOrAfter,
227
457
                                             const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *notBefore,
228
 
                                             const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *notOnOrAfter);</pre><p>
 
458
                                             const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *notOnOrAfter);</pre>
 
459
<p>
229
460
Builds an assertion and stores it in profile session.
230
461
<em class="parameter"><code>authenticationInstant</code></em>, reauthenticateOnOrAfter, <em class="parameter"><code>notBefore</code></em> and
231
462
<em class="parameter"><code>notOnOrAfter</code></em> may be NULL.  If <em class="parameter"><code>authenticationInstant</code></em> is NULL, the current
232
 
time will be used.  Time values must be encoded in UTC.</p><p>
 
463
time will be used.  Time values must be encoded in UTC.</p>
 
464
<p>
233
465
 
234
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
235
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>authenticationMethod</code></em>�:</span></td><td> the authentication method
236
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>authenticationInstant</code></em>�:</span></td><td> the time at which the authentication took place
237
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>reauthenticateOnOrAfter</code></em>�:</span></td><td> the time at, or after which the service provider
 
466
</p>
 
467
<div class="variablelist"><table border="0">
 
468
<col align="left" valign="top">
 
469
<tbody>
 
470
<tr>
 
471
<td>
 
472
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
473
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
474
</td>
 
475
</tr>
 
476
<tr>
 
477
<td>
 
478
<span class="term"><em class="parameter"><code>authenticationMethod</code></em>&#160;:</span></td>
 
479
<td> the authentication method
 
480
</td>
 
481
</tr>
 
482
<tr>
 
483
<td>
 
484
<span class="term"><em class="parameter"><code>authenticationInstant</code></em>&#160;:</span></td>
 
485
<td> the time at which the authentication took place
 
486
</td>
 
487
</tr>
 
488
<tr>
 
489
<td>
 
490
<span class="term"><em class="parameter"><code>reauthenticateOnOrAfter</code></em>&#160;:</span></td>
 
491
<td> the time at, or after which the service provider
238
492
    must reauthenticates the principal with the identity provider
239
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>notBefore</code></em>�:</span></td><td> the earliest time instant at which the assertion is valid
240
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>notOnOrAfter</code></em>�:</span></td><td> the time instant at which the assertion has expired
241
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
242
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2546537"></a><h3><a name="lasso-login-build-authn-request-msg"></a>lasso_login_build_authn_request_msg ()</h3><a class="indexterm" name="id2546550"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_build_authn_request_msg
243
 
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre><p>
 
493
</td>
 
494
</tr>
 
495
<tr>
 
496
<td>
 
497
<span class="term"><em class="parameter"><code>notBefore</code></em>&#160;:</span></td>
 
498
<td> the earliest time instant at which the assertion is valid
 
499
</td>
 
500
</tr>
 
501
<tr>
 
502
<td>
 
503
<span class="term"><em class="parameter"><code>notOnOrAfter</code></em>&#160;:</span></td>
 
504
<td> the time instant at which the assertion has expired
 
505
</td>
 
506
</tr>
 
507
<tr>
 
508
<td>
 
509
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
510
<td> 0 on success; or a negative value otherwise.
 
511
</td>
 
512
</tr>
 
513
</tbody>
 
514
</table></div>
 
515
</div>
 
516
<hr>
 
517
<div class="refsect2" lang="en">
 
518
<a name="id2531246"></a><h3>
 
519
<a name="lasso-login-build-authn-request-msg"></a>lasso_login_build_authn_request_msg ()</h3>
 
520
<a class="indexterm" name="id2531258"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_build_authn_request_msg
 
521
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre>
 
522
<p>
244
523
Converts profile authentication request (<em class="parameter"><code>request</code></em> member) into a Liberty
245
524
message, either an URL in HTTP-Redirect profile or an URL and a field value
246
525
in Browser-POST (form) profile.
247
 
</p><p>
 
526
</p>
 
527
<p>
248
528
The URL is set into the <em class="parameter"><code>msg_url</code></em> member and the eventual field value (LAREQ)
249
 
is set into the <em class="parameter"><code>msg_body</code></em> member.</p><p>
 
529
is set into the <em class="parameter"><code>msg_body</code></em> member.</p>
 
530
<p>
250
531
 
251
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
252
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
253
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2546644"></a><h3><a name="lasso-login-build-authn-response-msg"></a>lasso_login_build_authn_response_msg ()</h3><a class="indexterm" name="id2546656"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_build_authn_response_msg
254
 
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre><p>
 
532
</p>
 
533
<div class="variablelist"><table border="0">
 
534
<col align="left" valign="top">
 
535
<tbody>
 
536
<tr>
 
537
<td>
 
538
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
539
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
540
</td>
 
541
</tr>
 
542
<tr>
 
543
<td>
 
544
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
545
<td> 0 on success; or a negative value otherwise.
 
546
</td>
 
547
</tr>
 
548
</tbody>
 
549
</table></div>
 
550
</div>
 
551
<hr>
 
552
<div class="refsect2" lang="en">
 
553
<a name="id2531352"></a><h3>
 
554
<a name="lasso-login-build-authn-response-msg"></a>lasso_login_build_authn_response_msg ()</h3>
 
555
<a class="indexterm" name="id2531363"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_build_authn_response_msg
 
556
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre>
 
557
<p>
255
558
Converts profile authentication response (<em class="parameter"><code>response</code></em> member) into a Liberty
256
559
message.
257
 
</p><p>
 
560
</p>
 
561
<p>
258
562
The URL is set into the <em class="parameter"><code>msg_url</code></em> member and the field value (LARES) is set
259
 
into the <em class="parameter"><code>msg_body</code></em> member.</p><p>
 
563
into the <em class="parameter"><code>msg_body</code></em> member.</p>
 
564
<p>
260
565
 
261
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
262
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
263
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2546749"></a><h3><a name="lasso-login-build-request-msg"></a>lasso_login_build_request_msg ()</h3><a class="indexterm" name="id2546761"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_build_request_msg   (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre><p>
 
566
</p>
 
567
<div class="variablelist"><table border="0">
 
568
<col align="left" valign="top">
 
569
<tbody>
 
570
<tr>
 
571
<td>
 
572
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
573
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
574
</td>
 
575
</tr>
 
576
<tr>
 
577
<td>
 
578
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
579
<td> 0 on success; or a negative value otherwise.
 
580
</td>
 
581
</tr>
 
582
</tbody>
 
583
</table></div>
 
584
</div>
 
585
<hr>
 
586
<div class="refsect2" lang="en">
 
587
<a name="id2531456"></a><h3>
 
588
<a name="lasso-login-build-request-msg"></a>lasso_login_build_request_msg ()</h3>
 
589
<a class="indexterm" name="id2531467"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_build_request_msg   (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre>
 
590
<p>
264
591
Converts profile artifact request into a Liberty SOAP message.
265
 
</p><p>
 
592
</p>
 
593
<p>
266
594
The URL is set into the <em class="parameter"><code>msg_url</code></em> member and the SOAP message is set into the
267
 
<em class="parameter"><code>msg_body</code></em> member.</p><p>
 
595
<em class="parameter"><code>msg_body</code></em> member.</p>
 
596
<p>
268
597
 
269
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
270
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
271
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2546846"></a><h3><a name="lasso-login-build-response-msg"></a>lasso_login_build_response_msg ()</h3><a class="indexterm" name="id2546858"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_build_response_msg  (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
272
 
                                             <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *remote_providerID);</pre><p>
 
598
</p>
 
599
<div class="variablelist"><table border="0">
 
600
<col align="left" valign="top">
 
601
<tbody>
 
602
<tr>
 
603
<td>
 
604
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
605
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
606
</td>
 
607
</tr>
 
608
<tr>
 
609
<td>
 
610
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
611
<td> 0 on success; or a negative value otherwise.
 
612
</td>
 
613
</tr>
 
614
</tbody>
 
615
</table></div>
 
616
</div>
 
617
<hr>
 
618
<div class="refsect2" lang="en">
 
619
<a name="id2531553"></a><h3>
 
620
<a name="lasso-login-build-response-msg"></a>lasso_login_build_response_msg ()</h3>
 
621
<a class="indexterm" name="id2531564"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_build_response_msg  (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
 
622
                                             <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *remote_providerID);</pre>
 
623
<p>
273
624
Converts profile assertion response (<em class="parameter"><code>response</code></em> member) into a Liberty SOAP
274
625
messageresponse message.
275
 
</p><p>
 
626
</p>
 
627
<p>
276
628
The URL is set into the <em class="parameter"><code>msg_url</code></em> member and the SOAP message is set into the
277
 
<em class="parameter"><code>msg_body</code></em> member.</p><p>
 
629
<em class="parameter"><code>msg_body</code></em> member.</p>
 
630
<p>
278
631
 
279
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
280
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>remote_providerID</code></em>�:</span></td><td> service provider ID
281
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
282
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2546972"></a><h3><a name="lasso-login-init-authn-request"></a>lasso_login_init_authn_request ()</h3><a class="indexterm" name="id2546984"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_init_authn_request  (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
 
632
</p>
 
633
<div class="variablelist"><table border="0">
 
634
<col align="left" valign="top">
 
635
<tbody>
 
636
<tr>
 
637
<td>
 
638
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
639
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
640
</td>
 
641
</tr>
 
642
<tr>
 
643
<td>
 
644
<span class="term"><em class="parameter"><code>remote_providerID</code></em>&#160;:</span></td>
 
645
<td> service provider ID
 
646
</td>
 
647
</tr>
 
648
<tr>
 
649
<td>
 
650
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
651
<td> 0 on success; or a negative value otherwise.
 
652
</td>
 
653
</tr>
 
654
</tbody>
 
655
</table></div>
 
656
</div>
 
657
<hr>
 
658
<div class="refsect2" lang="en">
 
659
<a name="id2531678"></a><h3>
 
660
<a name="lasso-login-init-authn-request"></a>lasso_login_init_authn_request ()</h3>
 
661
<a class="indexterm" name="id2531689"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_init_authn_request  (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
283
662
                                             const <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *remote_providerID,
284
 
                                             <a href="LassoProvider.html#LassoHttpMethod">LassoHttpMethod</a> http_method);</pre><p>
 
663
                                             <a href="LassoProvider.html#LassoHttpMethod">LassoHttpMethod</a> http_method);</pre>
 
664
<p>
285
665
Initializes a new lib:AuthnRequest from current service provider to remote
286
666
identity provider specified in <em class="parameter"><code>remote_providerID</code></em> (if NULL the first known
287
 
identity provider is used).</p><p>
 
667
identity provider is used).</p>
 
668
<p>
288
669
 
289
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
290
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>remote_providerID</code></em>�:</span></td><td> the providerID of the identity provider (may be NULL)
291
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>http_method</code></em>�:</span></td><td> HTTP method to use for request transmission
292
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
293
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2547106"></a><h3><a name="lasso-login-init-idp-initiated-authn-request"></a>lasso_login_init_idp_initiated_authn_request ()</h3><a class="indexterm" name="id2547119"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_init_idp_initiated_authn_request
 
670
</p>
 
671
<div class="variablelist"><table border="0">
 
672
<col align="left" valign="top">
 
673
<tbody>
 
674
<tr>
 
675
<td>
 
676
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
677
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
678
</td>
 
679
</tr>
 
680
<tr>
 
681
<td>
 
682
<span class="term"><em class="parameter"><code>remote_providerID</code></em>&#160;:</span></td>
 
683
<td> the providerID of the identity provider (may be NULL)
 
684
</td>
 
685
</tr>
 
686
<tr>
 
687
<td>
 
688
<span class="term"><em class="parameter"><code>http_method</code></em>&#160;:</span></td>
 
689
<td> HTTP method to use for request transmission
 
690
</td>
 
691
</tr>
 
692
<tr>
 
693
<td>
 
694
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
695
<td> 0 on success; or a negative value otherwise.
 
696
</td>
 
697
</tr>
 
698
</tbody>
 
699
</table></div>
 
700
</div>
 
701
<hr>
 
702
<div class="refsect2" lang="en">
 
703
<a name="id2531811"></a><h3>
 
704
<a name="lasso-login-init-idp-initiated-authn-request"></a>lasso_login_init_idp_initiated_authn_request ()</h3>
 
705
<a class="indexterm" name="id2531823"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_init_idp_initiated_authn_request
294
706
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
295
 
                                             const <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *remote_providerID);</pre><p>
 
707
                                             const <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *remote_providerID);</pre>
 
708
<p>
296
709
Generates an authentication response without matching authentication
297
710
request.
298
 
</p><p>
299
 
If <em class="parameter"><code>remote_providerID</code></em> is NULL, the first known provider is used.</p><p>
 
711
</p>
 
712
<p>
 
713
If <em class="parameter"><code>remote_providerID</code></em> is NULL, the first known provider is used.</p>
 
714
<p>
300
715
 
301
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>.
302
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>remote_providerID</code></em>�:</span></td><td> the providerID of the remote service provider (may be
 
716
</p>
 
717
<div class="variablelist"><table border="0">
 
718
<col align="left" valign="top">
 
719
<tbody>
 
720
<tr>
 
721
<td>
 
722
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
723
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>.
 
724
</td>
 
725
</tr>
 
726
<tr>
 
727
<td>
 
728
<span class="term"><em class="parameter"><code>remote_providerID</code></em>&#160;:</span></td>
 
729
<td> the providerID of the remote service provider (may be
303
730
     NULL)
304
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
305
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2547223"></a><h3><a name="lasso-login-init-request"></a>lasso_login_init_request ()</h3><a class="indexterm" name="id2547234"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_init_request        (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
 
731
</td>
 
732
</tr>
 
733
<tr>
 
734
<td>
 
735
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
736
<td> 0 on success; or a negative value otherwise.
 
737
</td>
 
738
</tr>
 
739
</tbody>
 
740
</table></div>
 
741
</div>
 
742
<hr>
 
743
<div class="refsect2" lang="en">
 
744
<a name="id2531927"></a><h3>
 
745
<a name="lasso-login-init-request"></a>lasso_login_init_request ()</h3>
 
746
<a class="indexterm" name="id2531937"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_init_request        (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
306
747
                                             <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *response_msg,
307
 
                                             <a href="LassoProvider.html#LassoHttpMethod">LassoHttpMethod</a> response_http_method);</pre><p>
 
748
                                             <a href="LassoProvider.html#LassoHttpMethod">LassoHttpMethod</a> response_http_method);</pre>
 
749
<p>
308
750
Initializes an artifact request.  <em class="parameter"><code>response_msg</code></em> is either the query string
309
 
(in redirect mode) or the form LAREQ field (in browser-post mode).</p><p>
 
751
(in redirect mode) or the form LAREQ field (in browser-post mode).</p>
 
752
<p>
310
753
 
311
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
312
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>response_msg</code></em>�:</span></td><td> the authentication response received
313
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>response_http_method</code></em>�:</span></td><td> the method used to receive the authentication
 
754
</p>
 
755
<div class="variablelist"><table border="0">
 
756
<col align="left" valign="top">
 
757
<tbody>
 
758
<tr>
 
759
<td>
 
760
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
761
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
762
</td>
 
763
</tr>
 
764
<tr>
 
765
<td>
 
766
<span class="term"><em class="parameter"><code>response_msg</code></em>&#160;:</span></td>
 
767
<td> the authentication response received
 
768
</td>
 
769
</tr>
 
770
<tr>
 
771
<td>
 
772
<span class="term"><em class="parameter"><code>response_http_method</code></em>&#160;:</span></td>
 
773
<td> the method used to receive the authentication
314
774
     response
315
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
316
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2547356"></a><h3><a name="lasso-login-must-ask-for-consent"></a>lasso_login_must_ask_for_consent ()</h3><a class="indexterm" name="id2547368"></a><pre class="programlisting"><GTKDOCLINK HREF="gboolean">gboolean</GTKDOCLINK>    lasso_login_must_ask_for_consent
317
 
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre><p>
318
 
Evaluates if consent must be asked to the Principal to federate him.</p><p>
319
 
 
320
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
321
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> <code class="literal">TRUE</code> if consent must be asked
322
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2547443"></a><h3><a name="lasso-login-must-authenticate"></a>lasso_login_must_authenticate ()</h3><a class="indexterm" name="id2547455"></a><pre class="programlisting"><GTKDOCLINK HREF="gboolean">gboolean</GTKDOCLINK>    lasso_login_must_authenticate   (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre><p>
323
 
Evaluates if user must be authenticated.</p><p>
324
 
 
325
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
326
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> <code class="literal">TRUE</code> if user must be authenticated
327
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2547529"></a><h3><a name="lasso-login-process-authn-request-msg"></a>lasso_login_process_authn_request_msg ()</h3><a class="indexterm" name="id2547541"></a><pre class="programlisting"><GTKDOCLINK HREF="int">int</GTKDOCLINK>         lasso_login_process_authn_request_msg
 
775
</td>
 
776
</tr>
 
777
<tr>
 
778
<td>
 
779
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
780
<td> 0 on success; or a negative value otherwise.
 
781
</td>
 
782
</tr>
 
783
</tbody>
 
784
</table></div>
 
785
</div>
 
786
<hr>
 
787
<div class="refsect2" lang="en">
 
788
<a name="id2532059"></a><h3>
 
789
<a name="lasso-login-must-ask-for-consent"></a>lasso_login_must_ask_for_consent ()</h3>
 
790
<a class="indexterm" name="id2532071"></a><pre class="programlisting"><GTKDOCLINK HREF="gboolean">gboolean</GTKDOCLINK>    lasso_login_must_ask_for_consent
 
791
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre>
 
792
<p>
 
793
Evaluates if consent must be asked to the Principal to federate him.</p>
 
794
<p>
 
795
 
 
796
</p>
 
797
<div class="variablelist"><table border="0">
 
798
<col align="left" valign="top">
 
799
<tbody>
 
800
<tr>
 
801
<td>
 
802
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
803
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
804
</td>
 
805
</tr>
 
806
<tr>
 
807
<td>
 
808
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
809
<td> <code class="literal">TRUE</code> if consent must be asked
 
810
</td>
 
811
</tr>
 
812
</tbody>
 
813
</table></div>
 
814
</div>
 
815
<hr>
 
816
<div class="refsect2" lang="en">
 
817
<a name="id2532146"></a><h3>
 
818
<a name="lasso-login-must-authenticate"></a>lasso_login_must_authenticate ()</h3>
 
819
<a class="indexterm" name="id2532157"></a><pre class="programlisting"><GTKDOCLINK HREF="gboolean">gboolean</GTKDOCLINK>    lasso_login_must_authenticate   (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login);</pre>
 
820
<p>
 
821
Evaluates if user must be authenticated.</p>
 
822
<p>
 
823
 
 
824
</p>
 
825
<div class="variablelist"><table border="0">
 
826
<col align="left" valign="top">
 
827
<tbody>
 
828
<tr>
 
829
<td>
 
830
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
831
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
832
</td>
 
833
</tr>
 
834
<tr>
 
835
<td>
 
836
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
837
<td> <code class="literal">TRUE</code> if user must be authenticated
 
838
</td>
 
839
</tr>
 
840
</tbody>
 
841
</table></div>
 
842
</div>
 
843
<hr>
 
844
<div class="refsect2" lang="en">
 
845
<a name="id2532232"></a><h3>
 
846
<a name="lasso-login-process-authn-request-msg"></a>lasso_login_process_authn_request_msg ()</h3>
 
847
<a class="indexterm" name="id2532243"></a><pre class="programlisting"><GTKDOCLINK HREF="int">int</GTKDOCLINK>         lasso_login_process_authn_request_msg
328
848
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
329
 
                                             const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *authn_request_msg);</pre><p>
 
849
                                             const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *authn_request_msg);</pre>
 
850
<p>
330
851
Processes received authentication request, checks it is signed correctly,
331
 
checks if requested protocol profile is supported, etc.</p><p>
332
 
 
333
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
334
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>authn_request_msg</code></em>�:</span></td><td> the authentication request received
335
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
336
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2547635"></a><h3><a name="lasso-login-process-authn-response-msg"></a>lasso_login_process_authn_response_msg ()</h3><a class="indexterm" name="id2547647"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_process_authn_response_msg
337
 
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
338
 
                                             <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *authn_response_msg);</pre><p>
339
 
Processes received authentication response.</p><p>
340
 
 
341
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
342
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>authn_response_msg</code></em>�:</span></td><td> the authentication response received
343
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
344
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2547739"></a><h3><a name="lasso-login-process-request-msg"></a>lasso_login_process_request_msg ()</h3><a class="indexterm" name="id2547752"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_process_request_msg (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
345
 
                                             <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *request_msg);</pre><p>
346
 
Processes received artifact request.</p><p>
347
 
 
348
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
349
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>request_msg</code></em>�:</span></td><td> the artifact request received
350
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
351
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2547842"></a><h3><a name="lasso-login-process-response-msg"></a>lasso_login_process_response_msg ()</h3><a class="indexterm" name="id2547854"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_process_response_msg
352
 
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
353
 
                                             <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *response_msg);</pre><p>
354
 
Processes received assertion response.</p><p>
355
 
 
356
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
357
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>response_msg</code></em>�:</span></td><td> the assertion response received
358
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
359
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2547946"></a><h3><a name="lasso-login-validate-request-msg"></a>lasso_login_validate_request_msg ()</h3><a class="indexterm" name="id2547958"></a><pre class="programlisting"><GTKDOCLINK HREF="int">int</GTKDOCLINK>         lasso_login_validate_request_msg
 
852
checks if requested protocol profile is supported, etc.</p>
 
853
<p>
 
854
 
 
855
</p>
 
856
<div class="variablelist"><table border="0">
 
857
<col align="left" valign="top">
 
858
<tbody>
 
859
<tr>
 
860
<td>
 
861
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
862
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
863
</td>
 
864
</tr>
 
865
<tr>
 
866
<td>
 
867
<span class="term"><em class="parameter"><code>authn_request_msg</code></em>&#160;:</span></td>
 
868
<td> the authentication request received
 
869
</td>
 
870
</tr>
 
871
<tr>
 
872
<td>
 
873
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
874
<td> 0 on success; or a negative value otherwise.
 
875
</td>
 
876
</tr>
 
877
</tbody>
 
878
</table></div>
 
879
</div>
 
880
<hr>
 
881
<div class="refsect2" lang="en">
 
882
<a name="id2532336"></a><h3>
 
883
<a name="lasso-login-process-authn-response-msg"></a>lasso_login_process_authn_response_msg ()</h3>
 
884
<a class="indexterm" name="id2532348"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_process_authn_response_msg
 
885
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
 
886
                                             <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *authn_response_msg);</pre>
 
887
<p>
 
888
Processes received authentication response.</p>
 
889
<p>
 
890
 
 
891
</p>
 
892
<div class="variablelist"><table border="0">
 
893
<col align="left" valign="top">
 
894
<tbody>
 
895
<tr>
 
896
<td>
 
897
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
898
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
899
</td>
 
900
</tr>
 
901
<tr>
 
902
<td>
 
903
<span class="term"><em class="parameter"><code>authn_response_msg</code></em>&#160;:</span></td>
 
904
<td> the authentication response received
 
905
</td>
 
906
</tr>
 
907
<tr>
 
908
<td>
 
909
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
910
<td> 0 on success; or a negative value otherwise.
 
911
</td>
 
912
</tr>
 
913
</tbody>
 
914
</table></div>
 
915
</div>
 
916
<hr>
 
917
<div class="refsect2" lang="en">
 
918
<a name="id2532440"></a><h3>
 
919
<a name="lasso-login-process-request-msg"></a>lasso_login_process_request_msg ()</h3>
 
920
<a class="indexterm" name="id2532452"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_process_request_msg (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
 
921
                                             <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *request_msg);</pre>
 
922
<p>
 
923
Processes received artifact request.</p>
 
924
<p>
 
925
 
 
926
</p>
 
927
<div class="variablelist"><table border="0">
 
928
<col align="left" valign="top">
 
929
<tbody>
 
930
<tr>
 
931
<td>
 
932
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
933
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
934
</td>
 
935
</tr>
 
936
<tr>
 
937
<td>
 
938
<span class="term"><em class="parameter"><code>request_msg</code></em>&#160;:</span></td>
 
939
<td> the artifact request received
 
940
</td>
 
941
</tr>
 
942
<tr>
 
943
<td>
 
944
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
945
<td> 0 on success; or a negative value otherwise.
 
946
</td>
 
947
</tr>
 
948
</tbody>
 
949
</table></div>
 
950
</div>
 
951
<hr>
 
952
<div class="refsect2" lang="en">
 
953
<a name="id2532543"></a><h3>
 
954
<a name="lasso-login-process-response-msg"></a>lasso_login_process_response_msg ()</h3>
 
955
<a class="indexterm" name="id2532554"></a><pre class="programlisting"><GTKDOCLINK HREF="gint">gint</GTKDOCLINK>        lasso_login_process_response_msg
 
956
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
 
957
                                             <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *response_msg);</pre>
 
958
<p>
 
959
Processes received assertion response.</p>
 
960
<p>
 
961
 
 
962
</p>
 
963
<div class="variablelist"><table border="0">
 
964
<col align="left" valign="top">
 
965
<tbody>
 
966
<tr>
 
967
<td>
 
968
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
969
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
970
</td>
 
971
</tr>
 
972
<tr>
 
973
<td>
 
974
<span class="term"><em class="parameter"><code>response_msg</code></em>&#160;:</span></td>
 
975
<td> the assertion response received
 
976
</td>
 
977
</tr>
 
978
<tr>
 
979
<td>
 
980
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
981
<td> 0 on success; or a negative value otherwise.
 
982
</td>
 
983
</tr>
 
984
</tbody>
 
985
</table></div>
 
986
</div>
 
987
<hr>
 
988
<div class="refsect2" lang="en">
 
989
<a name="id2532645"></a><h3>
 
990
<a name="lasso-login-validate-request-msg"></a>lasso_login_validate_request_msg ()</h3>
 
991
<a class="indexterm" name="id2532657"></a><pre class="programlisting"><GTKDOCLINK HREF="int">int</GTKDOCLINK>         lasso_login_validate_request_msg
360
992
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
361
993
                                             <GTKDOCLINK HREF="gboolean">gboolean</GTKDOCLINK> authentication_result,
362
 
                                             <GTKDOCLINK HREF="gboolean">gboolean</GTKDOCLINK> is_consent_obtained);</pre><p>
363
 
Initializes a response to the authentication request received.</p><p>
 
994
                                             <GTKDOCLINK HREF="gboolean">gboolean</GTKDOCLINK> is_consent_obtained);</pre>
 
995
<p>
 
996
Initializes a response to the authentication request received.</p>
 
997
<p>
364
998
 
365
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
366
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>authentication_result</code></em>�:</span></td><td> whether user has authenticated succesfully
367
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>is_consent_obtained</code></em>�:</span></td><td> whether user consent has been obtained
368
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
369
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2548073"></a><h3><a name="lasso-login-set-encryptedResourceId"></a>lasso_login_set_encryptedResourceId ()</h3><a class="indexterm" name="id2548086"></a><pre class="programlisting"><GTKDOCLINK HREF="int">int</GTKDOCLINK>         lasso_login_set_encryptedResourceId
 
999
</p>
 
1000
<div class="variablelist"><table border="0">
 
1001
<col align="left" valign="top">
 
1002
<tbody>
 
1003
<tr>
 
1004
<td>
 
1005
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
1006
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
1007
</td>
 
1008
</tr>
 
1009
<tr>
 
1010
<td>
 
1011
<span class="term"><em class="parameter"><code>authentication_result</code></em>&#160;:</span></td>
 
1012
<td> whether user has authenticated succesfully
 
1013
</td>
 
1014
</tr>
 
1015
<tr>
 
1016
<td>
 
1017
<span class="term"><em class="parameter"><code>is_consent_obtained</code></em>&#160;:</span></td>
 
1018
<td> whether user consent has been obtained
 
1019
</td>
 
1020
</tr>
 
1021
<tr>
 
1022
<td>
 
1023
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1024
<td> 0 on success; or a negative value otherwise.
 
1025
</td>
 
1026
</tr>
 
1027
</tbody>
 
1028
</table></div>
 
1029
</div>
 
1030
<hr>
 
1031
<div class="refsect2" lang="en">
 
1032
<a name="id2532772"></a><h3>
 
1033
<a name="lasso-login-set-encryptedResourceId"></a>lasso_login_set_encryptedResourceId ()</h3>
 
1034
<a class="indexterm" name="id2532784"></a><pre class="programlisting"><GTKDOCLINK HREF="int">int</GTKDOCLINK>         lasso_login_set_encryptedResourceId
370
1035
                                            (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
371
 
                                             <GTKDOCLINK HREF="LassoDiscoEncryptedResourceID">LassoDiscoEncryptedResourceID</GTKDOCLINK> *encryptedResourceId);</pre><p>
372
 
...</p><p>
373
 
 
374
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
375
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>encryptedResourceId</code></em>�:</span></td><td>
376
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
377
 
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2548176"></a><h3><a name="lasso-login-set-resourceId"></a>lasso_login_set_resourceId ()</h3><a class="indexterm" name="id2548188"></a><pre class="programlisting"><GTKDOCLINK HREF="int">int</GTKDOCLINK>         lasso_login_set_resourceId      (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
378
 
                                             const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *content);</pre><p>
379
 
...</p><p>
380
 
 
381
 
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>login</code></em>�:</span></td><td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
382
 
</td></tr><tr><td><span class="term"><em class="parameter"><code>content</code></em>�:</span></td><td>
383
 
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> 0 on success; or a negative value otherwise.
384
 
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="LassoProfile.html"><b>&lt;&lt;�LassoProfile</b></a></td><td align="right"><a accesskey="n" href="LassoLecp.html"><b>LassoLecp�&gt;&gt;</b></a></td></tr></table></body></html>
 
1036
                                             <GTKDOCLINK HREF="LassoDiscoEncryptedResourceID">LassoDiscoEncryptedResourceID</GTKDOCLINK> *encryptedResourceId);</pre>
 
1037
<p>
 
1038
...</p>
 
1039
<p>
 
1040
 
 
1041
</p>
 
1042
<div class="variablelist"><table border="0">
 
1043
<col align="left" valign="top">
 
1044
<tbody>
 
1045
<tr>
 
1046
<td>
 
1047
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
1048
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
1049
</td>
 
1050
</tr>
 
1051
<tr>
 
1052
<td>
 
1053
<span class="term"><em class="parameter"><code>encryptedResourceId</code></em>&#160;:</span></td>
 
1054
<td>
 
1055
</td>
 
1056
</tr>
 
1057
<tr>
 
1058
<td>
 
1059
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1060
<td> 0 on success; or a negative value otherwise.
 
1061
</td>
 
1062
</tr>
 
1063
</tbody>
 
1064
</table></div>
 
1065
</div>
 
1066
<hr>
 
1067
<div class="refsect2" lang="en">
 
1068
<a name="id2532875"></a><h3>
 
1069
<a name="lasso-login-set-resourceId"></a>lasso_login_set_resourceId ()</h3>
 
1070
<a class="indexterm" name="id2532886"></a><pre class="programlisting"><GTKDOCLINK HREF="int">int</GTKDOCLINK>         lasso_login_set_resourceId      (<a href="LassoLogin.html" title="LassoLogin">LassoLogin</a> *login,
 
1071
                                             const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *content);</pre>
 
1072
<p>
 
1073
...</p>
 
1074
<p>
 
1075
 
 
1076
</p>
 
1077
<div class="variablelist"><table border="0">
 
1078
<col align="left" valign="top">
 
1079
<tbody>
 
1080
<tr>
 
1081
<td>
 
1082
<span class="term"><em class="parameter"><code>login</code></em>&#160;:</span></td>
 
1083
<td> a <a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a>
 
1084
</td>
 
1085
</tr>
 
1086
<tr>
 
1087
<td>
 
1088
<span class="term"><em class="parameter"><code>content</code></em>&#160;:</span></td>
 
1089
<td>
 
1090
</td>
 
1091
</tr>
 
1092
<tr>
 
1093
<td>
 
1094
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1095
<td> 0 on success; or a negative value otherwise.
 
1096
</td>
 
1097
</tr>
 
1098
</tbody>
 
1099
</table></div>
 
1100
</div>
 
1101
</div>
 
1102
</div>
 
1103
<table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle">
 
1104
<td align="left"><a accesskey="p" href="LassoProfile.html"><b>&lt;&lt;&#160;LassoProfile</b></a></td>
 
1105
<td align="right"><a accesskey="n" href="LassoLecp.html"><b>LassoLecp&#160;&gt;&gt;</b></a></td>
 
1106
</tr></table>
 
1107
</body>
 
1108
</html>