Configurare un'integrazione

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

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.

​

2. Connettere il provider

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

Quando contattate il Supporto di Living Security, 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