Le serveur WAPT ayant été installé avec succès, nous allons maintenant installer la console WAPT.

Console de gestion WAPT

Attention

Si vous avez déjà généré l’agent WAPT et déployé l’agent sur le poste de travail de votre Administrateur, alors lancez la console WAPT.

Note

• La gestion de WAPT se fait principalement via la console WAPT installée sur le poste de travail de l”Administrateur.

• Il est recommandé de joindre l’ordinateur de l’administrateur à l’Active Directory de l” Organisation.

• Le nom d’hôte du poste de travail de l’administrateur ne doit pas comporter plus de 15 caractères, ce qui est une limite de l’attribut sAMAccountName dans Active Directory.

• L’ordinateur de l’administrateur deviendra essentiel pour l’administration de WAPT et le test des paquets WAPT.

• Si les enregistrements DNS sont correctement configurés, vous devriez être en mesure d’accéder à l’interface web WAPT en visitant https://srvwapt.mydomain.lan.

• A la date du 2024-01-09 la console WAPT ne s’installe que sous Windows.

Indication

Il est hautement recommandé d’utiliser la console sur une machine de gestion dédiée.

WAPT Server hosted on WindowsWAPT Server hosted on Linux

Avertissement

La console WAPT NE DOIT PAS être installée sur votre serveur WAPT basé sur Windows.

La console WAPT doit être installée sur le poste de travail à partir duquel vous gérez votre réseau.

Pour installer la console WAPT, téléchargez waptsetup.exe sur le serveur de Tranquil IT vers le serveur WAPT.

• Renommez le fichier waptsetup-tis.exe.

• Copiez-le dans C:\wapt\waptserver\repository\wapt.

Vous pouvez maintenant poursuivre le téléchargement et le lancement de l’installation de la console WAPT sur l’ordinateur de l’Administrateur

Passez à l’étape suivante, la Console WAPT est déjà sur votre serveur.

L’interface du serveur WAPT dans un navigateur web

• Si les enregistrements DNS sont correctement configurés, vous devriez pouvoir accéder à l’interface web WAPT en vous rendant à l’adresse suivante : https://srvwapt.mydomain.lan.

• Cliquez sur le lien WAPTSetup sur le côté droit de la page web du serveur WAPT.

Installation sur l’ordinateur de l’administrateur

Attention

Si waptagent n’est pas compilé et installé sur votre ordinateur, vous devez installer waptsetup.

• Lancez le programme d’installation exécutable en tant que Administrateur local sur le poste de travail de l”Administrateur.

• Choix de la langue pour WAPT

• Cliquez sur OK pour passer à l’étape suivante.

• Acceptez les conditions de la licence et cliquez sur Next pour passer à l’étape suivante.

• Choisissez des tâches de configuration supplémentaires (laissez la valeur par défaut si vous n’êtes pas sûr).

Choisir les options de l’installateur

Choisissez les options de l’installateur

Paramètres	Description	Valeur par défaut
Organisation	Active le service WAPT sur cet ordinateur.	Coché
Lancer l’icône de notification lors de l’ouverture de session	Lancer waptagent dans la barre d’état système au démarrage.	Non coché
Désactiver l’hiberboot, et augmenter le temps pour les GPO (recommandé)	Désactiver le démarrage rapide de Windows pour la stabilité, élargir le délai d’attente pour WAPTExit.	Coché
Installer les certificats fournis par cet installeur	Installez le certificat Tranquil iT uniquement sur cet ordinateur.	Non coché
Utiliser un UUID aléatoire pour identifier l’ordinateur au lieu du BIOS	Pour plus d’informations, consultez la documentation sur BIOS UUID bugs	Non coché

• Configurez l’URL du serveur WAPT .

Indication

Ici, deux choix s’offrent à vous.

• S’il s’agit de la première installation et que l’agent WAPT.

  • Vérifiez les « Informations statiques WAPT » et définissez-les :

    • URL du dépot WAPT : http://srvwapt.mydomain.lan/wapt.

    • URL du serveur WAPT : https://srvwapt.mydomain.lan.

Choix du dépot et du serveur WAPT

• Choisissez le référentiel WAPT et le serveur WAPT ; cliquez sur Suivant.

