Outil d’importation d'utilisateurs
Modifié par jhurst le 2024/04/02 14:25
Description
importtools est un outil pour gérer les utilisateurs dans le LDAP DigDash. Il est notamment utile dans le cas de gestion d’une grosse base d’utilisateurs.
L'importtools peut être lancé directement via le fichier de commande « importtools.bat » fourni, avec les arguments par défaut (modifiables en éditant le fichier .bat)
ou
Il peut être exécuté via l’outil Java « importtools.jar » fourni dans le dossier <digdash_install>\add-ons\tools\lib avec les arguments par défaut ou personnalisables (voir partie suivante).
java -jar importtools.jar [-conf configfile] [-users userfile] [-out outputfile]
Il permet de régenter la base LDAP DigDash via les opérations suivantes :
Importation d’utilisateurs
Elle consiste principalement à avoir deux fichiers en entrée :
- le fichier de configuration au format XML : le fichier d’exemple conf.xml est livré dans <digdash_install>\add-ons\tools\importtools ; il permet de faire la correspondance entre une colonne du fichier utilisateurs (voir suite) et un attribut d’un utilisateur LDAP dans le fichier de sortie (voir suite).
- le fichier utilisateurs au format Excel ou CSV : le fichier d’exemple users.xls est livré dans <digdash_install>\add-ons\tools\importtools ; Il s’agit de la base utilisateurs (une ligne par utilisateur) à importer dans LDAP. Ses colonnes correspondent aux attributs du fichier de configuration XML.
Et un fichier en sortie :
- le fichier de sortie au format XML : nommé « out.xml » par défaut, il est généré au lancement de l’outil « importtools » avec les deux fichiers mentionnés précédemment en entrée ; il est généré de manière à se mapper sur la structure LDAP.
Suppression d’utilisateurs
Il est possible de supprimer tout ou partie selon critères des utilisateurs de la base LDAP DigDash.
Exportation d’utilisateurs
Il est possible d’exporter les utilisateurs de la base LDAP.
Options :
| Tag | Description |
|---|---|
| Importation | |
| -conf <config file> | Chemin du fichier de configuration XML. Par défaut, conf.xml. |
| -users <excel file / csvfile> | Chemin du fichier en entrée des utilisateurs à importer. Il s’agit d’un fichier Excel ou d’un fichier CSV. Par défaut, users.xls. |
| -out <outputfile> | Chemin du fichier de sortie XML faisant le mapping avec LDAP. Par défaut, out.xml. |
| -help | Commande d’aide d’usage. |
| -debug | Affiche les traces dans les cas erreurs. |
| -import | Envoie le fichier de sortie (par défaut out.xml) au serveur pour l’importer dans LDAP. |
| -importonly | Utilise un fichier de sortie existant (par défaut, out.xml) et l’envoie au serveur pour l’importer dans LDAP. |
| -server | L’adresse du serveur DigDash. |
| -user | L’utilisateur superviseur. |
| -pass | Le mot de passe de l’utilisateur superviseur. |
| Suppression | |
| -removeall | Supprime TOUS les utilisateurs présents dans LDAP ET la licence. |
| -removeall -attr "ldap attribut name" -regexp "regexp" | Supprime toutes les entrées dans LDAP ET la licence lorsque l’attribut spécifié de l’entrée LDAP correspond à l’expression régulière mentionnée. |
| -removeall -attr "license_type" -regexp "extranet" | Cas spécial : supprime l’utilisateur dans LDAP ET le licence si le type de la licence de l’utilisateur est « extranet ». |
| Exportation | |
| -export | Exporte tous les utilisateurs dans un fichier CSV. Par défaut, le fichier d’export se nomme users_export.csv. |
| -exportfile "file.csv" | Exporte tous les utilisateurs dans le fichier CSV mentionné par son chemin absolu (précédé de -export). |
| Logs | |
| -log "C:\temp" | Le fichier log sera créé dans le répertoire spécifié, nommé de la manière suivante : importtool-yyyy-mm-dd_hh-mm-ss.log. |
| -log "C:\log.txt" | Le fichier log sera créé dans le répertoire et sous le nom spécifiés. |
| Autres | |
| -loginForm | Force l’authentification LDAP dans le cas SSO. |
Exemples
- java -jar importtools.jar
- java -jar importtools.jar -conf conf.xml -users users.xls -out out.xml
- java -jar importtools.jar -conf conf.xml -users users.xls -out out.xml -import -server http://localhost:8080 -domain ddenterpriseapi -user admin -pass admin
- java -jar importtools.jar -export -server http://localhost:8080 -domain ddenterpriseapi -user admin -pass admin
- java -jar importtools.jar -export -exportfile "D:\my_users_export.csv" -server http://localhost:8080 -domain ddenterpriseapi -loginForm -user admin -pass admin
- java -jar importtools.jar -removeall -server http://localhost:8080 -domain ddenterpriseapi -user admin -pass admin
- java -jar importtools.jar -removeall -attr "license_type" -regexp "extranet" -server http://localhost:8080 -domain ddenterpriseapi -user admin -pass admin
- java -jar importtools.jar -removeall -attr "uid" -regexp "toto1[0-9]*" -server http://localhost:8080 -domain ddenterpriseapi -user admin -pass admin