Salta ai contenuti
Service status

Digita per cercare

Flussi di dati · 10 min di lettura

OAuth Tools

Descrizione tecnica di come vengono gestiti i tuoi dati quando un assistente usa un tool di integrazione OAuth.

La trasparenza è centrale per noi di Intric. Perché alcuni tool funzionino (ad esempio recuperare documenti da SharePoint), l’utente deve collegare un’integrazione personale. Qui descriviamo passo dopo passo come funziona il flusso di dati quando un assistente usa un tool di integrazione.

Il processo dal tuo messaggio a una risposta completa avviene in un’interazione tra la piattaforma di Intric, il modello linguistico selezionato per l’assistente e l’API del provider (ad esempio Microsoft Graph). Intric agisce sempre da intermediario — il modello linguistico non contatta mai direttamente il provider.

Passo dopo passo: come vengono gestiti i tuoi dati

Sezione intitolata “Passo dopo passo: come vengono gestiti i tuoi dati”

Tutti i trasferimenti tra Intric e i provider esterni avvengono tramite connessioni sicure e crittografate.

1 / 7L’utente interagisce con Intric nel browser

1 / 7

Passaggio 1 — L’utente interagisce con Intric nel browser

L’utente scrive un messaggio a un assistente che ha uno o più tool di integrazione OAuth configurati (ad esempio SharePoint).

Dati inviati al server di Intric:

  • Il messaggio dell’utente
  • La cronologia della chat
  • Eventuali file allegati

Esempio: “Riassumi il documento ‘Report Q1’ dal nostro SharePoint.”

Intric applica il principio della minimizzazione dei dati. Con le integrazioni OAuth ci sono due considerazioni distinte sulla privacy — i dati vengono inviati sia al modello linguistico sia all’API del provider. Di seguito vedi esattamente cosa viene condiviso a ogni passaggio.

Inviato all’LLMNon inviato all’LLM
  • Il messaggio dell’utente e la cronologia della conversazione
  • Definizioni dei tool — nome, descrizione, parametri
  • Risultati dell’API del provider (ad esempio contenuto del documento)
  • Token di accesso e refresh token
  • Dati personali dell’utente in Intric che interagisce con l’assistente, a condizione che non compaiano nel messaggio all’assistente:

    • Nome
    • Email
    • Indirizzo IP
    • Appartenenza all’organizzazione
Inviato al providerNon inviato al provider
  • Token di accesso (nell’header della chiamata)
  • L’azione e i parametri specificati dal modello linguistico (ad esempio nome del file o query di ricerca)
  • Il prompt originale completo dell’utente
  • La cronologia della chat
  • I file allegati (a meno che non facciano parte della chiamata al tool)
  • Appartenenza all’organizzazione
  • Token per altre integrazioni

Autenticazione e controllo degli accessi tramite OAuth

Sezione intitolata “Autenticazione e controllo degli accessi tramite OAuth”

Intric usa OAuth 2.0 per collegare gli utenti a servizi di terze parti. Ogni utente si autentica direttamente presso il provider e approva i permessi richiesti — Intric non vede né gestisce mai la password dell’utente.

Quando un utente ha approvato la connessione, Intric archivia un token di accesso e un refresh token per utente e integrazione. I token sono cifrati con crittografia Fernet (AES-128-CBC) prima di essere scritti nel database e vengono decifrati solo in memoria nel momento in cui servono per una chiamata API. Nessun token viene archiviato in chiaro e ogni token è legato a un singolo utente — non esistono token condivisi o validi per l’intera organizzazione.

Se un token di accesso scade, Intric usa automaticamente il refresh token archiviato per richiedere un nuovo token di accesso al provider. Il nuovo token viene cifrato e sostituisce quello precedente. L’intero processo avviene senza che l’utente debba effettuare nuovamente il login.

Ogni token di accesso è collegato all’account individuale dell’utente presso il provider e porta esattamente i permessi che l’utente ha nel servizio esterno. Questo significa che quando Intric chiama l’API del provider con questo token, il provider restituisce solo il contenuto a cui quello specifico utente è autorizzato ad accedere. Se un utente ha, ad esempio, solo accesso in lettura a determinate pagine SharePoint, Intric non può recuperare contenuto da pagine a cui l’utente non ha permesso di accedere. Il controllo dei permessi è gestito interamente lato provider — l’integrazione di Intric non ha alcuna capacità tecnica di modificare, estendere o influenzare in altro modo i permessi o l’accesso dell’utente.

I token vengono archiviati cifrati sui server di Intric in Svezia per tutta la durata in cui l’integrazione è attiva. Quando un utente disconnette un’integrazione, tutti i token vengono eliminati immediatamente.

La cronologia delle conversazioni in cui sono stati usati tool di integrazione segue le stesse regole di eliminazione degli altri assistenti.

Gli amministratori possono monitorare come viene usato il servizio tramite il log di audit dove abilitato.