Module mylutece persona

Introduction

This module let use Persona to authenticate users in Lutece

All users having an Persona account can be authenticated by this module. Users who have not already an Persona should create one.

For more information about Persona please refer to links provided in the side bar.

Installation

Requirements

This module requires version 2.1.2 or higher of the Lutece kernel (lutece-core)

The plugin MyLutece should be installed in version 2.1.0 or higher

Build and deploy

To build the latest version just follow this steps

(NB: Subversion's client and Maven3 should be installed on your system)

  $ svn export http://dev.lutece.paris.fr/svn/lutece/portal/trunk/plugins/module-mylutece-persona module-mylutece-persona
  $ cd module-mylutece-persona
  $ mvn lutece:assembly

The last command will build the module's package as an archive named module-mylutece-persona-xxx-bin-xxxx.zip in the directory ./target/assembly

To deploy this package, just extract its content in your webapp's root.

Configuration

As soon as the module has been extracted in the webapp, just activate it in the "Plugins management" feature of the Lutece backoffice

Check in the file WEB-INF/conf/plugins/mylutece.properties that the authentication is correctly enabled as follows :

# Enable authentication
mylutece.authentication.enable=true

mylutece.authentication.class=fr.paris.lutece.plugins.mylutece.modules.persona.authentication.PersonaAuthentication

mylutece.url.login.page=Portal.jsp?page=persona
mylutece.url.doLogin=jsp/site/plugins/mylutece/modules/persona/DoRedirectPersonaPage.jsp
mylutece.url.doLogout=jsp/site/plugins/mylutece/modules/persona/DoRedirectPersonaPage.jsp
mylutece.url.default.redirect=../../Portal.jsp

Usage

The Persona authentication page is called by the following URL :

http://myhost/lutece/jsp/site/Portal.jsp?page=persona

You may create an authentication form in a portlet, by copying the form in an HTML portlet, or by modifying the MyLutece XSL default stylesheet.

Troubleshooting

  • Check the MyLutece configuration as above.
  • Check that Persona module is the only MyLutece module of the webapp. It should exist no other file mylutece-xxxxx.properties in the WEB-INF/conf/plugins/ directory.
  • Activate debug logging by adding the following line in the file WEB-INF/conf/config.properties in the LOGGERS bloc.

     log4j.logger.persona=DEBUG, Console