Proteggere il tuo assistente
La sicurezza si basa su tre livelli che lavorano insieme: la modalità di autenticazione, l’elenco delle origini consentite e, per la modalità API, la chiave API. Come combinarli dipende da chi deve poter usare l’assistente.
Capire cosa è pubblico
Quando un assistente è integrato in un sito web, lo snippet di integrazione (compresi assistantId, accessToken (chiave API) e serviceURL) si trova nel codice HTML della pagina. Chiunque possa vedere il codice sorgente della pagina può leggere questi valori. Non è un difetto: è così che funzionano le integrazioni lato client. La sicurezza non deriva dal nascondere questi valori, ma da ciò che fa il server quando li riceve.
Scenari di sicurezza
Sito web pubblico: accesso libero
Modalità: None. Origini: i tuoi domini.
L’assistente si carica su qualsiasi origine consentita senza chiave. È la configurazione più semplice e quella giusta per centri di assistenza pubblici, pagine prodotto e siti di marketing in cui i contenuti sono già pubblici. Limita le origini ai tuoi domini per impedire a qualcuno di integrare il tuo assistente in un sito estraneo.
Intranet o sito privato: accesso con protezione leggera
Modalità: API. Origini: i tuoi domini interni. Chiave: generata.
La chiave API funge da identificatore pubblico: indica al server quale assistente caricare, ma non è un segreto. In combinazione con origini consentite limitate, impedisce il riutilizzo occasionale: l’assistente si carica solo sui tuoi domini e solo con la chiave giusta. Chi copia la chiave non può comunque usare l’assistente da un’origine non autorizzata.
Questo basta per strumenti interni, ambienti di staging e siti in cui il pubblico è controllato ma un’autenticazione formale sarebbe eccessiva.
Applicazione con autenticazione: accesso legato all’identità
Modalità: OIDC. Origini: i tuoi domini. Issuer + audience: il tuo provider.
L’integrazione passa come accessToken un JWT del tuo provider di identità (Firebase, Auth0, Azure AD, Okta, ecc.). Seekdown convalida il token rispetto all’issuer e all’audience configurati prima di consentire all’assistente di rispondere. Solo gli utenti che hanno effettuato l’accesso tramite il tuo stack di autenticazione possono usarlo.
È la protezione più forte e la scelta giusta per dashboard con accesso utente, portali clienti e qualsiasi scenario in cui l’utilizzo debba essere legato all’identità di un utente.
Come si sovrappongono i livelli
| Livello | Cosa controlla | Visibile nel codice sorgente della pagina? |
|---|---|---|
| Modalità di autenticazione | Se è richiesto un token e come viene convalidato. | La modalità è un’impostazione lato server: non è esposta. |
| Origini consentite | Quali domini possono integrare l’assistente. | No: è applicata lato server. |
| Chiave API | Identifica l’assistente in modalità API. | Sì: si trova nello snippet di integrazione. |
| Token OIDC | Dimostra l’identità del visitatore in modalità OIDC. | Il token è per sessione, di breve durata e convalidato lato server. |
La chiave API identifica quale assistente caricare. Le origini consentite controllano dove può essere caricato. La modalità di autenticazione controlla chi può usarlo. Insieme formano un modello di sicurezza pratico per qualsiasi scenario, da completamente aperto a completamente autenticato.