Dades declaratives

Les dades declaratives permeten declarar explícitament informació relacionada amb un actiu.

Serveixen per crear un actiu air gap o per modificar la informació d’un actiu que ja és present a Cyberwatch per adaptar els resultats dels escanejos.

La informació que cal indicar ha de respectar la sintaxi que es descriu a continuació.

Modificar les dades declaratives d’un actiu

  1. Feu clic a Inventari
  2. Seleccioneu un actiu
  3. A la pàgina de l’actiu corresponent, pestanya «Anàlisis», feu clic al botó d’edició que hi ha davant de «Dades declaratives»
  4. Indiqueu la informació relativa a l’actiu, respectant la sintaxi
  5. Confirmeu fent clic al botó «Actualitza»

Sintaxi del llenguatge

Cada propietat del llenguatge es compon d’un parell clau/valor, amb la sintaxi següent:

KEY:value

Precisions sobre la sintaxi

  • Les claus es componen exclusivament de lletres majúscules i de guions baixos (underscores):

     bad_key: → erreur de syntaxe
 BAD-KEY: → erreur de syntaxe
 GOOD_KEY:

  • Les línies que no respecten el format clau:valor també provoquen errors de sintaxi

    Cal tenir en compte que els errors de sintaxi no són mai fatals: simplement, la propietat no es tindrà en compte a l’anàlisi.

  • Els comentaris comencen a l’inici de la línia amb el caràcter # i s’estenen per tota la línia. Com que els valors poden contenir el caràcter #, no es pot comentar només una part de la línia

  • Algunes propietats accepten valors en diverses línies. Aquestes línies han de tenir un sagnat més gran que la propietat que les defineix:

     KEY:start
    ...
    end

Prohibició d’un valor

Podeu prohibir un valor perquè Cyberwatch deixi de tenir-lo en compte posant un guionet davant de la sintaxi anterior:

-KEY1:value1

Totes les ocurrències de KEY1:value1 que vinguin després de -KEY1:value1 s’ignoraran.

El guionet ha d’anar seguit de la línia exacta obtinguda durant l’escaneig.

Tipus de propietats

Hi ha dos tipus de propietats disponibles:

  • Les propietats simples, que només es poden definir una vegada i que només accepten un sol valor. Si la propietat es torna a definir, el segon valor s’ignora:

     HOSTNAME:server-1
 HOSTNAME:server-2 → ignorée

  • Les propietats múltiples, que es poden indicar diverses vegades a l’script. Permeten construir una llista d’elements:

     # Renseigne 2 paquets :
 PACKAGE:coreutils|8.32-1
 PACKAGE:bash|5.1.004-1

Tingueu en compte que, quan es modifica la informació d’un actiu, les propietats simples es poden reescriure directament. En aquest cas, substitueixen la informació obtinguda durant els escanejos:

   HOSTNAME:server-1 → remplace la valeur remontée

En canvi, les propietats múltiples no es poden reescriure directament. Perquè se substitueixi un valor obtingut durant els escanejos, cal prohibir-lo i afegir una propietat amb el valor nou.

Exemple de cas d’ús:

   # Remplacer la version d'un paquet
   -PACKAGE:coreutils|8.31
   PACKAGE:coreutils|8.32

Llista de les propietats principals

Informació del sistema

KEYImpacteExemple KEY:valueSimple/Múltiple
HOSTNAMEDefineix el nom de l’actiuHOSTNAME:serverSimple
KERNEL_VERSIONDefineix la versió del nucli del sistema operatiuKERNEL_VERSION:5.4.0-42-genericSimple
OS_NAMEDefineix el nom del sistema operatiu de l’actiuOS_NAME:UbuntuSimple
OS_VERSIONDefineix la versió del sistema operatiuOS_VERSION:20.04.1 LTSSimple
OS_PRETTYNAMEDefineix el sistema operatiu i la seva versióOS_PRETTYNAME:Ubuntu 20.04.1 LTSSimple
ARCHDefineix l’arquitectura en què s’executa l’actiuARCH:x86_64Simple

Estat del sistema

KEYImpacteExemple KEY:valueSimple/Múltiple
REBOOTPermet definir l’estat Reinici necessariREBOOT:falseSimple
BOOT_TIMEDefineix l’hora i la data d’arrencadaBOOT_TIME:2021-03-18T07:38:59+0000Simple

Serveis

KEYImpacteExemple KEY:valueSimple/Múltiple
SERVICEAfegeix una línia a la pestanya ServeisSERVICE:ssh|enabledMúltiple

Paquets/aplicacions instal·lats

