Integracions

Es poden enviar les dades de Cyberwatch a un sistema extern mitjançant les Integracions.

Creació d’una integració

Feu clic a Administració
Feu clic a Integracions
Feu clic a Afegeix
Ompliu els camps del formulari de creació de la integració:
- Plantilla d’integració:
  - Microsoft Teams - Informació d’actius és una plantilla de configuració que us permet enviar al vostre canal de Teams la informació relativa a les vulnerabilitats presents als vostres actius
  - Microsoft Teams - Informació de vulnerabilitats és una plantilla de configuració que us permet enviar les diferents informacions relatives a les CVE
  - Microsoft Teams - Gestió de pedaços és una plantilla de configuració que us permet enviar la informació relativa als pedaços que cal desplegar als vostres actius
- Protocol de la integració:
  - HTTP hook per enviar sol·licituds HTTP REST
  - SMTP hook per enviar correus electrònics amb la configuració SMTP definida a Administració > SMTP
- Nom de la integració: nom de la integració que es mostrarà a les llistes de selecció d’integracions
- Ubicació de l’activador: ubicació on es podrà trobar la integració. Les ubicacions disponibles són:
  - Inventari
  - Detalls d’un actiu - Pestanya Vulnerabilitats
  - Detalls d’un actiu - Pestanya Gestió de pedaços
  - Detalls d’un actiu - Pestanya Conformitat
  - Detalls d’un actiu - Pestanya Problemes de seguretat
  - Enciclopèdia de vulnerabilitats
  - Enciclopèdia de regles de conformitat
  - Enciclopèdia de problemes de seguretat
  - Accions correctives
  - Detalls d’una vulnerabilitat
  - Detalls d’una regla de conformitat
  - Detalls d’un problema de seguretat
  - Detalls d’una acció correctiva
  - Cap: correspon a les integracions disponibles només per a les alertes
Per a les integracions HTTP
- URL de la sol·licitud: URL a la qual s’enviaran les dades
- Capçaleres de la sol·licitud: capçaleres de la sol·licitud en forma de diccionari, per exemple:
```
{
    "Accept-Charset": "utf-8",
    "Accept-Encoding": "gzip",
    "Authorization": "Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==",
    "Content-Type": "application/json",
    "User-Agent": "Mozilla/5.0 (X11; Linux x86_64; rv:12.0) Gecko/20100101 Firefox/12.0"
}
```
- Cos de la sol·licitud: cos de la sol·licitud que conté les dades que cal enviar. Compatible amb les plantilles
- Mètode HTTP de la sol·licitud: elecció del mètode HTTP amb què s’enviarà la sol·licitud
- Utilitza un certificat autosignat per a la sol·licitud: permet connectar-se a un servidor amb un certificat autosignat. Atenció: connectar-se a un servidor amb un certificat autosignat comporta el risc que un tercer pugui interceptar el trànsit cap al servidor mitjançant aquest certificat
- Utilitza la configuració del servidor intermediari per a la sol·licitud: permet utilitzar el servidor intermediari configurat a Cyberwatch
Per a les integracions SMTP
- Adreça electrònica del destinatari
- Assumpte del correu electrònic. Compatible amb les plantilles
- Contingut del correu electrònic: el missatge que conté les dades que cal enviar. Compatible amb les plantilles
Deseu

Si els camps s’han omplert correctament, la integració apareixerà a la llista d’integracions.

Per configurar integracions amb Teams, feu clic aquí.

Plantilles

Cyberwatch utilitza el motor de plantilles Liquid per donar format al cos de les sol·licituds HTTP i dels correus electrònics. La seva documentació està disponible en anglès a l’adreça https://shopify.dev/docs/api/liquid.

Hi ha disponibles les variables de dades de Cyberwatch següents:

