Skip to main content

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

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 :

  • 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 >