Detalls tècnics del funcionament de l’agent Windows

Instal·lació i desinstal·lació de l’agent

El paquet d’instal·lació de l’agent Windows es distribueix en forma de fitxer .msi. Aquest paquet segueix les recomanacions oficials de Microsoft sobre la creació de paquets d’instal·lació.

L’MSI de l’agent s’ha de generar directament des de la vostra instància de Cyberwatch, al formulari de creació d’un agent Windows. Per defecte, inclou els paràmetres seleccionats a Cyberwatch per a la instal·lació, com ara, per exemple, el tipus d’arquitectura, els grups, l’URL de la instància de Cyberwatch…

També es pot baixar directament l’agent en funció del tipus d’actiu escanejat:

Windows Server 2003 i Windows 7 en versió de 32 bits o en versió de 64 bits
Windows Server 2008 en versió de 64 bits
Windows Server 2012 en versió de 64 bits
Windows Server 2016 / 2019 / 2022 / 2025 i Windows 10 / 11: en versió de 32 bits o en versió de 64 bits

Un cop instal·lat, es crea una entrada a la llista Programs and Features, accessible des del Control Panel.

De manera individual, l’MSI de l’agent es pot instal·lar amb un simple «doble clic» al fitxer, com qualsevol altre paquet d’instal·lació. Per a qualsevol desplegament a gran escala, l’agent és compatible amb els mètodes de desplegament oficials de Microsoft per GPO, però també amb qualsevol altre mecanisme de desplegament basat en solucions de tercers (per exemple, SCCM, Chocolatey…).

La desinstal·lació de l’agent segueix, de la mateixa manera, els mètodes oficials de Microsoft. L’agent es pot desinstal·lar des de la llista Programs and Features, accessible des del Control Panel.

Funcionament de l’agent

Als sistemes Windows, la instal·lació de l’agent crea un servei anomenat CyberwatchAgent.service i genera un directori C:\Program Files\CYBERWATCH SAS\CyberwatchAgent\.

Aquest directori conté els elements següents:

una carpeta logs/ que conté els registres de l’agent en dos fitxers:
- un fitxer agent.log que conté els registres d’execució de l’agent
- un fitxer service.log que conté els registres de l’execució del servei
el fitxer agent.conf, que conté la configuració de l’agent (URL, claus d’API…)
l’executable cyberwatch-agent.exe, que és el programa d’execució de l’agent
l’executable CyberwatchService.exe, que s’utilitza per crear el servei
l’script PowerShell launcher.ps1, que crida el servei i que s’encarrega d’executar el fitxer cyberwatch-agent.exe

El servei CyberwatchService s’executa cada 5 minuts i inicia la comunicació de l’agent amb l’escàner de Cyberwatch al qual està vinculat (en particular segons l’URL configurada, que es pot trobar al fitxer agent.conf).

Durant aquesta comunicació amb el servidor de Cyberwatch, l’agent simplement consulta l’API de Cyberwatch i obté les possibles tasques que ha de fer a l’actiu en qüestió (per exemple, tornar a executar un escaneig, desplegar un pedaç…).

Actualitzacions de l’agent

Cyberwatch publica regularment actualitzacions de l’agent, els canvis de les quals es recullen a l’historial de versions de l’agent de Cyberwatch.

Aquestes actualitzacions poden incloure, per exemple, millores en el funcionament, el rendiment o algunes funcionalitats relacionades amb la instal·lació de l’agent.

Aquestes actualitzacions són independents de les actualitzacions del programari: una versió antiga de l’agent no actualitzada als actius continuarà funcionant amb les properes versions de Cyberwatch (llevat que s’indiqui específicament el contrari). Tanmateix, Cyberwatch recomana actualitzar sistemàticament els agents sempre que sigui possible.

Per actualitzar l’agent Windows, n’hi ha prou de tornar a instal·lar el paquet MSI sobre una instal·lació existent. La versió nova de l’agent substitueix llavors la versió antiga al sistema. Aquestes actualitzacions també es poden fer amb els mètodes de desplegament massiu esmentats més amunt.

Atenció: si l’actualització de l’agent es fa després d’un canvi de servidor de gestió, cal assegurar-se de suprimir tots els components restants de l’agent presents a la màquina de destinació abans de tornar-lo a instal·lar, perquè els fitxers de configuració s’actualitzin correctament. En particular:

els elements presents a C:\Program Files\CYBERWATCH SAS\CyberwatchAgent
les claus de registre associades

Desplegar l’agent mitjançant una GPO (opcional)

El procediment que es proposa aquí s’ha provat en un servidor Windows 2019; els detalls poden variar segons la versió utilitzada. A la resta de la pàgina, utilitzarem el terme més habitual, GPO, per designar les Group Policy Preferences (GPP) que cal definir.

El procediment següent permet desplegar l’agent de Cyberwatch amb una GPO mitjançant el planificador de tasques (Task Scheduler) per evitar reiniciar els actius de destinació:

Baixeu el fitxer MSI de l’agent de Cyberwatch des de Gestió d’actius > Agents > Afegeix
Creeu una carpeta compartida per desar-hi el fitxer MSI de l’agent de Cyberwatch i l’script batch de desplegament
El contingut de l’script de desplegament (fitxer .bat) és el següent (adapteu-lo segons el camí al fitxer MSI):
```
 @ECHO OFF
 if EXIST "C:\Program Files\CYBERWATCH SAS\CyberwatchAgent\cyberwatch-agent.exe" ( 
 echo "Cyberwatch Agent is present" 
 ) else ( 
 msiexec /qn /i "\\Server\CheminVers\cyberwatch_agent-x64.msi" )
```
Aquest script verifica si l’agent de Cyberwatch és present a la màquina i, si no hi és, l’instal·la en mode silenciós.
Al vostre controlador de domini, obriu Group Policy Management i creeu una GPO nova al vostre domini
Editeu la GPO que acabeu de crear per obrir-la al Group Policy Management Editor
A «Computer Configuration > Preferences > Control Panel Settings > Scheduled Tasks», creeu una tasca planificada nova (At least Windows 7) amb els elements següents:
- Pestanya General: doneu un nom a la tasca i utilitzeu el compte «NT AUTHORITY\System» per executar-la
- Pestanya Triggers: afegiu un activador segons les vostres preferències
- Pestanya Actions: afegiu una acció del tipus «Start a program» i seleccioneu el fitxer .bat creat anteriorment
Si encara no ho heu fet, vinculeu la GPO a una OU o al vostre domini des de Group Policy Management

Un cop aplicada la GPO als clients, es crea una tasca planificada per executar l’script de desplegament.