> ## 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. # Configurare un'integrazione > Preparare le credenziali del provider, connettere un sistema supportato, abilitare i relativi flussi di dati e verificare la prima sincronizzazione riuscita. Questa guida descrive la procedura di configurazione comune per le integrazioni elencate in **Impostazioni → Integrazioni → Catalogo**. I campi specifici del provider, le autorizzazioni e le procedure di autenticazione sono riportati nella guida di configurazione collegata alla scheda del provider nel Catalogo. ## Prerequisiti | Ruolo | Responsabilità | | - | - | | [**Program Owner**](/it/reference/glossary#responsabile-del-programma) | Seleziona l'origine, la connette in Living Security, abilita i flussi e verifica il risultato | | [**System Administrator**](/it/reference/glossary#amministratore-di-sistema) | Crea o approva le credenziali e gli ambiti (scope) nel sistema di origine | Questi ruoli possono essere ricoperti dalla stessa persona. La persona che inserisce le credenziali in Living Security deve disporre di un ruolo di amministratore che consenta la gestione delle integrazioni; non invitate in Living Security un amministratore del sistema di origine partendo dal presupposto che esista un ruolo di configurazione con autorizzazioni limitate. Prima di iniziare: * Scegliete l'organizzazione e l'ambiente di Living Security a cui appartiene la connessione. * Aprite la guida del provider nel Catalogo e raccogliete gli ambiti (scope) richiesti, gli URL di reindirizzamento e i requisiti relativi alle liste di autorizzazione (allowlist). * Se le credenziali vengono create e inserite da persone diverse, utilizzate il processo di condivisione dei segreti approvato dalla vostra organizzazione. * Non inviate mai password, client secret, chiavi private o valori delle chiavi di accesso tramite e-mail o ticket di supporto. ## 1. Preparare le credenziali del provider Aprite **Impostazioni → Integrazioni → Catalogo**, individuate il provider e leggete la relativa guida di configurazione prima di creare le credenziali. L'autenticazione del provider può utilizzare il consenso OAuth, un token API, un client ID e un secret, un account di servizio o un altro metodo supportato dal provider. Create solo le credenziali e gli ambiti (scope) indicati nella guida del provider. Non copiate le autorizzazioni da un altro provider e non concedete un ampio accesso in scrittura “per sicurezza”. Le autorizzazioni mancanti producono normalmente un errore 401 o 403 chiaro che può essere corretto; le autorizzazioni eccessive creano un rischio evitabile. ## 2. Connettere il provider Andate a **Impostazioni → Integrazioni → Catalogo** e selezionate il provider. Selezionate **Connetti**. Completate il flusso OAuth oppure inserite i campi richiesti nella finestra di dialogo di connessione. La guida del provider spiega da dove proviene ciascun valore. Se previsto, approvate la schermata di consenso del provider. Dopo il completamento dell'autenticazione, Living Security apre o elenca la nuova connessione in **Connesso**. Se il provider rifiuta l'autenticazione, interrompete la procedura e correggete la credenziale, il tenant, la regione, l'URL di reindirizzamento o le autorizzazioni nel sistema di origine prima di proseguire. ## 3. Abilitare i flussi di dati Aprite la connessione in **Impostazioni → Integrazioni → Connesso**. Living Security rileva i modelli di sincronizzazione disponibili per quel provider e li elenca come flussi. 1. Esaminate il nome e lo scopo di ciascun flusso. 2. Abilitate solo i flussi necessari al vostro programma. 3. Lasciate in pausa i flussi non pertinenti. 4. Utilizzate **Sincronizza ora**, se disponibile, per richiedere la prima esecuzione. Non tutti i provider offrono gli stessi flussi o gli stessi controlli di pianificazione. Seguite i controlli mostrati nella connessione, senza aspettarvi una frequenza, un ambito, una mappatura dei campi, una bozza o una procedura guidata di attivazione universali. ## 4. Verificare la prima esecuzione L'autenticazione della connessione da sola non dimostra che i dati stiano affluendo. Verificate che la connessione sia integra e che non richieda una nuova autorizzazione. Verificate che il flusso richiesto sia abilitato e non in pausa. Aprite il flusso, il collegamento di sincronizzazione della connessione oppure **Impostazioni** → **Integrazioni** → **sincronizza**. Attendete un risultato finale positivo ed esaminate gli errori del provider e il numero di record, se disponibili. Aprite l'area pertinente di Living Security. I dati di identità dovrebbero generare le persone e le identità attese in Forza lavoro; i dati provenienti da origini di sicurezza dovrebbero comparire nella funzionalità documentata da quel provider. Per l'onboarding, le attività **Verify Identity Data Flowing** e **Verify Integration Data Flowing** della Journey Map vengono completate in base ai dati acquisiti. Non sostituite i risultati di queste verifiche con una connessione semplicemente salvata. ## Pagina di dettaglio della sincronizzazione Da **Impostazioni** → **Integrazioni** → **sincronizza**, aprite una sincronizzazione qualsiasi per visualizzare in un unico posto la sua configurazione e la cronologia delle esecuzioni. La pagina di dettaglio mostra: | Sezione | Contenuto | | - | - | | **Intestazione** | Nome della sincronizzazione, badge di stato e provider di integrazione | | **Statistiche** | Modello, ultima sincronizzazione, esecuzioni completate e totale dei record | | **Cronologia esecuzioni** | Esecuzioni recenti con stato, tempistiche e numero di record | | **Azioni** | **Aggiorna**, **Pausa** / **Riprendi** e **Sincronizza ora** | Utilizzate **Sincronizza ora** per avviare un'esecuzione immediata quando la sincronizzazione è attiva. Le sincronizzazioni in pausa devono essere riprese prima che possano iniziare nuove esecuzioni pianificate o manuali. È inoltre possibile aprire una sincronizzazione dalla pagina di dettaglio della relativa connessione quando l'integrazione elenca flussi attivi. ## Operazioni sulla connessione La pagina di dettaglio della connessione espone le operazioni supportate da quell'integrazione: | Operazione | Effetto | | - | - | | **Sincronizza ora** | Richiede un'esecuzione immediata per il flusso selezionato | | **Pause stream** | Interrompe le nuove esecuzioni per quel flusso mantenendo la connessione | | **Sospende la connessione** | Interrompe l'attività supportata della connessione senza eliminare la configurazione | | **Riprendi** | Riavvia un flusso o una connessione in pausa | | **Reauthorize** | Ripete l'autenticazione dopo una modifica delle credenziali o del consenso | | **Rimuovi** | Elimina la configurazione della connessione dopo conferma | La rimozione di una connessione non equivale all'eliminazione dei dati già acquisiti tramite di essa. Consultate la guida del provider o contattate il Supporto se il comportamento di conservazione dei dati influisce sulla vostra decisione. ## Origini push personalizzate Utilizzate **Custom Push Source** quando un sistema invia i dati a Living Security anziché essere interrogato tramite un connettore del Catalogo. 1. Create l'origine dalla parte inferiore del **Catalogo**. 2. Aprite la relativa pagina di dettaglio nell'area push personalizzata. 3. Selezionate il flusso di destinazione. 4. Utilizzate **Upload CSV** per un batch manuale oppure **Push via API** per un mittente automatizzato. 5. Dopo l'invio, visualizzate l'anteprima del file o del payload ed esaminate la cronologia delle esecuzioni dell'origine. Per il contratto completo relativo a endpoint, autenticazione, payload, nuovi tentativi e verifica, consultate [Custom Push Source API](/it/integrations/custom-push-source). Non deducete tali dettagli da una precedente guida all'integrazione di Unify. Il caricamento dalla pagina di dettaglio dell'origine accetta un file CSV di origine fino a 100 MB. Prima del caricamento, la Dashboard lo suddivide lato client in richieste di non più di 10 MB e 10.000 righe ciascuna. Questo strumento di caricamento specifico per l'origine è distinto dalla pagina generale **Integrazioni → Caricamento** per i modelli di identità e di attività. ## Risoluzione dei problemi | Sintomo | Verifica | | - | - | | `401 Unauthorized` | Valore della credenziale, scadenza, revoca, tenant del provider e stato di riautorizzazione | | `403 Forbidden` | Ruolo del provider richiesto, ambiti (scope), consenso dell'amministratore e criteri di accesso del sistema di origine | | La connessione non riesce immediatamente | URL di reindirizzamento, regione, URL di origine, requisiti di rete o di allowlist IP | | La connessione è integra ma non avvengono esecuzioni | Il flusso richiesto è abilitato e il provider espone tale flusso | | Un'esecuzione riuscita non restituisce record | L'account di origine vede la popolazione attesa e gli eventuali filtri lato provider sono corretti | | I dati compaiono sotto la persona sbagliata | Gli attributi di identità e gli alias sono coerenti tra le origini connesse | | I dati non vengono più aggiornati | Il flusso o la connessione sono in pausa, le credenziali sono scadute o l'ultima esecuzione non è riuscita | Quando contattate il [Supporto di Living Security](mailto:support@livingsecurity.com), indicate l'organizzazione, il provider, il nome della connessione, il flusso, l'orario dell'ultima esecuzione e l'errore visualizzato. Non includete segreti. ## Argomenti correlati Riferimento per Connesso, Catalogo, sincronizza, Azioni e Caricamento. Comprendere gli attributi e le mappature supportati, dove disponibili. Gestire un'integrazione esistente, fino alla riautorizzazione o alla rimozione. Completare le attività di verifica dei dati di identità e di sicurezza. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.