3
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
4
<title>LassoLibAuthnRequest</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="xml.html" title="Schemas">
8
<link rel="prev" href="LassoLibAuthnContext.html" title="LassoLibAuthnContext">
9
<link rel="next" href="lasso-LassoLibAuthnRequestEnvelope.html" title="LassoLibAuthnRequestEnvelope">
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 & 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">
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="LassoLibAuthnContext.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
22
<td><a accesskey="u" href="xml.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="lasso-LassoLibAuthnRequestEnvelope.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
27
<div class="refentry" lang="en">
28
<a name="LassoLibAuthnRequest"></a><div class="titlepage"></div>
29
<div class="refnamediv"><table width="100%"><tr>
31
<h2><span class="refentrytitle">LassoLibAuthnRequest</span></h2>
32
<p>LassoLibAuthnRequest — <lib:AuthnRequest></p>
34
<td valign="top" align="right"></td>
36
<div class="refsynopsisdiv">
38
<pre class="synopsis">
40
#include <lasso/lasso.h>
43
<a href="LassoLibAuthnRequest.html#LassoLibAuthnRequest-struct">LassoLibAuthnRequest</a>;
44
<a href="LassoLibAuthnRequest.html" title="LassoLibAuthnRequest">LassoLibAuthnRequest</a>* <a href="LassoLibAuthnRequest.html#lasso-lib-authn-request-new">lasso_lib_authn_request_new</a>
49
<div class="refsect1" lang="en">
50
<a name="id2562152"></a><h2>Object Hierarchy</h2>
51
<pre class="synopsis">
53
<GTKDOCLINK HREF="GObject">GObject</GTKDOCLINK>
54
+----<a href="LassoNode.html" title="LassoNode">LassoNode</a>
55
+----<a href="LassoSamlpRequestAbstract.html" title="LassoSamlpRequestAbstract">LassoSamlpRequestAbstract</a>
56
+----LassoLibAuthnRequest
59
<div class="refsect1" lang="en">
60
<a name="id2562584"></a><h2>Description</h2>
62
Authentication requests are sent from a service provider to an identity
66
<div class="refsect1" lang="en">
67
<a name="id2562595"></a><h2>Details</h2>
68
<div class="refsect2" lang="en">
69
<a name="id2562601"></a><h3>
70
<a name="LassoLibAuthnRequest-struct"></a>LassoLibAuthnRequest</h3>
71
<a class="indexterm" name="id2562612"></a><pre class="programlisting">typedef struct {
72
/* <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/> */
74
/* <xs:element ref="ProviderID"/> */
76
/* <xs:element ref="AffiliationID" minOccurs="0"/> */
78
/* <xs:element ref="NameIDPolicy" minOccurs="0"/> */
80
/* <xs:element name="ForceAuthn" type="xs:boolean" minOccurs="0"/> */
82
/* <xs:element name="IsPassive" type="xs:boolean "minOccurs="0"/> */
84
/* <xs:element ref="ProtocolProfile" minOccurs="0"/> */
85
char *ProtocolProfile;
86
/* <xs:element name="AssertionConsumerServiceID" type="xs:string" minOccurs="0"/> */
87
char *AssertionConsumerServiceID;
88
/* <xs:element ref="RequestAuthnContext" minOccurs="0"/> */
89
LassoLibRequestAuthnContext *RequestAuthnContext;
90
/* <xs:element ref="RelayState" minOccurs="0"/> */
92
/* <xs:element ref="Scoping" minOccurs="0 "/> */
93
LassoLibScoping *Scoping;
94
/* <xs:attribute ref="consent" use="optional"/> */
96
} LassoLibAuthnRequest;
99
<em class="parameter"><code>ProviderID</code></em> is the service provider identifier, this field will often be filled
100
with <a href="LassoLogin.html#lasso-login-init-authn-request"><code class="function">lasso_login_init_authn_request()</code></a>.
103
<em class="parameter"><code>nameIDPolicy</code></em> tells the identity provider about the policy to use for
104
federation; it must be one of <a href="lasso-strings.html#LASSO-LIB-NAMEID-POLICY-TYPE-NONE:CAPS"><span class="type">LASSO_LIB_NAMEID_POLICY_TYPE_NONE</span></a>,
105
<a href="lasso-strings.html#LASSO-LIB-NAMEID-POLICY-TYPE-ONE-TIME:CAPS"><span class="type">LASSO_LIB_NAMEID_POLICY_TYPE_ONE_TIME</span></a>, <a href="lasso-strings.html#LASSO-LIB-NAMEID-POLICY-TYPE-FEDERATED:CAPS"><span class="type">LASSO_LIB_NAMEID_POLICY_TYPE_FEDERATED</span></a>
106
or <a href="lasso-strings.html#LASSO-LIB-NAMEID-POLICY-TYPE-ANY:CAPS"><span class="type">LASSO_LIB_NAMEID_POLICY_TYPE_ANY</span></a>.
109
<em class="parameter"><code>IsPassive</code></em>; if <code class="literal">TRUE</code> (default) it tells the identity provider not to interact
113
<em class="parameter"><code>ForceAuthn</code></em>; only used if <em class="parameter"><code>IsPassive</code></em> is <code class="literal">FALSE</code>, it tells the identity provider
114
to force authentication of the user even when already authenticated.
117
<em class="parameter"><code>ProtocolProfile</code></em> is the Single Sign-On and Federation profile to adopt; either
118
<a href="lasso-strings.html#LASSO-LIB-PROTOCOL-PROFILE-BRWS-ART:CAPS"><span class="type">LASSO_LIB_PROTOCOL_PROFILE_BRWS_ART</span></a> (which is the default value) or
119
<a href="lasso-strings.html#LASSO-LIB-PROTOCOL-PROFILE-BRWS-POST:CAPS"><span class="type">LASSO_LIB_PROTOCOL_PROFILE_BRWS_POST</span></a>.
123
<div class="refsect2" lang="en">
124
<a name="id2562806"></a><h3>
125
<a name="lasso-lib-authn-request-new"></a>lasso_lib_authn_request_new ()</h3>
126
<a class="indexterm" name="id2562818"></a><pre class="programlisting"><a href="LassoLibAuthnRequest.html" title="LassoLibAuthnRequest">LassoLibAuthnRequest</a>* lasso_lib_authn_request_new
129
Creates a new <a href="LassoLibAuthnRequest.html" title="LassoLibAuthnRequest"><span class="type">LassoLibAuthnRequest</span></a> object.</p>
133
<div class="variablelist"><table border="0">
134
<col align="left" valign="top">
137
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
138
<td> a newly created <a href="LassoLibAuthnRequest.html" title="LassoLibAuthnRequest"><span class="type">LassoLibAuthnRequest</span></a> object
144
<div class="refsect1" lang="en">
145
<a name="id2562877"></a><h2>See Also</h2>
148
<div class="variablelist"><table border="0">
149
<col align="left" valign="top">
152
<span class="term"><a href="LassoLogin.html" title="LassoLogin"><span class="type">LassoLogin</span></a></span></td>
153
<td><p>Class for Single Sign-On and Federation
161
<table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle">
162
<td align="left"><a accesskey="p" href="LassoLibAuthnContext.html"><b><< LassoLibAuthnContext</b></a></td>
163
<td align="right"><a accesskey="n" href="lasso-LassoLibAuthnRequestEnvelope.html"><b>LassoLibAuthnRequestEnvelope >></b></a></td>