Données déclaratives

Les données déclaratives permettent de déclarer explicitement des informations liées à un actif.

Elles servent à créer un actif air gap ou à modifier les informations d’un actif déjà présent dans Cyberwatch pour adapter les résultats des scans.

Les informations à renseigner doivent respecter la syntaxe décrite ci-dessous.

Modifier les données déclaratives d’un actif

1. Cliquer sur Inventaire.
2. Sélectionner un actif.
3. Depuis la page dédiée à l’actif concerné, onglet « Analyse », cliquer sur le bouton d’édition devant « Données déclaratives ».
4. Renseigner les informations relatives à l’actif, en respectant la syntaxe.
5. Valider en cliquant sur le bouton « Mettre à jour ».

Syntaxe du langage

Chaque propriété du langage est composée d’une paire de clé/valeur, dont la syntaxe est :

KEY:value

Précisions sur la syntaxe

• Les clés sont composées exclusivement de lettres majuscule et d’underscores (tirets du bas) :

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

• Les lignes ne respectant pas le format clé:valeur déclenchent également des erreurs de syntaxe.

  Il est à noter que les erreurs de syntaxe ne sont jamais fatales, la propriété ne sera simplement pas prise en compte dans l’analyse.

• Les commentaires commencent au début de la ligne par la caractère #, et s’étendent sur toute la ligne. Les valeurs pouvant contenir le caractère #, commenter une partie de la ligne n’est pas possible.

• Des valeurs en plusieurs lignes sont acceptées pour certaines propriétés. Elles doivent avoir une indentation plus importante que la propriété qui les définit :

   KEY:start
      ...
      end
  

Interdiction d’une valeur

Vous pouvez interdire une valeur pour qu’elle ne soit plus prise en compte par Cyberwatch, en faisant précéder la syntaxe précédente d’un trait d’union :

-KEY1:value1

Toutes les occurrences de KEY1:value1 qui suivront -KEY1:value1 seront ignorées.

N.B. : Le trait d’union doit être suivi de la ligne exacte remontée lors du scan.

Types de propriétés

Deux types de propriétés sont disponibles :

• Les propriétés simples qui ne peuvent être définies qu’une fois et qui n’acceptent qu’une seule valeur. Si la propriété est redéfinie, la deuxième valeur est ignorée :

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

• Les propriétés multiples qui peuvent être renseignées plusieurs fois dans le script. Elles permettent de construire une liste d’éléments :

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

Notez que lors de la modification des informations d’un actif, les propriétés simples peuvent être directement réécrites. Elles remplaceront alors les informations remontées lors des scans :

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

A l’inverse, les propriétés multiples ne peuvent pas être directement réécrites. Pour qu’une valeur remontée lors des scans soit remplacée, il convient de l’interdire et d’ajouter une propriété avec la nouvelle valeur.

Exemple de cas d’usage :

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

Liste des propriétés principales

Informations système

État du système

Services

Paquets/applications installés

Informations réseau

Propriétés spécifiques à Windows

Propriétés spécifiques à SAP

Défauts de sécurité