KB N°03 : Déployer l’agent de post via WAPT

Publié le 15 décembre 2023Modifié le 28 mars 2024

Dans cet article, vous trouverez la procédure détaillée du déploiement de l’Agent de poste via WAPT.

Contexte

WAPT est une solution souveraine de gestion de parc informatique développée par Tranquil IT et certifiée par l’ANSSI. Plus d’infos par ici.

Le déploiement avec WAPT permet de déployer l’Agent de poste sur les postes de travail de vos collaborateurs. Ce mode de déploiement est très pertinent dès lors que l’agent WAPT est installé sur des postes de travail que vous maîtrisez.

Prérequis

Vous devez avoir une maîtrise de votre parc informatique, WAPT est fonctionnelle et l’agent WAPT est déployé sur les postes.

Procédure

Vous pouvez déployer l’Agent sur un poste de travail.

  1. Téléchargez le .msi de l’Agent de poste dans Olfeo SaaS (Configuration > Annuaires :

  1. Générez un modèle de paquet dans WAPT en cliquant sur « Modèle de paquet » :

  1. Ajoutez le .msi de l’Agent de poste puis cliquez sur « Continuer » :

  1. L’assistance de création de paquet affichera les informations suivantes :

  1. Cliquez sur « Éditer manuellement » pour éditer le fichier setup.py qui, par défaut, contient les lignes ci-dessous :
  • from setuphelpers import*r » » »
    Usable WAPT package functions: install(), uninstall(), session_setup(), audit(), update_package()
    «  » »# Declaring global variables – Warnings: 1) WAPT context is only available in package functions; 2) Global variables are not persistent between calls
    def install():

    # Declaring local variables
    # Installing the software

    print(« Installing: authentication_agent_fr.msi »)

    install_msi_if_needed(‘authentication_agent_fr.msi’)

  • Tip
  • Retrouvez ci-dessous un exemple setup.py fonctionnel dont il est fortement reconseillé de suivre les recommandations/instructions de WAPT en cliquant ici.
  • # -*- coding: utf-8 -*-from setuphelpers import *uninstallkey = []
    properties = {
    ‘CONFIG_URL’:’https://storage.gra.cloud.ovh.net/v1/AUTH_XXXXX/prod-pub/XXXXXX/config.json’,
    }

    def install():

    print(‘installing olf-trustlane-agent’)
    install_msi_if_needed(‘authentication_agent_fr.msi’,properties=properties)

    def uninstall():

    pass

    # put here what to do when package is removed from host
    # implicit context variables are WAPT, control, user, params, run

    print(‘RAZ configuration proxy’)

    run(r’reg add « HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Connections » /f /v « DefaultConnectionSettings » /t REG_BINARY /d « 4600000002000000090000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 »‘)
    run(r’reg add « HKEY_LOCAL_MACHINE\Software\WOW6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\Connections » /f /v « DefaultConnectionSettings » /t REG_BINARY /d « 4600000002000000090000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 »‘)

    def session_setup():

    print(‘Session setup for %s’ %asrequirement())

    # put here what to do when package is configured inside a user session
    # implicit context variables are WAPT, control, user, params

    def update_package():

    pass

    # put here what to do to update package content with newer installers.
    # launched with command wapt-get update-package-sources <path-to-wapt-directory>
    # implicit context variables are WAPT, basedir, control, user, params, run
    # if attributes in control are changed, they should be explicitly saved to package file with control.save_control_to_wapt()

    def audit():

    pass

    # put here code to check periodically that state is matching expectations
    # return « OK », « WARNING » or « ERROR » to report status in console.
    # all print statement are reported too

    return « OK »

  • La valeur de «  CONFIG_URL » correspond à l’URL de configuration de l’Agent de poste que vous trouverez dans votre interface Olfeo SaaS (Configuration > Annuaires (consultez l’annuaire) > onglet Agent de poste) :
  1. Importez le nouveau paquet en cliquant sur « Construire et importer un paquet dans le dépôt » puis sélectionnez le dossier contenant le paquet qui se trouve par défaut dans « C:\waptdev ».

  • Le bouton « Import » permet d’importer le paquet que vous trouverez ensuite dans la liste des paquets du menu « Dépôt privé » :

  • Le nouveau paquet apparaît dans la liste « Dépôt privé » :

Caution

Dans certains cas de figure, le systray de l’Agent peut ne pas démarrer suite à l’installation dans ce mode de déploiement (usages de bureau et de droits de type user par le user « WAPT » là où le systray requiert un espace admin), Pour éviter ces effets de bord, prévoyez un redémarrage du poste suite à l’installation de l’Agent.

Tags: Déployer, Agent, UC-03