KEYImpacteExemple KEY:valueSimple/Múltiple
PACKAGEAfegeix un paquet a les tecnologies de l’actiuPACKAGE:firefox|80.0.1+build1-0ubuntu0.20.04.1Múltiple
APPLICATIONAfegeix una aplicació a les tecnologies de l’actiuAPPLICATION:Microsoft Office 365 ProPlus - en-us|16.0.11328.20512Múltiple
NVD_APPLICATIONAfegeix una aplicació de tercers a partir d’un codi CPE conegut de la base NVDNVD_APPLICATION:cpe:/a:elastic:kibana:7.0.0Múltiple
METAAfegeix una línia a la pestanya MetadadesMETA:processor-version|Intel(R) Core(TM) i7-10700 CPU @ 2.90GHzMúltiple

Informació de xarxa

KEYImpacteExemple KEY:valueSimple/Múltiple
IPDefineix les adreces IP de l’actiu amb màscara de subxarxa o senseIP:127.0.0.1 o IP:127.0.0.1/8 o IP:127.0.0.1/255.0.0.0Múltiple
TCPAfegeix un port TCP a la pestanya PortsTCP:22 o TCP:22|opensshMúltiple
UDPAfegeix un port UDP a la pestanya PortsUDP:53Múltiple

Propietats específiques de Windows

KEYImpacteExemple KEY:valueSimple/Múltiple
OS_BUILDDefineix la compilació (build) de WindowsOS_BUILD:17763.1158Simple
WUAVERSIONDefineix la versió del Windows Update AgentWUAVERSION:10.0.17763.1Simple
CAB_FILENAMEDefineix el nom del fitxer oficial de Microsoft utilitzat per a aquest escaneigCAB_FILENAME:dcdb9e78484667695627acea9213897eaf.cabSimple

Dispositius mòbils

KEYImpacteExemple KEY:valueSimple/Múltiple
FIRMWAREEspecifica el codi CPE del microprogramari d’un dispositiu mòbilFIRMWARE:cpe:/o:google:android:2022-08-15
FIRMWARE:cpe:/o:apple:iphone_os:14.3		Múltiple

Propietats específiques de SAP

KEYImpacteExemple KEY:valueSimple/Múltiple
SAP_NOTEAfegeix una nota SAP a l’actiuSAP_NOTE:3119365Múltiple

Problemes de seguretat

KEYImpacteExemple KEY:valueSimple/Múltiple
SECURITY_ISSUEAfegeix una línia a la pestanya Problemes de seguretatSECURITY_ISSUE:
   sid: WSTG-CRYP-04 (low)
   cipher: TLS_RSA_WITH_AES_128_CBC_SHA
   grade: A
   port: 443		Múltiple
sidEspecifica la referència del problema de seguretat associatSECURITY_ISSUE:
   sid: WSTG-ATHN-02		Simple
cipherDefineix el xifratge no conformeSECURITY_ISSUE:
   sid: WSTG-CRYP-04 (low)
   cipher: TLS_RSA_WITH_AES_256_CBC_SHA		Simple
portDetalla el port associat al problema de seguretatSECURITY_ISSUE:
   sid: WSTG-CRYP-04 (low)
   port: 443		Simple
infoPrecisa informació complementàriaSECURITY_ISSUE:
   sid: WSTG-CONF-07
   path: "/login.php"
   method: GET
   info: HttpOnly flag is not set in the cookie : language 		Simple
methodEspecifica el mètode de la sol·licitud HTTPSECURITY_ISSUE:
   sid: WSTG-CONF-07
   path: "/login.php"
   method: GET 		Simple
pathEspecifica el camí d’accésSECURITY_ISSUE:
   sid: WSTG-CONF-07
   path: "/login.php"		Simple
parameterDefineix el paràmetre vulnerableSECURITY_ISSUE:
   sid: WSTG-INPV-01
   info: XSS vulnerability found via injection in the parameter id
   parameter: id		Simple
http_requestEspecifica la sol·licitud HTTP associadaSECURITY_ISSUE:
   sid: WSTG-INPV-01
   path: "/login.php"
   parameter: id
   http_request: |−
      GET /login.php HTTP/1.1
      host: website.test 		Simple
curl_commandIndica l’ordre curl equivalentSECURITY_ISSUE:
   sid: WSTG-CONF-07
   curl_command: curl "<https://website.test/login.php>" 		Simple
descriptionDescripció del problema de seguretatSECURITY_ISSUE:
   sid: WSTG-CONF-07
   description: HTTP Strict Transport Security		Simple
protocolDefineix el protocol no conformeSECURITY_ISSUE:
   sid: Telnet-port
   protocol: TCP		Simple

Dispositius de xarxa

KEYImpacteExemple KEY:valueSimple/Múltiple
FIRMWAREEspecifica el codi CPE del microprogramari d’un dispositiuFIRMWARE:cpe:/o:stormshield:stormshield_network_security:3.8.1Múltiple
HARDWAREPrecisa el codi CPE del maquinari del dispositiuHARDWARE:cpe:2.3:h:sonicwall:nssp_15700Múltiple