> ## 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 CultureAI

> Connecteu CultureAI a la Living Security Platform per importar dades de comportament de seguretat i de notificació.

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="CultureAI" />

## Què aporta aquesta integració

CultureAI pot aportar activitat de phishing, de formació, de notificació per part dels empleats i de protecció de dades. Alguns exemples revisats són:

* `phishing.real.clicked` — fa clic en enllaços de correus electrònics de phishing reals
* `data.transfer.blocked` — transferència de dades bloquejada
* `phishing.safe.reported` — notifica correus electrònics que posteriorment es consideren segurs

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

## Què necessita Living Security

| Credencial | Descripció |
| - | - |
| **API key** | Una clau generada des de la consola d'administració de CultureAI. Living Security envia aquesta clau en cada sol·licitud per autenticar-se a l'API de CultureAI. És l'única credencial necessària. |

**Abast (scopes):** les claus d'API de CultureAI no tenen abast definit: una clau vàlida atorga accés a l'API. Living Security només llegeix dades de notificació; si la consola de CultureAI ofereix la selecció d'abast o de permisos en crear una clau, atorgueu-hi accés de només lectura a les dades de notificació.

**Rol necessari:** **Admin** o **Owner** a CultureAI (per gestionar l'accés a l'API)

### Requisits previs

* Heu d'haver iniciat la sessió a la consola d'administració de CultureAI amb un rol que pugui gestionar l'accés a l'API, normalment el rol **Admin** o **Owner**. Si no veieu cap àrea de configuració d'API o de desenvolupador, poseu-vos en contacte amb el vostre representant del compte de CultureAI perquè activi l'accés a l'API per a la vostra organització.

***

## Part A — A CultureAI

*L'administrador de CultureAI completa aquests passos.*

<Steps>
  <Step title="Genereu una API key">
    1. Inicieu la sessió a la consola d'administració de CultureAI.
    2. Obriu la configuració de la vostra organització o del vostre compte i localitzeu l'àrea **API** (o **API keys** / **Developer**).
    3. Creeu una nova clau d'API i assigneu-li un nom descriptiu (p. ex., `Living Security Platform`).

    <Note>
      Living Security utilitza aquesta clau per accedir en mode de només lectura a les dades de notificació que importa de CultureAI. No cal cap accés d'escriptura. Si CultureAI us demana que trieu abastos o permisos, atorgueu només accés de lectura a les dades de notificació.
    </Note>

    <Warning>
      És possible que CultureAI mostri el valor de la clau d'API **només una vegada**, en el moment de crear-la. Copieu-la immediatament i deseu-la en un lloc segur (p. ex., una caixa forta de contrasenyes o un gestor de secrets). Si abandoneu la pàgina sense copiar-la, haureu de generar una clau nova.
    </Warning>

    <Note>
      Si no trobeu on crear una clau d'API, o no esteu segur de quins permisos heu d'atorgar, poseu-vos en contacte amb el vostre representant del compte de CultureAI. Living Security no pot generar credencials de CultureAI en nom vostre.
    </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="CultureAI">
    | Camp | Valor |
    | - | - |
    | **API key** | La clau d'API de la Part A |
  </ConnectInPlatform>
</Steps>

Ja esteu connectat a CultureAI.

***

## Resolució de problemes

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    La clau d'API no és vàlida o s'ha revocat. Verifiqueu que la clau sigui correcta i que no s'hagi regenerat a CultureAI.
  </Accordion>

  <Accordion title="403 Forbidden">
    La clau d'API no té accés de lectura a les dades de notificació. A CultureAI, verifiqueu que la clau tingui accés de lectura o genereu una clau nova amb els permisos correctes.
  </Accordion>

  <Accordion title="Resultats buits (200 OK però sense dades)">
    És possible que la clau d'API no tingui accés a les dades de notificació que importa Living Security. Confirmeu amb el vostre representant del compte de CultureAI que la clau té accés de lectura a les dades de notificació.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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