239 lines
8.4 KiB
HTML
239 lines
8.4 KiB
HTML
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
|
|
lang="en" dir="ltr">
|
|
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title></title>
|
|
<!-- metadata -->
|
|
<meta name="generator" content="Offline" />
|
|
<meta name="version" content="Offline 0.1" />
|
|
<!-- style sheet links -->
|
|
<link rel="stylesheet" media="all" type="text/css" href="../../../../css/all.css" />
|
|
<link rel="stylesheet" media="screen" type="text/css" href="../../../../css/screen.css" />
|
|
<link rel="stylesheet" media="print" type="text/css" href="../../../../css/print.css" />
|
|
|
|
</head>
|
|
<body>
|
|
<div class="dokuwiki export">
|
|
|
|
|
|
<h1 class="sectionedit1" id="liferay">Liferay</h1>
|
|
<div class="level1">
|
|
|
|
<p>
|
|
<a href="/_detail/applications/liferay_logo.png?id=documentation%3A2.0%3Aapplications%3Aliferay" class="media" title="applications:liferay_logo.png"><img src="../../../../media/icons/kmultiple.png" class="mediacenter" alt="" /></a>
|
|
</p>
|
|
|
|
</div>
|
|
<!-- EDIT1 SECTION "Liferay" [1-62] -->
|
|
<h2 class="sectionedit2" id="presentation">Presentation</h2>
|
|
<div class="level2">
|
|
|
|
<p>
|
|
<a href="http://www.liferay.com/" class="urlextern" title="http://www.liferay.com/" rel="nofollow">Liferay</a> is an enterprise portal.
|
|
</p>
|
|
|
|
<p>
|
|
Liferay can use <abbr title="LemonLDAP::NG">LL::NG</abbr> as an <abbr title="Single Sign On">SSO</abbr> provider but you have to manage how users are created:
|
|
</p>
|
|
<ul>
|
|
<li class="level1"><div class="li"> By hand in Liferay administration screens</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> Imported from an LDAP directory</div>
|
|
</li>
|
|
</ul>
|
|
|
|
<p>
|
|
Of course, integration will be full if you use the LDAP directory as users backend for <abbr title="LemonLDAP::NG">LL::NG</abbr> and Liferay.
|
|
</p>
|
|
|
|
<p>
|
|
<p><div class="noteimportant">If the user is not created, or can not be created via LDAP import, the connection to Liferay will be refused. With LDAP, login, mail, first name and last name are required attributes. If one is missing, the user is not created.
|
|
</div></p>
|
|
</p>
|
|
|
|
<p>
|
|
This documentation just explains how to set up the <abbr title="Single Sign On">SSO</abbr> part. Please refer to Liferay documentation to enable LDAP provisionning.
|
|
</p>
|
|
|
|
</div>
|
|
<!-- EDIT2 SECTION "Presentation" [63-811] -->
|
|
<h2 class="sectionedit3" id="configuration">Configuration</h2>
|
|
<div class="level2">
|
|
|
|
</div>
|
|
<!-- EDIT3 SECTION "Configuration" [812-838] -->
|
|
<h3 class="sectionedit4" id="liferay_administration">Liferay administration</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Access to Liferay (first time):
|
|
</p>
|
|
|
|
<p>
|
|
<a href="/_detail/documentation/liferay_1.png?id=documentation%3A2.0%3Aapplications%3Aliferay" class="media" title="documentation:liferay_1.png"><img src="../../../../media/documentation/liferay_1.png" class="mediacenter" alt="" width="600" /></a>
|
|
</p>
|
|
|
|
<p>
|
|
Login as administrator:
|
|
</p>
|
|
|
|
<p>
|
|
<a href="/_detail/documentation/liferay_2.png?id=documentation%3A2.0%3Aapplications%3Aliferay" class="media" title="documentation:liferay_2.png"><img src="../../../../media/documentation/liferay_2.png" class="mediacenter" alt="" width="600" /></a>
|
|
</p>
|
|
|
|
<p>
|
|
Go to <code>My Account</code>:
|
|
</p>
|
|
|
|
<p>
|
|
<a href="/_detail/documentation/liferay_3.png?id=documentation%3A2.0%3Aapplications%3Aliferay" class="media" title="documentation:liferay_3.png"><img src="../../../../media/documentation/liferay_3.png" class="mediacenter" alt="" width="600" /></a>
|
|
</p>
|
|
|
|
<p>
|
|
Go to <code>Portal</code> » <code>Settings</code>:
|
|
</p>
|
|
|
|
<p>
|
|
<a href="/_detail/documentation/liferay_4.png?id=documentation%3A2.0%3Aapplications%3Aliferay" class="media" title="documentation:liferay_4.png"><img src="../../../../media/documentation/liferay_4.png" class="mediacenter" alt="" width="600" /></a>
|
|
</p>
|
|
|
|
<p>
|
|
Go to <code>Configuration</code> » <code>Authentication</code>:
|
|
</p>
|
|
|
|
<p>
|
|
<a href="/_detail/documentation/liferay_5.png?id=documentation%3A2.0%3Aapplications%3Aliferay" class="media" title="documentation:liferay_5.png"><img src="../../../../media/documentation/liferay_5.png" class="mediacenter" alt="" width="600" /></a>
|
|
</p>
|
|
|
|
<p>
|
|
In <code>General</code>, fill at least the following information:
|
|
</p>
|
|
<ul>
|
|
<li class="level1"><div class="li"> <strong>How do users authenticate?</strong>: by login</div>
|
|
</li>
|
|
</ul>
|
|
|
|
<p>
|
|
<p><div class="notetip">We advice to deactivate other options, cause users will use <abbr title="LemonLDAP::NG">LL::NG</abbr> portal to modify or reset their password.
|
|
</div></p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="/_detail/documentation/liferay_6.png?id=documentation%3A2.0%3Aapplications%3Aliferay" class="media" title="documentation:liferay_6.png"><img src="../../../../media/documentation/liferay_6.png" class="mediacenter" alt="" width="600" /></a>
|
|
</p>
|
|
|
|
<p>
|
|
<p><div class="noteimportant">
|
|
You need to activate LDAP authentication, else <abbr title="Single Sign On">SSO</abbr> authentication will not work. Do this in the control panel or in the configuration file:
|
|
</p>
|
|
<pre class="file">ldap.auth.enabled=true</pre>
|
|
|
|
<p>
|
|
|
|
</div></p>
|
|
</p>
|
|
|
|
<p>
|
|
Then use the <code>SiteMinder</code> tab to configure <abbr title="Single Sign On">SSO</abbr>:
|
|
</p>
|
|
<ul>
|
|
<li class="level1"><div class="li"> <strong>Enabled</strong>: Yes</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> <strong>Import from LDAP</strong>: Yes (see <a href="#presentation" title="documentation:2.0:applications:liferay ↵" class="wikilink1">presentation</a>)</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> <strong>User Header</strong>: Auth-User (case sensitive)</div>
|
|
</li>
|
|
</ul>
|
|
|
|
<p>
|
|
<a href="/_detail/documentation/liferay_7.png?id=documentation%3A2.0%3Aapplications%3Aliferay" class="media" title="documentation:liferay_7.png"><img src="../../../../media/documentation/liferay_7.png" class="mediacenter" alt="" width="600" /></a>
|
|
</p>
|
|
|
|
<p>
|
|
<p><div class="noteimportant">Do not forget to save your changes!
|
|
</div></p>
|
|
</p>
|
|
|
|
</div>
|
|
<!-- EDIT4 SECTION "Liferay administration" [839-2004] -->
|
|
<h3 class="sectionedit5" id="liferay_virtual_host">Liferay virtual host</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Configure Liferay virtual host like other <a href="../../../documentation/2.0/configvhost.html" class="wikilink1" title="documentation:2.0:configvhost">protected virtual host</a>.
|
|
</p>
|
|
<ul>
|
|
<li class="level1"><div class="li"> For Apache:</div>
|
|
</li>
|
|
</ul>
|
|
<pre class="code file apache"><<span class="kw3">VirtualHost</span> *:<span class="nu0">80</span>>
|
|
<span class="kw1">ServerName</span> liferay.example.com
|
|
|
|
PerlHeaderParserHandler Lemonldap::NG::Handler
|
|
|
|
...
|
|
|
|
</<span class="kw3">VirtualHost</span>></pre>
|
|
<ul>
|
|
<li class="level1"><div class="li"> For Nginx:</div>
|
|
</li>
|
|
</ul>
|
|
<pre class="code file nginx">server {
|
|
listen 80;
|
|
server_name liferay.example.com;
|
|
root /path/to/application;
|
|
# Internal authentication request
|
|
location = /lmauth {
|
|
internal;
|
|
include /etc/nginx/fastcgi_params;
|
|
fastcgi_pass unix:/var/run/llng-fastcgi-server/llng-fastcgi.sock;
|
|
# Drop post datas
|
|
fastcgi_pass_request_body off;
|
|
fastcgi_param CONTENT_LENGTH "";
|
|
# Keep original hostname
|
|
fastcgi_param HOST $http_host;
|
|
# Keep original request (LLNG server will received /llauth)
|
|
fastcgi_param X_ORIGINAL_URI $request_uri;
|
|
}
|
|
|
|
# Client requests
|
|
location / {
|
|
auth_request /lmauth;
|
|
auth_request_set $lmremote_user $upstream_http_lm_remote_user;
|
|
auth_request_set $lmlocation $upstream_http_location;
|
|
error_page 401 $lmlocation;
|
|
try_files $uri $uri/ =404;
|
|
|
|
...
|
|
|
|
include /etc/lemonldap-ng/nginx-lua-headers.conf;
|
|
}
|
|
location / {
|
|
try_files $uri $uri/ =404;
|
|
}
|
|
}</pre>
|
|
|
|
</div>
|
|
<!-- EDIT5 SECTION "Liferay virtual host" [2005-3261] -->
|
|
<h3 class="sectionedit6" id="liferay_virtual_host_in_manager">Liferay virtual host in Manager</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Go to the Manager and <a href="../../../documentation/2.0/configvhost.html#lemonldapng_configuration" class="wikilink1" title="documentation:2.0:configvhost">create a new virtual host</a> for Liferay.
|
|
</p>
|
|
|
|
<p>
|
|
Just configure the <a href="../../../documentation/2.0/writingrulesand_headers.html#rules" class="wikilink1" title="documentation:2.0:writingrulesand_headers">access rules</a>. You can add a rule for logout:
|
|
</p>
|
|
<pre class="code"> ^/c/portal/logout => logout_sso</pre>
|
|
|
|
<p>
|
|
Configure the <code>Auth-User</code> <a href="../../../documentation/2.0/writingrulesand_headers.html#headers" class="wikilink1" title="documentation:2.0:writingrulesand_headers">header</a>.
|
|
</p>
|
|
|
|
</div>
|
|
</div><!-- closes <div class="dokuwiki export">--> |