L’isolamento dei tenant in Cloudflare AI Search diventa importante non appena la stessa applicazione serve organizzazioni con documenti privati. Un risultato può divulgare informazioni prima della generazione della risposta e una citazione può esporre un documento anche quando il testo sembra innocuo. Il confine dei permessi deve coprire tutto il percorso.
Ricava l’ambito del tenant dall’identità applicativa autenticata, poi seleziona l’istanza consentita o applica filtri obbligatori controllati dal server. Mantieni acquisizione, recupero, citazioni e cache nello stesso progetto di accesso. Dimostra l’isolamento con test negativi, includendo cambio di tenant, sessioni obsolete e tentativi diretti di aprire fonti altrui.
Immagina un SaaS che permette ai distributori di caricare accordi con i fornitori. Ciascuno vuole un assistente che spieghi le proprie condizioni di consegna e sconto. Il prodotto può includere un manuale pubblico condiviso. Combinare le fonti è utile solo se il materiale privato non attraversa mai il confine previsto.
Questo è un progetto applicativo e un approccio di accettazione proposto. Non afferma che un namespace o un filtro soddisfino da soli ogni requisito di sicurezza.
L’isolamento dei tenant in Cloudflare AI Search inizia prima del recupero
La guida multitenant documenta approcci con istanze separate o condivise. La scelta architetturale richiede prima un modello di identità. Decidi che cosa rappresenti un tenant e quali utenti possano operarvi.
Ottieni il tenant da una sessione verificata o contesto equivalente attendibile. Un parametro può indicare la selezione desiderata, ma il server deve accertarne l’autorizzazione. Non lasciare al modello l’ambito autorevole del tenant.
Per un collega appartenente a più distributori, rendi esplicita l’organizzazione attiva. Cambiarla deve modificare fonti consentite e contesto conversazionale associato. Un passaggio privato recuperato prima del cambio non deve restare silenziosamente nella risposta successiva.
| Confine | Input attendibile | Sostituto non attendibile da rifiutare |
|---|---|---|
| Selezione del tenant | Appartenenza autenticata e ambito attivo | Identificatore arbitrario dal browser |
| Instradamento dell’istanza | Associazione controllata dal server | Nome inventato dal modello |
| Ambito documentale | Titolarità e permessi verificati | File che dichiara da sé il proprio tenant |
| Accesso alle citazioni | Autorizzazione corrente all’apertura | Solo possesso dell’URL risultante |
Confrontare istanze e filtri obbligatori
Istanze separate possono rendere più ispezionabile il confine dei dati, aggiungendo gestione del ciclo di vita e provisioning. Un’istanza condivisa riduce tale onere, ma ogni percorso deve applicare l’ambito corretto senza aggiramenti opzionali.
La documentazione dei namespace spiega raggruppamento e accesso tramite binding. Esamina attentamente l’ambito del binding. Un raggruppamento logico non prova che ogni chiamante sia instradato correttamente.
| Scelta | Beneficio operativo da valutare | Responsabilità residua |
|---|---|---|
| Istanze separate per tenant | Separazione più chiara di fonti e ciclo di vita | Instradamento e verifica delle appartenenze |
| Istanza condivisa con filtri | Gestione comune di acquisizione e indice | Ambito obbligatorio su tutti i percorsi |
| Raccolta pubblica separata | Materiale condiviso esplicito | Impedire l’acquisizione di materiale privato |
| Sottoinsiemi documentali riservati | Accesso più fine nel tenant | Permessi documentali attuali |
Scegli in base a permessi e requisiti operativi, non solo al numero di tenant. Un’organizzazione con gruppi interni riservati può richiedere più del confine aziendale qualunque sia la disposizione delle istanze.
Applicare l’ambito anche all’acquisizione
Stabilisci la titolarità quando il contenuto entra. Associa ogni fonte al tenant e alla visibilità prevista mediante metadati applicativi attendibili. Non accettare la proprietà dichiarata da un caricamento senza verificare l’autorità del chiamante.
Mantieni stabili gli identificatori durante gli aggiornamenti. Un accordo sostitutivo deve aggiornare il materiale del tenant previsto e l’eliminazione deve riguardare la fonte corretta e i contenuti derivati corrispondenti. Una collisione di identificatori può compromettere l’isolamento prima della ricerca.
Separa decisioni di acquisizione pubbliche e private. Un manuale condiviso può essere deliberatamente pubblico; un accordo non deve entrarvi perché estensione o cartella assomigliano a quelle di un manuale.
Registra quale identità di acquisizione possa leggere ogni posizione. L’applicazione può filtrare correttamente mentre un connettore troppo ampio importa materiale che non dovrebbe elaborare. La revisione deve includere entrambi i lati della pipeline.
Rendere i filtri una politica applicativa non opzionale
Cloudflare documenta il filtraggio del recupero . Traduci i permessi attuali nel contratto scelto e verifica la richiesta effettivamente generata dal server.
Non esporre un oggetto filtro generico sostituibile da un client ordinario. Non aggiungere nemmeno un ripiego che riprovi senza filtri quando non ci sono corrispondenze. Nessun risultato è un esito valido e necessario per informazioni assenti o non autorizzate.
Separa ambito applicativo e preferenze come tipo o lingua del documento. L’utente può restringere la ricerca, ma non rimuovere la condizione obbligatoria cambiando un’opzione.
Verifica ogni percorso: risultati, risposte generate, esportazioni, strumenti degli agenti e anteprime amministrative. Una pagina sicura non compensa un endpoint senza filtri sulla stessa raccolta.
Proteggere citazioni, cache e cronologia
Una risposta può omettere un passaggio privato restituendo comunque titolo o URL che espongono informazioni altrui. Verifica tutti i campi restituiti, non solo il testo.
Apri citazioni secondo l’autorizzazione documentale corrente. Se l’applicazione serve la fonte, controlla prima il chiamante. Se usa un sistema esterno, accerta che il collegamento ne preservi le regole di accesso.
Includi tenant e contesto pertinente dei permessi nella cache applicativa. Una risposta adatta a un’organizzazione non deve diventare condivisa soltanto perché coincide il testo della domanda.
La cronologia può conservare passaggi dopo un cambio di organizzazione o una revoca. Decidi quale possa essere riaperta e quale contesto fornire al modello. La revoca deve avere un effetto definito anche sulle copie derivate, non solo sulla ricerca attiva.
Costruire test negativi che rivelino divulgazioni reali
Usa documenti sintetici con marcatori distinti e inequivocabili. Poni la stessa domanda come utenti di organizzazioni diverse e verifica che il marcatore altrui non appaia in passaggi, risposte, metadati o citazioni.
| Prova | Risultato atteso |
|---|---|
| Alterare l’identificatore richiesto | Il server rifiuta o mantiene l’ambito consentito |
| Cercare una frase nota di un altro tenant | Nessun passaggio, risposta o citazione privata |
| Aprire l’URL di un documento altrui | Accesso rifiutato |
| Cambiare organizzazione attiva | Recupero e contesto seguono il nuovo ambito |
| Rimuovere l’appartenenza durante una sessione | Ulteriori accessi seguono l’autorizzazione attuale |
| Ripetere una domanda in cache tra tenant | Nessun riuso della risposta tra tenant |
Includi separatamente un amministratore multitenant autorizzato. La diagnostica amministrativa richiede autorità e prove proprie. Non normalizzare i risultati ampi dell’amministratore nel test per utenti ordinari.
Ripeti l’isolamento dopo modifiche a instradamento, acquisizione, filtri e cache. La sola rilevanza non rileva regressioni di permessi: un risultato molto pertinente può essere proprio il documento vietato all’utente.
Prevedere il ciclo di vita dei permessi
L’impegno dipende da appartenenze, permessi documentali, integrazione delle fonti e percorsi di recupero. Una dimostrazione semplice di un filtro esclude gran parte del lavoro di un SaaS reale.
Chiedi una proposta in GBP comprensiva di provisioning, cambi di tenant, eliminazione, revoca e accettazione. Specifica se l’isolamento termini al confine organizzativo o includa gruppi e singoli documenti.
| Area di lavoro | Prove richieste |
|---|---|
| Identità | Regole di appartenenza e cambio tenant |
| Acquisizione | Titolarità verificata e accesso alle fonti |
| Recupero | Ambito controllato dal server su ogni percorso |
| Contenuto derivato | Politiche di cache, citazioni e cronologia |
| Operazioni | Manuali di provisioning, eliminazione e incidenti |
Un progetto pilota di integrazione IA delimitato può verificare organizzazioni sintetiche e documenti rappresentativi prima dei dati privati. Richiedi una proposta di ricerca multitenant con modello di appartenenza e permessi delle fonti. L’isolamento diventa così un contratto verificabile, anziché un’etichetta rassicurante sul diagramma architetturale.
Domande frequenti
Ogni tenant richiede un’istanza AI Search separata? Non necessariamente. Cloudflare documenta istanze separate e condivise. Confronta permessi, provisioning e affidabilità dei filtri obbligatori prima di scegliere. Nessun approccio elimina l’autorizzazione applicativa.
Il browser può inviare l’identificatore del tenant? Può richiedere una selezione, ma il server deve verificarla rispetto all’appartenenza autenticata. Parametri arbitrari o valori generati non sono la fonte dell’autorità di accesso.
I namespace sono un sistema di autorizzazione? Organizzano l’accesso alle istanze tramite il modello documentato di binding. L’applicazione deve ancora autenticare e instradare correttamente. Esamina l’ambito e dimostra il confine con test negativi per utenti ordinari.
Una ricerca filtrata vuota deve riprovare senza filtro? No. Rimuovere l’ambito obbligatorio per ottenere una risposta può esporre materiale altrui. Restituisci un esito utile senza risultati o indaga indice e permessi senza ampliare gli accessi.
Le citazioni possono divulgare informazioni? Sì. Titoli, URL, estratti e download possono rivelare informazioni private anche se la risposta generata le omette. Verifica la risposta completa e richiedi autorizzazione corrente all’apertura.
Che cosa accade quando si perde l’appartenenza al tenant? Ulteriori accessi devono seguire i permessi attuali. Definisci l’effetto su sessioni aperte, cache, cronologia e copie derivate oltre al recupero attivo. Verifica la revoca durante una sessione.
Che cosa deve provare un pilota di isolamento? Il pilota deve dimostrare che gli utenti ordinari non possano recuperare fonti private di un altro tenant, dedurne il contenuto attraverso i metadati restituiti o aprirle. Includi manomissione dell’ambito, cambio tenant, riuso della cache, aggiornamenti e revoca.