> ## 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 Adaptive Security

> Connecteu Adaptive Security a la Living Security Platform per importar els resultats de les simulacions de phishing, smishing i vishing, així com els resultats de la formació de sensibilització en seguretat del vostre personal.

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 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="Adaptive Security" />

## Què aporta aquesta integració

Adaptive Security pot aportar resultats de Workforce, de Training i de simulacions multicanal. Alguns dels exemples revisats són:

* `phishing.simulation.clicked` — ha fet clic en un correu electrònic simulat sense notificar-ho
* `phishing.simulation.credential.submitted` — ha introduït credencials en una pàgina d'inici de sessió simulada
* `phishing.simulation.attachment.opened` — ha obert un fitxer adjunt d'un correu electrònic simulat
* `phishing.simulation.reported` — ha notificat un correu electrònic simulat
* `smishing.simulation.replied` — ha respost a un missatge de text simulat
* `vishing.simulation.succeeded` — ha complert les instruccions d'una persona que trucava en una simulació de veu
* `training.assigned` — se li ha assignat una formació de seguretat
* `training.completed` — ha acabat una formació de seguretat
* `training.past.due` — no ha complert el termini d'una formació

Aquests exemples mostren els tipus d'activitat normalitzada que Living Security pot utilitzar. Consulteu [com les dades d'integració es converteixen en Signals](/ca/signals/data-sources).

<Note>
  **Adaptive fa simulacions per tres canals, i Living Security puntua cadascun per separat.**
  Els resultats de correu electrònic es puntuen com a phishing, els de missatges de text com a smishing i els de trucades de veu com a vishing. Una persona que fa clic en un correu electrònic simulat i una altra que respon a un missatge de text simulat no es mesuren com el mateix comportament, perquè el criteri que ha aplicat cadascuna és diferent.
</Note>

## Què necessita Living Security

| Credential | Description |
| - | - |
| **API token** | Un token d'API d'Adaptive Security. Living Security l'envia com a token de tipus bearer en cada sol·licitud. |

**Rol necessari:** Un administrador del vostre compte d'Adaptive Security amb accés a **Settings → API**. Adaptive governa l'accés a l'API mitjançant permisos basats en rols, de manera que el token ha de pertànyer a un rol que pugui llegir usuaris, phishing i formació.

**Accés:** Només lectura. Living Security només llegeix d'Adaptive Security i mai no crea, modifica ni elimina res del vostre compte.

### Què recupera Living Security

| Data | Detail |
| - | - |
| **People** | El directori d'usuaris d'Adaptive: nom, correu electrònic, departament, càrrec, nom i correu electrònic del responsable, ubicació, divisió, situació laboral i data d'incorporació. |
| **Email simulations** | Per persona i per simulació: quan es va lliurar el missatge, es va obrir, s'hi va fer clic, es va respondre, se'n va obrir el fitxer adjunt, se'n va escanejar el codi QR, s'hi van introduir credencials o es va notificar. |
| **Text simulations** | Per persona i per simulació: lliurat, obert, s'hi ha fet clic, respost, credencials introduïdes o notificat. |
| **Voice simulations** | Per persona i per simulació: l'esquer lliurat, el número al qual es va trucar, si la persona va complir les instruccions de qui trucava i si ho va notificar. |
| **Training** | Per persona i per campanya: quan es va inscriure, quan vencia, quan la va començar, quan la va completar i si va acceptar la política de la campanya. |

<Note>
  **Els números de telèfon no s'emmagatzemen.** Adaptive retorna els números de l'oficina i del mòbil en el registre d'usuari. Living Security descarta tots dos abans d'emmagatzemar res, perquè cap funcionalitat de Living Security no els utilitza.
</Note>

<Note>
  **La puntuació de risc d'Adaptive s'enregistra, però mai no es fa servir per puntuar.** Adaptive calcula un `current_risk_score` per persona. Living Security el conserva perquè pugueu comparar els dos sistemes, però el Human Risk Index sempre es calcula a partir del comportament observat amb el model publicat de Living Security, mai a partir de la puntuació composta d'un altre proveïdor.
</Note>

### Requisits previs

* Un compte d'Adaptive Security amb l'API activada.
* Accés d'administrador a [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com).
* Adreces de correu electrònic dels usuaris a Adaptive que coincideixin amb les que utilitzen els altres sistemes connectats. Living Security fa servir el correu electrònic per associar un usuari d'Adaptive amb una persona.

