Datos declarativos

Los datos declarativos permiten declarar explicitamente información relacionada con un activo.

Sirven para crear un activo air gap o para modificar la información de un activo ya presente en Cyberwatch para adaptar los resultados de los escaneos.

La información a introducir debe respetar la sintaxis descrita a continuación.

Modificar los datos declarativos de un activo

  1. Hacer clic en Inventario
  2. Seleccionar un activo
  3. Desde la pagina dedicada al activo, pestaña “Análisis”, hacer clic en el botón de edición frente a “Datos declarativos”
  4. Introducir la información relativa al activo, respetando la sintaxis
  5. Validar haciendo clic en el botón “Actualizar”

Sintaxis del lenguaje

Cada propiedad del lenguaje esta compuesta por un par clave/valor, cuya sintaxis es:

KEY:value

Precisiones sobre la sintaxis

  • Las claves están compuestas exclusivamente de letras mayusculas y guiones bajos:

     bad_key: -> error de sintaxis
 BAD-KEY: -> error de sintaxis
 GOOD_KEY:

  • Las lineas que no respetan el formato clave:valor también provocan errores de sintaxis

    Cabe senalar que los errores de sintaxis nunca son fatales; la propiedad simplemente no se tendrá en cuenta en el análisis.

  • Los comentarios comienzan al inicio de la linea con el caracter # y se extienden por toda la linea. Como los valores pueden contener el caracter #, no es posible comentar solo una parte de la linea

  • Se aceptan valores en varias lineas para ciertas propiedades. Deben tener una indentacion mayor que la propiedad que los define:

     KEY:start
    ...
    end

Prohibicion de un valor

Puede prohibir un valor para que ya no sea tomado en cuenta por Cyberwatch, anteponiendo un guion a la sintaxis anterior:

-KEY1:value1

Todas las ocurrencias de KEY1:value1 que sigan a -KEY1:value1 se ignoraran.

El guion debe ir seguido de la linea exacta obtenida durante el escaneo.

Tipos de propiedades

Hay dos tipos de propiedades disponibles:

  • Las propiedades simples que solo pueden definirse una vez y que aceptan un solo valor. Si la propiedad se redefine, el segundo valor se ignora:

     HOSTNAME:server-1
 HOSTNAME:server-2 -> ignorada

  • Las propiedades multiples que pueden indicarse varias veces en el script. Permiten construir una lista de elementos:

     # Indica 2 paquetes:
 PACKAGE:coreutils|8.32-1
 PACKAGE:bash|5.1.004-1

Observe que al modificar la información de un activo, las propiedades simples pueden reescribirse directamente. Entonces reemplazaran la información obtenida durante los escaneos:

   HOSTNAME:server-1 -> reemplaza el valor obtenido

En cambio, las propiedades multiples no pueden reescribirse directamente. Para que un valor obtenido durante los escaneos sea reemplazado, se debe prohibir y agregar una propiedad con el nuevo valor.

Ejemplo de caso de uso:

   # Reemplazar la version de un paquete
   -PACKAGE:coreutils|8.31
   PACKAGE:coreutils|8.32

Lista de propiedades principales

Información del sistema

KEYImpactoEjemplo KEY:valueSimple/Multiple
HOSTNAMEDefine el nombre del activoHOSTNAME:serverSimple
KERNEL_VERSIONDefine la version del kernel del SOKERNEL_VERSION:5.4.0-42-genericSimple
OS_NAMEDefine el nombre del sistema operativo del activoOS_NAME:UbuntuSimple
OS_VERSIONDefine la version del sistema operativoOS_VERSION:20.04.1 LTSSimple
OS_PRETTYNAMEDefine el sistema operativo y su versionOS_PRETTYNAME:Ubuntu 20.04.1 LTSSimple
ARCHDefine la arquitectura bajo la cual se ejecuta el activoARCH:x86_64Simple

Estado del sistema

KEYImpactoEjemplo KEY:valueSimple/Multiple
REBOOTPermite definir el estado en Reinicio necesarioREBOOT:falseSimple
BOOT_TIMEDefine la hora y fecha de arranqueBOOT_TIME:2021-03-18T07:38:59+0000Simple

Servicios

KEYImpactoEjemplo KEY:valueSimple/Multiple
SERVICEAnade una linea en la pestaña ServiciosSERVICE:ssh|enabledMultiple

Paquetes/aplicaciones instalados