• Si la console WAPT ou l’agent WAPT est déjà installé:

  • Cochez Ne pas modifier la configuration actuelle, puis cliquez sur Suivant.

Le dépôt et le serveur WAPT sont déjà configurés

• Obtenir un résumé de l’installation de la console WAPT.

Obtenir un résumé de l’installation de la console WAPT.

• Cliquez sur Installer pour lancer l’installation, attendez que l’installation se termine, puis cliquez sur Terminé (laissez les options par défaut).

• Décochez Afficher la documentation d’installation.

Démarrer la console WAPT

• Lancez la console WAPT :

  • En cherchant le binaire.

    C:\Program Files (x86)\wapt\waptconsole.exe

  • Ou en utilisant le menu Démarrer.

  

  Lancement de la console WAPT à partir du menu de démarrage de Windows

• Connectez-vous à la console WAPT avec le login et le mot de passe SuperAdmin.

  

  La fenêtre d’authentification de la console WAPT

Si vous avez des problèmes pour vous connecter à la console WAPT, veuillez vous référer à la FAQ : Message d’erreur à l’ouverture de la console.

Il est recommandé de lancer la console WAPT avec un compte d’administrateur local pour permettre le débogage local des paquets WAPT.

Pour la version Enterprise, il est possible de s’authentifier avec l”Active Directory.

Premier démarrage après l’installation du serveur

Indication

Au premier démarrage, vous devez lancer la console WAPT avec des privilèges élevés. Cliquez avec le bouton droit de la souris sur le binaire de la console WAPT ‣ Démarrer en tant qu’administrateur local.

Affectation du certificat

Note

Un message peut apparaître indiquant qu’aucun certificat personnel n’a été défini.

Certificat personnel WAPT non présent

• Sélectionnez Oui

Fenêtre pour la configuration basique de la console WAPT

• Cliquez sur Générer un certificat puis allez créer votre certificat.

Définition du préfixe de paquet

Note

Un message peut apparaître indiquant qu’aucun certificat personnel n’a été défini.

Boîte de dialogue informant qu’aucun préfixe n’a été défini dans la configuration WAPT

• Sélectionnez Oui

• Définissez votre préfixe de paquet sur préfixe des paquets WAPT

Fenêtre pour la configuration basique de la console WAPT

erreurs du waptagent.exe

Note

Un message peut apparaître indiquant que la version de votre agent WAPT est obsolète ou n’existe pas encore.

Boîte de dialogue informant que l’agent WAPT n’est pas présent sur le serveur WAPT

Si le certicat de l’Administrateur existe, il est possible de générer un nouvel agent en cliquant sur Oui.

Aussi, cliquez sur Non et générez le certificat Administrateur.

Activer la licence

Note

Sur WAPT, la différence entre les versions Discovery et Enterprise est gérée par la licence utilisée.

Indication

Pour activer la licence, utilisez le fichier licence.lic communiqué par notre département de vente.

• Dans la console WAPT, cliquez sur l’onglet ?

• Choisissez Licences :

Fenêtre indiquant qu’il n’y a pas de licences WAPT souscrites dans la console WAPT

• Sélectionnez votre licence.lic et cliquez sur Ouvrir.

Fenêtre montrant une licence activée dans la console WAPT

Supprimer la licence

• Dans la console WAPT, cliquez sur l’onglet ?

• Choisissez Licences :

Fenêtre indiquant qu’il n’y a pas de licences WAPT souscrites dans la console WAPT

• Sélectionnez la ligne et cliquer sur Retirer la licence :

Fenêtre de confirmation pour retirer une licence de la Console WAPT

• Après confirmation, la licence est retirée :

Fenêtre indiquant qu’il n’y a pas de licences WAPT souscrites dans la console WAPT

Emplacement de la licence

Le licence.json est stocké sur le serveur sur l’emplacement suivant :

Debian / UbuntuRedHat and derivativesWindows

/var/www/licences.json

Erreur de licence

Expiration de la licence

Si la licence est expirée, le statut affiche Expiré :

Fenêtre montrant une licence expirée dans la console WAPT

Emplacement de l’ancienne licence

Sur la console d’installation, si la licence est localisée sur l’ancien emplacement, cette erreur apparaît :

