2. Vue d’ensemble des paquets WAPT

Cette page présente une vue d’ensemble des différents types de paquets WAPT.

Dans WAPT, la plupart des opérations tournent autour du concept de paquet. Cela inclut les paquets de logiciels classiques, ainsi que les modèles de paquets, les paquets de groupe, les profil AD, les règles WUA, les règles Self-service, les paquets de configuration dynamique de l’agent.

Tous les paquets sont accessibles depuis l’onglet WAPT Packages tab.

Tous les paquets suivants sont stockés dans le répertoire web https://srvwapt.mydomain.lan/wapt/.

Avertissement

Avant d’installer un paquet sur un hôte, assurez-vous que le certificat WAPT est déployé sur cet hôte. Vous pouvez voir le certificat sur la machine cible dans l’onglet Certificate sous la section Inventory dans la console WAPT.

2.1. Modèle de paquet

Les modèles de paquets sont disponibles en cliquant sur WAPT Packages → Make package template from setup file.

Chaque modèle de cette section comprend un assistant qui vous guide tout au long du processus de création du paquet.

WAPT propose sept types de modèles de paquets :

• Windows installer (.msi/.msix/.exe) → Pour l’installation de logiciels sous Windows.

• Application portable Windows → Pour déployer un logiciel portable sous Windows.

• Paquet Windows Update (.msu) → Pour l’installation de mises à jour de KB hors bande ou de mises à jour requises par d’autres services de l’entreprise.

• paquet macOS (.dmg/.pkg/.mpkg) → Pour l’installation du logiciel sur macOS.

• Paquet Linux (.deb/.rpm) → Pour l’installation du logiciel sur les systèmes Debian/Ubuntu et Red Hat/CentOS.

• Paquet de certificat (.crt) → Pour déployer le certificat WAPT sur les machines.

• Paquet vide → Pour effectuer des actions personnalisées sur la machine (nécessite des connaissances de base en ligne de commande ou en Python).

2.1.1. Edition d’un modèle de paquet

Edition d’un modèle de paquet

Étapes pour modifier un modèle de paquet:

1. Pour les fichiers de base (.msu, .crt, .msi, etc.), téléchargez votre fichier en utilisant le bouton de sélection de fichier.

2. Cliquez sur Continuer dans la boîte de dialogue.

3. Dans l”Assistant paquet, personnalisez le nom du paquet, le nom du logiciel et la description.

4. L’assistant propose des flags d’installation silencieuse par défaut. Modifiez-les si nécessaire (consultez la documentation de l’éditeur du logiciel pour connaître la compatibilité).

5. Trois options s’offrent alors à vous :

   • Construire et télécharger : Construit le paquet et le télécharge sur le serveur WAPT. Le paquet est maintenant prêt à être utilisé.

   • Editer manuellement : Ouvre un éditeur de code (PyScripter par défaut). Faites vos modifications, puis utilisez Import package → Build and upload package pour finaliser. Le paquet apparaîtra dans la liste WAPT Packages.

   • Annuler : Abandonne le processus de création du paquet.

Indication

Le modèle paquet vide n’inclut pas de champ de téléchargement de fichier. Il ouvre directement l’éditeur de code et peut être utilisé pour créer un meta-package.

2.2. Paquet Groupe

Un Paquet Groupe vous permet de regrouper plusieurs paquets en une seule unité. Ceci est particulièrement utile lorsque vous devez déployer le même ensemble de paquets sur plusieurs machines. Au lieu d’installer chaque paquet individuellement, vous pouvez déployer un seul paquet de groupe contenant tous les paquets nécessaires.

Les paquet de groupe sont souvent utilisés pour déployer des certificats ou des outils de base (par exemple, tis-vlc, tis-thunderbird, tis-7zip) vers des Organizational Units (OUs) ou des machines spécifiques.

2.2.1. Édition d’un paquet groupe

Ce modèle de paquet est disponible via : Make package template from setup file → Group.

Édition d’un paquet groupe

Étapes de la modification d’un paquet groupe

1. Personnaliser les champs du paquet:

   • Indiquez un nom et une description.

   • Par défaut, la version initiale est fixée à 0.

