Utilitzar els scripts d’anàlisi personalitzats

Els scripts d’anàlisi personalitzats permeten afegir scripts d’anàlisi als que proporciona Cyberwatch. Els resultats d’aquests scripts d’anàlisi s’afegiran a la informació dels actius associats.

L’interès pot ser afegir a l’actiu informació del sistema, paquets o aplicacions, etc. Les propietats que es poden enviar i la sintaxi dels resultats dels scripts es descriuen a la documentació de les dades declaratives.

Activació de la funcionalitat

La funcionalitat s’activa anant a Administració i activant «Anàlisis personalitzades». Si el menú «Scripts personalitzats» no està disponible a les configuracions, pot ser que aquesta funcionalitat no estigui activa a la vostra llicència de Cyberwatch. Podeu contactar amb nosaltres a l’adreça de correu electrònic support@cyberwatch.com perquè l’activem (sense cap cost addicional).

Creació d’un script d’anàlisi personalitzat

  1. Assegureu-vos que la funcionalitat Anàlisis personalitzades està activada
  2. Aneu a Paràmetres > Scripts d’anàlisi i feu clic al botó + Afegeix
  • El camp Nom permet identificar l’script d’anàlisi personalitzat
  • El camp Sistema operatiu permet especificar l’objectiu de l’script d’anàlisi personalitzat. Només s’executarà en els actius que tinguin el sistema operatiu al qual s’adreça l’script d’anàlisi
  • El camp Codi font ha de contenir l’script d’anàlisi creat. Ha de ser compatible amb el sistema operatiu de destinació i enviar la informació desitjada seguint la sintaxi de les dades declaratives

Després de desar aquest script nou, cal associar-lo a una política d’anàlisi perquè s’executi en els actius de destinació.

Associar un script d’anàlisi personalitzat a una política d’anàlisi

  1. Seleccioneu una política d’anàlisi a la llista Paràmetres > Polítiques d’anàlisi
  2. Feu clic al botó d’edició (icona del llapis) corresponent a la política d’anàlisi que voleu editar
  3. A la línia «Anàlisis personalitzades» del formulari, feu clic al botó «Afegeix una anàlisi personalitzada»
  4. Seleccioneu l’anàlisi i el seu període de recurrència
  5. Deseu

Desassociar un script d’anàlisi personalitzat d’una política d’anàlisi

  1. Seleccioneu una política d’anàlisi a la llista Paràmetres > Polítiques d’anàlisi
  2. Feu clic al botó d’edició (icona del llapis) corresponent a la política d’anàlisi que voleu editar
  3. A la línia «Anàlisis personalitzades» del formulari, feu clic a la icona de la paperera corresponent a l’anàlisi personalitzada que voleu desassociar
  4. Deseu

Cas pràctic: crear un script d’anàlisi

Suposem que una tecnologia que els escanejos de vulnerabilitats de Cyberwatch no cobreixen de manera nativa, com ara Keycloak, és present als nostres actius Linux. Podem crear un script d’anàlisi personalitzat per enviar la informació necessària a Cyberwatch, que la podrà tenir en compte i detectar les possibles vulnerabilitats associades.

  • El primer pas consisteix a poder obtenir la versió de la tecnologia desitjada de manera dinàmica als actius. En el cas de Keycloak, es pot utilitzar l’ordre següent:
bash-5.1$ /opt/keycloak/bin/kc.sh --version
Keycloak 24.0.2
JVM: 17.0.10 (Red Hat, Inc. OpenJDK 64-Bit Server VM 17.0.10+7-LTS)
OS: Linux 5.15.0-101-generic amd64
# Nous formattons le retour de la commande pour n'obtenir que la version
bash-5.1$ /opt/keycloak/bin/kc.sh --version | grep 'Keycloak' | cut -d ' ' -f2
24.0.2
  • Per comunicar a Cyberwatch la informació sobre la tecnologia i la seva versió, podem utilitzar el format del codi CPE, que és un esquema de noms estructurat. En el cas de Keycloak, el codi CPE associat és el següent, en què caldrà substituir <version> per la versió corresponent:
cpe:2.3:a:redhat:keycloak:<version>:*:*:*:*:*:*:*

Per facilitar l’obtenció del codi CPE associat a una tecnologia, hi ha disponible un formulari de cerca.

  • Un cop establert el mètode d’obtenció dinàmica de la versió de la nostra tecnologia, i amb el codi CPE a la mà, es pot crear l’script d’anàlisi personalitzat següent:
KC_VERSION=$(/opt/keycloak/bin/kc.sh --version | grep 'Keycloak' | cut -d ' ' -f2)
echo "NVD_APPLICATION:cpe:2.3:a:redhat:keycloak:$KC_VERSION:*:*:*:*:*:*:*"

A la sortida de l’script obtenim així la dada declarativa NVD_APPLICATION, que permet indicar una tecnologia a partir del seu codi CPE.

Índex