WAPT
Suivi du projet de déploiement de poste via la solution de tranquil IT
Documentation
Installation/modification
Installation -> serveur, console, agent | Modification -> serveur, consoleLiens utiles :
Documentation WAPT, serveur
Documentation WAPT, console/agent
Mise en place du serveur
Prérequis
Schéma
Dans la configuration actuel de l'infra de test, voici les caractéristiques :
- le nom FQDN est srvwapt.test-wapt.local ;
- le nom court du Serveur WAPT est srvwapt ;
- le suffixe DNS est test-wapt.local ;
- l’adresse IP est 10.35.1.11/24 ;
Ports réseau
| Service | Ports | Protocoles | Justification |
|---|---|---|---|
| HTTP(S) | 443 | TCP | Canal principal sécurisé pour le transfert de paquets, l'inventaire, et la configuration. Requis pour la communication Console/Agent -> Serveur. |
| HTTP | 80 | TCP | Requis pour le service iPXE (utilisé lors du Déploiement d'OS) pour charger la configuration initiale, comme défini dans les scripts DHCP. |
| TFTP | 69 | UDP | Essentiel pour le déploiement d'OS (PXE). Utilisé pour le transfert des fichiers de démarrage initiaux (ex. snponly.efi) aux clients qui démarrent par le réseau. |
| Kerberos (AD) | 88 | UDP/TCP | Requis pour l'authentification auprès de l'Active Directory (AD) de la part du serveur WAPT, notamment pour l'enregistrement Kerberos des agents WAPT. |
Nom d'hôte
Pour modifier le nom de la machine, on peut faire la commande suivante : nano /etc/hostname afin d'écrire le FQDN du serveur WAPT à la place de l'entrée déjà présente. Cela sera plus simple pour retrouver la machine avec un nom plus parlant.
Réseau
-> Fichier hosts
La modification du fichier /etc/hosts sur le serveur WAPT est une étape essentielle de la configuration qui permet de garantir une stratégie de nommage et d'adressage réseau appropriée pour le bon fonctionnement de WAPT.
# /etc/hosts of the WAPT Server
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
10.35.1.10 srvwapt.test-wapt.local srvwapt
-> Interface réseau
Pour assurer la bonne communication entre les agents et le serveurs, il est essentiel et fondamental :
# /etc/network/interfaces of the WAPT Server
auto eth0
iface eth0 inet static
address 10.35.1.11
netmask 255.255.255.0
gateway 10.35.1.254
Il faudra ensuite redémarrer la machine pour s'assurer de la bonne prise en compte des modifications via la commande reboot et ajouter l'entrée DNS sur le serveur qui possède ce service.
Locales
Pour avoir des journaux non localisés et faciliter la recherche des erreurs courantes, il est nécessaire de définir les locales. Pour ce faire
apt install locales-all -y
localectl set-locale LANG=en_US.UTF-8
localectl status
- Si cela affiche un access denied il faudra faire
dpkg-reconfigure locales
Une fois les locales configurés, il faudra reboot.
Heure et date
À des fins de bonne connectivité, de traçabilité et de sécurité, il faudra vérifier la bonne synchronisation de la date et de l'heure. Pour ce faire, il faudra exécuter la commande timedatectl status
Si la date et l'heure ne sont pas à jour il faudra se référer à la documentation.
Certification
Selon Debian.org
Le paquet ca-certificates permet** aux applications basées sur SSL de vérifier l'authenticité des connexions SSL. Ce qui sera particulièrement utile dans le cadre de l'accès en HTTPS à l'interface web de WAPT, mais aussi il pourra être utile lors de l'ajout de paquets dans le dépôt local.
Pour procéder à l'installation :
apt install ca-certificates -y
Configuration
Paquets obligatoire
La commande suivante installe les utilitaires nécessaires pour sécuriser et préparer l'ajout du dépôt WAPT :
apt install apt-transport-https lsb-release gnupg wget -y
| Paquet | Rôle dans l'installation de WAPT |
|---|---|
apt-transport-https |
Permet au gestionnaire de paquets apt de télécharger les paquets depuis des dépôts sécurisés utilisant le protocole HTTPS (nécessaire pour le dépôt Tranquil IT). |
lsb-release |
Fournit un utilitaire pour identifier la distribution et la version du système d'exploitation (par exemple, "Debian 12"). Cette information est utilisée pour construire l'URL exacte du dépôt WAPT compatible. |
gnupg |
Installe les outils GnuPG (GNU Privacy Guard) requis pour importer et vérifier la clé GPG du dépôt WAPT, assurant l'authenticité et l'intégrité des paquets téléchargés. |
wget |
Outil de ligne de commande pour télécharger des fichiers (ici, utilisé pour récupérer la clé GPG de Tranquil IT). |
-y |
Argument de confirmation automatique, permettant une exécution non interactive de la commande. |
Dépôt
-> Ajout de la clé
Il faut importer la clé publique GPG de Tranquil IT pour authentifier l'origine des paquets WAPT.
sudo bash -c 'wget -qO- https://wapt.tranquil.it/$(lsb_release -is)/tiswapt-pub-2026.gpg > /usr/share/keyrings/tiswapt-pub.gpg'
-> Ajout du dépôt
Pour obtenir les paquets provenant de provenant de Tranquil IT, il faudra ajouter ce dépôt :
echo "deb [signed-by=/usr/share/keyrings/tiswapt-pub.gpg] https://wapt.tranquil.it/$(lsb_release -is)/wapt-2.6/ $(lsb_release -c -s) main" > /etc/apt/sources.list.d/wapt.list
Paquets supplémentaires
Mettre à jour l'index des paquets et installer le Serveur WAPT ainsi que les outils de configuration associés, en mode non interactif pour garantir une installation fluide.
export DEBIAN_FRONTEND=noninteractive
apt update
apt install tis-waptserver tis-waptsetup -y
unset DEBIAN_FRONTEND
Post-conf
Enfin, pour configurer notre serveur WAPT, il faudra exécuter un script (postconf.sh) présent au chemin suivant : /opt/wapt/waptserver/scripts/postconf.sh
Qui se décompose de cette manière :
- Cliquez sur Oui pour exécuter le script de post-configuration.
Do you want to launch post configuration tool?
< yes > < no >
- Choisissez un mot de passe (si ce n’est pas déjà défini) pour le compte SuperAdmin du Serveur WAPT (longueur minimale de 10 caractères).
Please enter the wapt server password (min. 10 characters)
*****************
< OK > < Cancel >
- Confirmez le mot de passe.
Please enter the server password again:
*****************
< OK > < Cancel >
Choisissez le mode d’authentification pour l’enregistrement initial des Agents WAPT :
- Le choix n°1 : Permet d’enregistrer les ordinateurs sans authentification. Le Serveur WAPT enregistre tous les ordinateurs qui demandent à être enregistrés.
Sans certificat, il n’est pas possible de télécharger les paquets WAPT et d’interroger certains points d’accès du serveur WAPT. Cette méthode est recommandée si vous installez WAPT pour la première fois.
- Le choix n°2 (celle que j'ai choisi) : Active l’enregistrement initial basé sur Kerberos (vous pourrez l’activer aussi plus tard). Si vous rencontrez des problèmes lors de la mise à jour OU si vous utilisez un reverse proxy, cette méthode est recommandée pour le temps de la mise à jour.
Si vous voulez utiliser l’option 2 et que votre keytab Kerberos n’existe pas, le script postconf.sh le créera, après que vous ayez validé l’option 2. Il faudra lire la sous-partie keytab.
- Le choix n°3 : N’active pas le mécanisme d’authentification kerberos pour l’enregistrement initial des hôtes équipés de WAPT. Le Serveur WAPT exigera un login et un mot de passe pour chaque hôte s’enregistrant auprès de lui.
WaptAgent Authentication type?
--------------------------------------------------------------------------
(x) 1 Allow unauthenticated registration
( ) 2 Enable kerberos authentication required for machines registration.
Registration will ask for password if kerberos not available
( ) 3 Disable kerberos but registration require strong authentication
--------------------------------------------------------------------------
< OK > < Cancel >
- Si vous souhaitez utiliser WAPT pour le déploiement de systèmes d’exploitation, sélectionnez
Oui.
Si vous avez choisi Oui pour activer le déploiement d’OS, la post-configuration vous demandera si vous souhaitez utiliser une authentification sécurisée pour déployer les images d’OS. Il vous demandera un utilisateur / mot de passe lorsque vous allez déployer des images d’OS en utilisant WADS (mon cas).
- Si vous avez choisi
Non, Nginx n’activera pas les points d’extrémité de l’API WADS pour les Agents WAPT.
Do you want to activate os deployment?
< Yes > < No >
L’authentification sécurisée pour WADS exige que l’utilisateur soit authentifié sur la machine où le système d’exploitation sera déployé.
Would you like to activate secure authentication on wads?
< Yes > < No >
Toujours en ce qui concerne la fonction WADS, si vous avez répondu Oui aux 2 dernières questions, vous aurez une dernière question :
Would you like to mention subnet ip exempt from wads authentication
< Yes > < No >
- Si vous répondez
Ouià cette question, vous devrez donner un sous-réseau IP en format liste : 192.168.0.0/24,192.168.1.0/24. Cela permettra à ce que les machines présents au sein du/des sous-réseaux puisse ce connecter avec wads sans authentification.
Choisissez si vous voulez utiliser WAPT WUA pour Windows Update.
Do you want to activate WUA?
< Yes > < No >
- Si vous choisissez
Oui, Nginx activera les points de terminaison de l’API WUA pour les Agents WAPT.
Sélectionnez Oui pour configurer Nginx.
Do you want to configure nginx?
< Yes > < No >
Indiquez le FQDN du Serveur WAPT.
FQDN for the WAPT Server (eg. wapt.example.com)
---------------------------------------------
srvwapt.mydomain.lan
---------------------------------------------
< OK > < Cancel >
Sélectionner OK et un certificat auto-signé sera généré. Cette étape peut prendre un certain temps.
Generating DH parameters, 2048 bit long safe prime, generator 2 This is going to take a long time
.......................................+...............................+...
Nginx est maintenant configuré, sélectionnez OK pour redémarrer Nginx :
The Nginx config is done.
We need to restart Nginx?
< OK >
Sélectionnez OK pour démarrer le Serveur WAPT.
Press OK to start waptserver and wapttasks daemons
< OK >
La post-configuration est maintenant terminée.
Postconfiguration completed.
Please connect to https://srvwapt.test-wapt.local/ to access the WAPT Server.
< OK >
- Ajouté dans la version 2.5: L’accès à l’interface web de WAPT est désormais protégé par un mot de passe.
Enfin, le postconf affiche quelques informations sur le certificat SSL du Serveur WAPT et l’URL pour télécharger WaptSetup et l’installer sur l’ordinateur de l’Administrateur WAPT.
Annexe
Keytab
Création de votre Keytab, après selection de l'activation kerberos pour la première fois.
Enter Kerberos REALM (domain name)
-----------------------------------
MYDOMAIN.LAN
-----------------------------------
< Yes > < Cancel >
Enter a Domain Controller name in write mode
-----------------------------------
srvads1.mydomain.lan
-----------------------------------
< Yes > < Cancel >
Enter a username authorized to join machines to the domain.
-----------------------------------
administrator
-----------------------------------
< Yes > < Cancel >
Enter administrator password
-----------------------------------
**************
-----------------------------------
< Yes > < Cancel >
Enter the URL that will be used by the WAPTAgent
-----------------------------------
srvwapt.mydomain.lan
-----------------------------------
< Yes > < Cancel >
Choose the name of the computer used by the waptserver
-----------------------------------
SRVWAPT
-----------------------------------
< Yes > < Cancel >
Keytab file is correctly generated in /etc/nginx/http-krb5.keytab
< OK >
Mise en place de la console
Installation
Pour installer la console WAPT, il est nécessaire de ce rendre à l'adresse indiquée en fin de script postconf.shqui correspond au FQDN du serveur.
- Comme mentionné à la page Mise en place du serveur, Pour ce connecter l'ID est admin et le mot de passe est celui entrer dans le script post-conf.
- Une fois les identifiants entré on se retrouve sur l'interface web WAPT qui nous permet de télécharger le "WAPT Setup" pour Windows.
- Lancer le programme d'installation et accepter les termes de licences. La coche "Installer le service résident WAPT" permet d'avoir le service WAPT d'installé sur le poste. La coche "Lancer l'icone de notification lors de l'ouverture de session" permet de lancer le service de la console (
wapttray) au démarrage du poste, pratique, dans le cadre d'une machine dédiée à la console WAPT.
- Le but est, de ne pas modifier la configuration actuelle car, on va pouvoir modifier la configuration au premier lancement de la console. De plus, je laisse cocher la case Kerberos car ma configuration actuelle le permet et est configuré.
- A la fin du setup d'installation de la console on va laisser cocher "lancement de l'icône de notification" pour que
wapttrayce lance à la fermeture du programme d'installation.
Configuration
Dans cette partie on va configurer notre console mais aussi notre agent afin de pouvoir déployer au mieux la solution au sein de l'infrastructure.
- Dans un premier temps, il est demandé de remplir le FQDN dans le premier champ.
- On fait confiance au certificat générer par le post script.
- Voici ce que cela donne après confirmation de confiance et récupération du certificat. Il est possible de passer à la sous-partie suivante.

Clé
Cette partie n'est pas très complexe mais est nécessaire notamment pour la signature de paquet et même de l'agents qui sera installer sur le poste console et/ou sur les postes utilisateur.
- Dans un premier temps, il faudra choisir "Nouvelle clé et certificat"
- Dans un second, remplir les champs

Une fois les champs remplis, il faudra confirmer les informations, et vérifier la clé en rentrant le mot de passe associé.
Licences
WAPT est une solution qui peut s'utiliser de manière gratuite via la formule Discovery mais en y intégrant une licence dit "Entreprise" on débloque tout le potentiel de la solution notamment, la fonctionnalité de déploiement de poste qui va nous interesser dans la suite de cette documentation.
Pour la licence rien de plus simple une fois l'email de confirmation reçu de la part de TranquilIT un fichier en .lic y est inclus. Ce fichier est un fichier licence qui sera à intégrer la première fois que la console est ouverte, cet étape intervient après la configuration initiale. D'ailleurs une pop-up s'affiche nous informant de la possibilité d'y glisser le fichier de licence.
- Après avoir confirmer le choix d'affectation de licence, il faudra choisir "Activer une licence. De parcourir le poste de travail pour choisir le fichier en .lic.

Création agent
Lors de la configuration de la console, WAPT demandera à ce que l'agent soit présent sur la machine où la console a été installé. De ce fait une pop-up s'affichera invitant l'utilisateur à cocher ou non des options selon sa configuration.

Quelques précisions sur les informations de base :
| Valeur | Description | Requis | Entreprise |
|---|---|---|---|
| Certificats de paquets autorisés | Définit tous les certificats de confiance intégrés au programme d’installation de l’Agent WAPT et définis dans la configuration par défaut. | Non | Oui |
| Adresse du Serveur WAPT | Définit l’URL du dépôt WAPT principal. | Oui | Oui |
| Adresse du serveur WAPT | Définit l’URL du Serveur WAPT. | Oui | Oui |
| Vérifier le certificat https serveur | Définit si l’authentification client du certificat HTTPS est activée sur le Serveur WAPT. | Non | Oui |
| Utiliser Kerberos pour l’enregistrement initial | Définit si l’authentification Kerberos des Agents WAPT doit être utilisée avec le Serveur WAPT. | Non | Oui |
Lorsque l'on coche la case "Voir les options avancées" voici quelques précisions :
| Valeur | Description | Requis | Entreprise |
|---|---|---|---|
| Toujours installer ces paquets « profile » sur les postes | Définit s’il faut installer automatiquement les packages du groupe lors de l’installation de l’Agent WAPT. | Non | Oui |
| Autoriser l’installation automatique de packages basés sur les groupes AD | Permet l’installation des packages de profil. Cette fonctionnalité peut dégrader les performances de WAPT. | Non | Oui |
| Autoriser le redémarrage à distance | Définit si les redémarrages à distance sont autorisés à partir de la Console WAPT. | Non | Oui |
| Autoriser l’arrêt à distance | Définit si les arrêts à distance sont autorisés à partir de la Console WAPT. | Non | Oui |
| Inclure les infos DMI dans l’inventaire | Obtenir des informations sur les DMI dans l’inventaire de l’agent. | Non | Oui |
| Inclure les infos WMI dans l’inventaire | Obtenir des informations WMI dans l’inventaire de l’agent. | Non | Oui |
| Utiliser les règles d’accès au dépôt | Définit si les règles d’accès aux dépôts doivent être utilisées pour répliquer les dépôts distants. | Non | Non |
| Utiliser le FQDN de l’ordinateur comme UUID | Définit si les FQDN doivent être utilisés pour identifier les Agents WAPT. | Non | Oui |
| Utiliser un UUID hôte aléatoire (pour les BIOS bogués) | Définit si des UUID aléatoires doivent être utilisés pour identifier les Agents WAPT. | Non | Oui |
| Gérer les mises à jour de Windows avec WAPT | Désactiver WAPT WUA | Ne rien définir | Active ou désactive WAPT WUA. | Non | Oui |
| Maturité du paquet Waptupgrade | Permet de choisir la maturité du paquet Waptupgrade. | Non | Oui |
Enfin si une fenêtre s'affiche afin de vous demander d'appliquer la configuration sur la machine, accepter, sinon à la fin de création lancer l'agent crée, au repertoire ouvert automatiquement.
Pour vérifier le fonctionnement de l'agent, il faut regarder si l'appareil est présent dans l'inventaire.
Configuration déploiement (serveur)
- Extinction des services waptserver, waptservice.
- Accès au fichier waptserver.ini, trouvable dans le chemin
/opt/wapt/conf/waptserver.ini. - Modification des valeurs de
wads_enableetwaptwua_enabledeFalseàTrue. - Ajout de
login_on_wadsen valeurTrue. - Ajout de
list_subnet_skip_login_wadsavec comme valeur le sous-réseau dédié au déploiement de postes. - Mise en place du démarrage du service
wapttftpserverautomatique viasystemctl enable. - Lancement des services
waptserver,waptservice,wapttftpserver. - Ajout des règles DHCP :
$scopeId = "10.35.1.0" # Sous-réseau cible
$waptserver_ipaddress_tftp = "10.35.1.11" # Adresse du serveur TFTP
$url_waptserver = "http://srvwapt.test-wapt.local" # URL du serveur WAPT
$keymap = "fr"
# Define DHCP Classes
Add-DhcpServerv4Class -Name "legacy_bios" -Type Vendor -Data "PXEClient:Arch:00000" -ErrorAction SilentlyContinue
Add-DhcpServerv4Class -Name "iPXE" -Type User -Data "iPXE" -ErrorAction SilentlyContinue
# Define option 66 (TFTP) for the declared scope only
Set-DhcpServerv4OptionValue -ScopeId $scopeId -OptionId 66 -Value $waptserver_ipaddress_tftp
# Define policies for this scope
# 1. Legacy BIOS without iPXE
Add-DhcpServerv4Policy -ScopeId $scopeId -Name "pxebootn12" -Condition AND -UserClass NE,iPXE -VendorClass EQ,legacy_bios* -ErrorAction SilentlyContinue
Set-DhcpServerv4OptionValue -ScopeId $scopeId -PolicyName "pxebootn12" -OptionID 67 -Value "boot/pxeboot.n12"
# 2. iPXE + legacy BIOS
Add-DhcpServerv4Policy -ScopeId $scopeId -Name "wapt-ipxe-url-legacy" -Condition AND -UserClass EQ,iPXE -VendorClass EQ,legacy_bios* -ErrorAction SilentlyContinue
Set-DhcpServerv4OptionValue -ScopeId $scopeId -PolicyName "wapt-ipxe-url-legacy" -OptionID 67 -Value "$url_waptserver/api/v3/baseipxe?uefi=false&keymap=$keymap"
# 3. Non iPXE + non legacy BIOS
Add-DhcpServerv4Policy -ScopeId $scopeId -Name "bootmgfw.efi" -Condition AND -UserClass NE,iPXE -VendorClass NE,legacy_bios* -ErrorAction SilentlyContinue
Set-DhcpServerv4OptionValue -ScopeId $scopeId -PolicyName "bootmgfw.efi" -OptionID 67 -Value "efi/boot/bootmgfw.efi"
# 4. iPXE + UEFI
Add-DhcpServerv4Policy -ScopeId $scopeId -Name "wapt-ipxe-url-uefi" -Condition AND -UserClass EQ,iPXE -VendorClass NE,legacy_bios* -ErrorAction SilentlyContinue
Set-DhcpServerv4OptionValue -ScopeId $scopeId -PolicyName "wapt-ipxe-url-uefi" -OptionID 67 -Value "$url_waptserver/api/v3/baseipxe?keymap=$keymap"
- Ajout de la configuration HTTP :
$waptserver_ipaddress_tftp = "10.35.1.11" # Adresse du serveur TFTP
$url_waptserver = "http://srvwapt.test-wapt.local" # FQDN du serveur WAPT
$keymap = "fr"
Add-DhcpServerv4Class -Name "legacy_bios" -Type Vendor -Data "PXEClient:Arch:00000"
Add-DhcpServerv4Class -Name "iPXE" -Type User -Data "iPXE"
Set-DhcpServerv4OptionValue -OptionId 66 -Value "$waptserver_ipaddress_tftp"
Add-DhcpServerv4Policy -Name "wapt-ipxe-url-legacy" -Condition AND -UserClass EQ,iPXE -VendorClass EQ,legacy_bios*
Set-DhcpServerv4OptionValue -PolicyName "wapt-ipxe-url-legacy" -OptionID 67 -Value "$url_waptserver/api/v3/baseipxe?uefi=false&keymap=$keymap"
Add-DhcpServerv4Policy -Name "wapt-ipxe-url-uefi" -Condition AND -UserClass EQ,iPXE -VendorClass NE,legacy_bios*
Set-DhcpServerv4OptionValue -PolicyName "wapt-ipxe-url-uefi" -OptionID 67 -Value "$url_waptserver/api/v3/baseipxe?keymap=$keymap"
Add-DhcpServerv4Policy -Name "snponly.efi" -Condition AND -UserClass NE,iPXE -VendorClass NE,legacy_bios*
Set-DhcpServerv4OptionValue -PolicyName "snponly.efi" -OptionID 67 -Value "snponly.efi"
Add-DhcpServerv4Policy -Name "undionly.kpxe" -Condition AND -UserClass NE,iPXE -VendorClass EQ,legacy_bios*
Set-DhcpServerv4OptionValue -PolicyName "undionly.kpxe" -OptionID 67 -Value "undionly.kpxe"
Déploiement
Cette catégorie concerne toute la partie déploiement.Liens utiles :
Documentation WAPT
Générateur Schneegans
Modification de la configuration (console)
Ajout de la fonctionnalité de déploiement
Pour ajouter la fonctionnalité de déploiement de postes il faudra ajouter une image WinPE, cette capture provient de la console qui nous indique d'ajouter une image.
Prérequis
Paquets
Il faudra aller d'abord chercher les paquets tis-wads-requirement-minimal-x64 et tis-wads-requirement-minimal trouvable dans le dépôt de TranquilIT. Voici une procédure pour l'ajout de paquet
NOTE : Il faut que le paquet soit installé soit sur un poste, soit sur la console dédiée. Au moins une fois.
Pilotes
Une fois démarrer sur le réseau l'ordinateur est lancé sur l'image WinPE créer. A cet image s'ajoute une surcouche WADS qui viendra configurer le système selon le fichier unattend.xml avec les pilotes, afin d'installer le système.
Pour exporter les pilotes nous avons plusieurs choix:
- Possibilité d'utiliser des pilotes génériques dans ce cas, il est possible d'utiliser les pilotes de machine virtuelles (oui oui de VM). Puis de faire les maj, après dans les paramètres ou via Dell Command Update
- (plus fiable) Possibilité de démarrer un pc fraichement arriver, le configurer, faire les maj de pilotes et de les exporter via la commande :
Export-WindowsDriver -Online -Destination FICHIER_DE_DESTINATION
3. Voir avec le fabricant, pour qu'il fournisse les fichiers en .inf répartie dans des dossiers distinct. Exemple pour la carte réseau d'une VM :
netkvm.inf
|-> netkvm.cat
|-> netkvm.inf
|-> netkvm.pnf
|-> netkvm.sys
|-> netkvmp.exe
NOTE : Pour la création de l'image WinPE il sera nécessaire la première fois d'avoir un pack de pilotes.
Déploiement
Une fois les prérequis remplit il est alors possible de créer notre image WinPE qui servira pour le démarrage en réseau.
- Une fois cliqué sur "oui" on arrive sur cet assistant de conception. On pourra cliquer sur la configuration de clavier qui nous interesse et choisir le dossier de pilote afin de confirmer la création.

ISO
Récupération de l'Image Windows
Prérequis :
- Avoir obtenu l'image ISO de Windows.
- Être connecté à la Console WAPT
Intégration de l'ISO dans la Console WAPT
L'image ISO doit être mise à disposition du service WADS (WAPT Deployment Services) pour être exploitée lors du déploiement.
- Accéder à l'interface de Déploiement d'OS :
- Sur la Console WAPT, naviguez vers l'onglet Déploiement d'OS (Déploiement de postes).
- Importer l'ISO d'installation :
- Dans la section Déploiement d'OS, cherchez l'option ou l'icône Importer des machines depuis un CSV ou Ajouter une ISO d'installation.
- Suivez l'assistant :
- Pointez vers le chemin local où vous avez stocké votre fichier ISO Windows.
- La Console WAPT analyse l'image pour détecter les versions de Windows (WIM files) qu'elle contient.
- Sélectionner l'Architecture :
- Choisissez l'architecture correspondante (ex.
x64).
- Enregistrement de l'ISO :
- La Console WAPT enregistre l'ISO, la rendant disponible pour être liée à un profil de déploiement.
Création de la Clé WinPE (Windows Preinstallation Environment)
Le WinPE est l'environnement minimal que le client télécharge via TFTP/HTTP pour exécuter l'Agent WAPT et lancer le processus d'installation.
- Dans la section Déploiement d'OS, utilisez le bouton Créer une clé WinPE.
- Sélectionner les options :
- L'outil va vous demander de sélectionner le modèle WinPE de base.
- Assurez-vous que l'option pour inclure l'Agent WAPT et les outils nécessaires est cochée.
- Génération et Enregistrement :
- Lancez la génération de la clé WinPE. Le fichier généré sera stocké sur le Serveur WAPT (
SRVWAPT) et utilisé par le service TFTP lors du démarrage PXE.
Prochaines Étapes Logiques
Une fois l'ISO et le WinPE intégrés, les étapes finales consisteront à :
- Exporter les pilotes nécessaires pour vos postes clients et les intégrer dans des paquets WAPT (via l'onglet Pilotes).
- Créer une Configuration (un profil de déploiement) dans l'onglet Déploiement d'OS pour lier l'ISO, les pilotes et les actions à effectuer (formatage, jointure de domaine, etc.).
Configuration
Cette partie est dédiée à documenter une configuration Windows 11 24H2+ type, fonctionnel.
NOTE : Il n'est pas obligatoire d'installer systématiquement l'agent WAPT ni même de joindre un domaine, pratique dans le cas de la vente de l'ordinateur ou de configuration pour des franchisés.
Description
Le script suivant :
- Configure la langue d'installation en français
- Installe la version Pro de Windows (index 6)
- Cible et formate la première partition disponible
- Injecte les pilotes
- Définis le nom de la machine comme le nom d'enregistrement auprès de la console
- Désactive la télémétrie
- Passe les écrans OOBE
- Joins le domaine de manière autonome
Script
<?xml version="1.0" encoding="utf-8"?>
<unattend xmlns="urn:schemas-microsoft-com:unattend">
<settings pass="windowsPE">
<component name="Microsoft-Windows-International-Core-WinPE" processorArchitecture="{{architecture}}" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SetupUILanguage>
<UILanguage>fr-FR</UILanguage>
</SetupUILanguage>
<InputLocale>040c:0000040c</InputLocale>
<SystemLocale>fr-FR</SystemLocale>
<UILanguage>fr-FR</UILanguage>
<UILanguageFallback>fr-FR</UILanguageFallback>
<UserLocale>fr-FR</UserLocale>
</component>
<component name="Microsoft-Windows-Setup" processorArchitecture="{{architecture}}" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ImageInstall>
<OSImage>
<InstallToAvailablePartition>true</InstallToAvailablePartition>
<WillShowUI>OnError</WillShowUI>
<InstallFrom>
<MetaData>
<Key>/IMAGE/INDEX</Key>
<Value>6</Value>
</MetaData>
</InstallFrom>
</OSImage>
</ImageInstall>
<UserData>
<ProductKey>
<Key/>
</ProductKey>
<AcceptEula>true</AcceptEula>
</UserData>
<UseConfigurationSet>false</UseConfigurationSet>
</component>
</settings>
<settings pass="offlineServicing">
<component name="Microsoft-Windows-PnpCustomizationsNonWinPE" processorArchitecture="{{architecture}}" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<DriverPaths>
<PathAndCredentials wcm:keyValue="1" wcm:action="add">
<Path>c:\installdir\drivers</Path>
</PathAndCredentials>
</DriverPaths>
</component>
</settings>
<settings pass="generalize">
<component name="Microsoft-Windows-Security-SPP" processorArchitecture="{{architecture}}" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SkipRearm>1</SkipRearm>
</component>
</settings>
<settings pass="specialize">
<component name="Microsoft-Windows-UnattendedJoin" processorArchitecture="{{architecture}}" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Identification>
<Credentials>
<Domain>adwapt.local</Domain>
<Password>pass</Password>
<Username>wadsjoin@adwapt.local</Username>
</Credentials>
<JoinDomain>adwapt.local</JoinDomain>
</Identification>
</component>
<component name="Microsoft-Windows-International-Core" processorArchitecture="{{architecture}}" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<InputLocale>040c:0000040c</InputLocale>
<SystemLocale>fr-FR</SystemLocale>
<UILanguage>fr-FR</UILanguage>
<UILanguageFallback>fr-FR</UILanguageFallback>
<UserLocale>fr-FR</UserLocale>
</component>
<component name="Microsoft-Windows-Security-SPP-UX" processorArchitecture="{{architecture}}" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SkipAutoActivation>true</SkipAutoActivation>
</component>
<component name="Microsoft-Windows-SQMApi" processorArchitecture="{{architecture}}" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<CEIPEnabled>0</CEIPEnabled>
</component>
<component name="Microsoft-Windows-Shell-Setup" processorArchitecture="{{architecture}}" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ComputerName>{{hostname}}</ComputerName>
<ProductKey>VK7JG-NPHTM-C97JM-9MPGT-3V66T</ProductKey>
</component>
<component name="Microsoft-Windows-Deployment" processorArchitecture="{{architecture}}" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<RunSynchronous>
<RunSynchronousCommand wcm:action="add">
<Path>"c:\installdir\wads.exe" --setup-startup-script="c:\installdir\SetupComplete.cmd"</Path>
<Order>2</Order>
<Description>postinstall</Description>
</RunSynchronousCommand>
</RunSynchronous>
</component>
</settings>
<settings pass="oobeSystem">
<component name="Microsoft-Windows-Shell-Setup" processorArchitecture="{{architecture}}" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<OOBE>
<HideEULAPage>true</HideEULAPage>
<HideOEMRegistrationScreen>true</HideOEMRegistrationScreen>
<HideOnlineAccountScreens>true</HideOnlineAccountScreens>
<HideWirelessSetupInOOBE>true</HideWirelessSetupInOOBE>
<NetworkLocation>Work</NetworkLocation>
<SkipUserOOBE>true</SkipUserOOBE>
<SkipMachineOOBE>true</SkipMachineOOBE>
<ProtectYourPC>1</ProtectYourPC>
</OOBE>
<AutoLogon>
<Enabled>true</Enabled>
<LogonCount>1</LogonCount>
<Domain>adwapt.local</Domain>
<Username>Administrateur@adwapt.local</Username>
<Password>
<value>pass</value>
<PlainText>true</PlainText>
</Password>
</AutoLogon>
<RegisteredOrganization>CHCOM</RegisteredOrganization>
<RegisteredOwner>CHCOM</RegisteredOwner>
<DisableAutoDaylightTimeSet>false</DisableAutoDaylightTimeSet>
<TimeZone>Romance Standard Time</TimeZone>
</component>
</settings>
</unattend>
Plus de détails
Variables
Ces variables servent tout du long du fichier de configuration :
| Paramètre générique | Description |
|---|---|
| {{architecture}} | Variable WAPT/WADS remplacée par l'architecture du système cible (ex: amd64). |
| {{hostname}} | Variable WAPT/WADS remplacée par le nom d'hôte de la machine à déployer. |
Composants
| Composant | Paramètres clés | Rôle / Justification |
|---|---|---|
| windowsPE | ||
| Microsoft-Windows-International-Core-WinPE | UILanguage, InputLocale, SystemLocale, UserLocale | Configuration linguistique initiale : Définit toutes les langues et formats régionaux sur Français (France) (fr-FR, code 040c). |
| Microsoft-Windows-Setup | InstallToAvailablePartition: true | Ciblage de l'installation : Indique au programme d'installation de formater et d'utiliser la première partition disponible pour l'OS. |
| Microsoft-Windows-Setup | Key: /IMAGE/INDEX Value: 6 | Sélection de l'image (WIM) : Spécifie que l'image à installer est la 6ème image trouvée dans le fichier WIM de l'ISO. (Généralement, pour Windows Server, l'index 6 correspond à une édition spécifique, ex: Datacenter/Standard avec expérience utilisateur.) |
| Microsoft-Windows-Setup | AcceptEula: true | Contrat de Licence : Accepte automatiquement le contrat de licence utilisateur final (EULA). |
| Microsoft-Windows-Setup | ProductKey: <Key/> | Clé produit : Le champ est laissé vide ici, car la clé de produit sera généralement insérée plus tard dans la passe specialize (ou dans la phase de configuration WAPT). |
| offlineServicing | ||
| Microsoft-Windows-PnpCustomizationsNonWinPE | Path: c:\installdir\drivers | Injection de Pilotes : Spécifie le chemin d'accès aux pilotes qui doivent être installés dans l'image Windows. WADS s'assure que les pilotes nécessaires sont bien placés dans ce répertoire temporaire (c:\installdir\drivers) avant l'exécution de cette passe. |
| generalize | ||
| Microsoft-Windows-Security-SPP | SkipRearm: 1 | Activation de la Licence : Empêche le processus Sysprep de "réarmer" l'état d'activation de la licence Windows. |
| specialize | ||
| Microsoft-Windows-Shell-Setup | ComputerName: {{hostname}} | Nom de la machine : Le nom de l'ordinateur est défini en utilisant la variable fournie par WADS ({{hostname}}), garantissant que chaque machine déployée aura un nom unique et cohérent. |
| Microsoft-Windows-Shell-Setup | ProductKey: VK7JG-NPHTM-C97JM-9MPGT-3V66T | Clé de licence : Insère une clé de produit. (Ceci est souvent une clé générique KMS/GVLK pour l'édition Standard ou Datacenter et nécessite un serveur KMS pour l'activation finale.) |
| Microsoft-Windows-UnattendedJoin | JoinDomain: adwapt.local | Jointure de Domaine : Joint l'ordinateur au domaine adwapt.local. |
| Microsoft-Windows-UnattendedJoin | Credentials | Authentification de la jointure : Fournit les identifiants pour effectuer la jointure au domaine (wadsjoin@adwapt.local / pass). |
| Microsoft-Windows-International-Core | UILanguage, InputLocale, etc. | Configuration linguistique de l'OS : Répète la configuration française pour l'environnement utilisateur final de l'OS. |
| Microsoft-Windows-Security-SPP-UX | SkipAutoActivation: true | Activation de la Licence : Ignore la tentative d'activation automatique de Windows. |
| Microsoft-Windows-SQMApi | CEIPEnabled: 0 | Télémétrie : Désactive la participation au programme d'amélioration de l'expérience client (CEIP). |
| Microsoft-Windows-Deployment | RunSynchronousCommand | Script de post-installation : Exécute le script wads.exe qui met en place le script de démarrage final (c:\installdir\SetupComplete.cmd). Ce script est essentiel pour le déploiement WAPT/WADS car il est généralement responsable de l'installation finale de l'Agent WAPT et du lancement des paquets d'installation. |
| oobeSystem | ||
| Microsoft-Windows-Shell-Setup | HideEULAPage: true, SkipUserOOBE: true, SkipMachineOOBE: true | Passer OOBE : Désactive tous les écrans d'expérience utilisateur initiale (questions de compte, paramètres Wi-Fi, EULA, etc.) pour rendre l'installation entièrement silencieuse. |
| Microsoft-Windows-Shell-Setup | TimeZone: Romance Standard Time | Fuseau Horaire : Définit le fuseau horaire, généralement sur l'heure d'Europe centrale (CET/CEST), cohérent avec la France. |
| Microsoft-Windows-Shell-Setup | RegisteredOrganization, RegisteredOwner | Informations d'enregistrement : Enregistre la machine sous l'organisation CHCOM. |
| Microsoft-Windows-Shell-Setup | AutoLogon | Connexion automatique post-installation : Configure le système pour se connecter automatiquement une fois (LogonCount: 1) après le OOBE, en utilisant les identifiants de l'administrateur de domaine. Ceci permet au script final (SetupComplete.cmd) d'exécuter des tâches nécessitant une session utilisateur complète avant que l'utilisateur final ne voie le bureau. |
Fonctionnalités
| Phase du Déploiement | Composant | Fonctionnalité Clé du Script |
|---|---|---|
| windowsPE (Pré-Installation) | Microsoft-Windows-International-Core-WinPE |
Configure la langue d'installation et toutes les locales initiales sur Français (France) (fr-FR) |
Microsoft-Windows-Setup |
Installe le système d'exploitation en utilisant la 6ème image (index 6) trouvée dans le fichier WIM de l'ISO | |
Microsoft-Windows-Setup |
Accepte automatiquement le contrat de licence utilisateur final (EULA) | |
Microsoft-Windows-Setup |
Précise au programme d'installation de cibler et formater la première partition disponible (InstallToAvailablePartition: true) |
|
offlineServicing (Hors Ligne) |
Microsoft-Windows-PnpCustomizationsNonWinPE |
Injecte des pilotes : Ajoute le chemin c:\installdir\drivers comme source pour les pilotes à intégrer dans l'image Windows |
specialize (Premier Démarrage) |
Microsoft-Windows-Shell-Setup |
Définit le Nom de la machine (ComputerName) en utilisant la variable WADS/WAPT {{hostname}} pour garantir un nom unique |
Microsoft-Windows-UnattendedJoin |
Jointure au Domaine : Joint l'ordinateur au domaine adwapt.local en utilisant des identifiants spécifiques (wadsjoin@adwapt.local / pass) |
|
Microsoft-Windows-Deployment |
Post-installation WADS : Exécute la commande wads.exe pour mettre en place le script de démarrage final (SetupComplete.cmd), crucial pour le lancement de l'Agent WAPT |
|
oobeSystem (Post-Configuration) |
Microsoft-Windows-Shell-Setup |
Passer OOBE : Contourne tous les écrans d'expérience utilisateur (EULA, comptes, Wi-Fi) pour une installation totalement silencieuse |
Microsoft-Windows-Shell-Setup |
Configure la Connexion automatique au domaine (adwapt.local) en utilisant le compte administrateur une seule fois (LogonCount: 1), permettant l'exécution de tâches finales |
|
Microsoft-Windows-Shell-Setup |
Définit le fuseau horaire sur Romance Standard Time (Heure d'Europe centrale/France) | |
Microsoft-Windows-Shell-Setup |
Définit l'organisation enregistrée sur CHCOM |
Erreurs courantes
Il est défendable devant un service cybersécurité de dire que mettre LAPS et BitLocker “dans l’unattend.xml” n’est ni essentiel, ni souhaitable, car cela augmente la surface d’attaque sans apporter de bénéfice par rapport à un pilotage par GPO/MDM, qui est la pratique recommandée.[1][2]
LAPS : pourquoi éviter l’unattend.xml
-
Les mots de passe locaux définis via des réponses d’installation (unattend.xml) sont stockés dans un fichier lisible sur le support d’installation et souvent laissé sur le disque après déploiement ; on trouve de nombreux retours de mots de passe admin en clair ou simplement encodés en Base64 dans des unattend.xml, ce qui est trivial à récupérer en post‑compromission.[3][4]
-
Des ressources de tests d’intrusion et de pentest listent explicitement les fichiers unattended comme cibles pour la recherche de mots de passe locaux afin d’escalader les privilèges, ce qui montre que ce vecteur est maintenant standard dans la kill‑chain offensive.[4][5]
-
Microsoft LAPS et Windows LAPS, au contraire, sont conçus pour être pilotés par stratégie (GPO/MDM) : on y configure centralement la rotation automatique, la complexité, l’intervalle de changement et le stockage sécurisé du mot de passe dans AD/Entra, sans jamais exposer ce mot de passe dans un fichier de réponse ou un script.[2][6]
-
Des guides d’implémentation récents recommandent explicitement de créer une GPO dédiée (ex. C_LAPS) et de l’appliquer aux OU cibles, ce qui garantit une configuration homogène et auditables, tout en réduisant les secrets “cachés” dans l’infra de déploiement.[2]
En bref, inclure la logique LAPS dans l’unattend.xml reviendrait à réintroduire des mots de passe locaux statiques ou prévisibles dans un fichier facilement récupérable, alors que la bonne pratique actuelle est d’externaliser complètement cette gestion vers LAPS via GPO/MDM, avec rotation et stockage centralisé protégés.
BitLocker : pourquoi le laisser aux GPO/MDM
-
Les bonnes pratiques BitLocker en entreprise recommandent d’utiliser des stratégies centralisées (GPO/Intune/MDM) pour : imposer l’algorithme de chiffrement, les exigences TPM/PIN, la sauvegarde des clés de récupération et l’activation automatique sur les machines cibles.[7][8][1]
-
L’utilisation de Group Policy pour gérer BitLocker est explicitement citée comme une “best practice” afin de garantir homogénéité, traçabilité et gestion sécurisée des clés sur l’ensemble du parc, plutôt que de disperser la logique dans des scripts ou fichiers d’installation.[1][7]
-
Unattend.xml permet bien de modifier certains comportements (par exemple désactiver le chiffrement automatique OEM via la clé PreventDeviceEncryption), mais ce fichier n’est ni conçu, ni recommandé comme point unique de contrôle de la politique de chiffrement, et son contenu peut être lu par un attaquant ayant accès au support ou au système.[9][8]
-
Des retours d’attaque montrent que la recherche de fichiers XML d’installation (dont unattend.xml) fait partie des techniques standard pour découvrir des informations sensibles (clés, paramètres sécurité, éventuelles commandes BitLocker), ce qui va à l’encontre du principe de minimisation des secrets dans les artefacts de déploiement.[5][4]
En bref, l’activation et la configuration de BitLocker dans l’unattend.xml ne sont pas indispensables et peuvent même fragiliser la chaîne de déploiement si des paramètres sensibles y sont intégrés. L’approche recommandée est de déclencher et de gouverner BitLocker via des GPO/MDM dédiées, qui centralisent les clés, permettent l’audit et évitent l’exposition d’informations critiques dans des fichiers d’installation.
Sources :
Résolution de pannes
Rapport d'Intervention 02/2026 : Résolution Anomalie Déploiement WADS
Objet : Diagnostic et rétablissement du service de déploiement réseau (WADS/WAPT). Statut : Résolu.
1. Analyse Réseau (Wireshark & DHCP)
La première phase du diagnostic a porté sur la validation de la couche transport et de l'adressage :
- Capture de paquets : L'analyse Wireshark confirme que les options DHCP sont correctement transmises au client dans leur intégralité.
- Conformité : La configuration du serveur DHCP est validée conforme à la documentation technique de référence.
L'infrastructure réseau est donc hors de cause.
2. Investigation Système (Serveur WAPT)
L'anomalie ayant été isolée au niveau de la couche application, les tests se sont portés sur le protocole de transfert de fichiers (TFTP).
Diagnostic du service TFTP
- Test client : La commande
tftp -i 10.53.96.65 get snponly.efia retourné une erreur de connexion. - Analyse des sockets : L'inspection via
ss -pantul | grep 69a montré une instabilité dans l'écoute du port, bien quesystemctl status wapttftpserver.serviceindique un service actif sans erreur apparente dans les logs (journalctl). - Résolution : Un redémarrage à chaud (
reboot) du serveur a été nécessaire pour réinitialiser correctement le service et libérer les ressources réseau.
Résultat : Le téléchargement du fichier snponly.efi est de nouveau fonctionnel après redémarrage.
3. Configuration Console & Environnement WinPE
Suite au rétablissement du flux TFTP, un conflit de certificat a été identifié lors de l'initialisation de l'image WinPE.
- Action : Régénération complète de l'image WinPE via la console WAPT en suivant la documentation interne.
- Ajustement technique : En l'absence de documentation spécifique sur la chaîne de certification locale, l'image a été générée sans vérification de certificat afin de garantir la disponibilité immédiate du déploiement.
Conclusion
Le diagnostic a couvert l'ensemble des couches du modèle OSI, permettant d'identifier un blocage au niveau du socket TFTP et un conflit de certificat applicatif. Le flux de déploiement est de nouveau opérationnel.
Note : La mémorisation de ce diagnostic permettra d'accélérer la résolution en cas de récurrence de ce type d'incident.