2. Ajouter des dépendances:

   • Par défaut, le Group Package s’ouvre dans l’onglet Dépendances.

   • Pour ajouter un paquet en tant que dépendance :

     • Sélectionnez un paquet dans le panneau de droite et ajoutez-le comme dépendance au paquet groupe.

     • Vous pouvez également tirer et déposer le paquet du panneau de droite vers le panneau de gauche.

3. Ajouter les paquets conflictuels (facultatif) :

   • Les paquets en conflit vous permettent de spécifier les paquets qui doivent être désinstallés lors de l’installation de ce paquet groupe.

4. Finaliser le paquet groupe:

   • Une fois le paquet groupe terminé, cliquez sur Build Upload.

   • Votre paquet groupe est maintenant prêt à être déployé.

2.3. Profil AD

Le paquet profil AD est conçu pour fonctionner avec les groupes d’ordinateurs Active Directory. Contrairement aux paquets standard, les paquets AD Profile fonctionnent de manière dynamique en fonction de l’appartenance à un groupe Active Directory :

• L’agent WAPT récupère automatiquement la liste des groupes Active Directory auxquels l’hôte appartient.

• Si un Paquet profil AD porte le même nom (sensible à la casse) qu’un groupe Active Directory, l’agent WAPT installera automatiquement le paquetage de profil correspondant à ce groupe.

• Si l’hôte est supprimé d’un groupe Active Directory, le profil AD associé sera désinstallé.

Les paquets de profil AD ne sont pas explicitement assignés à l’hôte (par exemple, en tant que dépendances dans le paquetage de l’hôte). Au lieu de cela, ils sont gérés implicitement par le moteur de dépendances de l’agent WAPT lors des mises à jour de WAPT.

Note

Pour des raisons de performance, cette fonctionnalité est uniquement activée si l’option use_ad_groups est réglée sur True dans le fichier de configuration wapt-get.ini.

Important

Conditions requises:

• Le nom du groupe AD et le programme AD doivent correspondre exactement (sensible à la casse).

• Utilisez le bouton AD pour rechercher le groupe d’ordinateurs Active Directory et éviter les erreurs de frappe.

Exemple:

• AD Security Group: hw_laptops

• WAPT Profile Package: hw_laptops

2.3.1. Editer un paquet profil AD

Vous pouvez créer un paquet profil AD avec Make package template from setup file → AD profile.

Une fenêtre s’ouvre, vous invitant à sélectionner les paquets WAPT que vous souhaitez inclure dans le nouveau Paquet de profil AD.

Editer un paquet profil AD

Édition d’un paquet de profil AD:

1. Définir le nom du paquet:

   • Remplissez le champ nom du paquet avec le nom exact du groupe d’ordinateurs Active Directory (AD) (utilisez le bouton AD pour vous aider).

   • Indiquez un numéro de version et une description.

2. Ajouter des paquets au profil:

   • Sélectionnez les paquets dans le panneau de droite et déplacez-les dans le panneau de gauche (onglet Dépendances).

   • Vous pouvez également tirer et déposer les paquets à l’aide de votre souris.

3. Finaliser le paquet:

   • Cliquez sur Build Upload pour terminer le processus.

   • Votre paquet profil AD est maintenant prêt à être déployé automatiquement.

2.4. Règles WUA

Pour plus d’informations sur WAPTWUA, voir cette documentation.

Lorsqu’un paquet WAPTWUA est installé sur un hôte, il informe l”agent WAPTWUA des KBs qui sont autorisés ou interdits.

Si plusieurs paquets WAPTWUA sont installés sur le même hôte, leurs règles sont fusionnées.

Important

Si un fichier .cab n’est ni autorisé ni interdit dans un paquet WAPTWUA, l’agent WAPT utilisera le paramètre default_allow de wapt-get.ini :

• Si default_allow est fixé à True, seulement les fichiers interdits .cab doivent être explicitement spécifiés.

