Prochaine révision | Révision précédente |
informatique:reseau:messagerie:sogo [2013/11/12 09:02] – créée bn8 | informatique:reseau:messagerie:sogo [2024/05/03 17:01] (Version actuelle) – bn8 |
---|
| |
Fait en sorte que ce fichier appartienne à l'utilisateur et au groupe //sogo// et qu'il est des droits //400//. | Fait en sorte que ce fichier appartienne à l'utilisateur et au groupe //sogo// et qu'il est des droits //400//. |
| |
| ===== Mise en place de l'authentification CAS ===== |
| |
| |
| |
| <note>Dans cet exemple, le serveur SOGo est derrière l'URL https://mail.exemple.org et le serveur CAS est derrière l'URL https://login.exemple.org/cas. Il est indispensable que le serveur accepte son utilisation depuis les services [[imap://mail.exemple.org]] et [[https://mail.exemple.org]]. Pour cela rendez vous sur l'interface de gestion des services du serveur CAS [[https://login.exemple.org/cas/services/manage.html]].</note> |
| |
| |
| <note important>Pour que l'authentification //CAS// fonctionne, //SOGo// doit utilisé un serveur //memcached//.</note> |
| |
| |
| |
| **Procédure :** |
| |
| Il faut tout d'abord mettre en place l'authentification CAS au niveau du serveur IMAP/SIEVE. Pour cela, je prendrais l'exemple de Dovecot avec **libpam-cas** + **libpam-ccreds** pour mettre en cache les tickets d'authentification CAS. Pour cela, on commence par installer le paquet Debian //libpam-cas// et //libpam-ccreds//. Le second est dans Debian mais pas le premier. On peut cependant le compiler soit même à partir des [[https://github.com/EsupPortail/esup-pam-cas|sources]] fournissant le nécessaire : |
| |
| <code bash> |
| apt install debhelper libpam0g-dev libssl-dev build-essential git |
| cd /usr/local/src |
| git clone https://github.com/EsupPortail/esup-pam-cas.git |
| cd esup-pam-cas |
| dpkg-buildpackage -b --no-sign |
| sudo dpkg -i ../libpam-cas_*.deb</code> |
| |
| Un fois installer on met en place le fichier de configuration ///etc/pam_cas.conf// : <code># host from CAS server. mandatory |
| host login.exemple.org |
| |
| # port from CAS server. Default to 80 or 443, depends from ssl instruction |
| port 443 |
| |
| # uri to validate ticket. Default to /proxyValidate |
| uriValidate /cas/proxyValidate |
| |
| # https or no. values on or off. Default to on. |
| ssl on |
| |
| # proxy or proxies who deliver Proxy Ticket. |
| # If no proxy, pam_cas doesn't control it |
| # It may be several proxy instructions |
| proxy https://mail.exemple.org/SOGo/casProxy |
| |
| # debug (on) or no (off). debug in syslog, level LOG_DEBUG. Default to off |
| debug off |
| |
| # trusted_ca. mandatory if ssl on. |
| # It a file in pem format. It can contents several certificates |
| # If the CAS server certificate is auto-signed, the file must content the certificate |
| # If the certificate is trusted by an Certificate Autority, The file must content |
| # certificate from high level CA |
| trusted_ca [chemin vers le certificat de la CA ayant émis les certificats SSL de l'infra]</code> |
| |
| <note tip>Pour le paramètre **trusted_ca**, vous pouvez utiliser le fichier **/etc/ssl/certs/ca-certificates.crt** gérer par le paquet //Debian ca-certificates//.</note> |
| |
| On met ensuite en place un fichier de configuration //PAM// pour //dovecot-cas//, à savoir le fichier ///etc/pam.d/dovecot-cas// : <code>auth sufficient pam_ccreds.so action=validate service_specific |
| auth [success=ok new_authtok_reqd=ok ignore=done default=die] pam_cas.so -simap://mail.exemple.org -f/etc/pam_cas.conf |
| auth optional pam_ccreds.so action=store service_specific timeout=300 |
| account sufficient pam_permit.so |
| session sufficient pam_permit.so</code> |
| |
| Cette configuration défini le principe d'authentification suivant en 3 étapes : |
| - Lors d'une authentification, on vérifie tout d'abord si l'utilisateur n'est pas déjà connecté dans le cache de //pam_ccreds// (situé dans le fichier ///var/cache/.security.db//). Si l'utilisateur est déjà connecté, on le laisse passé, sinon on passe à l'étape suivante |
| - La seconde étape utilise le module //pam_cas// pour tenter une authentification de l'utilisateur via CAS en validant le ticket CAS passé en tant que mot de passe. On passe ici deux paramètres au module CAS : |
| * Via le paramètre //-s// on lui fourni le nom du service CAS, qui doit être identique à celui fournis au serveur CAS lors de l'obtention du ticket par le service agissant en Proxy CAS. |
| * Via le paramètre //-f// on lui fourni le chemin du fichier de configuration du module à savoir ///etc/pam_cas.conf// |
| - La troisième étape consiste, **si l'authentification de l'utilisateur à l'étape précédente à réussi**, à stocker dans le cache de //pam_ccreds// l'authentification de l'utilisateur. On passe au module //pam_ccreds// via le paramètre //timeout=300// la durée de validité de l'enregistrement dans le cache (par défaut, elle est infinie). On spécifie également que cette authentification est valable uniquement pour Dovecot au travers le paramètre //service_specific// |
| |
| <note>On peut ensuite tester la communication avec le serveur CAS en utilisant l'outil //castest// qui tentera la validation d'un ticket bidon auprès du serveur CAS qui devrait retourner //bas CAS ticket// mais pas une autre erreur :)</note> |
| |
| On configure ensuite Dovecot pour qu'il utilise en place de son backend d'authentification actuel (LDAP par exemple), l'authentification via //PAM// en tant que le service //dovecot-cas//. Pour cela, on créé le fichier ///etc/dovecot/conf.d/11-auth-pam-cas.conf// : <code>passdb { |
| args = session=yes cache_key=%n dovecot-cas |
| driver = pam |
| }</code> |
| |
| On dois ensuite redémarrer Dovecot pour application de cette nouvelle configuration. Un fois l'authentification CAS en place sur le serveur IMAP, passons à SOGo : On commence par mettre en place le service //casProxy// de SOGo : |
| |
| <code>mkdir -p /var/www/mail/cgi-bin |
| cd /var/www/mail/cgi-bin |
| wget https://raw.github.com/inverse-inc/sogo/master/Scripts/cas-proxy-validate.py |
| chmod 755 cas-proxy-validate.py |
| apt-get install python-memcache</code> |
| |
| Il faut également éditer le fichier //cas-proxy-validate.py// et adapter en haut du fichier les paramètres //cas-addr// qui doit correspondre à l'adresse IP du serveur CAS (//127.0.0.1// par défaut) et le paramètre //memcached-addrs// qui doit correspondre à l'IP et le port du service //memcache// utilisé par SOGo (//127.0.0.1:11211// par défaut). |
| |
| On met en place ensuite le //ScriptAlias// correspondant dans la configuration Apache pour SOGo en éditant le fichier ///etc/apache2/conf.d/SOGo.conf// et en ajoutant les lignes suivantes et en les adaptant : |
| |
| * Apache 2.2 (ou inférieur) : <code>ScriptAlias /SOGo/casProxy /var/www/mail/cgi-bin/cas-proxy-validate.py |
| <Location /SOGo/casProxy> |
| Order deny,allow |
| Deny from all |
| Allow from [IP du serveur CAS] |
| Allow from 127.0.0.1 |
| </Location></code> |
| |
| * Apache 2.4 (ou supérieur) : <code>ProxyPass /SOGo/casProxy ! |
| ScriptAlias /SOGo/casProxy /var/www/mail/cgi-bin/cas-proxy-validate.py |
| <Location /SOGo/casProxy> |
| Require ip [IP du serveur CAS] |
| Require ip 127.0.0.1 |
| </Location></code> |
| |
| Il faut ensuite redémarrer Apache pour activer le service. On configure ensuite SOGo en ajoutant dans le fichier ///etc/sogo/sogo.conf// les paramètres suivants : |
| <code>SOGoAuthenticationType = "cas"; |
| SOGoCASServiceURL = "https://login.exemple.org/cas/"; |
| WOWorkersCount = 5; |
| SOGoIMAPCASServiceName = "imap://mail.exemple.org";</code> |
| |
| On redémarre ensuite //SOGo// et ça devrais marcher ! |
| |
| <note>En cas de problème, vous pouvez activer l'option //debug// dans le fichier ///etc/pam_cas.conf// sur le serveur IMAP et suivre l'authentification dans ///var/log/auth.log//.</note> |
| |
| |
| Doc sur le sujet intéressante : http://www.esup-portail.org/consortium/espace/SSO_1B/tech/cas/cas_pam.html |
| |
| ==== Authentic2 ==== |
| |
| Pour configurer SOGo pour qu'il utilise l'IDP Authentic2 comme un serveur CAS, il faut via l'interface d'administration d'Authentic2 : |
| |
| * Créer un service CAS pour SOGo : |
| * **Identifiant :** ce que vous voulez, par exemple le nom de domaine du SOGo |
| * **URLs :** L'URL d'accès de votre SOGo suffixé par ///so/index//. Exemple : https://mail.exemple.com/SOGo/so/index |
| * **Nom de l'attribut :** sélectionner un attribut correspondant au login de l'utilisateur qui devra être reconnue par une de vos //SOGoUserSources// définies dans le fichier //sogo.conf// |
| * Créer un service CAS pour Dovecot : |
| * **Identifiant :** ce que vous voulez, par exemple //Dovecot// |
| * **URLs :** l'URL de service utilisée par //pam-cas// et telque définie dans le paramètre //SOGoIMAPCASServiceName// de SOGo |
| * **Nom de l'attribut :** sélectionner un attribut correspondant au login de l'utilisateur qui devra être reconnu par Dovecot |
| * **Mandataire :** sélectionner le service CAS précédemment créé correspondant à votre SOGo |