lemonldap-ng/build/lemonldap-ng/doc/4.4-SOAP-session-backend.html
Clément Oudot 34ea9bacd1 Doc: add DBI
2010-03-22 14:41:35 +00:00

162 lines
4.2 KiB
HTML

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
<head>
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org" />
<title>Lemonldap::NG documentation: 4.4-SOAP-session-backend.html</title>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<style type="text/css">
/*<![CDATA[*/
body{
background: #ddd;
font-family: sans-serif;
font-size: 11pt;
padding: 0 50px;
}
div.main-content{
padding: 10px;
background: #fff;
border: 2px #ccc solid;
}
a{
text-decoration: none;
}
p.footer{
text-align: center;
margin: 5px 0 0 0;
}
.heading-1{
text-align: center;
color: orange;
font-variant: small-caps;
font-size: 20pt;
}
.heading-1-1{
color: orange;
font-size: 14pt;
border-bottom: 2px #ccc solid;
}
pre{
background: #eee;
border: 2px #ccc solid;
padding: 5px;
border-left: 10px #ccc solid;
}
ul.star li{
list-style-type: square;
}
/*]]>*/
</style>
</head>
<body>
<div class="main-content">
<h2 class="heading-1"><span id="HSOAPSessionbackend">SOAP Session
backend</span></h2>
<p class="paragraph"></p>This documentation is available only for version
0.9.4 and later. For earlier versions, see the documentation in the source
tree.
<p class="paragraph"></p>
<ul>
<li><a href="#HPresentation">Presentation</a></li>
<li>
<a href="#HConfiguration">Configuration</a>
<ul>
<li><a href="#HMainPortal">Main Portal</a></li>
<li><a href="#HRemotecomponents">Remote components</a></li>
</ul>
</li>
</ul>
<h3 class="heading-1-1"><span id="HPresentation">Presentation</span></h3>
<p class="paragraph"></p>As the <span class="wikilink"><a href=
"4.3-SOAP-configuration-backend.html">SOAP Configuration
backend</a></span>, the SOAP Session backend allow distant access to
session database.
<p class="paragraph"></p>To work, the main Portal will have a direct
access to the real session database (for example files, MySQL or LDAP).
Remote components will send SOAP request to main portal to read and write
sessions.
<h3 class="heading-1-1"><span id=
"HConfiguration">Configuration</span></h3>
<h4 class="heading-1-1-1"><span id="HMainPortal">Main Portal</span></h4>
<p class="paragraph"></p>To activate SOAP in main Portal, just set:
<div class="code">
<pre>
Soap =&gt; 1,
</pre>
</div><br />
<br />
You have also to override the configuration of session database, with a
file backend for example:
<div class="code">
<pre>
globalStorage =&gt; 'Apache::Session::File',
globalStorageOptions =&gt; {
Directory =&gt; '/<span class=
"java-keyword">var</span>/lib/lemonldap-ng/sessions/',
LockDirectory =&gt; '/<span class=
"java-keyword">var</span>/lib/lemonldap-ng/sessions/lock/',
}
</pre>
</div>
<p class="paragraph"></p>You have also to update Apache configuration to
allow SOAP requests. Add this in the main Portal virtual host:
<div class="code">
<pre>
&lt;Location /index.pl/sessions&gt;
Order deny,allow
Deny from all
Allow from *remote servers*
&lt;/Location&gt;
</pre>
</div>
<h4 class="heading-1-1-1"><span id="HRemotecomponents">Remote
components</span></h4>
<p class="paragraph"></p>Remote components will use the main
configuration. So use the Manager to configure the session database with
this value:
<div class="code">
<pre>
Lemonldap::NG::Common::Apache::Session::SOAP
</pre>
</div><br />
<br />
Set also this Session Storage option:
<div class="code">
<pre>
proxy =&gt; 'http://auth.example.com/index.pl/sessions'
</pre>
</div><br />
<br />
No other parameters needed. It will send SOAP request to configured proxy
URL.
</div>
<p class="footer"><a href="index.html">Index</a></p>
</body>
</html>