> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuració de la integració amb KnowBe4

> Connecteu KnowBe4 a la Living Security Platform per importar usuaris, inscripcions a formacions i resultats de proves de seguretat de phishing.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Recursos relacionats</h2>
    <ul>
      <li>
        <a href="/ca/signals/data-sources">Descobriu com les dades d'integració es converteixen en Signals de Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Exploreu les Integrations de Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Obriu la Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Sol·liciteu una demostració de Living Security</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>Afegiu les quatre adreces IP de sortida de sincronització de Living Security</strong> a la llista d'adreces permeses de{' '}
    {system}. Introduïu-les cadascuna com a host únic amb <code>/32</code> si {system} espera notació CIDR:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    El trànsit pot sortir per qualsevol de les quatre, de manera que, si només'n permeteu algunes, es produeixen errors de
    sincronització intermitents. Aquestes quatre adreces són les mateixes a totes les regions de Living Security. Consulteu{' '}
    <a href="/ca/integrations/managing/egress-ip-addresses">
      Configuring Integration Egress IP Addresses
    </a>{' '}
    per obtenir la llista completa, la política de canvis i la resolució de problemes.
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Introduïu les credencials a la Living Security Platform">
    <p>
      Ho ha de dur a terme qui tingui accés a Living Security: el responsable del programa o
      l'administrador del sistema, si ha estat convidat (configuració delegada).
    </p>
    <ol>
      <li>
        Aneu a <strong>Settings → Integrations → Catalog</strong>, cerqueu la icona de{' '}
        <strong>{tile}</strong> i feu clic a <strong>Connect</strong>.
      </li>
      <li>
        Ompliu els camps següents i, a continuació, feu clic a <strong>Connect</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Aquesta guia és per a l'administrador o administradora de {system}.</strong> Explica com crear
      credencials d'API dins de {system}, cosa que requereix accés d'administració a {system}, no
      a la Living Security Platform.
    </p>
    <p>
      Si sou el <strong>responsable del programa</strong> de Living Security i no administreu {system},
      envieu aquesta pàgina a la persona que ho faci. Aquesta persona completarà la Part A i us lliurarà les credencials
      (o les introduirà directament si l'heu convidada a la plataforma).
      {recommendDelegated && <>
          {' '}Com que la configuració genera material de claus sensible, recomanem seguir el procés de{' '}
          <strong>configuració delegada</strong>, de manera que el secret no se us enviï mai.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="KnowBe4" />

## 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](/ca/signals/data-sources).

## Què necessita Living Security

| Credencial | Descripció |
| - | - |
| **API key** | Un token de portador de la Reporting API generat a **Account Settings → API**. S'envia a cada sol·licitud a la capçalera `Authorization: Bearer`. |
| **Reporting API server region** | La regió on està aprovisionat el vostre compte de KnowBe4, que es tria d'una llista (US, EU, Canada, UK, Germany). |

**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.*

<Steps>
  <Step title="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.

    <Warning>
      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.
    </Warning>

    <Note>
      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.
    </Note>
  </Step>

  <Step title="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](/ca/integrations/managing/egress-ip-addresses) a la llista d'adreces permeses. Les mateixes quatre adreces s'apliquen a totes les regions.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **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.
    </Warning>

    <Note>
      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](/ca/integrations/managing/egress-ip-addresses) i verifiqueu que la llista Allowed IP Addresses hi coincideixi.
    </Note>
  </Step>

  <Step title="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ó:

    | Regió | Host de la Reporting API |
    | - | - |
    | Estats Units | `us.api.knowbe4.com` |
    | Europa | `eu.api.knowbe4.com` |
    | Canadà | `ca.api.knowbe4.com` |
    | Regne Unit | `uk.api.knowbe4.com` |
    | Alemanya | `de.api.knowbe4.com` |

    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.

    <Note>
      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ó.
    </Note>
  </Step>
</Steps>

***

## 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.*

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Camp | Valor |
    | - | - |
    | **API key** | El token de la Reporting API de la part A, pas 1 |
    | **Reporting API server region** | La regió de la part A, pas 3 (p. ex., United States) |
  </ConnectInPlatform>
</Steps>

Ara ja esteu connectat a KnowBe4.

***

## Resolució de problemes

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    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**.
  </Accordion>

  <Accordion title="403 Forbidden">
    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](/ca/integrations/managing/egress-ip-addresses) siguin a la llista d'adreces permeses.
  </Accordion>

  <Accordion title="Resultats buits (200 OK però sense dades)">
    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.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.