Groupe 1A (socle)
Date de création :	29 novembre 2004
Dernière modification :	08 février 2005
Diffusion :	internet

Utilitaire chargement de permission

Ce document décrit comment utiliser l'utilitaire de chargement de permission développé par Esup-Portail.

Cette utilitaire est inclus dans les packages esup, (consulter le CHANGELOG du package afin de savoir si il est disponible dans votre version)

Principe

Cet utilitaire a pour but d'agir sur les permissions de uPortal via une tache ant. Il dispose des méthodes suivantes :

• Ajouter une permission
• Supprimer une permission

Utilisation

Cette utilitaire se base sur un fichier XML permettant de définir les actions a effectuer.

Par défaut, le fichier utilisé est properties/groups/GroupsPermLoad.xml

Il supporte le paramètre dataFile, qui permet d'utiliser un autre fichier de configuration.

Exemple :

ant esup.groups.perm.load -DdataFile=/properties/groups/myGroupsPerm.xml

Vous disposez aussi d'un fichier exemple :

• /properties/groups/GroupPermLoadSample.xml
  

Fichier de configuration

Exemple :

<?xml version="1.0" encoding="UTF-8" ?> 
	<Perm-Loading failonerror="true">
	<!--  BE CAREFUL BEFORE RUN SWITCH JNDI TO OFF in portal.properties and PersonDirs.xml --> 
  	<permAdd targetName="Tous les groupes de personnes" principalsName="Information" activity="VIEW" type="GRANT" />
  	<permAdd targetKey="local.0" principalsName="Etablissement" activity="VIEW" type="DENY" />
  	<permAdd targetKey="local.0" principalsName="Etablissement" activity="SELECT" type="DENY" /> 
  	<permAdd targetKey="local.0" principalsName="Etablissement" activity="ADD/REMOVE" type="GRANT" /> 
  	<permAdd targetName="Comptabilite" principalsKey="local.102" activity="SELECT" type="GRANT" />
  	<permAdd targetName="Comptabilite" principalsKey="local.102" activity="VIEW" type="DENY" />

    <permAdd targetName="Comptabilite" principalsUid="admin" activity="VIEW" type="DENY" />

	<!--  delete all permission of principals on target !--> 
  	<permDel targetName="Tous les groupes de personnes" principalsName="Information" />
  	<permDel targetKey="local.0" principalsName="Etablissement" />
</Perm-Loading>

Ce fichier est un exemple, en aucun cas ce fichier ne marchera.

Le fichier est traité de haut en bas.

Les groupes (target ou principal) peuvent être décrits par leur nom ou par leur clé.

failonerror

Ce flag vous permet de spécifierle comportement de l'utilitaire :

• true : s'arrête sur la 1ère erreur et ne traite pas le reste du fichier
• false : traite tout le fichier en affichant les erreurs

Ajout d'une permission (permAdd)

Attributs :

• [ targetName | targetKey] : nom du groupe sur lequel appliquer la permission
• [ principalsName | principalsKey | principalsUid] : nom du groupe qui aura la permission ou uid d'un utilisateur (principalsUid)
• activity : action de la permission parmi [ DELETE | UPDATE | VIEW | ADD/REMOVE | ASSIGNPERMISSIONS | SELECT | CREATE ]
• type : type de la permission parmi [ GRANT | DENY ]

Suppression d'une permission (permDel)

Attributs :

• [ targetName | targetKey] : nom du groupe sur lequel appliquer la permission
• [ principalsName | principalsKey] : nom du groupe qui aura la permission

Cette action supprime toutes les permissions du groupe principals sur le groupe target

Création :29 novembre 2004 - Julien Marchal
Modifications : 08 février 2005 : Julien Marchal : Possibilité d'utilisation du principalsUid