KEYImpactoEjemplo KEY:valueSimple/Multiple
PACKAGEAnade un paquete a las tecnologías del activoPACKAGE:firefox|80.0.1+build1-0ubuntu0.20.04.1Multiple
APPLICATIONAnade una aplicación a las tecnologías del activoAPPLICATION:Microsoft Office 365 ProPlus - en-us|16.0.11328.20512Multiple
NVD_APPLICATIONAnade una aplicación de terceros a partir de una CPE conocida de la base NVDNVD_APPLICATION:cpe:/a:elastic:kibana:7.0.0Multiple
METAAnade una linea a la pestaña MetadatosMETA:processor-version|Intel(R) Core(TM) i7-10700 CPU @ 2.90GHzMultiple

Información de red

KEYImpactoEjemplo KEY:valueSimple/Multiple
IPDefine las direcciones IP del activo con o sin mascara de subredIP:127.0.0.1 o IP:127.0.0.1/8 o IP:127.0.0.1/255.0.0.0Multiple
TCPAnade un puerto TCP a la pestaña PuertosTCP:22 o TCP:22|opensshMultiple
UDPAnade un puerto UDP a la pestaña PuertosUDP:53Multiple

Propiedades especificas de Windows

KEYImpactoEjemplo KEY:valueSimple/Multiple
OS_BUILDDefine el build de WindowsOS_BUILD:17763.1158Simple
WUAVERSIONDefine la version del Windows Update AgentWUAVERSION:10.0.17763.1Simple
CAB_FILENAMEDefine el nombre del archivo oficial de Microsoft usado para este escaneoCAB_FILENAME:dcdb9e78484667695627acea9213897eaf.cabSimple

Equipos moviles

KEYImpactoEjemplo KEY:valueSimple/Multiple
FIRMWAREEspecifica el código CPE del firmware de un equipo movilFIRMWARE:cpe:/o:google:android:2022-08-15
FIRMWARE:cpe:/o:apple:iphone_os:14.3		Multiple

Propiedades especificas de SAP

KEYImpactoEjemplo KEY:valueSimple/Multiple
SAP_NOTEAnade una nota SAP al activoSAP_NOTE:3119365Multiple

Defectos de seguridad

KEYImpactoEjemplo KEY:valueSimple/Multiple
SECURITY_ISSUEAnade una linea en la pestaña Defectos de seguridadSECURITY_ISSUE:
   sid: WSTG-CRYP-04 (low)
   cipher: TLS_RSA_WITH_AES_128_CBC_SHA
   grade: A
   port: 443		Multiple
sidEspecifica la referencia del defecto de seguridad asociadoSECURITY_ISSUE:
   sid: WSTG-ATHN-02		Simple
cipherDefine el cifrado no conformeSECURITY_ISSUE:
   sid: WSTG-CRYP-04 (low)
   cipher: TLS_RSA_WITH_AES_256_CBC_SHA		Simple
portDetalla el puerto asociado al defecto de seguridadSECURITY_ISSUE:
   sid: WSTG-CRYP-04 (low)
   port: 443		Simple
infoPrecisa información complementariaSECURITY_ISSUE:
   sid: WSTG-CONF-07
   path: "/login.php"
   method: GET
   info: HttpOnly flag is not set in the cookie : language 		Simple
methodEspecifica el método de solicitud HTTPSECURITY_ISSUE:
   sid: WSTG-CONF-07
   path: "/login.php"
   method: GET 		Simple
pathEspecifica la ruta de accesoSECURITY_ISSUE:
   sid: WSTG-CONF-07
   path: "/login.php"		Simple
parameterDefine el parámetro vulnerableSECURITY_ISSUE:
   sid: WSTG-INPV-01
   info: XSS vulnerability found vía injection in the parameter id
   parameter: id		Simple
http_requestEspecifica la solicitud HTTP asociadaSECURITY_ISSUE:
   sid: WSTG-INPV-01
   path: "/login.php"
   parameter: id
   http_request:		-

      GET /login.php HTTP/1.1
      host: website.test </code>		Simple  
curl_commandInforma del comando curl equivalenteSECURITY_ISSUE:
   sid: WSTG-CONF-07
   curl_command: curl "<https://website.test/login.php>" 		Simple
descriptionDescripción del defecto de seguridadSECURITY_ISSUE:
   sid: WSTG-CONF-07
   description: HTTP Strict Transport Security		Simple
protocolDefine el protocolo no conformeSECURITY_ISSUE:
   sid: Telnet-port
   protocol: TCP		Simple

Equipos de red

KEYImpactoEjemplo KEY:valueSimple/Multiple
FIRMWAREEspecifica el código CPE del firmware de un equipoFIRMWARE:cpe:/o:stormshield:stormshield_network_security:3.8.1Multiple
HARDWAREPrecisa el código CPE del hardware del equipoHARDWARE:cpe:2.3:h:sonicwall:nssp_15700Multiple

Volver arriba

English Français Español