Sommaire
Le système auf-django-users est un projet Django qui propose :
une interface Web d’accès à une base d’authentification compatible libnss-mysql-bg (voir AuthentificationCentralisée/NssMysql)
- une aide pour la création de cette base si elle n’existe pas
- une API permettant d’accéder aux données de la base via des objets Python
la possibilité d’ajouter des extensions (contrib), c’est-à-dire d’autres applications liées à la notion d’utilisateur.
Avant tout : ça ressemble à quoi ?
Notre photographe reporter a bien travaillé. Voici à quoi ressemble une installation de l'application quand on la teste sur sa machine : /PhotoRoman
Installation
auf-django-users est destiné à être installé sur un serveur Debian Lenny. Ce serveur a uniquement besoin d'un accès à la base de donnée MySQL, et cela peut-être un accès distant, par IP. Si votre serveur MySQL fonctionne encore en Debian Etch, vous pouvez donc installer auf-django-users sur un serveur à côté, en Lenny.
Le paquet auf-django-users est disponible sur le dépôt de paquets AUF. Pour l'installer sur un serveur Debian Lenny :
- Si vous n'avez pas déjà le dépôt AUF Lenny sur votre serveur :
- ajoutez la source :
deb http://apt.auf.org/ lenny auf
- mettez à jour la liste des paquets et installez la clé AUF :
# aptitude update ; aptitude install auf-keyring ; aptitude update
- ajoutez la source :
Ajoutez le paquet auf-django-users :
# aptitude install auf-django-users
Les dépendances installent automatiquement le module Python Django, entre autres.
Pour vos tests de mise en place, auf-django-users peut également s'installer sur une machine Ubuntu (versions Intrepid et suivantes). Voir la procédure de mise en place rapide ci-dessous.
Documentation complète
La documentation complète est fournie avec le paquet : file:///usr/share/doc/auf-django-users/html/index.html
Note : vous pouvez installer auf-django-users sur votre machine personnelle Ubuntu (Intrepid ou suivante). Cela n'installe aucun service et ne prend pas de ressources sur votre machine (hors quelques kilo-octets de disque dur). Vous aurez alors accès à la documentation en local sur votre machine. Vous pourrez aussi programmer des scripts Python, etc.
Mise en place pour les gens pressés
- Installez le paquet
Astuce Ubuntu : cliquez ici et choisissez le fichier .deb, cela installera directement le paquet sans besoin de modifier vos sources)
Indiquez les coordonnées de votre base de données dans /etc/auf-django-users/conf.py
Astuce : ne touchez à rien si vous voulez juste tester
Lancez un syncdb Django pour créer les tables manquantes dans la base : $ auf-django-users-manage.py syncdb
Lancez le serveur de test : $ auf-django-users-manage.py runserver et rendez-vous sur http://127.0.0.1:8000/
Astuce : si vous avez installé le système sur une machine distante, lancez le serveur avec «... runserver 1.2.3.4:8000» où 1.2.3.4 est l'IP visible de votre serveur. Vous pouvez alors accéder à l'interface à distance en allant sur http://1.2.3.4:8000/
Si tout fonctionne, installez apache2 et libapache2-mod-wsgi et inspirez-vous du fichier /etc/auf-django-users/apache.conf pour mettre l'application en ligne.