CAS est couramment utilisé dans les établissements de l'enseignement supérieur et donc chez les partenaires ESUP.

De fait EsupPortail, via le socle uPortal, propose l'intégration de l'authentification CAS (avec identification LDAP).

On note cependant que l'ENT EsupPortail supporte également CAS est un moyen parmi d'autres modes d'effectuer l'authentification sur le portailauthentification (shibboleth ou directement via LDAP).

Il y a plusieurs possibilités d'utilisation de CAS au niveau du package ESUP :

CAS interne (en bundle avec ESUP). Attention : ce CAS n'est pas préconisé pour un environnement hors développement.
CAS externe (à installer soi-même)
De plus, il est possible :
D'utiliser des certificats (et donc HTTPS)

De se passer des certificats (et donc utilie HTTP)

: l'idée étant d'utiliser naturellement le service de CAS pré-existant dans l'établissement.

En environnement de production, il est fortement recommandé de déployer l'application de façon sécurisée en utilisant des certificats et le protocole HTTPS uniquement (tout comme pour l'ENT).

Le fichier de propriétés

Bloc de code

theme

theme	Confluence
language	none
Confluence	title	esup.properties
firstline	68
linenumbers	true


################################################################################
## Configuration Serveur UPortal                                              ##
################################################################################
environment.build.uportal.server=esup4ent.univ.fr
environment.build.real.uportal.server=esup4ent1.univ.fr
environment.build.uportal.protocol=https
environment.build.uportal.context=/uPortal
environment.build.real.uportal.context=/uPortal
environment.build.uportal.email.fromAddress=portal4@univ.fr


################################################################################
## Configuration Serveur CAS                                                  ##
################################################################################
environment.build.cas.server=auth.univ.fr
environment.build.cas.protocol=https
environment.build.cas.context=/cas

Voici à quoi correspondent les différentes propriétés :

?

Propriétés uPortal	Définition
environment.build.uportal.server	Hostname du serveur uPortal
environment.build.real.uportal.server ?	Utilisé pour le load balancing. Par défaut mettre la même adresse que environment.build.uportal.server. La configuration exacte est expliquée dans la section dédiée au load balancing.
environment.build.uportal.protocol	Protocole utilisé pour contacter le serveur uPortal (http ou https)
environment.build.uportal.context	Nom de la webapp du serveur uPortal (En toute logique "/uPortal")
environment.build.real.uportal.context	Utilisé pour le load balancing. Par défaut mettre la même adresse que environment.build.uportal.context. La configuration exacte est expliquée dans la section dédiée au load balancing.
environment.build.uportal.email.fromAddress	Adresse utilisée pour envoyer des messages électronique. Elle sera visible des destinataires
Propriétés CAS	Définition
environment.build.cas.server	Hostname du serveur CAS
environment.build.cas.protocol	Protocole utilisé pour contacter le serveur CAS (http ou https)
environment.build.cas.context	Nom de la webapp du serveur CAS (En toute logique "/cas")

Toutes les propriétés "cas" servent à configurer la manière de contacter le serveur CAS
Toutes les propriétés "uportal" servent à configurer le service pour lequel on appelle le CAS. Concrètement, il s'agit de l'URL de redirection une fois l'authentification effectuée

Configurer le CAS embarqué

Utiliser le CAS embarqué revient à utiliser celui la machine locale qui ne demande pas de connexion sécurisée. Il faut donc configurer les propriétés du serveur CAS comme suit :

Avertissement

title	De la sécurité

Le mode HTTP (non sécurisé) est fortement déconseillé en production, que ce soit pour CAS (environment.build.cas.protocol) ou pour le portail (environment.build.uportal.protocol) !

Configurer le CAS au niveau de l'ENT

Fichier esup.properties

Bloc de code
Bloc de code
environment.build.cas.server=localhostent.univ.fr environment.build.cas.protocol=httphttps environment.build.cas.context=/cas

Les autres propriétés doivent être renseignée en fonction de là où est déployé l'application uPortal.

Configurer un CAS externe

Il est possible d'utiliser un serveur CAS externe. Cela peut permettre d'héberger le serveur CAS sur une autre machine que celle du portail.
Pour cela, il faut télécharger un serveur CAS (V3.5.1 ou plus conseillée) et réaliser l'installation.

Utiliser un certificat

...

Le serveur CAS (version bundle !) pourra être testé à l'URL suivante : https://ent.univ.fr/cas Il ne redirigera nulle part puisqu'aucun service ne lui a été demandé. L'utilisateur test est admin/admin.

Désactiver le cas embarqué.

Commenter la ligne "<module>cas</module>" dans le fichier uportal-portlets-overlay/pom.xml.

Bloc de code

language	html/xml

<modules>
    ...
    <module>BookmarksPortlet</module>
    <!-- module>cas</module -->
    <module>cas-proxy-test-portlet</module>
    ...
</modules>

Commenter la dépendance CAS dans le fichier uportal-ear/pom.xml.

Bloc de code

language	html/xml

<!--
<dependency>
    <groupId>org.jasig.portal.portlets-overlay</groupId>
    <artifactId>cas</artifactId>
    <version>${project.version}</version>
    <type>war</type>
</dependency>
-->

Installer CAS (rappel)

