53
36
<td valign="top" align="right"></td>
54
37
</tr></table></div>
55
<div class="refsynopsisdiv" title="Synopsis">
38
<div class="refsynopsisdiv">
56
39
<a name="lasso-LassoIdWsf2Profile.synopsis"></a><h2>Synopsis</h2>
57
<pre class="synopsis">
59
void lasso_idwsf2_profile_set_epr (LassoIdWsf2Profile *idwsf2_profile,
60
LassoWsAddrEndpointReference *epr);
61
LassoWsAddrEndpointReference* lasso_idwsf2_profile_get_epr
62
(LassoIdWsf2Profile *idwsf2_profile);
63
LassoSoapEnvelope* lasso_idwsf2_profile_get_soap_envelope_request
64
(LassoIdWsf2Profile *idwsf2_profile);
65
LassoSoapEnvelope* lasso_idwsf2_profile_get_soap_envelope_response
66
(LassoIdWsf2Profile *idwsf2_profile);
67
lasso_error_t lasso_idwsf2_profile_init_request (LassoIdWsf2Profile *profile);
68
lasso_error_t lasso_idwsf2_profile_build_request_msg
69
(LassoIdWsf2Profile *profile,
70
const char *security_mech_id);
71
lasso_error_t lasso_idwsf2_profile_process_request_msg
72
(LassoIdWsf2Profile *profile,
74
lasso_error_t lasso_idwsf2_profile_check_security_mechanism
75
(LassoIdWsf2Profile *profile,
76
const char *security_mech_id);
77
LassoNode * lasso_idwsf2_profile_get_name_identifier
78
(LassoIdWsf2Profile *idwsf2_profile);
79
lasso_error_t lasso_idwsf2_profile_init_response (LassoIdWsf2Profile *profile);
80
lasso_error_t lasso_idwsf2_profile_init_soap_fault_response
81
(LassoIdWsf2Profile *profile,
82
const char *faultcode,
83
const char *faultstring,
85
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
87
lasso_error_t lasso_idwsf2_profile_redirect_user_for_interaction
88
(LassoIdWsf2Profile *profile,
90
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
91
>gchar</a> *redirect_url,
93
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
94
>gboolean</a> for_data);
95
lasso_error_t lasso_idwsf2_profile_build_response_msg
96
(LassoIdWsf2Profile *profile);
97
lasso_error_t lasso_idwsf2_profile_process_response_msg
98
(LassoIdWsf2Profile *profile,
40
<pre class="synopsis">struct <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile">LassoIdWsf2Profile</a>;
41
<span class="returnvalue">void</span> <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-set-epr" title="lasso_idwsf2_profile_set_epr ()">lasso_idwsf2_profile_set_epr</a> (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>,
42
<em class="parameter"><code><a class="link" href="lasso-LassoWsAddrEndpointReference.html#LassoWsAddrEndpointReference" title="struct LassoWsAddrEndpointReference"><span class="type">LassoWsAddrEndpointReference</span></a> *epr</code></em>);
43
<a class="link" href="lasso-LassoWsAddrEndpointReference.html#LassoWsAddrEndpointReference" title="struct LassoWsAddrEndpointReference"><span class="returnvalue">LassoWsAddrEndpointReference</span></a> * <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-get-epr" title="lasso_idwsf2_profile_get_epr ()">lasso_idwsf2_profile_get_epr</a>
44
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);
45
<a class="link" href="lasso-LassoSoapEnvelope.html#LassoSoapEnvelope" title="struct LassoSoapEnvelope"><span class="returnvalue">LassoSoapEnvelope</span></a> * <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-get-soap-envelope-request" title="lasso_idwsf2_profile_get_soap_envelope_request ()">lasso_idwsf2_profile_get_soap_envelope_request</a>
46
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);
47
<a class="link" href="lasso-LassoSoapEnvelope.html#LassoSoapEnvelope" title="struct LassoSoapEnvelope"><span class="returnvalue">LassoSoapEnvelope</span></a> * <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-get-soap-envelope-response" title="lasso_idwsf2_profile_get_soap_envelope_response ()">lasso_idwsf2_profile_get_soap_envelope_response</a>
48
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);
49
<span class="returnvalue">lasso_error_t</span> <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-init-request" title="lasso_idwsf2_profile_init_request ()">lasso_idwsf2_profile_init_request</a> (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>);
50
<span class="returnvalue">lasso_error_t</span> <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-build-request-msg" title="lasso_idwsf2_profile_build_request_msg ()">lasso_idwsf2_profile_build_request_msg</a>
51
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
52
<em class="parameter"><code>const <span class="type">char</span> *security_mech_id</code></em>);
53
<span class="returnvalue">lasso_error_t</span> <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-process-request-msg" title="lasso_idwsf2_profile_process_request_msg ()">lasso_idwsf2_profile_process_request_msg</a>
54
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
55
<em class="parameter"><code>const <span class="type">char</span> *msg</code></em>);
56
<span class="returnvalue">lasso_error_t</span> <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-check-security-mechanism" title="lasso_idwsf2_profile_check_security_mechanism ()">lasso_idwsf2_profile_check_security_mechanism</a>
57
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
58
<em class="parameter"><code>const <span class="type">char</span> *security_mech_id</code></em>);
59
<a class="link" href="lasso-node.html#LassoNode" title="struct LassoNode"><span class="returnvalue">LassoNode</span></a> * <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-get-name-identifier" title="lasso_idwsf2_profile_get_name_identifier ()">lasso_idwsf2_profile_get_name_identifier</a>
60
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);
61
<span class="returnvalue">lasso_error_t</span> <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-init-response" title="lasso_idwsf2_profile_init_response ()">lasso_idwsf2_profile_init_response</a> (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>);
62
<span class="returnvalue">lasso_error_t</span> <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-init-soap-fault-response" title="lasso_idwsf2_profile_init_soap_fault_response ()">lasso_idwsf2_profile_init_soap_fault_response</a>
63
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
64
<em class="parameter"><code>const <span class="type">char</span> *faultcode</code></em>,
65
<em class="parameter"><code>const <span class="type">char</span> *faultstring</code></em>,
66
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *details</code></em>);
67
<span class="returnvalue">lasso_error_t</span> <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-redirect-user-for-interaction" title="lasso_idwsf2_profile_redirect_user_for_interaction ()">lasso_idwsf2_profile_redirect_user_for_interaction</a>
68
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
69
<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> *redirect_url</code></em>,
70
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> for_data</code></em>);
71
<span class="returnvalue">lasso_error_t</span> <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-build-response-msg" title="lasso_idwsf2_profile_build_response_msg ()">lasso_idwsf2_profile_build_response_msg</a>
72
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>);
73
<span class="returnvalue">lasso_error_t</span> <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-process-response-msg" title="lasso_idwsf2_profile_process_response_msg ()">lasso_idwsf2_profile_process_response_msg</a>
74
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
75
<em class="parameter"><code>const <span class="type">char</span> *msg</code></em>);
102
<div class="refsect1" title="Description">
78
<div class="refsect1">
103
79
<a name="lasso-LassoIdWsf2Profile.description"></a><h2>Description</h2>
105
<div class="refsect1" title="Details">
81
<div class="refsect1">
106
82
<a name="lasso-LassoIdWsf2Profile.details"></a><h2>Details</h2>
107
<div class="refsect2" title="LassoIdWsf2Profile">
108
<a name="LassoIdWsf2Profile"></a><h3>LassoIdWsf2Profile</h3>
109
<pre class="programlisting">typedef struct {
83
<div class="refsect2">
84
<a name="LassoIdWsf2Profile"></a><h3>struct LassoIdWsf2Profile</h3>
85
<pre class="programlisting">struct LassoIdWsf2Profile {
110
86
LassoProfile parent;
111
} LassoIdWsf2Profile;
115
<div class="refsect2" title="lasso_idwsf2_profile_set_epr ()">
91
<div class="refsect2">
116
92
<a name="lasso-idwsf2-profile-set-epr"></a><h3>lasso_idwsf2_profile_set_epr ()</h3>
117
<pre class="programlisting">void lasso_idwsf2_profile_set_epr (LassoIdWsf2Profile *idwsf2_profile,
118
LassoWsAddrEndpointReference *epr);</pre>
93
<pre class="programlisting"><span class="returnvalue">void</span> lasso_idwsf2_profile_set_epr (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>,
94
<em class="parameter"><code><a class="link" href="lasso-LassoWsAddrEndpointReference.html#LassoWsAddrEndpointReference" title="struct LassoWsAddrEndpointReference"><span class="type">LassoWsAddrEndpointReference</span></a> *epr</code></em>);</pre>
121
<div class="refsect2" title="lasso_idwsf2_profile_get_epr ()">
97
<div class="refsect2">
122
98
<a name="lasso-idwsf2-profile-get-epr"></a><h3>lasso_idwsf2_profile_get_epr ()</h3>
123
<pre class="programlisting">LassoWsAddrEndpointReference* lasso_idwsf2_profile_get_epr
124
(LassoIdWsf2Profile *idwsf2_profile);</pre>
99
<pre class="programlisting"><a class="link" href="lasso-LassoWsAddrEndpointReference.html#LassoWsAddrEndpointReference" title="struct LassoWsAddrEndpointReference"><span class="returnvalue">LassoWsAddrEndpointReference</span></a> * lasso_idwsf2_profile_get_epr
100
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);</pre>
126
Return the EPR used by this profile.</p>
102
Return the EPR used by this profile.
127
104
<div class="variablelist"><table border="0">
128
105
<col align="left" valign="top">
131
108
<td><p><span class="term"><em class="parameter"><code>idwsf2_profile</code></em> :</span></p></td>
132
<td> a <span class="type">LassoIdWsf2Profile</span> object
109
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
112
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
113
<td>a <a class="link" href="lasso-LassoWsAddrEndpointReference.html#LassoWsAddrEndpointReference" title="struct LassoWsAddrEndpointReference"><span class="type">LassoWsAddrEndpointReference</span></a> object, or NULL if none is set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
136
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
137
<td> a <span class="type">LassoWsAddrEndpointReference</span> object, or NULL if none is set.. <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=transfer"><span class="acronym">transfer</span></a> none. </td>
143
<div class="refsect2" title="lasso_idwsf2_profile_get_soap_envelope_request ()">
120
<div class="refsect2">
144
121
<a name="lasso-idwsf2-profile-get-soap-envelope-request"></a><h3>lasso_idwsf2_profile_get_soap_envelope_request ()</h3>
145
<pre class="programlisting">LassoSoapEnvelope* lasso_idwsf2_profile_get_soap_envelope_request
146
(LassoIdWsf2Profile *idwsf2_profile);</pre>
122
<pre class="programlisting"><a class="link" href="lasso-LassoSoapEnvelope.html#LassoSoapEnvelope" title="struct LassoSoapEnvelope"><span class="returnvalue">LassoSoapEnvelope</span></a> * lasso_idwsf2_profile_get_soap_envelope_request
123
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);</pre>
148
Return the last parsed SOAP request object.</p>
125
Return the last parsed SOAP request object.
149
127
<div class="variablelist"><table border="0">
150
128
<col align="left" valign="top">
153
131
<td><p><span class="term"><em class="parameter"><code>idwsf2_profile</code></em> :</span></p></td>
154
<td> a <span class="type">LassoIdWsf2Profile</span> object
132
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
135
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
136
<td>a <a class="link" href="lasso-LassoSoapEnvelope.html#LassoSoapEnvelope" title="struct LassoSoapEnvelope"><span class="type">LassoSoapEnvelope</span></a> object or NULL if no request as ever been
137
parsed with this object. You must free this object. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
158
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
159
<td>transfer none. <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=transfer"><span class="acronym">transfer</span></a> none. </td>
165
<div class="refsect2" title="lasso_idwsf2_profile_get_soap_envelope_response ()">
144
<div class="refsect2">
166
145
<a name="lasso-idwsf2-profile-get-soap-envelope-response"></a><h3>lasso_idwsf2_profile_get_soap_envelope_response ()</h3>
167
<pre class="programlisting">LassoSoapEnvelope* lasso_idwsf2_profile_get_soap_envelope_response
168
(LassoIdWsf2Profile *idwsf2_profile);</pre>
146
<pre class="programlisting"><a class="link" href="lasso-LassoSoapEnvelope.html#LassoSoapEnvelope" title="struct LassoSoapEnvelope"><span class="returnvalue">LassoSoapEnvelope</span></a> * lasso_idwsf2_profile_get_soap_envelope_response
147
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);</pre>
170
Return the last parsed SOAP response object.</p>
149
Return the last parsed SOAP response object.
171
151
<div class="variablelist"><table border="0">
172
152
<col align="left" valign="top">
175
155
<td><p><span class="term"><em class="parameter"><code>idwsf2_profile</code></em> :</span></p></td>
176
<td> a <span class="type">LassoIdWsf2Profile</span> object
156
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
159
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
160
<td>a <a class="link" href="lasso-LassoSoapEnvelope.html#LassoSoapEnvelope" title="struct LassoSoapEnvelope"><span class="type">LassoSoapEnvelope</span></a> object or NULL if no response as ever been
161
parsed with this objects. You must free this object. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
180
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
181
<td>transfer none. <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=transfer"><span class="acronym">transfer</span></a> none. </td>
187
<div class="refsect2" title="lasso_idwsf2_profile_init_request ()">
168
<div class="refsect2">
188
169
<a name="lasso-idwsf2-profile-init-request"></a><h3>lasso_idwsf2_profile_init_request ()</h3>
189
<pre class="programlisting">lasso_error_t lasso_idwsf2_profile_init_request (LassoIdWsf2Profile *profile);</pre>
170
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span> lasso_idwsf2_profile_init_request (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>);</pre>
191
Initialize a new SOAP ID-WSF 2.0 request. Clear the existing request if one is currently set.</p>
172
Initialize a new SOAP ID-WSF 2.0 request. Clear the existing request if one is currently set.
192
174
<div class="variablelist"><table border="0">
193
175
<col align="left" valign="top">
196
178
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
197
<td> a <span class="type">LassoIdWsf2Profile</span> object
179
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
201
182
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
202
<td> 0 if successful, an error code otherwise.
183
<td>0 if successful, an error code otherwise.</td>
209
<div class="refsect2" title="lasso_idwsf2_profile_build_request_msg ()">
189
<div class="refsect2">
210
190
<a name="lasso-idwsf2-profile-build-request-msg"></a><h3>lasso_idwsf2_profile_build_request_msg ()</h3>
211
<pre class="programlisting">lasso_error_t lasso_idwsf2_profile_build_request_msg
212
(LassoIdWsf2Profile *profile,
213
const char *security_mech_id);</pre>
191
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span> lasso_idwsf2_profile_build_request_msg
192
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
193
<em class="parameter"><code>const <span class="type">char</span> *security_mech_id</code></em>);</pre>
215
195
Serialize and sign, if needed, the SOAP request message, put the result in
221
FIXME: really do sign messages.</p>
201
FIXME: really do sign messages.
222
203
<div class="variablelist"><table border="0">
223
204
<col align="left" valign="top">
226
207
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
227
<td> a <span class="type">LassoIdWsf2Profile</span> object
208
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
231
211
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
232
<td> 0 if successful, LASSO_PROFILE_ERROR_BUILDING_REQUEST_FAILED.
212
<td>0 if successful, LASSO_PROFILE_ERROR_BUILDING_REQUEST_FAILED.</td>
239
<div class="refsect2" title="lasso_idwsf2_profile_process_request_msg ()">
218
<div class="refsect2">
240
219
<a name="lasso-idwsf2-profile-process-request-msg"></a><h3>lasso_idwsf2_profile_process_request_msg ()</h3>
241
<pre class="programlisting">lasso_error_t lasso_idwsf2_profile_process_request_msg
242
(LassoIdWsf2Profile *profile,
243
const char *msg);</pre>
220
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span> lasso_idwsf2_profile_process_request_msg
221
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
222
<em class="parameter"><code>const <span class="type">char</span> *msg</code></em>);</pre>
245
Parse a SOAP request message and initialize the SOAP Envelope for the response.</p>
224
Parse a SOAP request message and initialize the SOAP Envelope for the response.
246
226
<div class="variablelist"><table border="0">
247
227
<col align="left" valign="top">
250
230
<td><p><span class="term"><em class="parameter"><code>wsf2_profile</code></em> :</span></p></td>
251
<td> a <span class="type">LassoIdWsf2Profile</span> object
231
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
255
234
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
256
<td> a received SOAP message
235
<td>a received SOAP message</td>
260
238
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
261
<td> 0 if successful, an error code otherwise among:
239
<td>0 if successful, an error code otherwise among:
262
240
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
263
<li class="listitem"><p>LASSO_PARAM_ERROR_BAD_TYPE_OR_NULL_OBJ if <em class="parameter"><code>profile</code></em> is not a <span class="type">LassoIdWsf2Profile</span>
241
<li class="listitem"><p>LASSO_PARAM_ERROR_BAD_TYPE_OR_NULL_OBJ if <em class="parameter"><code>profile</code></em> is not a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a>
265
243
<li class="listitem"><p>LASSO_PARAM_ERROR_INVALID_VALUE if message is NULL,</p></li>
266
244
<li class="listitem"><p>LASSO_PROFILE_ERROR_INVALID_MSG if we cannot parse the message,</p></li>
276
<div class="refsect2" title="lasso_idwsf2_profile_check_security_mechanism ()">
254
<div class="refsect2">
277
255
<a name="lasso-idwsf2-profile-check-security-mechanism"></a><h3>lasso_idwsf2_profile_check_security_mechanism ()</h3>
278
<pre class="programlisting">lasso_error_t lasso_idwsf2_profile_check_security_mechanism
279
(LassoIdWsf2Profile *profile,
280
const char *security_mech_id);</pre>
256
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span> lasso_idwsf2_profile_check_security_mechanism
257
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
258
<em class="parameter"><code>const <span class="type">char</span> *security_mech_id</code></em>);</pre>
282
260
Check ID-WSF 2.0 Security Mechanism upon the received request. It is mandatory that a
283
<span class="type">LassoServer</span> is setted for the <em class="parameter"><code>profile</code></em> object.</p>
261
<a class="link" href="lasso-LassoServer.html#LassoServer" title="struct LassoServer"><span class="type">LassoServer</span></a> is setted for the <em class="parameter"><code>profile</code></em> object.
284
263
<div class="variablelist"><table border="0">
285
264
<col align="left" valign="top">
288
267
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
289
<td> a <span class="type">LassoIdWsf2Profile</span> object
268
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
293
271
<td><p><span class="term"><em class="parameter"><code>security_mech_id:(allow-none)</code></em> :</span></p></td>
294
<td> the security mechanism to enforce, if none is provided Bearer is
272
<td>the security mechanism to enforce, if none is provided Bearer is
299
276
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
300
<td> 0 if the request passed the check, an error code otherwise.
277
<td>0 if the request passed the check, an error code otherwise.</td>
307
<div class="refsect2" title="lasso_idwsf2_profile_get_name_identifier ()">
283
<div class="refsect2">
308
284
<a name="lasso-idwsf2-profile-get-name-identifier"></a><h3>lasso_idwsf2_profile_get_name_identifier ()</h3>
309
<pre class="programlisting">LassoNode * lasso_idwsf2_profile_get_name_identifier
310
(LassoIdWsf2Profile *idwsf2_profile);</pre>
285
<pre class="programlisting"><a class="link" href="lasso-node.html#LassoNode" title="struct LassoNode"><span class="returnvalue">LassoNode</span></a> * lasso_idwsf2_profile_get_name_identifier
286
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);</pre>
312
288
Return the NameIdentifier found in a WS-Security authentication token, when Bearer or SAML
313
289
security mechanism is used. This method does not validate any security conditions on the
315
292
<div class="variablelist"><table border="0">
316
293
<col align="left" valign="top">
319
296
<td><p><span class="term"><em class="parameter"><code>idwsf2_profile</code></em> :</span></p></td>
320
<td> a <span class="type">LassoIdWsf2Profile</span> object
297
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
300
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
301
<td>a <a class="link" href="lasso-node.html#LassoNode" title="struct LassoNode"><span class="type">LassoNode</span></a> object or NULL. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
324
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
325
<td> a <span class="type">LassoNode</span> object or NULL.. <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=transfer"><span class="acronym">transfer</span></a> full. <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=allow-none"><span class="acronym">allow-none</span></a> full. </td>
331
<div class="refsect2" title="lasso_idwsf2_profile_init_response ()">
308
<div class="refsect2">
332
309
<a name="lasso-idwsf2-profile-init-response"></a><h3>lasso_idwsf2_profile_init_response ()</h3>
333
<pre class="programlisting">lasso_error_t lasso_idwsf2_profile_init_response (LassoIdWsf2Profile *profile);</pre>
310
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span> lasso_idwsf2_profile_init_response (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>);</pre>
335
Initialize a new SOAP ID-WSF 2.0 response. Clear the existing response if one is currently set.</p>
312
Initialize a new SOAP ID-WSF 2.0 response. Clear the existing response if one is currently set.
336
314
<div class="variablelist"><table border="0">
337
315
<col align="left" valign="top">
340
318
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
341
<td> a <span class="type">LassoIdWsf2Profile</span> object
319
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
345
322
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
346
<td> 0 if successful, an error code otherwise.
323
<td>0 if successful, an error code otherwise.</td>
353
<div class="refsect2" title="lasso_idwsf2_profile_init_soap_fault_response ()">
329
<div class="refsect2">
354
330
<a name="lasso-idwsf2-profile-init-soap-fault-response"></a><h3>lasso_idwsf2_profile_init_soap_fault_response ()</h3>
355
<pre class="programlisting">lasso_error_t lasso_idwsf2_profile_init_soap_fault_response
356
(LassoIdWsf2Profile *profile,
357
const char *faultcode,
358
const char *faultstring,
360
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
361
>GList</a> *details);</pre>
331
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span> lasso_idwsf2_profile_init_soap_fault_response
332
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
333
<em class="parameter"><code>const <span class="type">char</span> *faultcode</code></em>,
334
<em class="parameter"><code>const <span class="type">char</span> *faultstring</code></em>,
335
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *details</code></em>);</pre>
363
Initialize a new SOAP 1.1 fault.</p>
337
Initialize a new SOAP 1.1 fault.
364
339
<div class="variablelist"><table border="0">
365
340
<col align="left" valign="top">
368
343
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
369
<td> a <span class="type">LassoIdWsf2Profile</span> object
344
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
373
347
<td><p><span class="term"><em class="parameter"><code>faultcode</code></em> :</span></p></td>
374
<td> a SOAP fault code, see <span class="type">LASSO_SOAP_FAULT_CLIENT</span>, <span class="type">LASSO_SOAP_FAULT_SERVER</span>.
348
<td>a SOAP fault code, see <span class="type">LASSO_SOAP_FAULT_CLIENT</span>, <span class="type">LASSO_SOAP_FAULT_SERVER</span>.</td>
378
351
<td><p><span class="term"><em class="parameter"><code>faultstring:(allow-none)</code></em> :</span></p></td>
379
<td> a human description of the error
352
<td>a human description of the error</td>
383
355
<td><p><span class="term"><em class="parameter"><code>details</code></em> :</span></p></td>
384
<td>allow-none)(element-type LassoNode. <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=allow-none"><span class="acronym">allow-none</span></a>. <acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> LassoNode. </td>
356
<td>complementary data describing the error, you can use
357
<a class="link" href="lasso-LassoIdWsf2UtilStatus.html#LassoIdWsf2UtilStatus" title="struct LassoIdWsf2UtilStatus"><span class="type">LassoIdWsf2UtilStatus</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> LassoNode]</span>
387
361
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
388
<td> 0 if successful, an error code otherwise.
362
<td>0 if successful, an error code otherwise.</td>
395
<div class="refsect2" title="lasso_idwsf2_profile_redirect_user_for_interaction ()">
368
<div class="refsect2">
396
369
<a name="lasso-idwsf2-profile-redirect-user-for-interaction"></a><h3>lasso_idwsf2_profile_redirect_user_for_interaction ()</h3>
397
<pre class="programlisting">lasso_error_t lasso_idwsf2_profile_redirect_user_for_interaction
398
(LassoIdWsf2Profile *profile,
400
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
401
>gchar</a> *redirect_url,
403
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
404
>gboolean</a> for_data);</pre>
370
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span> lasso_idwsf2_profile_redirect_user_for_interaction
371
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
372
<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> *redirect_url</code></em>,
373
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> for_data</code></em>);</pre>
406
375
Create a SOAP fault containing a RedirectRequest element, with a redirectURL property set to
407
376
<em class="parameter"><code>redirect_url</code></em> concatenated with the parameter "transactionID" set to the messageID of the
408
response message.</p>
409
379
<div class="variablelist"><table border="0">
410
380
<col align="left" valign="top">
413
383
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
414
<td> a <span class="type">LassoIdWsf2Profile</span> object
384
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
418
387
<td><p><span class="term"><em class="parameter"><code>redirect_url</code></em> :</span></p></td>
419
<td> an URL where the user must be redirected
388
<td>an URL where the user must be redirected</td>
423
391
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
424
<td> 0 if successful, an error code otherwise.
392
<td>0 if successful, an error code otherwise.</td>
431
<div class="refsect2" title="lasso_idwsf2_profile_build_response_msg ()">
398
<div class="refsect2">
432
399
<a name="lasso-idwsf2-profile-build-response-msg"></a><h3>lasso_idwsf2_profile_build_response_msg ()</h3>
433
<pre class="programlisting">lasso_error_t lasso_idwsf2_profile_build_response_msg
434
(LassoIdWsf2Profile *profile);</pre>
400
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span> lasso_idwsf2_profile_build_response_msg
401
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>);</pre>
436
403
Serialize and sign the SOAP, if needed, the response message, put the result in
438
405
<pre class="programlisting">LASSO_PROFILE(profile)->msg_body</pre>
440
408
<div class="variablelist"><table border="0">
441
409
<col align="left" valign="top">
444
412
<td><p><span class="term"><em class="parameter"><code>idwsf2_profile</code></em> :</span></p></td>
445
<td> a <span class="type">LassoIdWsf2Profile</span> object
413
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
449
416
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
450
<td> 0 if successful, LASSO_PROFILE_ERROR_BUILDING_RESPONSE_FAILED otherwise.
417
<td>0 if successful, LASSO_PROFILE_ERROR_BUILDING_RESPONSE_FAILED otherwise.</td>
457
<div class="refsect2" title="lasso_idwsf2_profile_process_response_msg ()">
423
<div class="refsect2">
458
424
<a name="lasso-idwsf2-profile-process-response-msg"></a><h3>lasso_idwsf2_profile_process_response_msg ()</h3>
459
<pre class="programlisting">lasso_error_t lasso_idwsf2_profile_process_response_msg
460
(LassoIdWsf2Profile *profile,
461
const char *msg);</pre>
425
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span> lasso_idwsf2_profile_process_response_msg
426
(<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
427
<em class="parameter"><code>const <span class="type">char</span> *msg</code></em>);</pre>
463
Parse a response received by SOAP. Place the parsed message in the <span class="type">LassoIdWsf2Profile</span> structure
464
in the <em class="parameter"><code>soap_envelope_response</code></em> field and the content of the body in the <em class="parameter"><code>response</code></em> field.</p>
429
Parse a response received by SOAP. Place the parsed message in the <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> structure
430
in the <em class="parameter"><code>soap_envelope_response</code></em> field and the content of the body in the <em class="parameter"><code>response</code></em> field.
465
432
<div class="variablelist"><table border="0">
466
433
<col align="left" valign="top">
469
436
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
470
<td> a <span class="type">LassoIdWsf2Profile</span> object
437
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
474
440
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
475
<td> a string containing a response message
441
<td>a string containing a response message</td>
479
444
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
480
<td> 0 if successful, one of those error codes if the call fails: <div class="itemizedlist"><ul class="itemizedlist" type="disc">
445
<td>0 if successful, one of those error codes if the call fails: <div class="itemizedlist"><ul class="itemizedlist" type="disc">
481
446
<li class="listitem"><p>LASSO_PARAM_ERROR_BAD_TYPE_OR_NULL_OBJ if first parameter is not
482
a <span class="type">LassoIdWsf2Profile</span> object,</p></li>
447
a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object,</p></li>
483
448
<li class="listitem"><p>LASSO_PARAM_ERROR_INVALID_VALUE if message is NULL,</p></li>
484
449
<li class="listitem"><p>LASSO_SOAP_ERROR_MISSING_BODY if no body element is found,</p></li>
485
450
<li class="listitem"><p>LASSO_PROFILE_ERROR_MISSING_RESPONSE if the body element is