Merge branch 'main' of https://gitlab.forge.education.gouv.fr/jsecula/glpi-airwatch-sync

README.md

@@ -0,0 +1,42 @@
+# Scripts Airwatch GLPI
+
+## Explication de l'usage des scripts : 
+
+### syncGLPI.py
+Le script syncGLPI.py permet de synchroniser les données des appareils présents dans Airwatch avec un inventaire GLPI.
+
+Au début, le script va vérifier la présence de doublons en fonction du numéro de série et garder seulement le dernier à s'être enrôlé, puis il va procéder à la vérification de la présence des appareils dans l'inventaire GLPI pour procéder à la synchronisation des données.
+
+#### Synchronisation
+Les éléments synchronisés de Airwatch vers GLPI : 
+ - l'utilisateur de l'appareil
+ - la dernière date de remontée vers le serveur Airwatch
+ - UUID
+ - le nom du système d'exploitation et sa version
+ - les logiciels présents sur la machine
+
+Les éléments synchronisés de GLPI vers Airwatch :
+ - Le nom d'inventaire de la machine qui est mis pour le friendlyname
+
+#### Paramètres
+Ce script possède les paramètres suivants qui sont optionnels pour son exécution : 
+
+ - **-debug** : affiche des informations lors de son exécution, utile pour résoudre des problèmes liés à des droits d'accès API ou des problèmes d'ouvertures réseaux
+ - **-searchFilter** : permet de filtrer la recherche des appareils dans airwatch sur un attribut spécifique parmi la liste suivante : "Id", "SerialNumber", "Imei", "UserName"
+ - **-searchValue** : la valeur pour la recherche lorsque -searchFilter est utilisé
+ - **-force** : permet d'outrepasser la vérification du verrou posé par le script lors de son exécution
+
+### StagingUserAssignation.py
+Le script StagingUserAssignation.py permet d'assigner les appareils en staging qui sont assignés à un utilisateur de staging à l'utilisateur renseigné dans l'inventaire GLPI.
+
+Il récupère le nom de l'utilisateur de staging dans le fichier settings.json.
+
+#### Paramètres
+ - **-debug** : affiche des informations lors de son exécution, utile pour résoudre des problèmes liés à des droits d'accès API ou des problèmes d'ouvertures réseaux
+ - **-force** : permet d'outrepasser la vérification du verrou posé par le script lors de son exécution
+
+### Fichier de configuration global settings.json
+Les scripts prennent les informations de configuration du fichier settings.json, si celui-ci n'existe pas au lancement d'un script, il est automatiquement créé avec des valeurs d'exemples.
+
+TO DO
+