Prihlásiť saRezervovať brífing

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

15 min čítania

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_URL sa 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_id vrá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-credentials zastaví 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 a povolenia
Manifest a povolenia
Časť Manifest a povolenia porovnáva to, čo deklaruje nové vydanie, s tým predchádzajúcim. Tu verzia 0.4.0 pridáva odosielanie pošty a jednu externú adresu, takže vydanie je pozdržané so stavom 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ť.

Kam môže aplikácia pristupovať
Kam môže aplikácia pristupovať
Časť Kam môže aplikácia pristupovať obsahuje zoznam všetkých externých adries, ktoré aplikácia deklarovala, a informáciu o tom, či ich schválil pracovník pre súlad s predpismi. Volanie na adresu, ktorú nikto nedeklaroval, je zastavené a započítané skôr, než čokoľvek opustí systém.

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.

  1. Každá trasa /api registruje strážcu rozsahu a jediné anonymné trasy sú presné cesty deklarované ako auth: public s allowAnonymous: true.
  2. Každá trasa, ktorú obsluhuje strážca rozsahu, uvádza right z registra manifestu a žiadny obslužný program si nenesie vlastnú kontrolu oprávnení.
  3. Žiadny obslužný program nečíta organizáciu, osobu ani jednotku z tela požiadavky, dopytu ani z hlavičky.
  4. Každý príkaz na tabuľke s obmedzeným rozsahom prechádza cez tenantFence vo vnútri withScopedTx a nič v repozitári nevolá set_config.
  5. 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.
  6. URL adresa odoslania sa číta v jednom súbore a zoznam povolení odoslania je konštantou typov úloh s menným priestorom.
  7. Nič v package.json nekomunikuje s poskytovateľom modelu a v prostredí sa nenachádza žiadny kľúč.
  8. Každá funkcia, ktorú obsahujú iba niektoré licencie, uvádza svoje licence na oprávnení, ktoré ju chráni.
  9. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test svieti na zeleno a rovnako aj npx -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.