Message d’erreur de la licence WAPT lors de la mise à niveau de WAPT vers 2.1

Erreur d’activation de la licence

Cette erreur est dû à un problème avec le script de post-configuration et une configuration spéciale de NGINX.

Boîte de dialogue informant qu’une erreur s’est produite lors de l’activation d’une licence WAPT

3 points sont à vérifier :

1. Vérifier si /etc/nginx/sites-enabled/wapt.conf est un lien symbolique du fichier /etc/nginx/sites-available/wapt.conf.

ls -l /etc/nginx/sites-enabled/wapt.conf

• Si le lien symbolique existe, la sortie est :

lrwxrwxrwx 1 root root 36 Jun  9 09:35 /etc/nginx/sites-enabled/wapt.conf --> /etc/nginx/sites-available/wapt.conf

• Si le lien symbolique n’existe pas, supprimez /etc/nginx/sites-enabled/wapt.conf et créez un nouveau lien symbolique :

rm /etc/nginx/sites-enabled/wapt.conf

ln -s /etc/nginx/sites-available/wapt.conf /etc/nginx/sites-enabled/wapt.conf

2. Vérifier si licences.json est présent dans la section location du fichier /etc/nginx/sites-enabled/wapt.conf

location ~ ^/(wapt/waptsetup-tis.exe|wapt/waptagent.exe|wapt/waptdeploy.exe|sync.json|rules.json|licences.json)$ {
        add_header Cache-Control "store, no-cache, must-revalidate, post-check=0, pre-check=0";
        add_header Pragma "no-cache";
        root "/var/www";
    }

• Si le fichier licences.json existe, alors redémarrez Nginx :

systemctl restart nginx

• Egalement, ajouter licences.json dans la section location dans /etc/nginx/sites-enabled/wapt.conf et redémarrer NGINX.

systemctl restart nginx

3. /var/www/licences.json vide:

> /var/www/licences.json

• Retenter licence activation

Génération du certificat principal

Indication

• Le nom de la clé privée est wapt-private.pem.

• Le nom du certificat public signé avec la clé privée est wapt-private.crt.

Clef privée wapt-private.pem

Attention

Le fichier wapt-private.pem est fondamental pour la sécurité. Il doit être stocké dans un endroit sûr et correctement protégé.

Le fichier wapt-private.pem est la clé privée, il est situé par défaut dans le dossier C:\private du poste Administrateur et est protégé par un mot de passe.

Cette clé privée sera utilisée avec le certificat pour signer les paquets avant de les télécharger sur le dépot WAPT.

Danger

Le fichier wapt-private.pem ne doit pas être stocké sur le serveur WAPT.

Certificat public : wapt-private.crt

Le fichier wapt-private.crt est le certificat public qui est utilisé avec la clé privée. Il est créé par défaut dans le dossier C:\private de l’administrateur, copié et déployé dans C:\Program Files (x86)\wapt\ssl sur les postes de travail Windows ou dans /opt/wapt/ssl sur les périphériques Linux et MacOS gérés par l’administrateur via un package WAPT, un GPO ou un rôle Ansible.

Ce certificat est utilisé pour valider la signature des paquets avant leur installation.

Attention

• Si le certificat public utilisé sur la console WAPT n’est pas dérivé de la clé privée utilisée pour générer les agents WAPT, aucune interaction ne sera possible.

• Les certificats enfants des clés privées sont fonctionnels pour les interactions.

Génération d’un certificat à utiliser avec WAPT

Dans la console WAPT, allez dans Outils ‣ Générer un agent WAPT

Création d’un certificat auto-signé

Note

Avec WAPT Enterprise, vous pouvez créer une clé principale d’autorité de certification qui peut à la fois signer des paquets et signer de nouveaux certificats.

Indication

Afin de créer de nouveaux certificats signés pour les utilisateurs délégués, veuillez vous référer à créer un nouveau certificat.

Création d’un certificat auto-signé pour la version WAPT Enterprise

Affectation du certificat

