Groupe 1A (socle)

Date de création : 2 mars 2004
Dernière modification : 2 avril 2004
Diffusion : internet

Définition des groupes et attributs esup-portal

Ce document propose une arborescence type des groupes uPortal pour esup-portail et une liste d'attributs qui devraient être nécessairement implémentés.

L'intérêt est de préparer l'organisation de la distribution esup-portail, et de permettre aux développeurs de connaitre les ressources proposées par le 'socle' en terme de groupes et d'attributs.

Se reporter aux documents sur l'utilisation des groupes :

Sommaire :

Les groupes dans uPortal

uPortal propose une gestion de groupes génériques.
Un groupe peut contenir un autre groupe, ou un type d'objet pré-défini.

En standard, uPortal propose des groupes d'objets 'application' et des groupes d'objets 'personne'.

Un objet susceptible d'appartenir a un groupe peut appartenir à plusieurs groupes de sa classe.

Il est tout à fait possible d'étendre cette gestion de groupes à d'autres types d'objets (groupes d'imprimantes par exemple) ; il suffit pour celà de développer et d'ajouter les classes java correspondantes, ceci sans toucher à l'existant.

L'utilité principal des groupes est:

uPortal gère des groupes 'internes' (ou 'locaux'), dans sa base.

Il est possible d'y ajouter des groupes 'externes', comme par exemple, des groupes issus de requêtes LDAP.

Il est possible d'inclure des groupes externes dans des groupes internes.

En standard avec uPortal

Groupes d'applicatications

Ici, les applications correspondent à des canaux publiés dans uPortal.

Ces groupes permettent de regrouper ces canaux en catégories. Ceci permet de simplifier la recherche d'un canal donné et éventuellement la permission d'allocation des canaux.

La hiérarchie des groupes prédéfinis lors d'une installation uPortal est celle-ci :

All categories
 |
 |____Applications                   (contient Group Manager et Permissions manager)
 |____Developpement                  (contient différents canaux)
 |      |___uPortal                  (contient différents canaux)
 |            |___Channel Types      (contient des canaux utilisant les types génériques)
 |                 |___....
 |____Entertainment
 |      |___Games
 |____News

Et les canaux fournis sont répartis dans les différents groupes, voire parfois dans plusieurs groupes différents.

Groupes de personnes

Les groupes prédéfinis à l'installation d'uPortal sont les suivants :

Everyone
 |
 |____Faculty
 |     |___Associates Professors       (vide)
 |     |___Tenured Professors          (vide)
 |____Guest                            (un membre : guest)
 |____Staff
 |     |___Developpers                 (2 membres : demo et admin)
 |     |___Officers
 |          |___Portal Administrators  (un membre : admin)
 |     |___Support Staff               (vide)
 |____Students                         (un membre : student)
       |___Graduate Students           (vide)
       |___Prospective Students        (vide)
       |___UnderGraduate Students
            |___Full Time              (vide)
            |___Part Time               (vide)


Comptes prédéfinis

Proposition de groupes dans esup-portail

Est décrite ici l'organisation générale de la distribution esup-portail.

Ce qui est présenté ici est une idée d'organisation ; chaque établissement a bien sur le loisir d'organiser ses groupes esup-portail à sa guise.

Groupes d'applications

