3. FAQ - Problèmes liés à la Console¶
3.1. Certificats et confiance¶
3.1.1. Pourquoi mon certificat n’est-il pas approuvé par une machine ?¶
Lors de la mise à jour du dépôt, de l’envoi d’un message ou de l’ajout d’un paquet, vous pouvez rencontrer l’erreur suivante :
EWaptCertificateUntrustedIssuer('Issuer CA certificate CN=XXXX,C=FR can not be found in supplied bundle')
Cette erreur indique que l’autorité ayant émis le certificat ne peut pas être trouvée dans les certificats fournis pour la vérification.
Afficher la solution
1. Vérifiez votre certificat personnel
Dans la Console WAPT, ouvrez Outils > Préférences et vérifiez le Chemin d’accès au certificat personnel configuré.
2. Vérifiez les certificats de confiance sur la machine cible
Ouvrez l’onglet Certificats dans l’inventaire WAPT et vérifiez que le certificat ou son autorité de certification émettrice est approuvé.
3. Signez le certificat avec une autorité de certification de confiance si nécessaire
Si le certificat n’est pas approuvé, créez un paquet de certificats et signez-le avec un certificat déjà approuvé par la machine cible.
Suivez le guide vidéo sur la signature des certificats.
4. Réessayez l’opération
Réessayez la mise à jour, l’envoi du message ou l’ajout du paquet.
3.2. Message d’erreur concernant un paquet dans la Console WAPT¶
Error « File setup.py is not allowed in manifest of xxx »
Cette erreur signifie que le certificat actuellement utilisé n’est pas habilité à signer des paquets.
Les deux seules options disponibles sont :
1- Utilisez un autre certificat disposant des droits de signature de code.
2- Régénérez un certificat en sélectionnant l’option signature de code (informations sur la création d’un certificat ici).
Signature de code pour un certificat¶
Problème avec la création de paquet
Fenêtre indiquant que le paquet téléversé présente un problème de certificat de signature¶
La Console WAPT affiche cette erreur : Erreur lors du téléversement du paquet : EWaptForbidden(“Host matching package UUID_HOST does not trusted signer certificate”).
Cette erreur survient lorsque vous essayez de téléverser un paquet WAPT, mais que le certificat utilisé pour signer le paquet n’est pas présent dans le dossier d’installation SSL de WAPT sur votre ordinateur. Si vous disposez d’un serveur WAPT fonctionnant sous Windows, n’oubliez pas de ne pas lancer la Console WAPT sur le serveur. Ajoutez le certificat WAPT ayant signé le paquet dans le dossier d’installation SSL de WAPT sur votre ordinateur, puis réessayez.
Erreur locale
Fenêtre indiquant que la Console WAPT ne trouve pas de paquet¶
La Console WAPT affiche cette erreur dans deux situations.
Le paquet n’existe plus dans le dépôt alors qu’une machine en a besoin
Deux solutions sont possibles :
Essayez de récupérer à nouveau le paquet depuis le store de Tranquil IT.
Supprimez le paquet des dépendances de la machine.
OU
Lorsque vous essayez d’installer un paquet avec une locale inconnue de la machine
Deux solutions sont possibles :
Téléchargez depuis le store de Tranquil IT le paquet WAPT correspondant à la locale.
Modifiez votre paquet WAPT et définissez dans le fichier
controll’optionlocaleavec la locale correcte (locale=en,fr).
3.3. Ouverture et connexion à la Console WAPT¶
3.3.1. Pourquoi la version de ma Console WAPT est-elle différente de celle du Serveur WAPT ?¶
La Console WAPT et le Serveur WAPT utilisent des versions différentes. Cela peut entraîner des problèmes de compatibilité.
Afficher la solution
Mettez à niveau la Console WAPT vers la même version que le Serveur WAPT.
3.3.2. Pourquoi la Console WAPT ne peut-elle pas se connecter au Serveur WAPT ?¶
La Console WAPT ne peut pas contacter le Serveur WAPT sur le port 443. Cela peut indiquer que le service web Nginx est arrêté ou ne parvient pas à démarrer.
Afficher la solution
1. Vérifiez si Nginx est en cours d’exécution
Sur un Serveur WAPT Linux, exécutez :
systemctl status nginx
2. Redémarrez Nginx si nécessaire
Si Nginx n’est pas en cours d’exécution, redémarrez le service :
systemctl restart nginx
3. Vérifiez les journaux si Nginx ne parvient pas à démarrer
Si le service ne démarre toujours pas, consultez les journaux de Nginx :
Linux:
/var/log/nginx/Windows:
C:\Program Files (x86)\wapt\waptserver\nginx\logs
3.3.4. Pourquoi la Console WAPT signale-t-elle une erreur de vérification du certificat SSL ?¶
La Console WAPT ne peut pas vérifier le certificat HTTPS présenté par le Serveur WAPT.
Attention
Avant de modifier les paramètres de certificat ou de vérification, assurez-vous que l’erreur n’est pas causée par une attaque MITM.
Afficher la solution
Cas 1 : Le Serveur WAPT a récemment été reconstruit
Si vous avez reconstruit votre Serveur WAPT et utilisez un certificat auto-signé, vous pouvez éventuellement récupérer les certificats et les clés de l’ancien serveur à partir de :
/opt/wapt/waptserver/apache/ssl
Cas 2 : Réinitialiser la configuration locale de la Console WAPT
Fermez la Console WAPT et supprimez le dossier suivant :
%LOCALAPPDATA%\waptconsole
Cas 3 : Réactiver la vérification des certificats
Exécutez la commande suivante :
wapt-get enable-check-certificate
Assurez-vous que la commande s’exécute correctement.
Redémarrez le service WAPT :
net stop waptservice && net start waptservice
Enfin, redémarrez la Console WAPT.
Cas 4 : Vérifier la chaîne de certificats du serveur
Si vous n’utilisez pas de certificate pinning, cette erreur peut indiquer que le certificat présenté par le Serveur WAPT ne peut pas être vérifié à l’aide du bundle de certificats Python certifi. Assurez-vous que le Serveur WAPT fournit la chaîne complète de certificats, y compris les éventuels certificats intermédiaires requis.
3.3.5. Pourquoi toutes les actions sont-elles désactivées dans la Console WAPT ?¶
La Console WAPT peut sembler verrouillée, avec toutes les actions grisées, si l’utilisateur connecté ne dispose pas des permissions requises.
Afficher la solution
1. Ouvrez la Console WAPT en tant que Superadmin
Fermez la Console WAPT et ouvrez-la à nouveau avec le compte Superadmin.
2. Vérifiez les permissions de l’utilisateur
Accédez à :
Tools > Manage Wapt users and rights
Sélectionnez l’utilisateur concerné et accordez-lui les permissions appropriées.
3. Enregistrez et reconnectez-vous
Enregistrez les modifications, fermez la Console WAPT et ouvrez-la à nouveau avec le compte habituel de l’utilisateur.
3.4. Gestion de l’emplacement des machines dans WAPT¶
3.4.1. Pourquoi une machine apparaît-elle dans la mauvaise unité d’organisation (OU) ?¶
Le Serveur WAPT ne détermine pas automatiquement l’emplacement d’une machine nouvellement déployée. L’agent WAPT installé sur la machine transmet cette information au Serveur WAPT en fonction des données disponibles lorsqu’il communique avec le serveur.
L’OU actuelle de la machine est enregistrée dans la clé de registre Windows suivante :
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Group Policy\State\Machine\Distinguished-Name
Afficher la solution
1. Vérifiez l’OU connue par la machine
Dans la Console WAPT, identifiez la machine concernée.
Accédez à l’onglet Inventaire matériel.
Recherchez la clé computer_ad_dn. Sa valeur correspond à l’OU que la machine a communiquée au Serveur WAPT.
2. Mettez à jour les informations de stratégie de groupe de la machine
Si la valeur de computer_ad_dn correspond à l’ancienne OU, forcez la machine à mettre à jour ses informations de stratégie de groupe.
Via l’invite de commandes :
Exécutez la commande suivante sur la machine :
gpupdate /force
Via la Console WAPT :
Select the workstation concerned.
Right-click > Windows Computer Management.
Choose Update AD Group Policies on hosts.
Une fois la mise à jour effectuée, la machine devrait apparaître dans la nouvelle OU dans l’inventaire WAPT.
3.4.2. Pourquoi des KB Windows Update en double ou obsolètes sont-ils affichés dans WAPT ?¶
Un appareil Windows 11 exécutant la version 25H2 peut afficher des mises à jour cumulatives destinées à des versions antérieures, telles que 22H2, 23H2 ou 24H2, dans l’onglet Mises à jour Windows de la Console WAPT.
À première vue, cela peut laisser penser que des mises à jour destinées à d’anciennes versions de Windows sont installées sur l’appareil. Heureusement, ce n’est pas le cas.
Pourquoi cela se produit-il ?
Microsoft est conscient de ce comportement et l’a reconnu sur ses forums d’assistance, bien que le problème n’ait pas encore été résolu.
Consultez la discussion Microsoft.
Les informations affichées dans l’onglet Mises à jour Windows proviennent directement de l’agent Windows Update natif et ne sont pas modifiées par WAPT.
WAPT conserve délibérément les données d’origine renvoyées par Windows Update afin que les administrateurs puissent exploiter les informations exactement telles qu’elles sont fournies par Microsoft.
Bien que la présence de KB en double ou correspondant à des versions antérieures puisse rendre la liste des mises à jour plus difficile à lire, il s’agit uniquement d’un problème d’affichage. Cela n’affecte pas le processus d’installation des mises à jour.
Windows Update installera uniquement la mise à jour cumulative correspondant à la version du système d’exploitation exécutée sur l’appareil.
Par exemple, sur un système Windows 11 25H2, seul le paquet KB destiné à la version 25H2 sera installé, même si des mises à jour ciblant les versions 22H2, 23H2 ou 24H2 sont également affichées dans la Console.
3.4.3. Comment vérifier quelles mises à jour Windows sont réellement installées ?¶
Afficher la solution
Pour vérifier quelles mises à jour sont réellement installées sur un appareil, exécutez la commande PowerShell suivante :
Get-Hotfix