Lasso

Présentation des prestations de SSO chez Entr'Ouvert.

Les spécifications

• ID-FF 1.2: conçue par le consortium Liberty Alliance
• SAML V2.0 qui fait converger ID-FF et les versions antérieures de SAML, chapeautée par l'OASIS

Les projets

• Lasso: bibliothèque multi-langages pour utiliser un environnement Liberty Alliance
• Authentic: fournisseur d'identités (support LDAP)
• Larpe: reverse proxy, pour gérer Liberty Alliance sans toucher le code de l'application. Attention, cela ne fonctionne pas toujours, voir par exemple les services Libre-Entreprise qui n'ont pas pu être libertisés (cf. liste interne [1]).
• scalp: module Apache pour gérer une partie de la couche SSO. bzr branch http://perso.entrouvert.org/~fred/bzr/modscalp/. Cette solution ne gère pas les sessions, ni donc le SingleLogout. Elle simplifie l'implémentation de la phase d'authentification, tout étant réalisé dans une même session Apache, avec un résultat sous forme de variable d'environnement (donc pas de problème de confiance / de validation des entrées).
• mod_mellon: autre module Apache fait par d'autres personnes, pourrait remplacer mod_scalp à terme [2].
• javamellon: exemple de Service Provider en Java/Lasso

Exemples

• Libertisation de SPIP
• w.c.s. est un logiciel d'Entr'Ouvert qui utilise Lasso (configuration)
• Démo en ligne

Installation de test

Créer une paire de clef:

• Avec GnuTLS:

certtool --generate-privkey --outfile smthing-priv.pem
# TODO: export public counterpart

• Avec OpenSSL

openssl genrsa -out smthing-priv.pem
openssl rsa -in smthing-priv.pem -pubout > smthing-pub.pem

Obtenir un fichier XML de IDP: installer Authentic. La doc de référence est INSTALL. Elle est un peu spartiate, voici un complément:

• Récupérer Authentic

svn checkout svn://labs.libre-entreprise.org/svnroot/authentic/trunk authentic

• Paquets nécessaires:

aptitude install python-scgi libapache2-mod-scgi python-quixote
echo "deb http://deb.entrouvert.org etch main" >> /etc/apt/sources.list
aptitude update
aptitude install python-lasso

• Installer Authentic (/usr/share/authentic/, /usr/lib/python2.4/site-packages/authentic/, /usr/bin/authenticctl.py):

sudo python setup.py install

• Installer les traductions:

aptitude install gettext
pushd po/
make
make install
popd

• Créer un espace pour les données persistantes:

useradd --home /var/lib/authentic authentic
mkdir -m 755 /var/lib/authentic
chown authentic: /var/lib/authentic

• Démarrer Authentic:

sudo -u authentic authenticctl.py start

• Paramétrer Apache (cf. INSTALL), par exemple pour Apache2+SCGI:

<VirtualHost *>
  ServerAdmin webmaster@localhost
  ServerName authentic.local
  DocumentRoot /usr/share/authentic/web/
  
  SCGIMount / 127.0.0.1:3002
  <LocationMatch "^/(css|images|js)/.*">
    SCGIHandler off
  </LocationMatch>
</VirtualHost>

• Relancer Apache:

a2enmod scgi
invoke-rc.d apache2 restart

• /etc/hosts:

127.0.0.1 authentic.local

• Suivre INSTALL, section "First Use" pour configurer un premier compte (http://authentic.local/admin/), puis demander Liberty Identity Provider Metadata.

Obtenir un fichier XML de SP: voir les didactitiels (tutorials) MAIS MAIS MAIS:

• ne mettez surtout pas d'espaces ou retours chariot autour de votre AssertionConsumerServiceURL comme dans l'exemple, car ils ne seront pas nettoyés et SCGI renverra une URL invalide (et du coup une erreur 500) :/
• le SingleLogoutProtocolProfile est http://projectliberty.org/profiles/slo-sp-soap et non pas http://projectliberty.org/profiles/slo-idp-soap (sp/service provider à la place de idp/identity provider)

Un autre exemple: http://wcs.entrouvert.org/liberty/metadata.xml

Désinstallation

# Lasso
cd /usr/src/la/lasso/
make uninstall
rm -rf /usr/include/lasso/
rm -rf /usr/share/doc/lasso/

# Authentic (no uninstall procedure)
rm -rf /usr/share/authentic/
rm -rf /var/lib/authentic/ # data

# spkitlasso (TODO: check with newer versions)
rm -rf /usr/share/php/spkitlasso/
rm -rf /usr/share/spkitlasso/
rm -rf /var/lib/spkitlasso/ # data

Documentation

• Page officielle
• Wiki d'Entr'Ouvert dont la version wiki de la doc Lasso [3].

Limitations

• Gestion d'erreur améliorable en PHP. La version de développement est en train de se débarrasser de SWIG pour régler la question [4] [5].

Autres

• Candle is a sample Liberty Attribute Provider
• Unwind is a sample Liberty Attributes Consumer
• Expression is a Liberty Alliance, WebDAV and XML based web application framework with its own HTTP server; written in Python
• Lasso Conformance Service Provider is a SAML 2.0 provider aimed to expose every aspect of SAML 2 protocols in the UI so they can be tested in conformance events
• IdPC: Liberty Alliance Identity Provider as a C CGI program - ancêtre de Authentic?
• Souk: ce projet, initialement un environnement de test, n'est non seulement plus maintenu mais également effacé, les auteurs recommandent d'utiliser Authentic à la place
• SAML: article sur Wikipédia anglophone