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"




