Utilitzar l’agent de Cyberwatch

Afegir un actiu en mode amb agent

  1. Feu clic a Gestió d’actius > Agents
  2. Feu clic al botó «Afegeix»
  3. Seleccioneu la plataforma en què s’instal·larà l’agent
  4. Seguiu el procediment indicat per completar la instal·lació de l’agent amb l’ajuda de la part dreta de la pàgina

Suprimir un o més agents

  1. Feu clic a Gestió d’actius > Agents
  2. Seleccioneu els agents que voleu suprimir
  3. Feu clic al botó «Edició en bloc»
  4. Feu clic al botó «Suprimeix els agents seleccionats» que apareix i confirmeu la supressió

El mode de supressió per defecte suprimeix de Cyberwatch els agents i l’actiu associat, però en conserva la clau d’API. Si un agent suprimit torna a comunicar-se amb Cyberwatch, es tornarà a registrar automàticament amb una configuració per defecte: se n’hauran perdut, entre altres coses, la descripció i els grups. Aquest mode de supressió està pensat principalment per als agents en pèrdua de comunicació.

També es pot sol·licitar la desinstal·lació d’un agent marcant la casella «Desinstal·la els agents seleccionats» al quadre de diàleg de confirmació de la supressió d’agents. L’agent iniciarà llavors el procés de desinstal·lació i, si té èxit, l’agent, el seu actiu i la seva clau d’API se suprimiran de Cyberwatch.

Per obtenir més detalls sobre el funcionament de l’agent de Cyberwatch, consulteu les seccions de la documentació següents:

Llistar els paràmetres i les ordres de l’agent

Es pot obtenir la llista d’ordres i paràmetres disponibles de l’agent de Cyberwatch mostrant-ne l’ajuda detallada.

Per fer-ho, n’hi ha prou d’executar les ordres següents:

  • A Unix:
cyberwatch-agent --help
  • A Windows, després d’anar a la carpeta d’instal·lació de l’agent (C:\Program Files\CYBERWATCH SAS\CyberwatchAgent per defecte):
./cyberwatch-agent.exe --help

El resultat d’aquestes execucions s’assembla a la llista no exhaustiva d’ordres i paràmetres següent:

> cyberwatch-agent --help
usage: cyberwatch-agent [-h] [-V] [-q] [-d] [--api-url URL] [--access-key-id KEY] [--secret-access-key KEY]
                        [--category CATEGORY] [--later] [--allow_selfsigned bool] [--proxy_enabled bool]
                        [--proxy_host URL] [--groups GROUPS]
                        [{check,register,get_tasks,set_config}]

positional arguments:
  {check,register,get_tasks,set_config}

options:
  -h, --help            show this help message and exit
  -V, --version         show program\'s version number and exit
  -q, --quiet           quiet output: print only errors
  -d, --debug           debug output
  --api-url URL         set api base url when registering
  --access-key-id KEY   set api access key id when registering
  --secret-access-key KEY
                        set api secret access key when registering
  --category CATEGORY   set the category of the computer when registering
  --later               Register only the next time the agent starts
  --allow_selfsigned bool
                        allow selfsigned certificates from the Cyberwatch server (default false)
  --proxy_enabled bool  enable proxy for Cyberwatch API requests (default false)
  --proxy_host URL      set the proxy for Cyberwatch API requests (https://username:password@host:port/ format)
  --groups GROUPS       set the server\'s groups by separating each one with a coma

Errors freqüents en el registre de l’agent

El registre d’un agent pot fallar i retornar un codi HTTP 401 unauthorized.

Podeu consultar els missatges d’error d’un agent als registres, accessibles a /var/log/cyberwatch-agent als sistemes Linux, o bé a C:\Program Files\CYBERWATCH SAS\CyberwatchAgent\logs\agent.log als sistemes Windows.

Aquesta secció de la documentació descriu les causes freqüents d’error durant un registre.

Claus d’API suprimides o revocades

Quan l’agent utilitza credencials vinculades a una clau d’API suprimida o revocada, el registre no es pot validar.

La informació de les claus d’API d’un usuari és accessible a la secció «Claus d’API» de la seva pàgina de perfil, si es tracta de l’usuari actual. La icona de perfil de la part superior dreta de la interfície us hi permet accedir ràpidament.

La pàgina de perfil també permet verificar si l’usuari té els drets suficients per instal·lar un agent.

Les claus d’API d’un usuari inactiu o suprimit no es poden utilitzar.

Diferència horària

Una diferència d’almenys dues hores entre l’hora del servidor de Cyberwatch i la de la màquina amfitriona pot provocar un error de comunicació. Per solucionar-ho, cal alinear els fusos horaris dels dos sistemes.

Base de dades de vulnerabilitats no sincronitzada

Una base de dades de vulnerabilitats no sincronitzada tindrà una llista incompleta de sistemes operatius compatibles. Això impedirà que l’agent identifiqui els sistemes operatius i, per tant, que es registri.

Podeu verificar la llista de sistemes operatius compatibles en aquesta pàgina, o bé l’estat actual de la vostra sincronització a la pàgina Administració, a la part superior de la pàgina, al quadre «Base de dades de seguretat».

També hi trobareu un botó per iniciar una sincronització o per importar manualment la base de dades si treballeu fora de línia.