Personnalisation de la mire SSO
Ce chapitre répertorie les différentes possibilités offertes pour personnaliser l'apparence de la page d'authentification du serveur EoleSSO (pour une meilleure intégration dans l'environnement existant, et en particulier dans le cadre d'un portail d'accès aux ressources d'un établissement).
Message d'avertissement (CNIL)
Il est prévu de pouvoir afficher un message relatif à la déclaration CNIL du site.
- mettre le texte du message d'avertissement (formaté en HTML) dans un fichier
avertissement.txt
qui est à placer dans le répertoire/usr/share/sso/interface/theme
; - relancer le service : CreoleService eole-sso restart
ExempleExemple de déclaration
Conformément à la loi, nous vous informons que ce site a fait l'objet d'une déclaration de traitement automatisé d'informations nominatives auprès de la CNIL Loi du 6 janvier 1978 relative à l' « Informatique et aux Libertés » :<br />
Conformément à la loi n° 78-17 du 6 janvier 1978, vous pouvez à tout moment accéder aux informations personnelles vous concernant et détenues par l'établissement, demander leur modification ou leur suppression. Ainsi, vous pouvez, à titre irrévocable, demander que soient rectifiées, complétées, clarifiées, mises à jour ou effacées les informations vous concernant qui sont inexactes, incomplètes, équivoques, périmées ou dont la collecte ou l'utilisation, la communication ou la conservation est interdite.<br/>
Pour toutes demandes, veuillez contacter l'administrateur à l'adresse : administrateur@etablissement.fr
CSS : Méthode 1
La feuille de style par défaut /usr/share/sso/interface/main.css
importe les feuilles de style ./theme/style/theme.css
et ./leaves.css
:
[ …]
@import url(./leaves.css);
@import url(./theme/style/theme.css);
[…]
Comme le fichier ./theme/style/theme.css
est appelé en deuxième dans la feuille il va permettre une surcharge de la première feuille de style ./leaves.css
.
Éditer le fichier vide ./theme/style/theme.css
appelé dont le chemin absolu est /usr/share/sso/interface/theme/style/theme.css
.
S'inspirer des balises de style utilisées dans le fichier /usr/share/sso/interface/leaves.css
pour les surcharger.
Utiliser le répertoire /usr/share/sso/interface/theme/images
pour ajouter vos images.
Recharger votre page d'authentification sans même redémarrer le service eole-sso
, la feuille de style est importée avec les modifications.
Attention
Cette méthode n'est pas compatible avec la personnalisation Envole Thèmes. Celui-ci écrase le contenu du fichier /usr/share/sso/interface/theme/style/theme.css
à chaque reconfigure. Il est possible d'enlever Envole Thèmes avec la commande suivante : # apt-get remove eole-envole-themes
CSS : Méthode 2
Un certain nombre de thèmes sont fournis dans le répertoire /usr/share/sso/interface/themes/
.
Il suffit de copier le thème voulu pour le rendre actif :
# /bin/cp -R /usr/share/sso/interface/themes/<nomDuTheme>/* /usr/share/sso/interface/theme
Recharger votre page d'authentification sans même redémarrer le service eole-sso
, la feuille de style est importée avec les modifications.
Truc & astuce
N'hésitez pas à proposer votre thème, il sera ajouté au paquetage et reversé à la communauté d'utilisateurs.
CSS : Méthode 3
La feuille de style CSS par défaut utilisée lors de l'affichage de la page d'authentification au portail est :
/usr/share/sso/interface/leaves.css
Il est possible d'utiliser une feuille de style CSS personnalisée pour la mire SSO.
Les fichiers CSS à utiliser sont à placer dans :
/usr/share/sso/interface/
Dupliquer la feuille de style originale sous un autre nom.
Modifier à volonté votre_nouvelle_feuille.css
Renseigner le nom de votre feuille sans l'extension (.css
) dans l'onglet Eole sso
depuis l'interface de configuration du module.
Réaliser autant de feuilles de style que souhaités.
Remarque
Si vous faites appel à des images, placez-les dans :
/usr/share/sso/interface/images/
Il est possible de passer le nom de la CSS en paramètre dans URL :
http://<adresse_serveur>/css=<nom_de_la_feuille_CSS>
Si vous utilisez un client phpCAS, il faudra modifier le client pour utiliser cette méthode (les URLs sont calculées par le client).
Truc & astuceChoix de la CSS par le filtre SSO
Si un fichier CSS porte le même nom qu'un filtre d'application (par exemple, ead2.css
), cette feuille de style CSS sera automatiquement utilisée lors des demandes à cette application (dans le cadre d'un portail web par exemple).