Variable	Descripció	Exemple
`asset`	Actiu afectat, per als contextos en què només n’hi ha un. Atributs: - `name`: nom de l’actiu. - `description`: descripció de l’actiu. - `cve_announcements_count`: nombre de vulnerabilitats de l’actiu. - `critical_cve_announcements_count`: nombre de vulnerabilitats prioritàries de l’actiu. - `compliance_rules_count`: nombre de regles de conformitat de l’actiu. - `compliance_rules_failed_count`: nombre de regles de conformitat fallides de l’actiu. - `compliance_rules_succeed_count`: nombre de regles de conformitat superades de l’actiu. - `compliance_rules_anomalies_count`: nombre de regles de conformitat en anomalia de l’actiu. - `security_issues_count`: nombre de problemes de seguretat de l’actiu.	`{{ asset.name }}` ⇒ `MY-PC.DOMAIN`
`assets`	Llista dels actius afectats. Els atributs són els mateixos que els d’`asset`.	`{{ assets \| map: 'name' \| join: ', ' }}` ⇒ `example-1.local, example-2.local`
`cve`	CVE afectada, per als contextos en què només n’hi ha una. Atributs: - `code`: referència de la CVE. - `content`: descripció de la CVE. - `summary`: descripció breu de la CVE. - `score`: puntuació CVSS de la CVE. - `epss`: puntuació EPSS de la CVE. - `catalogs`: llista dels catàlegs que referencien la vulnerabilitat (atributs: `name`, `added_at`). - `technologies`: llista de les tecnologies afectades per la CVE (atributs: `vendor`, `product`).	`{{ cve.code }}` ⇒ `CVE-2023-1234`
`cves`	Llista de les CVE afectades. Els atributs són els mateixos que els de `cve`.	`{{ cves \| map: 'code' \| join: ', ' }}` ⇒ `CVE-2023-0001, CVE-2023-0002`
`technology`	Tecnologia afectada, per als contextos en què només n’hi ha una. Atributs: - `product`: nom de producte de la tecnologia. - `target_title`: títol de la tecnologia. - `target_version_string`: versió de destinació de la tecnologia. - `cve_announcements_count`: nombre de vulnerabilitats de la tecnologia. - `critical_cve_announcements_count`: nombre de vulnerabilitats prioritàries de la tecnologia.	`{{ technology.product }}` ⇒ `Google Chrome`
`technologies`	Tecnologies afectades. Els atributs són els mateixos que els de `technology`.	`{{ technologies \| map: 'product' \| join: ', ' }}` ⇒ `linux, linux-firmware`
`compliance_rule`	Regla de conformitat afectada, per als contextos en què només n’hi ha una. Atributs: - `name`: nom de la regla de conformitat. - `description`: descripció de la regla de conformitat. -`code`: referència de la regla de conformitat. -`rationale`: objectiu de la regla de conformitat. -`audit`: auditoria de la regla de conformitat. -`remediation`: remediació de la regla de conformitat. -`require_sudo`: necessitat de drets d’administrador per a la regla de conformitat. -`reference`: referència de la regla de conformitat al benchmark.	`{{ compliance_rule.name }}` ⇒ `Ensure rsyslog service is enabled`
`compliance_rules`	Regles de conformitat afectades. Els atributs són els mateixos que els de `compliance_rule`.	`{{ compliance_rules \| map: 'code' \| join: ', ' }}` ⇒ `CIS-AWS-1.4, CIS-AWS-1.20`
`security_issue`	Problema de seguretat afectat, per als contextos en què només n’hi ha un. Atributs: - `sid`: referència del problema de seguretat. - `title`: nom del problema de seguretat. - `description`: descripció del problema de seguretat.	`{{ security_issue.title }}` ⇒ `TAA - TSX Asynchronous Abort`
`security_issues`	Problemes de seguretat afectats. Els atributs són els mateixos que els de `security_issue`.	`{{ security_issues \| map: 'sid' \| join: ', ' }}` ⇒ `WSTG-INPV-17, WSTG-ATHN-10`
`host`	Actiu descobert afectat, per als contextos en què només n’hi ha un. Atributs: - `hostname`: nom d’amfitrió de l’actiu descobert.	`{{ host.hostname }}` ⇒ `bar.example.com`
`hosts`	Actius descoberts afectats. Els atributs són els mateixos que els de `host`.	`{{ hosts \| map: 'hostname' \| join: ', ' }}` ⇒ `bar.example.com, foo.example.com`

A més dels filtres per defecte, el filtre json permet donar format JSON a una dada. Per tant, es pot enviar una llista de CVE a una API amb el cos: { "cves": {{ cves | json }} }. Aleshores, la llista de CVE apareixerà com una matriu JSON, per exemple { "cves": [{ "code": "CVE-2023-0001" }, { "code": "CVE-2023-0002" }] }.

Hi ha disponibles les variables d’alerta de Cyberwatch següents:

Variable	Descripció
`alert_name`	Nom de l’alerta que ha activat la integració
`manage_link`	Enllaç a la pàgina d’edició de l’alerta
`node_name`	Nom de la instància en què s’ha activat l’alerta
`node_url`	Enllaç a la instància en què s’ha activat l’alerta
`host`	En el cas d’un descobriment, nom de domini de l’actiu descobert
`hosts`	En el cas d’un descobriment, llista dels noms de domini dels actius descoberts

Variables disponibles per ubicació de l’activador

Detalls d’un actiu

Ubicació de l’activador	Variables disponibles
Pestanya Vulnerabilitats	`asset`, `assets`, `cve`, `cves`
Pestanya Gestió de pedaços	`asset`, `assets`, `cve`, `cves`, `technology`, `technologies`
Pestanya Conformitat	`asset`, `assets`, `technology`, `technologies`
Pestanya Problemes de seguretat	`asset`, `assets`, `security_issue`, `security_issues`

Enciclopèdies

Ubicació de l’activador	Variables disponibles
Vulnerabilitats	`asset`, `assets`, `cve`, `cves`
Regles de conformitat	`asset`, `assets`, `compliance_rule`, `compliance_rules`
Problemes de seguretat	`asset`, `assets`, `security_issue`, `security_issues`
Accions correctives	`asset`, `assets`, `technology`, `technologies`
Inventari	`asset`, `assets`

Detalls