Valeur	Description	Requis	Enterprise
Organisation	Dossier du certificat de confiance.
Nom du fichier clé	Définit le nom de la clé privée .pem.
Organisation	Fournissez le mot de passe pour déverrouiller la clé privée.
Confirmer le mot de passe	Fournissez le mot de passe pour déverrouiller la clé privée.
Liste de certificats autorisés	Dossier du certificat de confiance.
Organisation	Définit si le certificat/la paire de clés sera autorisé(e) à signer les packages logiciels.
Vérifier le certificat https serveur	Définit si le certificat peut être utilisé pour signer d’autres certificats (autorité de certification principale ou intermédiaire).
Nom commun (NC)	Dossier du certificat de confiance.
Organisation	Chemin d’accès aux certificats utilisés pour la vérification HTTPS.
Pays (2 chars. Ex : FR)	Définit le nom du pays du titulaire du certificat (FR, EN, ES, DE …) à enregistrer dans le certificat.
Organisation	Définit le nom du service ou du département organisationnel du titulaire du certificat à enregistrer dans le certificat.
Organisation	Nom de l’organisation permettant d’identifier l’origine des paquets WAPT.
Adresse du serveur WAPT	Définit l’adresse e-mail du titulaire du certificat à enregistrer dans le certificat.
Clé de signature de l’autorité	Définit la clé (.pem) de la CA.
Liste de certificats autorisés	Définit le certificat (.crt) de la CA.
Exporter PKCS12	Force la création du certicat *.p12 dans le répertoire Targets keys	(recommandé)

Des détails supplémentaires sont stockés dans la clé privée. Ces informations permettront d’identifier l’origine du certificat et l’origine du paquet WAPT.

Indication

La complexité du mot de passe **Doit**se conformer aux exigences de sécurité de votre Organisation (consultez le site ANSSI pour des recommandations sur les mots de passe).

Danger

• Le chemin d’accès à votre clé privée ne doit pas se trouver dans le chemin d’installation de WAPT (C:\Program Files (x86)\wapt).

• Si votre clé est stockée dans C:\Program Files (x86)\wapt, votre clé privée d’administrateur sera déployée sur vos clients, ce qui est absolument à proscrire!.

• Le fichier wapt-private.pem ne doit pas être stocké sur le serveur WAPT.

• Cliquez sur OK pour passer à l’étape suivante.

  Si tout s’est bien passé, le message suivant apparaît :

Le certificat a été généré avec succès

• Sélectionnez Oui

Boîte de dialogue demandant la confirmation de la copie du certificat dans le dossier ssl de la console WAPT

• Cliquez sur Yes pour copier le certificat nouvellement généré dans le dossier C:\Program Files (x86)\wapt\ssl sous Windows ou /opt/wapt/ssl sous Linux ou macOS. Ce certificat sera récupéré lors de la compilation de l’agent WAPT et déployé sur les ordinateurs clients.

Vous pouvez passer à l’étape suivante et construire le programme d’installation de l’agent WAPT.

Générer l’agent

Le binaire waptagent est un installateur InnoSetup.

Une fois que la console WAPT a été installée sur l’ordinateur Administrator, nous avons tous les fichiers nécessaires pour construire le programme d’installation de l’agent WAPT :

• Les fichiers qui seront utilisés lors de la construction de l’agent WAPT sont situés dans C:\Program Files (x86)\wapt.

• Les fichiers sources du programme d’installation (fichiers .iss) se trouvent dans C:\Program Files (x86)\wapt\waptsetup.

Indication

Avant de construire l’agent WAPT, veuillez vérifier le(s) certificat(s) public(s) dans C:\Program Files (x86)\wapt\ssl.

Si vous souhaitez déployer d’autres certificats publics sur les ordinateurs de votre Organisation qui sont équipés de WAPT, vous devrez les copier dans ce dossier.

Danger

NE COPIEZ PAS la clé privée d’un Administrator dans C:\Program Files (x86)\wapt.

Ce dossier est utilisé lors de la construction de l’agent WAPT et les clés privées seront ensuite déployées sur tous les ordinateurs.

• Dans la console WAPT, allez dans Outils ‣ Générer un agent WAPT

Générer l’agent WAPT depuis la console

Indication

Avant de construire l’agent WAPT, vous devez choisir comment il s’identifiera auprès du serveur WAPT.

Choix du mode d’identification unique des agents WAPT

