Groupe 3 (services applicatifs)
Date de création :	26 septembre 2003
Dernière modification :
Diffusion :	Esup-Portail

Canal apogéeweb

But

Afin d'intégrer l'application apogéeweb de l'AMUE dans Uportal, il est nécéssaire de rendre apogéeweb compatible CAS.

Principe de fonctionnement

Pour rendre apogéeweb compatible CAS, nous utiliserons le tagLibCAS.
Inconvénient majeur, apogéeweb est livré pour fonctionner avec un JDK1.3.1. Ce jdk ne connaît pas le protocole htpps utilisé par CAS. Il faut donc utiliser un jdk 1.4.1, sous réserve d'une validation par l'AMUE.

apogéeweb a besoin du numéro de l'étudiant et de sa date de naissance pour fonctionner normalement.
L'identifiant de connexion n'étant pas forcément le numéro de l'étudiant, il faut faire une recherche dans LDAP, puis dans la base de données Apogée pour retrouver grâce à l'identifiant de l'utilisateur son numéro étudiant et sa date de naissance.
Afin de ne pas surcharger l'application, nous utiliserons le pool de connexion de SOPRA, déjà intégré dans apogéeweb, sous réserve de l'acceptation de l'AMUE/SOPRA.

En plus du fichier de configuration cas.xml nécéssaire au tagLibCAS, il faut rajouter un fichier de configuration configLogin.xml contenant les paramètres LDAP ainsi que la requête SQL qui interrogera la base de données apogée.

Deux fichiers jsp sont nécéssaires au bon fonctionnement du login, le premier (login_cas.jsp) récupère les informations propre à l'utilisateur puis fait une redirection vers le deuxième (identification_cas.jsp) qui lui fait un forward vers la page suivante (identification.do).
Pourquoi faire cette manipulation supplémentaire ?
Si le premier faisait directement une redirection vers la page identification.do, l'url contenant le numero de l'étudiant et son mot de passe (içi sa date de naissance) apparaitrait en clair.
Si cette même page faisait elle même le forward, on se retrouverait avec une url du type
http://url?ticket=XX-XXX-XXXXXXXXX et on ne pourrait pas rafraîchir la page contenant les informations souhaitées.

Installation

Mise en place des fichiers

Pour commencer, installer le tagLibCAS.
Copier ensuite la librairie org.esup.apoweb.login.jar dans WEB-INF/lib.
Pour finir, copier les fichiers login_cas.jsp et identification_cas.jsp dans le répertoire "etapes" et également dans "consultation".

Configuration

En plus du fichier cas.xml nécéssaire au tagLibCAS, il faut rajouter dans WEB-INF/classes/config/ un fichier configLogin.xml de la forme suivante :

Exemple du fichier configLogin.xml pour Rennes 1

<?xml version="1.0" encoding="iso-8859-1"?>
<ROOT>
    <LDAP>
        <LDAP-url>ldap://url_LDAP:port/dc=etu,dc=univ-rennes1,dc=fr</LDAP-url>
        <LDAP-user></LDAP-user>
        <LDAP-pwd></LDAP-pwd>
        <LDAP-contextDeRecherche>ou=People</LDAP-contextDeRecherche>
        <LDAP-attributDeRecherche>uid</LDAP-attributDeRecherche>
        <LDAP-attributVoulu>employeenumber</LDAP-attributVoulu>
    </LDAP>
    <SQL>
        <SQL-requeteSQL>SELECT COD_ETU,to_char(DATE_NAI_IND,'DDMMYYYY') FROM INDIVIDU WHERE COD_IND=?</SQL-requeteSQL>
    </SQL>
</ROOT>

Il est aussi nécéssaire de modifier la page d'acceuil paramétrable dans le web.xml de l'application au niveau de la balise :

<welcome-file-list>
<welcome-file>consultation/login_cas.jsp</welcome-file>
</welcome-file-list>

Création : 26 septembre 2003 - Sébastien Gougeon (Université de Rennes1)
Modifications : 18 février 2004 - Florent FARENEAU (UVHC)