Pré-requis
Pour son fonctionnement, le Proxy d'authentification CAS-Zimbra nécessite d'avoir au préalable :
- Une installation des binaires Maven en version 2.2.x
- Une installation CAS fonctionnel
- Une installation Zimbra en version 6.0.x ou 7.x
- Une installation Tomcat fonctionnel
Téléchargement des sources
Il est possible de récupérer les sources de deux façons distinctes :
- Les télécharger depuis le site Sourcesup du projet
- Les récupérer directement avec un client Subversion
Téléchargement direct
Chaque version est disponible soit en .zip (pour les machines Windows) ou en .tar.gz (pour les machines Linux/UNIX).
Une fois l'archive récupérée, il faut la décompacter sur la machine où l'on souhaite installer la portlet :
Pas de format |
---|
tar zxvf web-auth-zcs-1.2.X-src.tar.gz
|
Client Subversion
Le dépôt Subversion est ouvert en anonyme, il est recommandé de récupérer une version présente dans la branche 'tags' :
Bloc de code |
---|
svn co https://subversion.cru.fr/web-auth-zcs/tags/1.2.X/ web-auth-zcs-1.2.X
|
Configuration
La configuration de l'application doit être réalisée dans un fichier profiles.xml présent à la racine des sources. Un fichier d'exemple profiles-sample.xml est fourni pouvant servir de base à toute nouvelle installation :cp profiles-sample.xml profiles.xml
...
Les logs de l'application (ne contenant aucune information importante, si ce n'est les exceptions pouvant se produire) peuvent être configurés de trois façons différentes, simplement en commentant/décommentant les sections correspondantes du fichiers profiles.xml.
Logs console
Dans ce mode, les logs sont écris directement sur la sortie standard et aboutissent généralement dans le fichier catalina.out de Tomcat.
Aucune configuration n'est nécessaire avec ce mode.
Logs syslog
Propriétés à renseigner :
- log4j.syslog.host : cette propriété doit contenir le nom du serveur syslog.
- log4j.syslog.facility : cette propriété doit contenir la facility syslog à utiliser.
Logs fichier
Propriétés à renseigner :
...
Les logs de l'application (ne contenant aucune information importante, si ce n'est les exceptions pouvant se produire) peuvent être configurés de trois façons différentes, simplement en commentant/décommentant les sections correspondantes du fichiers profiles.xml.
Déploiement
Pas de format |
---|
cd web-auth-zcs-1.2.X
mvn package
|
configuration tomcat
Pas de format |
---|
<Context path="/auth-zcs" docBase="/home/webpass/web-auth-zcs" reloadable="false">
<Manager pathname=""/>
</Context>
|
Utilisation
Si vous proxy auth zimbra est installé sur http://auth-zcs.univ.fr vous pouvez accéder à:
Bloc de code |
---|
http://auth-zcs.univ.fr/univ.fr.token => pour obtenir un token dans le domain univ.fr
http://auth-zcs.univ.fr/etudiant.univ.fr.token => pour obtenir un token dans le domain etudiant.univ.fr
...
|
...