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

# Configurazione dell'integrazione con CultureAI

> Collegare CultureAI a Living Security Platform per importare i dati sul comportamento in materia di sicurezza e sulle segnalazioni.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Risorse correlate</h2>
    <ul>
      <li>
        <a href="/it/signals/data-sources">Scopra come i dati delle integrazioni diventano segnali di Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Scopra le integrazioni di Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Apra la Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Richieda una demo di Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Inserire le credenziali in Living Security Platform">
    <p>
      Operazione da eseguire a cura di chi dispone dell'accesso a Living Security: il responsabile del programma oppure, se è stato invitato (configurazione delegata), l'amministratore di sistema.
    </p>
    <ol>
      <li>
        Andare in <strong>Impostazioni → Integrazioni → Catalogo</strong>, individuare il riquadro{' '}
        <strong>{tile}</strong> e fare clic su <strong>Connetti</strong>.
      </li>
      <li>
        Compilare i campi riportati di seguito, quindi fare clic su <strong>Connetti</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Questa guida è destinata all'amministratore di {system}.</strong> Descrive la creazione delle credenziali API all'interno di {system}, operazione che richiede l'accesso come amministratore a {system} e non alla
      Living Security Platform.
    </p>
    <p>
      Se Lei è il <strong>responsabile del programma</strong> Living Security e non amministra {system},
      inoltri questa pagina al responsabile dell'amministrazione di {system}. L'amministratore completerà la Parte A e Le restituirà le credenziali
      (oppure le inserirà direttamente, se è stato invitato nella piattaforma).
      {recommendDelegated && <>
          {' '}Poiché la configurazione genera materiale crittografico sensibile, si consiglia di seguire la procedura di{' '}
          <strong>configurazione delegata</strong>, in modo che il segreto non Le venga mai inviato.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="CultureAI" />

## Contributo di questa integrazione

CultureAI può fornire dati relativi ad attività di phishing, formazione, segnalazioni dei dipendenti e protezione dei dati. Tra gli esempi esaminati figurano:

* `phishing.real.clicked` — clic su link presenti in email di phishing reali
* `data.transfer.blocked` — trasferimento di dati bloccato
* `phishing.safe.reported` — segnalazione di email successivamente giudicate sicure

Questi esempi mostrano i tipi di attività normalizzate che Living Security può utilizzare. Consultare [come i dati dell'integrazione diventano Segnali](/it/signals/data-sources).

## Cosa serve a Living Security

| Credenziale | Descrizione |
| - | - |
| **Chiave API** | Una chiave generata dalla console di amministrazione di CultureAI. Living Security invia questa chiave a ogni richiesta per autenticarsi all'API di CultureAI. È l'unica credenziale richiesta. |

**Ambiti (scope):** le chiavi API di CultureAI non hanno un ambito specifico: una chiave valida consente l'accesso all'API. Living Security legge esclusivamente i dati di reportistica; se la console di CultureAI consente di selezionare ambiti o autorizzazioni durante la creazione di una chiave, concedere l'accesso in sola lettura alla reportistica.

**Ruolo richiesto:** **Ammin** o **Proprietario** in CultureAI (per gestire l'accesso all'API)

### Prerequisiti

* È necessario aver effettuato l'accesso alla console di amministrazione di CultureAI con un ruolo che consenta di gestire l'accesso all'API, in genere il ruolo **Ammin** o **Proprietario**. Se non è visibile un'area dedicata alle API o alle impostazioni per sviluppatori, contattare il proprio referente dell'account CultureAI per far abilitare l'accesso all'API per la propria organizzazione.

***

## Parte A — In CultureAI

*Questi passaggi vengono eseguiti dall'amministratore di CultureAI.*

<Steps>
  <Step title="Generare una chiave API">
    1. Accedere alla console di amministrazione di CultureAI.
    2. Aprire le impostazioni dell'organizzazione o dell'account e individuare l'area **API** (oppure **API keys** / **Developer**).
    3. Creare una nuova chiave API e assegnarle un nome descrittivo (ad es. `Living Security Platform`).

    <Note>
      Living Security utilizza questa chiave per l'accesso in sola lettura ai dati di reportistica che acquisisce da CultureAI. Non è richiesto alcun accesso in scrittura. Se CultureAI richiede di scegliere ambiti o autorizzazioni, concedere esclusivamente l'accesso in lettura ai dati di reportistica.
    </Note>

    <Warning>
      CultureAI potrebbe mostrare il valore della chiave API **una sola volta**, al momento della creazione. Copiarlo immediatamente e conservarlo in un luogo sicuro (ad es. un password vault o un gestore di segreti). Se si lascia la pagina senza averlo copiato, sarà necessario generare una nuova chiave.
    </Warning>

    <Note>
      Se non si riesce a trovare dove creare una chiave API oppure non si è certi di quali autorizzazioni concedere, contattare il proprio referente dell'account CultureAI. Living Security non può generare credenziali CultureAI per conto dell'utente.
    </Note>
  </Step>
</Steps>

***

## Parte B — In Living Security Platform

*Questo passaggio viene eseguito dal responsabile del programma oppure, se si utilizza la configurazione delegata, dall'amministratore di sistema.*

<Steps>
  <ConnectInPlatform tile="CultureAI">
    | Campo | Valore |
    | - | - |
    | **Chiave API** | La chiave API ottenuta nella Parte A |
  </ConnectInPlatform>
</Steps>

La connessione a CultureAI è ora attiva.

***

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    La chiave API non è valida oppure è stata revocata. Verificare che la chiave sia corretta e che non sia stata rigenerata in CultureAI.
  </Accordion>

  <Accordion title="403 Forbidden">
    La chiave API non dispone dell'accesso in lettura ai dati di reportistica. In CultureAI, verificare che alla chiave sia stato concesso l'accesso in lettura, oppure generare una nuova chiave con le autorizzazioni corrette.
  </Accordion>

  <Accordion title="Risultati vuoti (200 OK ma nessun dato)">
    La chiave API potrebbe non avere accesso ai dati di reportistica acquisiti da Living Security. Verificare con il proprio referente dell'account CultureAI che la chiave disponga dell'accesso in lettura ai dati di reportistica.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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