***

## Part A — A Adaptive Security

*L'administrador d'Adaptive Security completa aquests passos.*

<Steps>
  <Step title="Obriu la configuració de l'API">
    1. Inicieu sessió a [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) com a administrador.
    2. Aneu a **Settings → API**.
  </Step>

  <Step title="Genereu el token d'API">
    1. Genereu un token d'API nou.
    2. Poseu-li un nom que reconegueu més endavant, per exemple `Living Security`.
    3. Confirmeu que el rol del token pot llegir usuaris, campanyes de phishing i campanyes de formació.
    4. Copieu el token.

    <Warning>
      Copieu el token abans de sortir de la pàgina. Si el vostre compte d'Adaptive estableix una data de caducitat per al token, anoteu-la: Living Security no pot recuperar dades un cop ha caducat, i cal actualitzar la connexió amb un token nou.
    </Warning>
  </Step>
</Steps>

***

## Part B — A la Living Security Platform

*El responsable del programa completa aquest pas, o l'administrador del sistema si s'utilitza la configuració delegada.*

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | Field | Value |
    | - | - |
    | **API token** | El token que heu generat a la Part A |
  </ConnectInPlatform>
</Steps>

Ja esteu connectats a Adaptive Security.

***

## Freqüència de recuperació de les dades

| Data | Schedule |
| - | - |
| Persones | Cada 6 hores |
| Resultats de simulacions (correu electrònic, text, veu) | Cada 6 hores |
| Resultats de formació | Cada 6 hores |

L'API d'informes d'Adaptive no ofereix cap filtre de tipus «què ha canviat des de», de manera que Living Security llegeix cada simulació i cada campanya de formació mentre encara genera resultats, i deixa de llegir-les quan fa dues setmanes que s'han tancat. Així, encara es registren els clics i les notificacions tardans, i les campanyes finalitzades no es tornen a llegir indefinidament.

<Note>
  La primera connexió en un compte d'Adaptive gran pot necessitar diverses execucions programades per acabar de llegir-ho tot. Cada execució llegeix tant com pot i la següent continua des d'on s'havia aturat, de manera que els recomptes van augmentant durant el primer dia o els dos primers, en lloc d'aparèixer tots alhora.
</Note>

***

## Resolució de problemes

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    El token d'API és incorrecte, ha caducat o s'ha revocat. Adaptive retorna un cos de resposta buit en aquest error, de manera que no hi ha més detalls per consultar. Genereu un token nou a **Settings → API** i torneu a connectar amb aquest. Un token copiat parcialment produeix el mateix error i és la causa més habitual.
  </Accordion>

  <Accordion title="403 Forbidden">
    El token s'ha autenticat, però el seu rol no pot llegir les dades sol·licitades. Tornar a enganxar el mateix token no servirà de res. A Adaptive, confirmeu que el rol del token té accés de lectura a usuaris, phishing i formació, o bé emeteu un token des d'un rol que en tingui.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptive ha limitat la velocitat de la connexió. Living Security atura aquesta execució i continua des del mateix punt en la següent execució programada, de manera que no es perd cap dada; simplement els recomptes triguen més a augmentar. Si això persisteix durant dies, poseu-vos en contacte amb el servei d'assistència d'Adaptive Security per consultar el límit de velocitat que s'aplica al vostre compte.
  </Accordion>

  <Accordion title="Apareixen persones, però cap resultat de simulació">
    Comproveu que les campanyes que espereu s'hagin executat realment. Adaptive només informa de les inscripcions de les simulacions que s'han enviat, de manera que una campanya que encara tingui l'estat **Draft** o **Scheduled** no aporta res fins que no s'enviï. Living Security no les llegeix deliberadament, per dedicar el seu pressupost de sol·licituds a les campanyes que tenen resultats reals.
  </Accordion>

  <Accordion title="Falten simulacions de veu o de text">
    Living Security determina el canal de cada resultat a partir de l'escenari que té associat. Si s'ha eliminat un escenari a Adaptive després d'executar-se la simulació, els seus resultats es registren al canal de correu electrònic, perquè ja no es pot llegir el canal. Si conserveu els escenaris retirats a Adaptive en lloc d'eliminar-los, evitareu aquesta situació.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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