• Si default_allow est fixé à False`, seuls les fichiers autorisés .cab doivent être explicitement spécifiés.

Indication

Pour tester les mises à jour de Windows en toute sécurité :

• Fixer le niveau de maturité par défaut du paquetage WAPTWUA à PREPROD.

• Testez les mises à jour sur un petit groupe d’hôtes PREPROD.

• Si les mises à jour fonctionnent comme prévu, déployez-les sur l’ensemble du parc d’ordinateurs.

2.4.1. Edition d’un paquet de règles WUA

Pour créer ou modifier un Paquet de règles WUA, allez dans : Make package template from setup file → WUA Rules.

Vous pouvez également gérer les règles WUA directement depuis l’onglet WAPT Packages.

Modification d’un paquet de règles WUA dans la console WAPT

Étapes de la modification d’un paquet de règles WUA :

1. Définir les détails du paquet :

   • Indiquez un nom, une description et sélectionnez le niveau de maturité.

2. Gestion des mises à jour de Windows (KB) :

   • Pour chaque mise à jour (KB), vous pouvez :

     • Autorisez la mise à jour en cliquant sur Autoriser les mises à jour sélectionnées.

     • Bloquez la mise à jour en cliquant sur Forbid Selected Updates.

3. Enregistrez vos modifications:

   • Cliquez sur Save pour finaliser le paquet.

   • Votre Paquet de règles WUA est maintenant prêt à l’emploi.

2.5. Paquet de règles de self-service

Un Paquet de règles de self-service définit quels utilisateurs ou groupes (Active Directory ou local) sont autorisés à installer des paquets spécifiques de manière indépendante. Cela permet aux utilisateurs d’installer des logiciels approuvés sans intervention administrative.

La fonctionnalité WAPT Self-Service est automatiquement disponible sur tout poste de travail où l’agent WAPT est installé.

Note

Pour activer le filtrage des paquets pour les administrateurs locaux, définissez le paramètre suivant dans la configuration de WAPT : waptservice_admin_filter = True.

Cela garantit que les administrateurs locaux ne voient que les paquets qu’ils sont explicitement autorisés à installer.

2.5.1. Edition d’un paquet de règles en Self-Service

Pour créer un paquet de règle de Self-Service, suivez les étapes suivantes : Make package template from setup file → Self-service rules.

Edition d’un paquet de règles en Self-Service

Étapes de modification d’un paquet de règles de self-service:

1. Définir les détails du paquet :

   • Entrez un nom, description, et sélectionnez le niveau de maturité et le système d’exploitation cible.

2. Ajouter des groupes d’utilisateurs :

   • Dans le panneau de gauche, cliquez sur Add et faites un clic droit sur Users Groups.

   • Appuyez sur F2 pour renommer le groupe afin qu’il corresponde à un groupe Active Directory (AD) de votre domaine (sensible à la casse).

   • Vous pouvez également faire un clic droit sur Groupes d’utilisateurs et sélectionner Recherche dans le domaine.

     • Saisissez vos accréditations de domaine.

     • Cliquez sur Connecter au domaine.

     • Sélectionnez les groupes d’utilisateurs que vous souhaitez inclure.

3. Ajouter des paquets autorisés:

   • Sélectionnez un paquet dans le panneau de gauche et cliquez sur Enable pour l’ajouter à la liste du self-service.

   • Vous pouvez également tirer et déposer le paquet dans le panneau central.

4. Enregistrez vos modifications:

   • Cliquez sur Save pour finaliser le paquet.

   • Votre paquet de règles de self-service est maintenant prêt à être utilisé.

2.6. Configuration dynamique de l’agent hôte

Les paquets de configuration vous permettent de modifier les paramètres de configuration de l”agent WAPT. Cette approche permet d’utiliser un agent WAPT générique tout en personnalisant son comportement grâce à des profils spécifiques à l’hôte.

Par exemple :

• Certains hôtes peuvent exiger des règles WAPTWUA différentes.

• D’autres peuvent avoir besoin d’être paramétrés à un niveau de maturité DEV.

Note

Pour afficher ou modifier la configuration de l’agent WAPT pour un ordinateur spécifique :

1. Sélectionnez l’ordinateur dans la console WAPT.

2. Cliquez avec le bouton droit de la souris et choisissez Afficher la configuration de l’agent WAPT.

3. Une fenêtre apparaît, affichant la configuration actuelle et les paquets de configuration appliqués à l’ordinateur.

2.6.1. Fonctionnement de la configuration dynamique

Lorsqu’un paquet de configuration dynamique est appliqué, il crée une section nommée default-« X » (par exemple, default-global, default-waptwua, ou default-reposync) dans le fichier wapt-get.ini.

• Pour visualiser les paramètres actuellement appliqués, reportez-vous à la section défaut-« X ».

• La section « X » originale affiche la configuration initiale de l’agent.

De plus, les fichiers de configuration JSON pour ces paquets sont stockés dans : C:\\NProgram Files (x86)\\Nwapt\\Nconf.d\\N. Chaque fichier suit la convention de nommage : <nom du paquet de configuration>.json.

2.6.2. Interface du paquet de configuration

Lorsque vous ouvrez un paquet de configuration, vous pouvez accéder à trois onglets différents (ou deux si WUA n’est pas activé lors de la post-configuration) :

Onglets dans un paquet de configuration

globalwaptwuarepo-sync

Options	Description	Exemple
repo_url	Définit l’URL du dépôt principal de WAPT	repo_url = https://srvwapt.my.domain.lan/wapt
wapt_server	Définit de l’URL du serveur wapt	wapt_server = https://srvwapt.my.domain.lan
verify_cert	Définit si l’option HTTPS certificate client authentication est activée sur le serveur WAPT.	verify_cert = 0
Use repository rules	Active (1) ou désactive (0) les règles de dépôt pour le waptagent repository documentation.	Use repository rules = 1
use_kerberos	Définit l’utilisation de l’Kerberos authentication des agents WAPT doit être utilisé avec le serveur WAPT, oui (1) ou non (0).	use_kerberos = 1
peercache_enable	activer la fonction de peercache sur le waptagent peercache documentation	peercache_enable = 1
peercache_interface_name	spécifie l’interface sur laquelle vous voulez exécuter peercache. Indiquez l’adresse IP complète telle que spécifiée par ipconfig.	peercache_interface_name = 192.168.1.0
use_ad_groups	Activer ou désactiver l’installation automatique des paquets basés sur les groupes AD Package profil AD	use_ad_groups = 1
maturities	Liste des échéances des paquets qui peuvent être visualisées et installées par l’agent WAPT. La valeur par défaut est PROD. Seules les valeurs DEV, PREPROD et PROD sont utilisées par Tranquil IT, mais n’importe quelle valeur peut être utilisée pour s’adapter à vos processus internes.	maturities = PROD,PREPROD
service_auth_type	Définit le fonctionnement de l’authentification en libre-service. Les valeurs possibles sont : system, waptserver-ldap, waptagent-ldap ou filetoken.	service_auth_type = filetoken
waptaudit_task_period	Définit la fréquence à laquelle les audits sont déclenchés (hh:mm).	waptaudit_task_period = 2h
update_server_status_on_connect	Envoyer (1) ou ne pas envoyer (0) le statut au serveur lors de la reconnexion de l’Agent websocket.	update_server_status_on_connect = 0
allow_remote_reboot	Active (1) ou désactive (0) le redémarrage à distance du waptagent.	Allow_remote_reboot = 1
allow_remote_shutdown	Active (1) ou désactive (0) un arrêt à distance sur le waptagent.	allow_remote_shutdown = 1
wol_relay	Active (1) ou désactive (0) le Wake On Lane pour le waptagent.	wol_relay = 1
use_fqdn_as_uuid	autoriser (1) ou ne pas autoriser (0) l’utilisation du FQDN de l’ordinateur comme UUID.	use_fqdn_as_uuid = 0
use_random_uuid	autoriser (1) ou ne pas autoriser (0) l’utilisation de l’UUID aléatoire de l’hôte.	use_random_uuid = 0
host_profiles	Toujours installer quelques paquets spécifiques. Si ces paquets sont supprimés manuellement, ils seront réinstallés lors de la prochaine mise à jour.	host_profiles = tis-7zip, tis-waptupgrade

2.6.3. Edition d’un paquet de configuration

Edition d’un paquet de configuration

Étapes pour modifier un paquet de configuration:

1. Définir les détails du paquet :

   • Entrez un nom.

   • Définissez la priorité (le cas échéant).

   • Sélectionnez le niveau de maturité.

2. Configurer les paramètres :

   • Choisissez le panneau de configuration souhaité (par exemple, Global, WAPTWUA ou RepoSync).

   • Activer ou désactiver les paramètres requis.

   • Pour certains paramètres, vous devrez entrer une valeur ou sélectionner une option.

3. Enregistrez vos modifications:

   • Cliquez sur Save pour appliquer la configuration.

   • Votre Paquet de configuration est maintenant prêt.