GIP RECIA Intégration de GRR. Dossier d'installation du patch. Version 1.03 du 17 juillet 2008 Etat : Travail

Transcription

1 Dossier GIP RECIA Intégration de GRR Dossier d'installation du patch Version 1.03 du 17 juillet 2008 Etat : Travail SOPRA GROUP/Division Atlantique/Agence Centre Page 1/9

2 Historique : Version Date Origine de la mise à jour Rédigée par Validée par /06/2008 Initialisation T.BIZOUERNE /07/08 Modification config. CAS T.BIZOUERNE Page 2/9

3 Sommaire : 1. INTRODUCTION 4 2. MODIFICATION DU SERVEUR CAS ET DE SA CONFIGURATION Modification du bean attributerepository Modification du bean serviceregistrydao Modification de la JSP de génération du xml de réponse 8 3. APPLICATION DU PATCH SUR GRR Ajout de la table de correspondance Fonction/Statut Remplacement des fichiers modifiés dans GRR 9 Page 3/9

4 1. INTRODUCTION Ce document a pour objectif de présenter la procédure d installation du patch, et les différentes configurations à réaliser pour que celui-ci s intègre correctement à l application GRR. Il est divisé en deux parties : La modification du serveur CAS et de sa configuration L installation du patch sur GRR Page 4/9

5 2. MODIFICATION DU SERVEUR CAS ET DE SA CONFIGURATION Pour effectuer les modifications sur le serveur CAS, il faut repérer le dossier correspondant à l application web CAS sur le serveur Tomcat : webapps/cas/. Le premier fichier à éditer est deployerconfigcontext.xml : Dans ce fichier, deux beans vont devoir être modifiés : attributerepository et serviceregistrydao Modification du bean attributerepository Dans le fichier deployerconfigcontext.xml, repérer le bean attributerepository. La manipulation va consister à rajouter les attributs que l on souhaite récupérer en plus, dans la map de la propriété ldapattributestoportalattributes. Les deux attributs nécessaires au bon fonctionnement du patch, qui n étaient pas présents dans le fichier du GIP RECIA sont les attributs sn, givenname, preferredlanguage et ENTPersonFonctions. Il faut donc ici ajouter les lignes encadrées en rouge, correspondant aux attributs supplémentaires à récupérer auprès de l annuaire LDAP. Remarque : Un fichier nommé «bean attributerepository.xml» a été fourni avec le patch pour permettre au GIP RECIA d avoir la modification à effectuer au format texte, afin de pouvoir effectuer un copier/coller des lignes à ajouter. Page 5/9

6 2.2. Modification du bean serviceregistrydao Toujours dans le fichier deployerconfigcontext.xml, repérer le bean serviceregistrydao. Dans le fichier du GIP RECIA, ce bean ne contenait que cette ligne : La manipulation à effectuer consiste simplement à remplacer la version minimaliste du bean serviceregistrydao par la version correctement paramétrée. Vous devriez obtenir ceci : Page 6/9

7 Le premier bean défini dans la propriété registeredservices indique à CAS tous les attributs qui devront être envoyés à GRR. L élément qui permet à CAS de faire la différence entre GRR et les autres applications est le serviceid, qui est un champ permettant d expliquer à CAS quelle est la forme de l url d accès à l application GRR ; c est une sorte de filtre. L élément allowedattribute permet lui d énumérer tous les attributs qui devront être renvoyés par CAS pour cette application. Le second bean indique à CAS que pour tous les autres services, les attributs par défaut seront retournés, c'est-à-dire uniquement l uid. (On remarque le filtre *://*/** pour le serviceid) Remarque : Un fichier nommé «bean serviceregistrydao.xml» a été fourni avec le patch pour permettre au GIP RECIA d avoir la modification à effectuer au format texte, afin de pouvoir effectuer un copier/coller des lignes à ajouter. Page 7/9

8 2.3. Modification de la JSP de génération du xml de réponse Repérer la JSP casservicevalidationsuccess.jsp dans le répertoire webapps\cas\web- INF\view\jsp\protocol\2.0. La modification va devoir être effectuée dans la partie encadrée en rouge : Le code à insérer en lieu et place du code encadré est le suivant : Remarque : Un fichier nommé «casservicevalidationsuccess patch.xml» a été fourni avec le patch pour permettre au GIP RECIA d avoir la modification à effectuer au format texte, afin de pouvoir effectuer un copier/coller des lignes à ajouter. Page 8/9

9 3. APPLICATION DU PATCH SUR GRR 3.1. Ajout de la table de correspondance Fonction/Statut Il suffit d exécuter le script SQL nommé «creation_table_correspondance.sql» situé dans le répertoire grr_patch du package livré Remplacement des fichiers modifiés dans GRR Tout d abord, il faut se placer dans le répertoire de l application web GRR. Avant toute chose, il est conseillé de sauvegarder le fichier cas.sso situé dans le sousrépertoire CAS (répertoire de la librairie phpcas) de GRR, puisque c est le fichier qui contient l adresse du serveur CAS et son port. Il est préférable de faire la même opération pour le fichier connect.inc.php situé dans le répertoire include, qui lui contient les informations de connexion à la base de données. Pour appliquer le patch, il suffit de décompresser le fichier grr_patch.zip dans le répertoire de l application web de GRR1.95 RC1, et de valider le remplacement des fichiers déjà existants. Voici le contenu du patch : Le principe est le suivant : les fichiers modifiés vont remplacer les originaux, et les nouveaux fichiers vont simplement venir s ajouter dans les répertoires adéquats. Il sera certainement nécessaire ensuite de recopier le fichier cas.sso original du GIP RECIA dans le sous-répertoire CAS de l application GRR. Quant à lui, le fichier connect.inc.php ne devrait pas avoir été remplacé. Page 9/9