Verzia 1.0.0-alpha.1najnovšia
Kapitola 2.19
Pravidlá, ktoré dedí každé rozšírenie
Izolácia v troch osiach, výpočty cez UNO, AI (umelá inteligencia) cez smerovač, kľúče vo vlastníctve organizácie a kontroly licencií. Čo jednotlivé pravidlá znamenajú pre váš kód, ktorá brána ich vynucuje a prečo ich dedíte namiesto toho, aby ste ich písali.
Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

Prvé odmietnutie, ktoré môj plugin na kontrolu anomálií kedy odoslal, bolo určené mne. Napísal som testovacieho klienta, ktorý zo zvyku z inej platformy odoslal novú kontrolu s ID organizácie v tele požiadavky, a plugin odpovedal skôr, než sa môj obslužný program vôbec spustil:
{
"error": true,
"code": "TENANT_NOT_A_PARAMETER",
"message": "The request body names the organisation. Tenancy comes from the token.",
"resolved": ["tenant", "owner"],
"missing": [],
"troubleshooting": ["Remove organizationId from the body. The organisation is read from your sign-in."]
}Túto kontrolu som nenapísal ja. Prišla spolu so strážcom rozsahu (scope guard), ktorého šablóna SDK (súprava na vývoj softvéru) zapája do každej trasy /api, a spustí sa aj vtedy, keď ID v tele požiadavky patrí samotnému volajúcemu. Toto je vzor pre celú túto kapitolu: malý počet pravidiel, z ktorých každé je vynucované zdedeným mechanizmom a každé má kontrolnú bránu (gate), ktorá zastaví zostavenie (build), ak ju váš kód obíde. Na platforme Nexus váš plugin dedí svoju izoláciu od platformy a kontrolné brány ju auditujú.
Existuje päť pravidiel a nasledujúce časti sa im venujú postupne: izolácia na troch osiach; výpočtový výkon, ktorý beží výlučne cez UNO dispatch; AI (umelá inteligencia), ktorá prechádza len cez AI Provider Router; kľúče modelov, ktoré patria organizácii; a licencované funkcie overované voči licencii. Každý manifest navyše tri z nich opätovne deklaruje v jednom bloku viet.
Pravidlo 1: izolácia v troch osiach, od autentifikovanej požiadavky
Každé čítanie a zápis v rozšírení má obmedzený rozsah na troch osiach, a to isté platí pre každé volanie nástroja a odoslanie zručnosti (skill dispatch).
| Os | Stĺpec | Odpovedá na otázku | Aká pevná je táto hranica |
|---|---|---|---|
| Nájomca (Tenant) | organization_id |
Ktorá organizácia | Pevná hranica, ktorú možno prekročiť len prostredníctvom zaznamenaného povolenia výlučne na čítanie |
| Vlastník | owner_user_id |
Ktorá osoba v rámci organizácie | Súkromné aj v rámci jednej organizácie, pre čokoľvek osobné |
| Jednotka | business_unit_id |
Ktorá časť organizácie | Voliteľná ohrada v rámci tenanta |
Os vlastníka je tá, v ktorej nováčikovia robia chyby. Poštová schránka je osobná, rovnako ako uložené zobrazenie alebo graf odvodený z údajov jednej osoby. Dvaja členovia tej istej organizácie, v tej istej jednotke a s tou istou rolou, nevidia navzájom svoje riadky obmedzené na vlastníka. Pri artefakte organizácie, napríklad pri schválení alebo zázname prípadu, predstavuje vlastník namiesto toho pôvod: zaznamenáva, kto konal, a čítania sú obmedzené na rozsah tenanta, aby auditná stopa zostala viditeľná pre ľudí, ktorí ju potrebujú. Pre každú tabuľku sa rozhodnete, o ktorý druh ide, a vrstva repozitára to zakóduje – nikdy to nie je špeciálny prípad v trase.
Osi pochádzajú z autentifikovanej požiadavky a odnikiaľ inak. Premenná prostredia ich nemôže dodať, a rovnako ani parameter dopytu, segment cesty, hlavička klienta či konštanta zostavenia. SDK sťažuje napísanie nesprávnej veci: resolveScope(identity, options) nemá vôbec žiadny parameter organizácie. Organizácia sa nachádza vo vnútri identity a vytvorí ju iba overený token. Nie je kam odovzdať ID.
To je dôvod, prečo je telo požiadavky, ktoré uvádza tenanta, odmietnuté a nie ignorované. Strážca odmietne ktorýkoľvek z piatich názvov polí: orgId, organizationId, organization_id, tenant a tenantId. Ticho ignorované pole učí volajúceho, že toto pole funguje. Prvý volajúci ho otestuje a uvidí svoje vlastné údaje; druhý odošle ID inej organizácie. Odmietnutie pri prvej požiadavke jasne definuje kontrakt skôr, než niekto začne stavať na nesprávnom predpoklade. Rovnaké pravidlo platí pre inputParams odoslania (dispatch): vstup zručnosti, ktorý nesie ID organizácie, je pri odoslaní odmietnutý.
Os jednotky je buď deklarovaná a vynucovaná, alebo sa nepoužíva. Trasa, ktorá deklaruje needsUnit: true, odmietne požiadavku, keď poverenie neurčí jednotku, pričom uvedie unit v missing[]. Nesyntetizujte jednotku zo subdomény alebo hlavičky a nenastavujte ju ako predvolenú. Vymyslená jednotka ohradzuje inak ako skutočné jednotky organizácie a spája riadky, ktoré by nemala.
Rozhranie, ktoré nedokáže vyjadriť predikát, požiadavku odmietne
Ak trasa nedokáže určiť, ktorému tenantovi a vlastníkovi riadok patrí, a ktorej jednotke, ak ju vyžaduje, požiadavku odmietne. Neexistuje žiadne núdzové čítanie v rozsahu celej organizácie ani žiadna zástupná hodnota. Zástupná hodnota je tá najhoršia možnosť, pretože zástupná hodnota je stále hodnota a hodnoty sa zhodujú s riadkami: smerovač nástrojov, ktorý predvolil tenanta aj používateľa na reťazec 'unknown', sprístupnil údaje celej organizácie komukoľvek, kto ho zavolal. Na hranici tenanta je ?? 'unknown' chybou.
Odmietnutie má všade na platforme rovnaký tvar a nesie dostatok informácií na to, aby klient dokázal vykresliť riešenie:
{
"error": true,
"code": "SCOPE_PREDICATE_MISSING",
"message": "Request cannot be scoped to a tenant from the presented credential.",
"resolved": ["tenant", "owner"],
"missing": ["unit"],
"troubleshooting": [
"The credential resolved tenant+owner; this route additionally requires a business unit.",
"Select a business unit in the client and retry — re-authentication will not change this outcome."
]
}error je vždy true. code pochádza z katalógu kódov platformy. resolved[] menuje osi, ktoré boli odvodené, a missing[] tie, ktoré trasa potrebovala, ale nedokázala získať. troubleshooting[] hovorí, čo by to skutočne opravilo. Holé „forbidden“ (zakázané) nikoho nič nenaučí.
Rozlišujte medzi stavmi 401 a 403, pretože klienti na ne reagujú odlišne.
| Stav | Význam | Čo urobí klient |
|---|---|---|
| 401 | Neautentifikovaný | Znova sa prihlási |
| 403 | Autentifikovaný, ale pre požiadavku nemožno určiť rozsah, alebo volajúcemu chýba oprávnenie | Prestane opakovať pokusy a zmení požiadavku |
Odmietnutie rozsahu vrátené ako 401 pošle klienta do prihlasovacej slučky, ktorú žiadne prihlásenie nedokáže ukončiť: zahodí reláciu a znova sa prihlási, zopakuje pokus a opäť dostane 401, zatiaľ čo používateľ donekonečna sleduje načítavacie koliesko.
Ďalšie dva mechanizmy robia odmietnutie absolútnym. Vo vnútri obslužného programu (handlera) je scopeOf(req) jediným spôsobom, ako prečítať rozsah, a ak strážca nebežal, vyvolá výnimku. Strážca navyše beží po spracovaní tela požiadavky a pred akýmkoľvek obslužným programom; obslužný program, ktorý sa stane dosiahnuteľným bez predikátu, zámerne odpovie kódom 500 s MIDDLEWARE_ORDERING_ERROR, takže skončí vo vašom rozpočte chýb (error budget) namiesto v hlásení o incidente.
Databáza udržiava rovnakú líniu sama osebe
Ohrada v kóde a ohrada v databáze sú dva mechanizmy pre jeden zákon a vy dostanete oba.
Každý príkaz voči tabuľke s obmedzeným rozsahom skladá tenantFence(scope) z SDK; predikát nikdy nepíšete ručne. Každý príkaz tiež beží vo vnútri withScopedTx, čo naviaže tri osi pre danú jednu transakciu prostredníctvom jedinej databázovej funkcie a odmietne druhé naviazanie (SCOPE_ALREADY_BOUND). Pod povrchom má každá tabuľka vo vašej schéme vynútené zabezpečenie na úrovni riadkov (row-level security) a rola, pod ktorou sa vaša cesta požiadavky pripája, nemôže sama zmeniť naviazaného tenanta. Proces, ktorý sa pripojí pod rolou schopnou obísť zabezpečenie na úrovni riadkov, odmietne naštartovať s DB_ROLE_BYPASSES_ISOLATION. Kapitola 2.22, Behové prostredie pluginu, ukazuje kód; kapitola 2.21, Plugin SDK, ukazuje, ako sú roly pre vás vygenerované.
Jediný priechod: zaznamenané udelenie prístupu
Existuje presne jeden spôsob, ako prekročiť hranicu tenanta. Organizácia, ktorá vlastní riadky, zaznamená povolenie (grant), v ktorom uvedie, ktorá organizácia môže čítať ktoré tabuľky, na základe akej dohody a ako dlho. Databáza sprístupní čítanie iba v režime na čítanie a každé nahliadnutie sa zapíše pred samotným čítaním, v oboch organizáciách, výlučne podľa ID. Zápisy hranicu nikdy neprekračujú; práca odovzdaná inej firme putuje ako správa. Roly vlastníka a správcu nikdy nečítajú cez hranicu a manifest je odmietnutý, ak im oprávnenie, ktoré pripúšťa čítanie medzi organizáciami, nezakáže prístup. Plugin, ktorý chce iný spôsob prekročenia hranice, žiadny nedostane.
Pravidlo 2: všetky výpočty prebiehajú cez dispečing UNO
UNO, nástroj pre pracovné postupy (workflow engine), je jedinou výpočtovou cestou. Váš kód nikdy nevolá priamo poskytovateľa modelu ani výpočtový engine, a nikdy ani frontu (queue) či hostiteľa pracovných postupov. Odošlete jednu obálku na koncový bod odoslania (dispatch endpoint) a späť dostanete 202 s identifikátormi; výsledok dorazí prostredníctvom dopytovania (polling) alebo spätného volania (callback).
Z toho vyplývajú tri návyky a šablóna už obsahuje všetky tri.
- Jeden súbor vlastní URL adresu odoslania.
UNO_DISPATCH_URLsa načíta raz v zavádzači konfigurácie a musí ísť o adresu v rámci klastra. Verejná adresa je pri štarte odmietnutá, pretože inštaláciu nič neopúšťa. - Jeden uzavretý zoznam povolení (allow-list) toho, čo môže toto rozhranie odosielať. Backend, ktorý odošle akékoľvek ID zručnosti odovzdané prehliadačom, je všeobecným proxy serverom pre každú zručnosť v registri, vrátane zručností iných pluginov a zručností, ktoré míňajú rozpočet na modely niekoho iného. Zoznam je konštantou na úrovni modulu obsahujúcou typy úloh s menným priestorom, nikdy nie premennou prostredia. ID, ktoré sa na ňom nenachádza, je odmietnuté s
SKILL_NOT_ALLOWED. - Znova skontrolujte to, čo sa vráti. Keď spätne načítate úlohu, klient SDK porovná
organization_idvráteného riadka s tenantom volajúceho na vašej strane sieťového volania. Ohrada, ktorá existuje iba na druhej strane volania, je len konvenciou.
Pravidlo 3: všetka AI prechádza cez smerovač poskytovateľov AI
Plugin nikde nevykonáva žiadne volanie modelu. V package.json nie je žiadne SDK poskytovateľa, v prostredí nie je žiadny kľúč modelu a neexistuje žiadny preposielací uzol (relay). Výlučne smerovač (router) drží poverenie poskytovateľa organizácie a robí konečné rozhodnutie o poskytovateľovi a modeli.
Čo plugin môže urobiť, je vyjadriť želania v čase registrácie v riadku registra pre zručnosť z manifestu:
{
"execution_config_skill": {
"preferredProvider": "gemini",
"preferredModel": "gemini-3.5-flash",
"capabilityProfile": { "needsToolUse": true, "minContextWindow": 200000 }
}
}Smerovač vyhovie želaniu iba vtedy, keď má organizácia daného poskytovateľa povoleného a vybaveného povereniami. V opačnom prípade ho nahradí z vlastného fondu organizácie. capabilityProfile nikdy nevyberá; filtruje, a jeho pole dataResidency je tvrdým jurisdikčným obmedzením, ktorému smerovač buď vyhovie, alebo požiadavku odmietne. Vynechanie všetkých týchto možností je pre väčšinu zručností správnou predvolenou voľbou: rozhodujú potom vlastné priradenia rolí organizácie, keďže organizácia je tá, ktorá platí.
Späť sa vracajú dva druhy odmietnutí a znamenajú veľmi odlišné veci.
| Kód | Stav | Čo to znamená |
|---|---|---|
MISSING_CALLER_IDENTITY, UNAUTHORIZED_CALLER |
403 | Váš kód sa pokúsil zavolať samotný smerovač. Zastavte: toto je rozhranie, ktoré odmieta zámerne už z princípu návrhu, a pokus nemožno opakovať |
MODEL_CAPABILITY_UNAVAILABLE |
422 | Žiadny povolený poskytovateľ nemá model, ktorý vyhovuje profilu. Uvoľnite profil, alebo organizácia povolí spôsobilého poskytovateľa |
NO_PROVIDER_FOR_ROLE |
422 | Organizácia nenakonfigurovala smerovanie pre túto rolu. Zobrazte osobe text nápravy zo smerovača |
Druhá dvojica patrí na obrazovku, nie do záznamu (logu). Neexistuje žiadny predvolený model ani záložný poskytovateľ: rola, ktorú organizácia nenastavila, zlyhá hlasno, s vetou, ktorá hovorí, čo treba nakonfigurovať.
Jediné čítanie, ktoré môže plugin vykonať zo smerovača, je effectiveRoute() z runtime/ai-route. Odpovedá na to, ktorého poskytovateľa a model by smerovač vybral pre prihlásenú organizáciu bez odoslania požiadavky na AI, a keď neexistuje žiadny model, vráti slovné odmietnutie smerovača. Ukazuje to kapitola 2.22, Behové prostredie pluginu.
Rebríček dôvery pridáva ešte jednu hranicu. Iba pluginy core a verified môžu deklarovať dve úrovne zručností v manifeste, ktoré dosiahnu na smerovač: tool_using a llm_only. Všetci ostatní sprostredkúvajú deterministickú prácu a časť, ktorá komunikuje s modelom, prenechávajú platforme.
Pravidlo 4: kľúče patria organizácii
Každá organizácia si prináša vlastný účet a kľúč poskytovateľa a platí svoj vlastný účet. Kľúč sa nachádza vo fonde poskytovateľov AI danej organizácie, ktorý spravujú jej vlastní správcovia z konzoly, a smerovač ho vyhodnocuje v čase volania. Za tenantom nie je žiadny zdieľaný kľúč platformy, takže žiadna organizácia nemíňa rozpočet inej.
Pre rozšírenie to znamená tri veci.
- Nikdy nedržíte kľúč modelu, či už v kóde, konfigurácii alebo v úložisku tajomstiev (secret store). Kontrolná brána
no-credentialszastaví zostavenie, ak je nejaký kľúč čitateľný, a zavádzač konfigurácie odmietne naštartovať, ak je prítomný. - Nikdy nevymenúvate kľúče organizácie. Ak si váš plugin myslí, že to potrebuje, požiadavka je na nesprávnom mieste.
- Organizácia bez kľúča nedostane žiadne odpovede od AI. To je očakávaný stav so skutočnou obrazovkou. Pomenujte chýbajúcu rolu, citujte nápravu a potom nasmerujte osobu na jej nastavenia poskytovateľa. Nevykresľujte to ako prázdny výsledok.
Pravidlo 5: licencované funkcie sa kontrolujú oproti licencii
To, čo môže inštalácia používať nad rámec základnej úrovne Community, pochádza z jedného miesta: z licenčného dokumentu podpísaného spoločnosťou Adverant, overeného na inštalácii výlučne pomocou verejných kľúčov. Vaše rozšírenie sa nikdy nerozhoduje na základe niečoho slabšieho, ako je napríklad názov plánu v tokene alebo príznak v konfigurácii.
V plugine je najjednoduchším spôsobom, ako naviazať funkciu na licenciu, urobiť to na oprávnení, ktoré ju chráni. Oprávnenie v registri rights manifestu môže pomenovať funkciu licence:
"rights": {
"evidence.export": {
"summary": "Export the evidence pack for an inspection.",
"roles": ["owner", "admin", "member"],
"licence": "compliance-packs"
}
}Ktokoľvek zavolá trasu chránenú týmto oprávnením, je odmietnutý s LICENCE_LOCKED (403) bez ohľadu na to, aké roly a miesta (seats) zastáva, ak licencia organizácie neobsahuje compliance-packs. Odmietnutie pomenuje funkciu a to, čo ju obsahuje, a uvedie, kto ju môže zapnúť.
Záleží aj na stave licencie. Kým je licencia platná alebo je v období upozornenia, licencované funkcie fungujú; fungujú naďalej aj v odkladnom období (grace period), pričom odkladné obdobie zobrazuje oznámenie LICENCE_IN_GRACE. Keď licencia prekročí odkladné obdobie, prejde do obmedzeného režimu: bežiaca práca a čítania pokračujú, rovnako aj exporty a bezpečnostné aktualizácie, ale vytvorenie niečoho nového v rámci licencovanej funkcie je odmietnuté s LICENCE_LOCKED. Navrhnite svoje cesty vytvárania tak, aby túto odpoveď očakávali.
Keď sa váš plugin pýta kontroly nárokov (entitlement check), či má organizácia nárok na funkciu, dostane verdikt, nikdy nie holú booleovskú hodnotu. „Nedostupné“ a „dostupné a nie“ sú odlišné fakty s odlišnými kódmi: ENTITLEMENT_UNREACHABLE (502) a ENTITLEMENT_DENIED (403). Chvíľkový výpadok dostupnosti nikdy nesmie potichu degradovať každého zákazníka na bezplatnú základnú úroveň.
MANIFEST_SCOPE_WIDENED, kým to neschvália dvaja kontrolóri a pracovník pre súlad s predpismi (compliance officer).Manifest znova potvrdzuje pravidlá
Každý manifest verzie v2 obsahuje blok architecture s tromi povinnými vetami a validátor vyžaduje ich presné znenie. V plugine, ktorý zostavujete pre svoju vlastnú inštaláciu, znejú takto:
"architecture": {
"compute": "All compute runs via UNO dispatch (nexus-orchestrator /api/v1/dispatch + nexus-workflows). No direct engine, queue or model-provider calls from plugin code.",
"ai": "All AI goes through the AI Provider Router, which alone owns the credential and the final provider/model decision. This plugin holds no model credentials.",
"deploy": "Deploy is through the installation's release channels only."
}Tieto vety sa kontrolujú. Plugin, ktorého manifest by súhlasil so zákonmi, zatiaľ čo jeho kód by volal poskytovateľa modelu, by klamal vo svojom vlastnom kontrakte, a kontrolné brány existujú na to, aby bolo toto klamstvo odhaliteľné.
Brány, ktoré vynucujú jednotlivé pravidlá
SDK dodáva dvadsaťdva kontrolných brán dodržiavania pravidiel ako jeden príkaz, nexus-gates. Kapitola 2.21, Plugin SDK, opisuje každú z nich. Tu sú zoskupené podľa pravidla, ktoré vynucujú.
| Pravidlo | Kontrolné brány | Čo spôsobí zlyhanie zostavenia |
|---|---|---|
| Izolácia vo vrstve trás | scope-adherence, one-fence, rights-register, crud-adherence |
Trasa /api bez strážcu rozsahu, druhý ručne napísaný predikát tenanta, trasa s rozsahom bez oprávnenia, mutujúca trasa, ktorej oprávnenie nič neuvádza |
| Izolácia v SQL | sql-fence, no-set-config |
Príkaz na tabuľke s obmedzeným rozsahom bez ohrady; kód pluginu, ktorý sám naväzuje nastavenie tenanta |
| Izolácia v databáze | migrations-are-scoped, rls-present, db-role-honest |
Tabuľka, ktorej chýba os alebo kľúč začínajúci tenantom, tabuľka bez vynúteného zabezpečenia na úrovni riadkov, cesta požiadavky pripájajúca sa ako vlastník alebo superpoužívateľ |
| Jediné prekročenie hranice | grants-declared |
Tabuľka s udeleným prístupom v migráciách, ktorú manifest nedeklaruje, alebo miesto na čítanie (read seat), ktorému boli privilégiá pridelené ručne |
| Výpočtový výkon cez UNO | no-direct-compute |
Priame volanie poskytovateľa modelu alebo enginu, prípadne fronty alebo hostiteľa pracovných postupov; druhý čitateľ URL adresy odoslania |
| AI a kľúče | no-credentials |
Poverenie poskytovateľa modelu čitateľné v repozitári alebo v prostredí |
| Deklarovaný kontrakt | api-contract, platform-clients, declared-input |
Trasa zaregistrovaná, ale nedeklarovaná, alebo deklarovaná, ale nezaregistrovaná; klient platformy importovaný, ale nepomenovaný |
Každá kontrolná brána má autotest, ktorý dokazuje, že zlyhá na testovacej vzorke (fixture) vytvorenej tak, aby ju spustila. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test ich spustí všetky a kontrolná brána, ktorá prestala zlyhávať na svojej vlastnej vzorke, prestala fungovať.
Skôr než požiadate o kontrolu
Toto je zoznam, ktorý si prechádzam predtým, než požiadam kolegu o kontrolu pluginu. Každý riadok predstavuje niečo, čo mi kontrolór v spoločnosti Corrán Orbital vrátil aspoň raz.
- Každá trasa
/apiregistruje strážcu rozsahu a jediné anonymné trasy sú presné cesty deklarované akoauth: publicsallowAnonymous: true. - Každá trasa, ktorú obsluhuje strážca rozsahu, uvádza
rightz registra manifestu a žiadny obslužný program si nenesie vlastnú kontrolu oprávnení. - Žiadny obslužný program nečíta organizáciu, osobu ani jednotku z tela požiadavky, dopytu ani z hlavičky.
- Každý príkaz na tabuľke s obmedzeným rozsahom prechádza cez
tenantFencevo vnútriwithScopedTxa nič v repozitári nevoláset_config. - Každá tabuľka má stĺpce pre tri osi, primárny kľúč, ktorý začína s
organization_id, a zložené cudzie kľúče, ktoré nesú tenanta. - URL adresa odoslania sa číta v jednom súbore a zoznam povolení odoslania je konštantou typov úloh s menným priestorom.
- Nič v
package.jsonnekomunikuje s poskytovateľom modelu a v prostredí sa nenachádza žiadny kľúč. - Každá funkcia, ktorú obsahujú iba niektoré licencie, uvádza svoje
licencena oprávnení, ktoré ju chráni. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testsvieti na zeleno a rovnako ajnpx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json.
Ak platí všetkých deväť bodov, kontrola je o vašom produkte, a presne tam by mal smerovať čas kontrolóra.
Prečo platforma vynucuje tieto pravidlá
Každé z vyššie uvedených pravidiel bolo kedysi niekde len konvenciou a každá konvencia zlyhala rovnakým spôsobom: trasy, ktoré si ju pamätali, boli v poriadku, a tá jedna, ktorá na ňu zabudla, spôsobila incident. Ohrada organizačnej jednotky aplikovaná ako voliteľný middleware bola obídená šiestimi nezávislými spôsobmi, pričom v každom prípade išlo o trasu, ktorá sa k nej nikdy neprihlásila. Premenná prostredia, ktorá prepísala identitu tenanta, sprístupnila jednej organizácii 1 406 kontaktov inej organizácie, a pri kontrole to vyzeralo správne, pretože to bolo správne pre pod, pre ktorý to bolo napísané.
Platforma preto umiestňuje predikát tam, kadiaľ už každé rozhranie prechádza: do strážcu rozsahu a funkcie ohrady, do obalu transakcie a vynúteného zabezpečenia na úrovni riadkov a do klienta odoslania. Kontrolná brána potom vymenuje každú trasu, každý príkaz a každý import a zastaví zostavenie, keď niektorý z nich pristúpi k tabuľke s obmedzeným rozsahom, k modelu alebo k výpočtovému enginu bez toho, aby prešiel týmito mechanizmami. Cenou za tento návrh je, že pri vašom prvom plugine sa cítite obmedzovaní. Odmenou je, že tisíci plugin je izolovaný bez toho, aby jeho autor vôbec vedel, že táto funkcia existuje, pretože neexistuje žiadna iná cesta k údajom, ktorou by sa mohol vydať.
Toto všetko má jedno úprimné obmedzenie. Kontrolné brány dokazujú, že váš kód prechádza cez stanovené mechanizmy; nedokážu však potvrdiť, že vaša produktová logika je správna. Trasa, ktorá správne obmedzí rozsah dopytu na riadky vlastníka, môže stále zobraziť nesprávne riadky správnemu vlastníkovi. Súprava izolačných testov v kapitole 2.22, Behové prostredie pluginu, útočí na každú trasu v mene inej organizácie a v mene kolegu, pričom postupne odstraňuje každú ohradu, a presne tento test by som spustil predtým, než by som uveril vlastnej interpretácii čohokoľvek z tohto textu.

