Aucun librairie non incluse de base dans UPortal n'est utilisée.
Mais si vous souhaitez utiliser CAS il fautla librairie CAS.
Préparation du fichier de configuration CImap.xlm : mettre les renseignements relatifs aux serveurs et aux attributs importants.
Préparation du déploiement : modifier le deploy.home du fichier build.properties.
Lancement la commande ant deploy.
L'administrateur peut maintenant publier les canaux dont il a besoin en fonction des paramètres d'instanciation.
La configuration du canal se situe à 3 niveaux :
Il est nécessaire de tenir compte des logiques des différents établissements : un seul serveur mail, un serveur pour les étudiants et un pour le personnel, un par composante .... La configuration permettra donc de déclarer plusieurs serveurs mail mais une instance du canal ne fera référence qu'à un seul serveur.
Ces critères sont testés les uns après les autres et dès que l'un est vérifié, l'allocation se fait. Il est donc important de noter que l'ordre d'apparition de ces critères dans le fichier de config donne la priorité.
<?xml version="1.0"?> <\!DOCTYPE CanalMail SYSTEM "CImap.dtd"> <CanalMail> <Servers> <\!\--=========================================================================-\-> <\!\--===============Serveur de messagerie du personnel de Nancy 2=============-\-> <\!\--=========================================================================-\-> <Server key="PERS" default="1" hostname="mail.univ-nancy2.fr" port="143" protocole="imap" description="Serveur de messagerie du personnel de Nancy 2" inboxName="INBOX" inboxLocalName="Réception" urlWebmail="https://webmail.univ-nancy2.fr/imp/mailbox.php?mailbox=%m" /> <\!\--=========================================================================-\-> <\!\--==============Serveur de messagerie des etudiants de Nancy 2=============-\-> <\!\--=========================================================================-\-> <Server key="ETUD" hostname="etudiant.univ-nancy2.fr" port="143" protocole="imap" description="Serveur de messagerie des etudiants de Nancy 2" inboxName="INBOX" inboxLocalName="Réception" urlWebmail="http://etumel.univ-nancy2.fr/imp/mailbox.php?mailbox=%m" /> </Servers> <Attachements> <Group key="local.1" serverKey="PERS" description="Groupe personnel de Nancy 2" /> <Attribut key="mail" value=".*@univ-nancy2\.fr" serverKey="PERS" description="Personne ayant un adresse mail en @univ-nancy2.fr de Nancy 2" /> <Group key="local.2" serverKey="ETUD" description="Groupe etudiants de Nancy 2" /> <Attribut key="mail" value=".*@etudiant\.univ-nancy2\.fr" serverKey="ETUD" description="Personne ayant un adresse mail en @etudiant.univ-nancy2.fr de Nancy 2" /> </Attachements> </CanalMail> |
L'administrateur, lorsqu'il publie un canal, peut ajouter des paramètres d'instanciation pour changer le comportement du canal. Ici, aucun de ces paramètre n'est obligatoire.
Il est possible depuis la version 2 du canal, d'avoir une interface pour envoyer un mail depuis le canal. Pour cela, vous devez installer lecanal "mailTo". Puis au niveau du fichier de config, vous devez préciser le nom complet de la classe de mailTo :<?xml version="1.0"?>
<!DOCTYPE CanalMail SYSTEM "CImap.dtd">
<CanalMail classSendMail="org.esupportail.portal.channels.CMailTo.CMailToServant">
<Servers>...Redeployez le canal imap.
A ce moment là, sur l'apercu de la boite mail un bouton est apparu : "envoyer un mail".
Ces exemples montrent les différentes applications du canal en fonction des paramètres d'instanciation.
Pour laisser l'utilisateur choisir son serveur, il faut que l'administrateur publie un canal en laisser la possibilité de saisir la valeur du paramètre "serverKey". Par contre il n'est pas possible de proposer une liste de valeur ce type d'implémentation s'adresse à des utilisateurs avertis. Dans la boîte de dialogue qui s'ouvre, il peut y avoir une valeur par défaut qui, comme son nom l'indique, peut être modifiée.
L'administrateur peut déclarer par exemple un canal "boîte aux lettres du personnel". Pour cela, le paramètre "serverKey" doit être rempli avec la clé du serveur du personnel et doit être non saisissable par l'utilisateur. L'utilisateur qui s'ajoute ce canal, sera automatiquement relié au serveur du personnel. Donc dans la même logique, l'adminsitrateur peux publier un canal pour le serveur étudiant, un pour le serveur du personnel.... etc.
Une fois le canal inséré, l'utilisateur voit :
mais il peux afficher le détail et là il optient :
Si l'utilisateur veut ouvrir un dossier, il lui suffit de cliquer sur le nom de celui-ci et une fenetre s'ouvrira dans le webmail directement dans le bon dossier.
En plus de préciser le serveur, il est possible de spécifier d'où proviennent les informations de LOGIN / MOT DE PASSE. Par défaut elles découlent de l'authentification CAS. Mais en ajoutant le paramètre "useCasAuth", non saisissable par l'utilisateur et avec la valeur "N", ce sera les LOGIN ET MOT DE PASSE de connexion à UPortal qui serviront. Ceci va permettre de tester le canal avec un serveur imap non cassifié.
Pour utiliser l'authentification LDAP et pour garder le mot de passe en cache, il faut mettre ces lignes dans le fichier security.properties :root.ldap=org.jasig.portal.security.provider.CacheLdapSecurityContextFactory
root.simple=org.jasig.portal.security.provider.CacheSecurityContextFactory
root.cas=org.jasig.portal.security.provider.YaleCasContextFactory