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

Installation/modification

Mise en place du serveur

Prérequis

Schéma

Dans la configuration actuel de l'infra de test, voici les caractéristiques :

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

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

Documentation WAPT

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 :

Do you want to launch post configuration tool?

            < yes >          < no >
Please enter the wapt server password (min. 10 characters)

*****************

                < OK >          < Cancel >
Please enter the server password again:

*****************

                < OK >          < Cancel >

Choisissez le mode d’authentification pour l’enregistrement initial des Agents WAPT :

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.

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.

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 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).

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 >

Choisissez si vous voulez utiliser WAPT WUA pour Windows Update.

Do you want to activate WUA?

        < Yes >        < No >

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 >

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 >
Installation/modification

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.

image.png

image.png

image (3).png

image (4).png

image (6).png

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.

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.

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.  

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.

Installation/modification

Configuration déploiement (serveur)

$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"
$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

Déploiement

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:

  1. 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  
  2. (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.  

Déploiement

ISO

Récupération de l'Image Windows

Prérequis :

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.

  1.  Accéder à l'interface de Déploiement d'OS :
  1.  Importer l'ISO d'installation :
  1.  Sélectionner l'Architecture :
  1.  Enregistrement de l'ISO :

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.

  1.  Naviguer vers l'outil WinPE :
  1.  Sélectionner les options :
  1.  Génération et Enregistrement :

Prochaines Étapes Logiques

Une fois l'ISO et le WinPE intégrés, les étapes finales consisteront à :

  1.  Exporter les pilotes nécessaires pour vos postes clients et les intégrer dans des paquets WAPT (via l'onglet Pilotes).
  2.  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.).
Déploiement

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 :

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

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

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 :

1 2 3 4 5 6 7 8 9 10 11 12

Résolution de pannes

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 :

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

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.


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.