Pour installer un CAS de production (si vous n'en avez pas déjà un dans votre établissement) on vous réfère à la documentation ESUP qui lui est spécifique :
http://www.esup-portail.org/display/CAS

Proxy CAS

Le fonctionnement d'un proxy CAS est également expliqué sur le wiki de l'esup-portail.

Le portail embarque par défaut la portlet cas-proxy-test-portlet (nommée PORTLET TEST CAS) qui indique si le portail est correctement configuré pour fonctionner en mode proxy CAS, hors si vous appliquez une configuration autre ou en load balancing par exemple que pour un fonctionnement en local la portlet ne sera pas automatiquement correctement configurée et retournera toujours une erreur de fonctionnement proxy cas, il sera donc nécessaire d'appliquer cette configuration une fois la portlet du pakaging du portail déployée :

Bloc de code

theme	Confluence
language	none
title	PATH.TO.WEBAPPS/cas-proxy-test-portlet/WEB-INF/classes/configuration.properties
firstline	19
linenumbers	true

cas.server.base.url=https://auth.univ.fr/cas
portal.server.base=https://ent.univ.fr
portal.real.base=https://ent1.univ.fr
portlet.context=cas-proxy-test-portlet

Remarque/rappel : on pourra utiliser également ici un system property java pour portal.real.base notamment, cf Apache frontal (esup 4)#Bonnepratique

Bloc de code

theme	Confluence
language	none
title	PATH.TO.WEBAPPS/cas-proxy-test-portlet/WEB-INF/context/applicationContext.xml
firstline	48
linenumbers	true

   <!-- 
        Validates service and proxy tickets for both the servlet targets and
        proxy portlet
    -->
    <bean id="ticketValidator" 
        class="org.jasig.cas.client.validation.Cas20ProxyTicketValidator"
        p:proxyCallbackUrl="${portal.real.base}/${portlet.context}/proxy/receptor"
        p:proxyGrantingTicketStorage-ref="proxyGrantingTicketStorage"
        p:acceptAnyProxy="true">
        <constructor-arg index="0" value="${cas.server.base.url}" />
    </bean>

Ancre

	CASLDAP
	CASLDAP

Connecter CAS Bundle et LDAP

Afin de connecter CAS bundle et LDAP, il faut procéder aux modifications suivantes (exemple de configuration - le FastBind ne fonctionne pas avec tous les LDAP) :

Ajout dans le fichier pom.xml du cas bundle :

Bloc de code

title	uportal-portlets-overlay/cas/pom.xml
firstline	160
linenumbers	true

<dependency>
    <groupId>org.jasig.cas</groupId>
    <artifactId>cas-server-support-ldap</artifactId>
    <version>${cas-server.version}</version>
    <scope>compile</scope>
    <exclusions>
        <exclusion>
            <groupId>org.inspektr</groupId>
            <artifactId>inspektr-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Ajouts dans le fichier deployerConfigContext.xml du cas bundle :

Bloc de code

title	uportal-portlets-overlay/cas/src/main/webapp/WEB-INF/deployerConfigContext.xml
firstline	120

<property name="authenticationHandlers">
        <list>
        ...
        <bean class="org.jasig.cas.adaptors.ldap.FastBindLdapAuthenticationHandler" >
            <property name="filter" value="${environment.build.ldap.uidAttr}=%u,${environment.build.ldap.baseDn}" />
            <property name="contextSource" ref="contextSource" />
        </bean>
    </list>
</property>

Bloc de code

title	uportal-portlets-overlay/cas/src/main/webapp/WEB-INF/deployerConfigContext.xml
firstline	222
linenumbers	true

</beans>
    ...
    <bean id="contextSource" class="org.springframework.ldap.core.support.LdapContextSource">
        <property name="urls">
            <list>
                <value>${environment.build.ldap.url}</value>
            </list>
        </property>
		<property name="userDn" value="${environment.build.ldap.userName}"/>
        <property name="password" value="${environment.build.ldap.password}"/>
        <property name="pooled" value="${environment.build.ldap.pooled}"/>
	 </bean>
    ...
</beans>

...

Info

title	Références

https://wiki.jasig.org/display/UPM40/CAS+in+uPortal+Overview^{Image Removed}
https://wiki.jasig.org/display/UPM40/CAS^{Image Removed}
http://www.ens-lyon.fr/Bibli/ENT-ESUP/sources/esup.properties.txt^{Image Removed}
https://wiki.jasig.org/display/UPM40/SSL+Configuration
http://www.esup-portail.org/consortium/espace/SSO_1B/cas/
Exemple de fichier de configuration
https://sourcesup.cru.fr/frs/?group_id=401&release_id=1461
CAS

Pages enfant

Comparaison des versions

Ancienne version 10

Nouvelle version Actuel

Légende

Le fichier de propriétés

Configurer le CAS embarqué

Configurer le CAS au niveau de l'ENT

Configurer un CAS externe

Utiliser un certificat

Désactiver le cas embarqué.

Installer CAS (rappel)

Proxy CAS

Connecter CAS Bundle et LDAP

Pages enfant

Pages … Projet socle ENT Anciennes documentations (anciennes versions) Documentations (esup-4.0) Documentation officielle Esup V4.0 04 - Installation (esup-4) c) Installation (esup 4) CAS (Central Authentication Service) (esup 4) Historique de la page

Comparaison des versions

Ancienne version 10

Nouvelle version Actuel

Légende

Le fichier de propriétés

Configurer le CAS embarqué

Configurer le CAS au niveau de l'ENT

Configurer un CAS externe

Utiliser un certificat

Désactiver le cas embarqué.

Installer CAS (rappel)

Proxy CAS

Connecter CAS Bundle et LDAP

Pages

Projet socle ENT
Anciennes documentations (anciennes versions)
Documentations (esup-4.0)
Documentation officielle Esup V4.0
04 - Installation (esup-4)
c) Installation (esup 4)
CAS (Central Authentication Service) (esup 4)

Historique de la page