Dans WAPT, vous pouvez choisir le mode d’identification unique des agents WAPT.

Lorsqu’un agent WAPT s’enregistre, le serveur doit savoir s’il s’agit d’une nouvelle machine ou d’une machine qui a déjà été enregistrée.

Pour cela, le serveur WAPT examine l”UUID de l’inventaire.

WAPT propose 3 modes pour vous aider à distinguer les machines, à vous de choisir le mode qui vous convient le mieux.

Attention

Après avoir choisi un mode de fonctionnement, il est difficile d’en changer, réfléchissez bien !

BIOS UUID (serial number)host namerandomly generated UUID

Ce mode de fonctionnement permet d’identifier les machines de la console de manière physique.

Si vous remplacez un ordinateur et donnez au nouvel ordinateur le même nom que le précédent, vous aurez deux ordinateurs qui apparaîtront dans la console WAPT puisque vous aurez physiquement deux ordinateurs différents.

Note

Certains fournisseurs font un travail inadéquat et attribuent les mêmes UUID de BIOS à des lots entiers d’ordinateurs. Dans ce cas, WAPT ne verra qu’un seul ordinateur !!!

Construire

• Dans la console WAPT, allez dans Outils ‣ Générer un agent WAPT

Générer l’agent WAPT depuis la console

• Remplissez les informations qui sont nécessaires pour l’installateur.

Remplir les informations sur votre organisation

Affectation du certificat

Valeur	Description	Requis	Enterprise
Liste de certificats autorisés	Dossier du certificat de confiance.
Liste de certificats autorisés	Définit si le certificat WAPT local doit être inclus.
Adresse du serveur WAPT	Définit l’URL du référentiel WAPT principal.
Adresse du serveur WAPT	Définit l’URL du serveur WAPT.
Vérifier le certificat https serveur	Définit si l’authentification client du certificat HTTPS est activée sur le serveur WAPT.
Utiliser les règles d’accès au référentiel	Définit si les règles d’accès aux référentiels doivent être utilisées pour répliquer les référentiels distants.
Chemin vers le paquet de certificats CA des serveurs https WAPT	Définit le chemin vers les certificats utilisés pour la vérification HTTPS.
Utiliser Kerberos pour l’enregistrement initial	Définit si l’authentification Kerberos des agents WAPT doit être utilisée avec le serveur WAPT.
Organisation	Définit le nom de l’organisation pour identifier l’origine des packages WAPT.
Utiliser le FQDN de l’ordinateur comme UUID	Définit si les FQDN doivent être utilisés pour identifier les agents WAPT.
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.
Il faut toujours installer ces packages	Définit s’il faut installer automatiquement les packages du groupe lors de l’installation de l’agent WAPT.
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.
Organisation	Définit si les redémarrages à distance sont autorisés à partir de la console WAPT.
Adresse du serveur WAPT	Définit si les arrêts à distance sont autorisés à partir de la console WAPT.
Gérer les mises à jour de Windows avec WAPT | Désactiver WAPT WUA | Ne rien définir	Active ou désactive WAPT WUA.
Autoriser toutes les mises à jour par défaut, sauf si elles sont explicitement interdites par les règles	Définit s’il faut autoriser toutes les mises à jour de Windows si elles ne sont pas interdites par des packages de règles WUA.
Organisation	Définit la périodicité de l’analyse de Windows Update.
Délai minimum avant installation (jours après la date de publication)	Définit un délai d’installation différée avant la publication.
Installer les mises à jour Windows en attente à l’arrêt	Force les mises à jour à s’installer lorsque l’hôte s’éteint.
Maturité du packaging de Waptupgrade	Allows to choose the maturity of the waptupgrade package.

Indication

Pour plus d’informations sur la section Windows update, consultez cette article sur la configuration de WAPTWUA sur l’agent WAPT

Danger

• La case à cocher Utiliser kerberos pour l’enregistrement initial doit être cochée UNIQUEMENT SI vous avez suivi la documentation sur Configurer l’authentification kerberos.

• La case à cocher Vérifier le certificat HTTPS du serveur WAPT doit être cochée SEULEMENT SI vous avez suivi la documentation sur Activer la vérification du certificat SSL / TLS.

