175 lines
7.9 KiB
HTML
175 lines
7.9 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="fr" dir="ltr">
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
|
<meta charset="utf-8" />
|
|
<title>documentation:2.0:soapsessionbackend</title><!-- //if:usedebianlibs
|
|
<link rel="stylesheet" type="text/css" href="/javascript/bootstrap/css/bootstrap.min.css" />
|
|
//elsif:useexternallibs
|
|
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css"></script>
|
|
//elsif:cssminified
|
|
<link rel="stylesheet" type="text/css" href="/static/bwr/bootstrap/dist/css/bootstrap.min.css" />
|
|
//else --><!-- //endif -->
|
|
<meta name="generator" content="DokuWiki"/>
|
|
<meta name="robots" content="index,follow"/>
|
|
<meta name="keywords" content="documentation,2.0,soapsessionbackend"/>
|
|
<link rel="search" type="application/opensearchdescription+xml" href="lib/exe/opensearch.html" title="LemonLDAP::NG"/>
|
|
<link rel="start" href="soapsessionbackend.html"/>
|
|
<link rel="contents" href="soapsessionbackend.html" title="Sitemap"/>
|
|
<link rel="stylesheet" type="text/css" href="lib/exe/css.php.t.bootstrap3.css"/>
|
|
|
|
<link rel="stylesheet" type="text/css" href="/static/bwr/bootstrap/dist/css/bootstrap.css" />
|
|
|
|
<script type="text/javascript">/*<![CDATA[*/var NS='documentation:2.0';var JSINFO = {"id":"documentation:2.0:soapsessionbackend","namespace":"documentation:2.0"};
|
|
/*!]]>*/</script>
|
|
<script type="text/javascript" charset="utf-8" src="lib/exe/js.php.t.bootstrap3.js"></script><!-- //if:usedebianlibs
|
|
<script type="text/javascript" src="/javascript/jquery/jquery.min.js"></script>
|
|
//elsif:useexternallibs
|
|
<script type="text/javascript" src="http://code.jquery.com/jquery-2.2.0.min.js"></script>
|
|
//elsif:jsminified
|
|
<script type="text/javascript" src="/static/bwr/jquery/dist/jquery.min.js"></script>
|
|
//else -->
|
|
|
|
<script type="text/javascript" src="/static/bwr/jquery/dist/jquery.js"></script><!-- //endif --><!-- //if:usedebianlibs
|
|
<script type="text/javascript" src="/javascript/jquery-ui/jquery-ui.min.js"></script>
|
|
//elsif:useexternallibs
|
|
<script type="text/javascript" src="http://code.jquery.com/ui/1.10.4/jquery-ui.min.js"></script>
|
|
//elsif:jsminified
|
|
<script type="text/javascript" src="/lib/scripts/jquery-ui.min.js"></script>
|
|
//else -->
|
|
|
|
|
|
<script type="text/javascript" src="/lib/scripts/jquery-ui.js"></script><!-- //endif -->
|
|
|
|
</head>
|
|
<body>
|
|
<div class="dokuwiki export container"><!-- TOC START -->
|
|
|
|
<div id="dw__toc">
|
|
<h3 class="toggle">Table of Contents</h3>
|
|
<div>
|
|
|
|
<ul class="toc">
|
|
<li class="level1"><div class="li"><a href="#setup">Mise en marche</a></div>
|
|
<ul class="toc">
|
|
<li class="level2"><div class="li"><a href="#manager">Manager</a></div></li>
|
|
<li class="level2"><div class="li"><a href="#apache">Apache</a></div></li>
|
|
<li class="level2"><div class="li"><a href="#real_session_backend">Backend de session réel</a></div></li>
|
|
</ul></li>
|
|
</ul>
|
|
</div>
|
|
</div><!-- TOC END -->
|
|
|
|
|
|
<h1 class="sectionedit1" id="soap_session_backend">Backend de sessions SOAP</h1>
|
|
<div class="level1">
|
|
|
|
<p>
|
|
<abbr title="LemonLDAP::NG">LL::NG</abbr> portal provides SOAP end points for sessions management:
|
|
|
|
</p>
|
|
<ul>
|
|
<li class="level1"><div class="li"> <strong>sessions/</strong> : accès en lecture seule aux sessions (suffisant pour les agents distants)</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> <strong>adminSessions/</strong> : accès en lecture/écriture aux sessions (nécessaire pour les portails ou manager distants ou les handlers distants qui modifient les sessions)</div>
|
|
</li>
|
|
</ul>
|
|
|
|
<p>
|
|
|
|
This session backend can be used to share sessions stored in a non-network backend (like <a href="filesessionbackend.html" class="wikilink1" title="documentation:2.0:filesessionbackend">file session backend</a>) or in a network backend protected with a firewall that only accepts HTTP flows.
|
|
|
|
</p>
|
|
|
|
<p>
|
|
|
|
Most of the time, SOAP session backend is used by Handlers installed on external servers.
|
|
|
|
</p>
|
|
|
|
<p>
|
|
|
|
To configure it, SOAP session backend will be set trough Manager in global configuration (used by all Hanlders), and the real session backend will be configured for local components in lemonldap-ng.ini.
|
|
|
|
</p>
|
|
|
|
</div><!-- EDIT1 SECTION "SOAP session backend" [1-832] -->
|
|
|
|
<h2 class="sectionedit2" id="setup">Mise en marche</h2>
|
|
<div class="level2">
|
|
|
|
</div><!-- EDIT2 SECTION "Setup" [833-851] -->
|
|
|
|
<h3 class="sectionedit3" id="manager">Manager</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
|
|
First, active SOAP in <code>General parameters</code> » <code>Advanced parameters</code> » <code>SOAP</code>.
|
|
|
|
</p>
|
|
|
|
<p>
|
|
|
|
Then, set <code>Lemonldap::NG::Common::Apache::Session::SOAP</code> in <code>General parameters</code> » <code>Sessions</code> » <code>Session storage</code> » <code>Apache::Session module</code> and add the following parameters (case sensitive):
|
|
|
|
</p>
|
|
<div class="table sectionedit4"><table class="inline table table-bordered table-striped">
|
|
<thead>
|
|
<tr class="row0 roweven">
|
|
<th class="col0 centeralign" colspan="3"> Paramètres exigés </th>
|
|
</tr>
|
|
<tr class="row1 rowodd">
|
|
<th class="col0 centeralign"> Nom </th><th class="col1 centeralign"> Commentaire </th><th class="col2 centeralign"> Exemple </th>
|
|
</tr>
|
|
</thead>
|
|
<tr class="row2 roweven">
|
|
<td class="col0 centeralign"> <strong>proxy</strong> </td><td class="col1"> <abbr title="Uniform Resource Locator">URL</abbr> of sessions SOAP end point </td><td class="col2"> http://auth.example.com/index.fcgi/sessions </td>
|
|
</tr>
|
|
</table></div><!-- EDIT4 TABLE [1163-1324] -->
|
|
<div class="notetip">Utiliser /adminSessions si l'agent doit modifier la session, par exemple si on configure un délai d'inactivité des sessions.
|
|
</div>
|
|
</div><!-- EDIT3 SECTION "Manager" [852-1452] -->
|
|
|
|
<h3 class="sectionedit5" id="apache">Apache</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
|
|
Sessions SOAP end points access must be allowed in Apache portal configuration (for example, access by <abbr title="Internet Protocol">IP</abbr> range):
|
|
|
|
</p>
|
|
<pre class="code file apache"><span class="co1"># SOAP functions for sessions management (disabled by default)</span>
|
|
<<span class="kw3">Location</span> /index.fcgi/adminSessions>
|
|
<span class="kw1">Require</span> 192.168.2.0/<span class="nu0">24</span>
|
|
</<span class="kw3">Location</span>>
|
|
|
|
<span class="co1"># SOAP functions for sessions access (disabled by default)</span>
|
|
<<span class="kw3">Location</span> /index.fcgi/sessions>
|
|
<span class="kw1">Require</span> 192.168.2.0/<span class="nu0">24</span>
|
|
</<span class="kw3">Location</span>></pre>
|
|
|
|
</div><!-- EDIT5 SECTION "Apache" [1453-1878] -->
|
|
|
|
<h3 class="sectionedit6" id="real_session_backend">Backend de session réel</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
|
|
Real session backend will be configured in <code>lemonldap-ng.ini</code>, in <code>portal</code> section (the portal hosts the SOAP service for sessions, and will do the link between SOAP requests and real sessions).
|
|
|
|
</p>
|
|
|
|
<p>
|
|
Par exemple, si les sessions réelels sont stockées dans des <a href="filesessionbackend.html" class="wikilink1" title="documentation:2.0:filesessionbackend">fichiers</a> :
|
|
</p>
|
|
<pre class="code file ini"><span class="re0"><span class="br0">[</span>portal<span class="br0">]</span></span>
|
|
<span class="re1">globalStorage</span> <span class="sy0">=</span><span class="re2"> Apache::Session::File</span>
|
|
<span class="re1">globalStorageOptions</span> <span class="sy0">=</span><span class="re2"> <span class="br0">{</span> 'Directory' <span class="sy0">=</span>> '/var/lib/lemonldap-ng/sessions/', 'LockDirectory' <span class="sy0">=</span>> '/var/lib/lemonldap-ng/sessions/lock/', <span class="br0">}</span></span></pre>
|
|
<div class="notetip">Si l'explorateur de sessions est sur le même serveur que le portail, utiliser soit la terminaison <strong>adminSessions</strong> dans la configuration eu manager, ou surcharger les paramètres <code>globalStorage</code> et <code>globalStorageOptions</code> dans la section all (et pas portal) de <code>lemonldap-ng.ini</code>.
|
|
</div>
|
|
</div><!-- EDIT6 SECTION "Real session backend" [1879-] -->
|
|
</div>
|
|
</body>
|
|
</html>
|