rajout doc

mise au point password.pl qui prend une branche en parametre
mise au point add_attribute.pl qui rajoute l'OC le cas echeant

doc.md

@@ -0,0 +1,50 @@
+##### Documentation
+
+#### Définition des nouveaux attributs
+
+Avant de pouvoir ajouter les nouveaux attributs aux objets ldap existants, il
+faut rajouter leur définition auprès du serveur LDAP.
+
+Cela se fait en injectant le fichier **klesia_entreprise_schema.ldif** via la
+commande:
+```bash
+   sudo ldapmodify -Y EXTERNAL -H ldapi:/// -f klesia_entreprise_schema.ldif
+
+Il faut ensuite rajouter l'attribut objectClass avec la valeur klesiaentreprise
+à tous les objets à qui on souhaite ajouter les attributs.
+```
+
+#### Script 1 : add_attributes.pl
+
+Ce script est responsable de l'ajout de la classe d'objet décrit ci-dessus d'une
+part, et de l'ajout des attributs supplémentaires d'autre part.
+
+Il attend en entrée un fichier csv ayant la structure suivante:
+dn de l'entrée à modifier
+nom attribut 1
+valeur attribut 1
+...
+nom attribut n
+valeur attribut n
+
+Chaque champ étant séparé par un ;
+
+
+Pour chaque ligne du fichier csv:
+  - vérification de la présence de l'attribut objectClass=klesiaEntreprise
+  - rajout de cet attribut le cas échéant.
+  - pour chaque attribut:
+      - mise à jour de l'attribut avec la valeur correspondante
+
+
+#### Script 2 : password.pl
+
+Ce script va modifier toutes les entrées d'une branche ldap donnée ayant un
+attribut **userPassword** non déjà hashé.
+
+Il prend en entrée le dn de la branche à modifier.
+
+Ex d'utilisation:
+```
+perl password.pl ou=PeopleEnt,o=od
+```