• Fournissez le mot de passe pour déverrouiller la clé privée.

Fournissez le mot de passe pour déverrouiller la clé privée.

Progression de l’installation de l’agent WAPT

Une fois que le programme d’installation de l’agent WAPT a terminé sa construction, une boîte de dialogue de confirmation apparaît pour indiquer que le binaire waptagent a été téléchargé avec succès sur https://srvwapt.mydomain.lan/wapt/.

Confirmation du chargement de l’agent WAPT sur le référentiel WAPT

Note

Un avertissement s’affiche indiquant que la valeur de hachage de la GPO doit être modifiée. Les GPO peuvent être utilisés pour déployer l’agent WAPT sur l’ordinateur de votre Organisation.

Attention

Après avoir construit l’agent sur votre ordinateur de gestion, quittez la console WAPT et installer le nouvel agent WAPT qui a été généré sur votre ordinateur de gestion WAPT.

Configuration initiale

Enterprise

Il est possible de configurer l’agent pour les options standard et avancées via une interface graphique.

• Dans la console WAPT, allez dans Outils ‣ Générer un agent WAPT

Création de la configuration initiale

• Remplissez les informations qui sont nécessaires pour l’installateur.

Modification de la configuration initiale

En-tête

Valeur	Description
Organisation	Sert à afficher les options comme dans wapt-get.ini.
Vérifier le certificat https serveur	Ajouter le certificat déployé avec la configuration.
Adresse du serveur WAPT	Charger une configuration précédemment créée
Vérifier le certificat https serveur	Rafraîchit la liste des configurations disponibles
Organisation	Créer une nouvelle configuration
Organisation	Supprimer une configuration

globalwaptwuarepo-sync

Valeur	Description	Requis	Enterprise
Adresse du serveur WAPT	Définit l’URL du référentiel WAPT principal.
Organisation	Définit l’URL du serveur WAPT.
Vérifier le certificat https serveur	Définit si l’authentification client du certificat HTTPS est activée sur le serveur WAPT.
Chemin vers l’autorité de certification pour les serveurs https	Définit le chemin vers les certificats utilisés pour la vérification HTTPS.
Organisation	Définit si les redémarrages à distance sont autorisés à partir de la console WAPT.
Adresse du serveur WAPT	Définit si les arrêts à distance sont autorisés à partir de la console WAPT.
Organisation	Active la fonctionnalité WoL sur les référentiels secondaires.
Utiliser le FQDN de l’ordinateur comme UUID	Définit si les FQDN doivent être utilisés pour identifier les agents WAPT.
Il faut toujours installer ces packages	Définit s’il faut installer automatiquement les packages du groupe lors de l’installation de l’agent WAPT.
Adresse du serveur WAPT	Définit si les dépôts sont répliqués.
Organisation	Définit si l’authentification Kerberos des agents WAPT doit être utilisée avec le serveur WAPT.
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.
Organisation	Liste des maturités de packaging qui peuvent être visualisées et installées par l’agent WAPT. La valeur par défaut est PROD. Seules les valeurs DEV, PREPROD et PROD sont utilisées par Tranquil IT, cependant toute valeur peut être utilisée pour s’adapter à vos processus internes.
Vérifier le certificat https serveur	Définit le mode de fonctionnement de l’authentification en libre-service. Les valeurs possibles sont : system, waptserver-ldap ou waptagent-ldap.
Organisation	Définit la fréquence à laquelle les audits sont déclenchés.

Colonne

Valeur	Description
Organisation	Liste des options avec la configuration.
Vérifier le certificat https serveur	Liste des certificat avec la configuration.

Pied de page

Valeur	Description
Organisation	Fenêtre pour la configuration basique de la console WAPT
Adresse du serveur WAPT	Exporter la configuration en JSON
Organisation	Fermer la fenêtre

• Après la configuration, il est possible de copier les commandes en cliquant avec le bouton droit de la souris sur la configuration

Commande de copie

Options de copie

Valeur	Description
Organisation	Donne une URL de téléchargement pour récupérer le .json du serveur.
Organisation	Donne une commande pour installer la configuration d’un agent WAPT.

Note

Il est possible d’installer un agent vierge et de lui donner la commande d’installation copiée pour fournir la configuration.