Skip to main content

​
Què aporta aquesta integració

KnowBe4 pot aportar resultats relacionats amb la plantilla (Workforce), la formació (Training) i les simulacions de phishing. Alguns exemples revisats:
  • training.completed — completa la formació en seguretat
  • training.past.due — té formació endarrerida
  • phishing.simulation.clicked — ha fet clic en una simulació sense reportar-la
Aquests exemples mostren els tipus d’activitat normalitzada que Living Security pot utilitzar. Consulteu com es converteixen les dades d’integració en Signals.

​
Què necessita Living Security

Abast (scopes): No cal configurar-ne cap — els tokens de la Reporting API de KnowBe4 són de només lectura per disseny i no tenen abast. El token concedeix accés de lectura als usuaris, a les inscripcions a formacions i als resultats de proves de seguretat de phishing, que és exactament el que llegeix la sincronització. Rol necessari: Account Admin a KnowBe4 (només els administradors del compte poden accedir a Account Settings → API)

​
Requisits previs

  • Heu d’haver iniciat sessió a la consola de KnowBe4 amb el rol Account Admin. Només els administradors del compte poden accedir a Account Settings → API per activar la Reporting API i generar tokens.

​
Part A — A KnowBe4

L’administrador de KnowBe4 completa aquests passos.
1

Activeu la Reporting API i genereu un token

  1. Inicieu sessió a la consola de KnowBe4.
  2. Feu clic al nom del vostre compte, a l’extrem superior dret, i seleccioneu Account Settings.
  3. Al tauler de navegació de l’esquerra, seleccioneu API.
  4. Activeu la Reporting API si encara no ho està i, a continuació, genereu un token d’API nou.
Indiqueu una finalitat descriptiva per al token (p. ex., Living Security Platform) si la consola us la demana.
KnowBe4 mostra el valor del token d’API només una vegada, en el moment de generar-lo. Copieu-lo immediatament i deseu-lo en un lloc segur (p. ex., una caixa forta de contrasenyes o un gestor de secrets). Si abandoneu la pàgina sense copiar-lo, haureu de generar un token nou.
La Reporting API és de només lectura. Exposa usuaris, inscripcions a formacions i resultats de proves de seguretat de phishing — les dades que Living Security ingereix per a la puntuació i els informes. No cal cap accés d’escriptura.
2

Afegiu les IP de sortida de Living Security a la llista Allowed IP Addresses

KnowBe4 permet restringir l’accés a la Reporting API a un conjunt concret d’adreces IP d’origen. Aquesta opció es troba al mateix lloc que el token:
  1. A la consola de KnowBe4, aneu a Account Settings → API → Allowed IP Addresses.
  2. Afegiu cada adreça IP de sortida de Living Security a la llista d’adreces permeses. Les mateixes quatre adreces s’apliquen a totes les regions.
Si la llista Allowed IP Addresses està configurada, s’aplica a la capa de xarxa. El diàleg de connexió funcionarà en el moment de l’autenticació, però les sincronitzacions de dades fallaran (bloquejades a la capa de xarxa, cosa que normalment es manifesta com a 403) fins que les IP de sortida de Living Security s’afegeixin a la llista d’adreces permeses. Si afegiu qualsevol adreça a aquesta llista, també heu d’afegir-hi els intervals de Living Security; en cas contrari, les nostres sol·licituds seran rebutjades encara que el token sigui vàlid.
Les adreces IP de sortida de Living Security poden canviar quan s’actualitza la infraestructura, tot i que procurem que aquests canvis siguin poc habituals. Si les sincronitzacions de dades comencen a fallar després d’haver funcionat correctament, consulteu Configuració de les adreces IP de sortida de les integracions i verifiqueu que la llista Allowed IP Addresses hi coincideixi.
3

Identifiqueu la regió del servidor de KnowBe4

KnowBe4 ofereix la Reporting API des d’un host específic de cada regió. Heu de seleccionar la regió al diàleg de connexió en lloc d’escriure un nom d’amfitrió:Si no esteu segur de quina regió utilitza el vostre compte, comproveu el domini de l’URL de la consola de KnowBe4 o contacteu amb l’administrador de KnowBe4.
Aquestes cinc regions són les que Living Security pot assolir. Si el vostre compte de KnowBe4 es troba en un altre servidor (per exemple, una instància del govern dels Estats Units), contacteu amb el suport de Living Security abans d’iniciar la connexió.

​
Part B — A la Living Security Platform

El responsable del programa completa aquest pas o, si s’utilitza la configuració delegada, l’administrador del sistema.
Ara ja esteu connectat a KnowBe4.

​
Resolució de problemes

El token d’API no és vàlid o ha caducat. Verifiqueu que el token sigui correcte i que no s’hagi regenerat a Account Settings → API.
O bé el token no té accés a la Reporting API, o bé la IP de la sol·licitud no es troba a la llista Allowed IP Addresses. Verifiqueu que la Reporting API estigui activada i que les quatre adreces IP de sortida de Living Security siguin a la llista d’adreces permeses.
Pot ser que la Reporting API encara no tingui dades per retornar, o que el compte del token no tingui visibilitat sobre els usuaris i les campanyes que ingereix Living Security. Verifiqueu que el token l’hagi generat un Account Admin.