A tenantazonosító a hiteles munkamenetből származzon
A tenant itt a rendszerben elkülönített ügyfélszervezetet jelenti. Egy felhasználó akár több szervezethez is tartozhat, ezért a bejelentkezés és az aktuális ügyfélkörnyezet kiválasztása külön lépés lehet. A háttérrendszernek ellenőriznie kell ezt a kapcsolatot, és a feldolgozási kontextust ebből kell előállítania. A böngészőben beküldött ügyfélazonosító nem tekinthető önmagában jogosultsági bizonyítéknak.
A tenantazonosító ne a kérdés szövegéből vagy a modell döntéséből szülessen. Ha a felhasználó azt írja, hogy „most a másik cég szerződéseit keresd”, az legfeljebb egy kérés, amelyet az alkalmazás a tényleges tagság alapján engedélyezhet vagy elutasíthat. A kereső meghívásakor a háttér szolgáltatás már egy ellenőrzött kontextust kapjon. Hiányzó vagy érvénytelen tenant esetén ne induljon korlátozás nélküli keresés.
A háttérfeladat is vigye magával ezt a kontextust. Egy később feldolgozott dokumentum, egy indexelési sor vagy egy export nem támaszkodhat arra, hogy a felhasználó éppen melyik ügyfélablakot nézi. A feladatban rögzített ügyfélkapcsolatot a végrehajtás előtt is ellenőrizni kell. Különösen fontos ez felfüggesztett előfizetésnél, megszűnt tagságnál vagy egy ügyfél másik környezetbe költöztetésénél.
Közös index, külön index vagy külön szolgáltatás?
A Microsoft többtenantos keresőrendszerekről szóló dokumentációja több elhelyezési mintát tárgyal: ügyfelenként külön indexet, külön szolgáltatást és megosztott indexet ügyfélazonosító szerinti szűréssel. Ezek nem egyenértékű üzemeltetési határok. A döntést a kívánt elkülönítés, a terhelés, a regionális elhelyezés és a fenntartható költség együtt befolyásolja. Az index neve önmagában nem helyettesíti a hozzáférés ellenőrzését.
Megosztott indexnél minden dokumentumnak és származtatott szövegrészletnek hordoznia kell az ellenőrzött tenantazonosítót. A dokumentumkulcs ne ütközhessen két ügyfél azonos nevű fájlja között. A tenantazonosító ne egy feltöltött PDF tetszőleges mezőjéből származzon, hanem a megbízható betöltési folyamat rendelje hozzá. Ha ez az adat hiányzik vagy nem egyezik a feladat kontextusával, az elem kerüljön hibasorba, ne közös alapértelmezett térbe.
Külön indexnél egyszerűbb lehet bizonyos életciklus-műveletek kezelése, de a kiszolgáló továbbra sem fogadhat el tetszőleges indexnevet a kliensből. A hiteles tenantkontextushoz engedélyezett cél tartozzon. Külön szolgáltatásnál is maradhat közös alkalmazás, napló vagy mentés. A fizikai elkülönítés hasznos eszköz lehet, de az adatút összes közös pontját ettől még meg kell vizsgálni.
| Réteg | Ügyfélhatárt hordozó adat | Tipikus keresztügyfél-hiba |
|---|---|---|
| Feltöltés és feladatsor | Ellenőrzött tenant és forráskapcsolat | A fájl rossz ügyfél indexébe kerül |
| Dokumentum és szövegrészlet | Tenant, dokumentumkulcs, verzió | Azonos fájlnév felülír másik ügyfelet |
| Retrieval és keresési kérés | Kötelező tenantkontextus | Egy keresési ág szűrés nélkül fut |
| Válaszgyorsítótár | Tenant és jogosultsági környezet | Másik ügyfél azonos kérdése kész választ kap |
| Hivatkozás és export | Tenantellenőrzött letöltési jog | Egy kitalálható azonosító idegen fájlt nyit |
| Migráció és lekapcsolás | Teljes ügyféladat-leltár | Régi index vagy cache tovább él |
A tenantkorlát a visszakeresés minden ágára érvényes
A RAG-rendszer nem mindig egyetlen keresést végez. Lehet kulcsszavas és vektoros ág, újrafogalmazott kérdés, kapcsolódó dokumentumlekérés és újrapontozás. A tenantkorlátot ezek mindegyikénél érvényesíteni kell, még mielőtt a tartalom a modellhez vagy külső pontozóhoz kerül. Az utólagos válaszszűrés már nem akadályozza meg, hogy idegen ügyfél adata bekerüljön a feldolgozásba.
A Microsoft biztonsági szűrési mintája is különbséget tesz az azonosítót tartalmazó szűrő és a tényleges hitelesítés között. A megfelelő szöveges mező megléte nem igazolja a hívó jogát. A rendszernek biztosítania kell, hogy minden megengedett lekérdezés a hiteles kontextushoz kötött korlátozást kapja. Ez alkalmazáslogikai és tesztelési feladat, nem a nyelvi modell jóindulatára bízott kérés.
A közös nyilvános tudást külön térként lehet kezelni. Például egy termék nyilvános kézikönyve minden ügyfél számára hozzáférhető, míg a saját szerződés és egyedi árlista csak az adott szervezeté. E megosztási szabály legyen kifejezett és ellenőrizhető. Az ismeretlen tenantjelölésű fájl nem válhat automatikusan nyilvánossá, és a keresés „nincs találat” eredménye sem indokolhat idegen ügyfélterületre kiterjesztést.
Szemléltető példa: azonos kérdés két külön ügyfélnél
Egy elképzelt szolgáltató két ügyfélnek, A és B vállalatnak készít belső dokumentumasszisztenst. Mindkettő felteszi ugyanazt a kérdést: „Mennyi a szerződés szerinti reakcióidő?” A kérdés szövege azonos, az érvényes válasz és a bizonyíték viszont eltérő lehet. Ha a gyorsítótár kulcsa csak a kérdés, B az A számára korábban előállított választ kaphatja meg anélkül, hogy egyetlen új keresés történne.
A cache ezért legalább az ellenőrzött ügyfélkörnyezetet és a releváns hozzáférési, forrásverziós feltételeket is vegye figyelembe. A pontos kulcsképzés a rendszer kialakításától függ, de a tenant kihagyása itt alapvető hiba. A beszélgetési előzményt ugyanígy kell kezelni: ügyfélváltáskor ne folytatódjon automatikusan egy olyan szál, amelyben másik szervezet dokumentumai szerepeltek.
Ez szemléltető forgatókönyv, nem valós ügyféleset. A teszthez szándékosan eltérő, mesterséges reakcióidőket tartalmazó irat készülhet a két ügyfélhez, egyértelmű jelöléssel. Így a keveredés felismerhető anélkül, hogy valódi titkokkal kellene kísérletezni. A helyes válasz mellett a keresési találatokat, az idézeteket és a gyorsítótárból visszaadott változatot is vizsgálni kell.
Keresztügyfél-tesztek a normál és a hibás útvonalakon
A teszt ne álljon meg annál, hogy A nem tudja B dokumentumazonosítóját megnyitni. Próba szükséges azonos fájlnévre, azonos dokumentumkulcsra, hiányzó tenantmezőre és módosított kérésparaméterre is. Vizsgáljuk meg a keresés mellett az automatikus kiegészítést, a találatszámot, az exportot és a hivatkozást. Egy dokumentum címének vagy létezésének megmutatása is lehet jogosulatlan információ.
A párhuzamos feldolgozás külön teszteset. Két ügyfél egyszerre indított indexelése, ugyanazt a kérdést feltevő felhasználói vagy az újrainduló háttérmunkás felfedhet olyan állapotkeveredést, amely egyetlen kézi próbán nem jelenik meg. Az ügyfélváltást és a tagság visszavonását futás közben is modellezzük. A rendszernek világos szabály szerint kell eldöntenie, mikor érvényesül a változás a már sorban álló munkánál.
- Tenant nélkül ne legyen alapértelmezett, minden ügyfélre kiterjedő keresés.
- Az indexcélt és a szűrőt a kiszolgáló a hiteles kontextusból képezze.
- A dokumentumkulcs, a cache és a beszélgetés is legyen ügyfélhez kötött.
- A teszt ellenőrizze a címeket, idézeteket és letöltéseket is, ne csak a válaszszöveget.
- A párhuzamos futás és az ügyfélváltás legyen önálló próbafolyamat.
- A támogatói hozzáférés kapjon külön engedélyezési és naplózási rendet.
Migráció és lekapcsolás: az ügyfélhatár életciklus-feladat
Egy ügyfél külön indexbe vagy másik régióba költöztetésénél nem elég átállítani a keresés célját. A források, szövegrészletek, beágyazások, háttérfeladatok és gyorsítótárak teljes körét fel kell mérni. A váltás idején ne keletkezzen kettős vagy elmaradt frissítés. Az ellenőrzés igazolja, hogy az ügyfél a megfelelő új térből kap választ, a többi ügyfél működése pedig nem örökölt idegen adatot.
Lekapcsoláskor először az új hozzáférést és feldolgozást kell a kijelölt szabály szerint megszüntetni, majd a megőrzési feltételekhez igazított adatkezelést végrehajtani. A mentések és naplók eltérő életciklusát külön dokumentálni szükséges; nem állítható azonnali teljes törlés bizonyíték nélkül. A KOCI az ügyfélmodell, az adatbesorolás és az üzemeltetési feltételek tisztázása után segíthet az elkülönített RAG-architektúra kialakításában.
Gyakori kérdések
Elég minden ügyfélnek külön indexet létrehozni?
Ez erősítheti az elkülönítést, de önmagában nem teljes jogosultsági rendszer. Az alkalmazásnak ellenőriznie kell, melyik indexhez tartozik a hiteles ügyfélkörnyezet. A cache, a napló, a beszélgetés és az export továbbra is közös hibapont lehet.
Megoldja a problémát, ha a prompt tiltja más ügyfél adatainak használatát?
Nem helyettesíti a technikai elkülönítést. Idegen ügyfél tartalma már a modell bemenetébe sem kerülhet jogosulatlanul. A tenantkorlátot a keresésben és minden kapcsolódó adatútban érvényesíteni kell.
Mi történjen, ha hiányzik a tenantazonosító?
A kérés álljon meg vagy kerüljön ellenőrzött hibakezelésbe. A hiányzó azonosítóból ne következzen közös vagy korlátozás nélküli keresés. A hibát úgy naplózzuk, hogy az a javításhoz elég legyen, de ne másoljon szükségtelenül ügyféladatot.
Források és további olvasnivaló
- Microsoft Learn: Design patterns for multitenant SaaS applications and Azure AI Search ↗
- Microsoft Learn: Security filters for trimming results in Azure AI Search ↗
A cikk tájékoztató jellegű szakmai útmutató. Az említett példák szemléltető helyzetek; a saját vállalkozásodnál a konkrét adatok és a működési feltételek alapján érdemes dönteni.
Beszéljük át, hogyan ültethető át a gyakorlatba.
Projektet indítokKapcsolódó szolgáltatás: AI és automatizálás ↗