All categories
 |
 |____uPortal
 |     |___AdminPortal               (contient Group Manager, Permissions manager, outils d'administration)   
 |     |___Channel Types             (recopie Channel Types d'origine)    
 |     |___divers                    (autres canaux de la distrib uportal)
 |___Outils Communication
 |___Informations
 |___Scolarite
 |___GRH
 |___Comptabilite
 |___Documentation
 |___Documents en ligne
 |___Divers

Groupes utilisateurs

Sont en couleur verte les groupes locaux créés dans la distribution esup-portail, en couleur bleue des exemples de groupes locaux personnalisés, en couleur rouge des exemples issus de requêtes LDAP.

 Everyone
 |___Anonyme
 |___Administrateurs
 |    |___Administrateurs uPortal
 |    |___Administrateurs Applications scolarité
 |    |___Administrateurs Applications GRH
 |    |___...
 |___Applicatifs
 |    |___Gestion
 |    |    |___App CMonDossierWeb
 |    |         |__ App CMonDossierWeb Lecteur
 |    |         |__ App CMonDossierWeb Ecrivain
 |    |         |__ App CMonDossierWeb Administrateur
 |    |___Documentation
 |    |___Communication
 |    |___Information
 |    |___Outils CRI
 |___Etablissement
 |    |___Personnels
 |    |    |___Categorie Personnels
 |    |    |    |___Enseignants
 |    |    |    |___Administratifs
 |    |    |    |___....
 |    |    |___Composantes Personnels
 |    |    |    |___Personnel Composante Presidence
 |    |    |    |___Personnel Composante UFR Maths Infos
 |    |    |    |___...
 |    |    |___Services Personnels
 |    |    |    |___Personnel service Scolarité
 |    |    |    |___Personnel service Recherche
 |    |    |    |___...
 |    |    |___Campus Personnels
 |    |    |    |___Personnel Pole Lorrain de Gestion
 |    |    |    |___...
 |    |    |___Equipes de Recherche
 |    |
 |    |___Etudiants
 |    |    |___UFR Etudiants   
 |    |    |    |___UFR Maths-Infos
 |    |    |    |    |___Miage 1
 |    |    |    |___...
 |    |    |____Campus Etudiants
 |    |          |___Pole Lorrain de Gestion
 |    |          |    |___Miage 1
 |    |          |___...
 |    |___Invites

Attributs Esup-Portail

Sont décrits ici les attributs pré-définis dans la distribution esup-portail, issus de l'annuaire LDAP. Bien entendu, chaque établissement a le loisir d'étendre cette liste.

Les développeurs de canaux dédiés à la communauté esup-portail peuvent s'appuyer sur cette liste d'attributs esup-portail. Il est donc de la responsabilité de chaque établissement de les implémenter.

La plupart de ces attributs sont définis par le groupe de travail supann (voir le document supann).

esup-portail
LDAP
uid uid
cn cn
givenName givenName
sn sn
displayName displayName
mail mail
telephoneNumber telephoneNumber
facsimileTelephoneNumber facsimileTelephoneNumber
postalAddress postalAddress
supannCodeINE supannCodeINE
supannEtuId supannEtuId
supannEmpId supannEmpId
esupEtuFormation xxxxxx
esupPersCategorie eduPersonAffiliation
esupEmpComposante xxxxxx

les attributs esupEtuFormation, esupPersCategorie, esupEmpComposante seront utilisés par le gestionnaire de groupes LDAP pour créer certains groupes uPortal, respectivement :

Exemple d'utilisation des groupes esup-portail

Comme décrit précédemment, uPortal permet l'utilisation de groupes hiérarchiques, et l'ajout de groupes issus de ressources externes.

Un des principaux intérêts des groupes d'utilisateurs est d'affecter des permissions liés à des applicatifs (canaux).

Deux exemples vont illustrer des possiblités d'utilisation :

Exemple 1 : un canal, appelé ici 'Mon Dossier Web'

Les groupes utilisés par ce canal font partie de l'arborescence décrite dans le paragraphe 'Proposition de groupes dans esup-portail'.

Pour ce canal, différents droits sont à définir, qui vont être traités par l'appartenance à des groupes :

Un exemple de gestion de ces groupes (pour simplifier cette explication, 'App MonDossierWeb Lecteur' a été remplacé par 'Lecteur', idem pour 'Ecrivain' et 'Administrateur') :

A l'installation du canal par l'administrateur esup-portail

Lors de l'utilisation

Exemple 2 : un canal Annonce

A l'installation

Lors de l'utilisation

Remarques au sujet des groupes

Groupes esup-portail issus de LDAP

Pour des raisons de performance, l'interface uPortal permettant de créer des groupes dynamiques issus de LDAP n'utilise pas les groupes LDAP ; ces groupes uPortal sont peuplés à l'aide de requêtes LDAP simples.

Ceci sous-entend que les entrées de personnes dans LDAP comportent des attributs permettant de faire le regroupement.

Utilisation des groupes par les canaux

Comme indiqué précédemment, les groupes sont utilisés par le 'socle' esup-portail, en particulier pour donner des droits ou des profils.

Il arrive fréquemment que des canaux aient besoin d'utiliser ces groupes en interne.

Pour celà, deux possibilités :

La spécification d'un groupe dans un fichier de config peut être fait soit à l'aide du nom du groupe, soit à l'aide de la clé interne, chaque méthode présentant des avantages et inconvénients.

Nous préconisons que les canaux ayant besoin de définir des groupes dans un fichier de configuration puisse proposer les 2 méthodes, afin de laisser le choix à l'administrateur esup-portail.

Comptes prédéfinis dans esup-portail

Les comptes suivants seront pré définis dans esup-portail ; ce sont des comptes locaux :