Ubicació de l’activador	Variables disponibles
Detalls d’una vulnerabilitat	`asset`, `assets`, `cve`, `cves`
Detalls d’una regla de conformitat	`asset`, `assets`, `compliance_rule`, `compliance_rules`
Detalls d’un problema de seguretat	`asset`, `assets`, `security_issue`, `security_issues`
Detalls d’una acció correctiva	`asset`, `assets`, `cve`, `cves`, `technology`, `technologies`

Edició d’una integració

Feu clic a Administració
Feu clic a Integracions
Feu clic al botó d’edició (icona de llapis) de la integració que vulgueu editar
Modifiqueu els camps que vulgueu al formulari. Els camps estan emplenats amb els valors de la integració que s’edita
Deseu

Supressió d’una integració

Feu clic a Administració
Feu clic a Integracions
Feu clic al botó de supressió (icona de paperera) de la integració que vulgueu suprimir
Confirmeu fent clic al botó «D’acord» de l’avís de confirmació

Provar una integració

Feu clic a Administració
Feu clic a Integracions
Feu clic al botó de prova (icona de fletxa) de la integració que vulgueu provar
Comproveu que apareix una finestra modal amb l’estat de la resposta, que confirma la connexió amb el servidor

Ús d’una integració

Les integracions es poden utilitzar en diferents ubicacions segons l’opció triada al formulari de creació o edició:

Inventari

Feu clic a Inventari
Seleccioneu els actius que vulgueu enviar
Feu clic al botó Accions en bloc
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta

Detalls d’un actiu - Pestanya Vulnerabilitats

Feu clic a Inventari
Feu clic al nom de l’actiu del qual vulgueu enviar les dades
Feu clic a la pestanya Vulnerabilitats
Seleccioneu les vulnerabilitats que vulgueu enviar
Feu clic a la fletxa a la dreta del botó Ignora
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta

Detalls d’un actiu - Pestanya Gestió de pedaços

Feu clic a Inventari
Feu clic al nom de l’actiu del qual vulgueu enviar les dades
Feu clic a la pestanya Gestió de pedaços
Seleccioneu els pedaços que vulgueu enviar
Feu clic a la fletxa a la dreta del botó Planifica els pedaços seleccionats (o al botó Envia la selecció si es tracta d’un actiu en mode «Només supervisió»)
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta

Detalls d’un actiu - Pestanya Conformitat

Feu clic a Inventari
Feu clic al nom de l’actiu del qual vulgueu enviar les dades
Feu clic a la pestanya Conformitat
Seleccioneu les regles de conformitat que vulgueu enviar
Feu clic a la fletxa a la dreta del botó Envia la selecció
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta

Detalls d’un actiu - Pestanya Problemes de seguretat

Feu clic a Inventari
Feu clic al nom de l’actiu del qual vulgueu enviar les dades
Feu clic a la pestanya Problemes de seguretat
Seleccioneu els problemes de seguretat que vulgueu enviar
Feu clic a la fletxa a la dreta del botó Ignora
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta

Enciclopèdia de vulnerabilitats

Feu clic a Vulnerabilitats
Seleccioneu les vulnerabilitats que vulgueu enviar
Feu clic al botó Accions en bloc
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta

Detalls d’una vulnerabilitat

Feu clic a Vulnerabilitats
Feu clic a una referència de CVE de l’enciclopèdia per anar a la fitxa de la CVE
Seleccioneu els actius que vulgueu enviar
Feu clic a la fletxa a la dreta del botó Ignora i comenta
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta

Enciclopèdia de regles de conformitat

Feu clic a Regles de conformitat
Seleccioneu les regles de conformitat que vulgueu enviar
Feu clic al botó Accions en bloc
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta

Detalls d’una regla de conformitat

Feu clic a Regles de conformitat
Feu clic a una referència de regla de conformitat per anar a la fitxa de la regla de conformitat
Seleccioneu els actius que vulgueu enviar
Feu clic a la fletxa a la dreta del botó Comprova els actius
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta

Enciclopèdia de problemes de seguretat

Feu clic a Problemes de seguretat
Seleccioneu els problemes de seguretat que vulgueu enviar
Feu clic al botó Accions en bloc
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta

Detalls d’un problema de seguretat

Feu clic a Problemes de seguretat
Feu clic a una referència de problema de seguretat per anar a la fitxa del problema de seguretat
Seleccioneu els actius que vulgueu enviar
Feu clic a la fletxa a la dreta del botó Ignora
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta

Accions correctives

Feu clic a Accions correctives
Seleccioneu les accions correctives que vulgueu enviar
Feu clic al botó Accions en bloc
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta

Detalls d’una acció correctiva

Feu clic a Problemes de seguretat
Feu clic a una referència de problema de seguretat per anar a la fitxa del problema de seguretat
Seleccioneu els actius que vulgueu enviar
Feu clic a la fletxa a la dreta del botó Desplega
Feu clic al nom de la integració al menú desplegable
Comproveu l’estat de la resposta a la notificació de la part superior dreta