<<TableOfContents>>

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.

    || {{attachment:auf-django-users.png}} ||

= 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ôtAPT|dépôt de paquets AUF]]. Pour l'installer sur un serveur Debian Lenny :

 1. Si vous n'avez pas déjà le dépôt AUF Lenny sur votre serveur : 
  1. ajoutez la source :
  {{{
deb http://apt.auf.org/ lenny auf
}}}
  1. mettez à jour la liste des paquets et installez la clé AUF :
  {{{
# aptitude update ; aptitude install auf-keyring ; aptitude update
}}}

 1. Ajoutez le paquet `auf-django-users` :
  {{{
# aptitude install auf-django-users
}}}

Les dépendances installent automatiquement le module Python Django, entre autres.

{i} 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 =
 
 1. Installez le paquet
  * ''Astuce Ubuntu : [[http://apt.auf.org/pool/auf/a/auf-django-users/|cliquez ici]] et choisissez le fichier `.deb`, cela installera directement le paquet sans besoin de modifier vos sources)''
 1. 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''
 1. Lancez un `syncdb` Django pour créer les tables manquantes dans la base : `$ auf-django-users-manage.py syncdb`
 1. 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/`''
 1. 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.