> ## 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 Google Workspace

> Collegare Google Workspace a Living Security per l'attività relativa al ciclo di vita degli utenti, agli accessi, all'MFA, all'amministrazione e alla protezione dei dati.

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="Google Workspace" recommendDelegated={true} />

## Cosa apporta questa integrazione

Google Workspace può fornire attività normalizzate relative al ciclo di vita degli utenti, agli accessi, all'MFA, all'amministrazione e alla protezione dei dati. Tra gli esempi esaminati figurano:

* `account.compromised` — account segnalato come compromesso
* `data.sensitive.downloaded` — scarica dati sensibili
* `auth.login.unusual` — accede da contesti insoliti

Consultare [come i dati di integrazione diventano Segnali](/it/signals/data-sources).

## Cosa richiede Living Security

| Credenziale | Descrizione |
| - | - |
| **Chiave dell'account di servizio** | Una chiave JSON per un account di servizio Google Cloud dedicato. |
| **Amministratore delegato** | L'indirizzo email di un amministratore di Google Workspace che l'account di servizio può impersonare. |

Abilitare le API Admin SDK e autorizzare solo gli ambiti (scope) che la connessione legge:

* `https://www.googleapis.com/auth/admin.reports.audit.readonly`
* `https://www.googleapis.com/auth/admin.directory.user.readonly`
* `https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly`

## Configurazione

<Steps>
  <Step title="Creare un account di servizio Google Cloud">
    Creare un account di servizio dedicato, abilitare la delega a livello di dominio e scaricare la relativa chiave JSON. Conservare la chiave in modo sicuro.
  </Step>

  <Step title="Autorizzare la delega a livello di dominio">
    Nella Google Admin Console, aprire **Security → Access and data control → API controls → Manage Domain Wide Delegation**. Aggiungere l'ID client numerico dell'account di servizio e i tre ambiti di sola lettura indicati sopra.
  </Step>

  <Step title="Scegliere l'amministratore delegato">
    Selezionare un amministratore di Workspace attivo in grado di leggere la directory, le assegnazioni di ruolo e i report di audit. Living Security utilizza questa identità esclusivamente per le letture API delegate.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    Caricare o incollare la credenziale dell'account di servizio come richiesto e inserire l'indirizzo email dell'amministratore delegato.
  </ConnectInPlatform>
</Steps>

## Verifica e risoluzione dei problemi

Verificare che la connessione sia in grado di leggere un utente della directory e l'attività di accesso recente. Google precisa che la propagazione delle nuove autorizzazioni di delega a livello di dominio può richiedere del tempo.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    Verificare che la delega a livello di dominio utilizzi l'ID client numerico dell'account di servizio, e non il relativo indirizzo email, e che tutti e tre gli ambiti corrispondano esattamente.
  </Accordion>

  <Accordion title="La directory funziona ma mancano le assegnazioni di ruolo">
    Aggiungere `admin.directory.rolemanagement.readonly` alla voce di delega e verificare che l'amministratore delegato possa visualizzare le assegnazioni di ruolo.
  </Accordion>

  <Accordion title="I report sono vuoti">
    Verificare che l'Admin Reports API sia abilitata e che l'amministratore delegato possa accedere ai report di audit per il tenant Workspace.
  </Accordion>
</AccordionGroup>

Per i dettagli lato fornitore, consultare la [guida di Google alla delega a livello di dominio](https://developers.google.com/identity/protocols/oauth2/service-account#delegatingauthority).

<PublicIntegrationNextSteps />


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