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 :

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 >

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.

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"