BejelentkezésBemutató kérése

2.19. fejezet

A szabályok, amelyeket minden bővítmény örököl

Izoláció három tengely mentén, számítási műveletek az UNO-n keresztül, AI (mesterséges intelligencia) a routeren keresztül, a szervezet tulajdonában lévő kulcsok és licencellenőrzések. Mit jelent az egyes szabály a kódjára nézve, melyik kapu (gate) kényszeríti ki, és miért örökli ahelyett, hogy Önnek kellene megírnia.

Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

15 perc olvasási idő

Az anomália-felülvizsgálati bővítményem a legelső elutasítást nekem küldte. Írtam egy tesztklienst, amely egy másik platformról hozott megszokásból a szervezet azonosítóját a törzsbe helyezve küldött be egy új felülvizsgálatot, és a bővítmény még a kezelőm lefutása előtt válaszolt:

{
  "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."]
}

Ezt az ellenőrzést nem én írtam. A hatókör-őrből (scope guard) származott, amelyet az SDK (szoftverfejlesztő készlet) sablonja minden /api útvonalba beköt, és még akkor is működésbe lép, ha a törzsben lévő azonosító maga a hívóé. Ez a minta vonul végig az egész fejezeten: néhány szabály, amelyek mindegyikét egy Ön által örökölt mechanizmus kényszerít ki, és mindegyikhez tartozik egy kapu (gate), amely megbuktatja a buildet, ha a kódja megkerüli azt. A Nexus rendszeren a bővítménye a platformtól örökli az izolációt, a kapuk pedig ellenőrzik azt.

Öt szabály létezik, és az alábbi szakaszok sorra veszik őket: izoláció három tengely mentén; számítási műveletek kizárólag az UNO diszpécseren keresztül; AI (mesterséges intelligencia) kizárólag az AI Provider Routeren keresztül; a szervezethez tartozó modellkulcsok; valamint a licenc alapján ellenőrzött, licenchez kötött funkciók. Emellett minden manifesztum megismétel ezekből hármat egyetlen mondatblokkban.

1. szabály: izoláció három tengely mentén, a hitelesített kérésből kiindulva

Egy kiterjesztésben minden olvasás és írás három tengely mentén van hatókörhöz kötve, és ugyanez vonatkozik minden eszközhívásra és képességindításra (skill dispatch) is.

Tengely Oszlop Megválaszolt kérdés Mennyire szigorú a határ
Bérlő (Tenant) organization_id Melyik szervezet Szigorú határ, amely csak rögzített, írásvédett engedéllyel léphető át
Tulajdonos (Owner) owner_user_id Melyik személy a szervezeten belül Egy szervezeten belül is privát minden személyes adat esetében
Egység (Unit) business_unit_id A szervezet melyik része Opcionális válaszfal egy bérlőn (tenant) belül

A tulajdonosi (owner) tengely az, amelyet az újoncok el szoktak rontani. Egy postafiók személyes, ahogy egy mentett nézet vagy egyetlen személy adataiból származtatott gráf is. Ugyanazon szervezet két tagja, ugyanabban az egységben és ugyanazzal a szerepkörrel, nem látja egymás tulajdonosi hatókörű sorait. Egy szervezeti műterméken – például egy jóváhagyáson vagy egy ügyrekordon – a tulajdonos ezzel szemben az eredetet jelöli: azt rögzíti, hogy ki járt el, az olvasások pedig a bérlőre korlátozódnak, így az ellenőrzési nyomvonal (audit trail) látható marad azok számára, akiknek szükségük van rá. Táblánként Ön dönti el, melyik típusról van szó, és ezt az adattárréteg (repository layer) kódolja, soha nem egy útvonalon belüli kivételként.

A tengelyek a hitelesített kérésből származnak, és sehonnan máshonnan. Környezeti változó nem szolgáltathatja őket, ahogy lekérdezési paraméter, elérésiút-szegmens, kliensfejléc vagy buildkonstans sem. Az SDK megnehezíti a hibás megoldás megírását: a resolveScope(identity, options) egyáltalán nem rendelkezik szervezeti paraméterrel. A szervezet a identity belsejében található, és ilyet csak egy ellenőrzött token állíthat elő. Nincs min átadni az azonosítót.

Ezért van az, hogy a bérlőt megnevező törzset a rendszer elutasítja ahelyett, hogy figyelmen kívül hagyná. Az őr öt mezőnév bármelyikét elutasítja: orgId, organizationId, organization_id, tenant és tenantId. Egy csendben figyelmen kívül hagyott mező arra tanítja a hívót, hogy a mező működik. Az első hívó leteszteli, és látja a saját adatait; a második már egy másik szervezet azonosítóját küldi el. Az első kérésnél történő elutasítás világossá teszi a szerződést, mielőtt bárki a rossz feltételezésre építene. Ugyanez a szabály érvényes az indítás (dispatch) inputParams elemére is: ha egy képesség bemenete szervezetazonosítót tartalmaz, az indításkor elutasításra kerül.

Az egységtengelyt (unit axis) vagy deklarálják és kikényszerítik, vagy nem használják. A needsUnit: true értéket deklaráló útvonal elutasítja a kérést, ha a hitelesítő adat nem old fel egy egységet, és a missing[] mezőben megnevezi a unit értéket. Ne állítson elő egységet aldomainből vagy fejlécből, és ne adjon meg alapértelmezett értéket sem. Egy kitalált egység a szervezet valódi egységeitől eltérően határol el, és olyan sorokat kapcsol össze, amelyeket nem kellene.

Az a felület, amely nem tudja kifejezni a predikátumot, elutasítja a kérést

Ha egy útvonal nem tudja megmondani, hogy egy sor melyik bérlőhöz és tulajdonoshoz tartozik – valamint melyik egységhez, ha arra szükség van –, akkor elutasítja a kérést. Nincs tartalékként szolgáló, teljes szervezetre kiterjedő olvasás, és nincs helyőrző érték sem. A helyőrző a legrosszabb lehetőség, mert a helyőrző is egy érték, az értékek pedig soroknak felelnek meg: egy eszközútválasztó, amely a bérlőt és a felhasználót is alapértelmezetten az 'unknown' karakterláncra állította, a teljes szervezetre kiterjedő adatokat szolgáltatott ki bárkinek, aki meghívta. Egy bérlői határon a ?? 'unknown' hibának minősül.

Az elutasítás a platformon mindenütt azonos formátumú, és elegendő információt hordoz ahhoz, hogy a kliens megjelenítse a javítási lehetőséget:

{
  "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."
  ]
}

A error mindig true. A code a platform kódkatalógusából származik. A resolved[] megnevezi a származtatott tengelyeket, a missing[] pedig azokat, amelyekre az útvonalnak szüksége volt, de nem tudta beszerezni őket. A troubleshooting[] megmondja, mi jelentené a tényleges megoldást. Egy puszta „forbidden” (tiltott) üzenetből senki nem tanul semmit.

Különböztesse meg a 401-es és a 403-as kódot, mert a kliensek eltérően reagálnak rájuk.

Állapot Jelentés Mit tesz a kliens
401 Nincs hitelesítve Újra bejelentkezik
403 Hitelesítve van, de a kérés hatóköre nem határozható meg, vagy a hívónak nincs jogosultsága Abba-hagyja az újrapróbálkozást, és módosítja a kérést

A 401-es kóddal megválaszolt hatókör-elutasítás olyan bejelentkezési végtelen ciklusba küldi a klienst, amelyet semmilyen bejelentkezés nem tud megszakítani: eldobja a munkamenetet és újra bejelentkezik, újrapróbálkozik és ismét 401-et kap, miközben a felhasználó a végtelenségig a töltésjelzőt nézi.

További két mechanizmus teszi teljessé az elutasítást. Egy kezelőn belül a scopeOf(req) az egyetlen módja a hatókör kiolvasásának, és kivételt dob, ha az őr nem futott le. Az őr pedig a törzs elemzése után és bármely kezelő előtt fut le; egy olyan kezelő, amely a predikátum nélkül válik elérhetővé, szándékosan 500-as kóddal és MIDDLEWARE_ORDERING_ERROR értékkel válaszol, így az incidensjelentés helyett az Ön hibakeretében (error budget) landol.

Az adatbázis önmagában is ugyanezt a határt tartja fenn

A kódbeli válaszfal és az adatbázisbeli válaszfal két mechanizmus ugyanarra a törvényre, és Ön mindkettőt megkapja.

A hatókörhöz kötött táblákon végrehajtott minden utasítás az SDK-ból származó tenantFence(scope) elemet építi be; a predikátumot soha nem Ön írja meg kézzel. Emellett minden utasítás a withScopedTx belsejében fut, amely egyetlen adatbázis-függvényen keresztül hozzáköti a három tengelyt az adott tranzakcióhoz, és elutasít minden második kötést (SCOPE_ALREADY_BOUND). A háttérben a sémájában lévő minden táblán kötelezően be van kapcsolva a sorszintű biztonság (RLS), és az a szerepkör, amelyként a kérési útvonala csatlakozik, maga nem tudja megváltoztatni a hozzákötött bérlőt. Az a folyamat, amely a sorszintű biztonság megkerülésére képes szerepkörként csatlakozik, DB_ROLE_BYPASSES_ISOLATION hibával megtagadja az indulást. A 2.22. fejezet (A bővítmény futtatókörnyezete) bemutatja a kódot; a 2.21. fejezet (A Plugin SDK) pedig bemutatja, hogyan kerülnek előállításra a szerepkörök az Ön számára.

Az egyetlen átjárás: egy rögzített engedély

A bérlői határon való átlépésnek pontosan egy módja van. A sorokat birtokló szervezet rögzít egy engedélyt, amely megnevezi, hogy melyik szervezet mely táblákat olvashatja, milyen megállapodás alapján és mennyi ideig. Az adatbázis írásvédetté teszi az olvasást, és minden betekintés még az olvasás előtt naplózásra kerül mindkét szervezetnél, kizárólag azonosító alapján. Az írások soha nem lépik át a határt; a másik cégnek átadott munka üzenetként utazik. A tulajdonosi és az adminisztrátori szerepkörök egyáltalán nem olvasnak át a határon, és a manifesztum elutasításra kerül, ha a szervezetek közötti olvasást megengedő jogosultság nem zárja ki őket. Az a bővítmény, amelyik más úton akar átlépni a határon, nem kap rá lehetőséget.

2. szabály: minden számítási művelet az UNO diszpécserén keresztül fut

Az UNO munkafolyamat-motor az egyetlen számítási útvonal. Az Ön kódja soha nem hív meg közvetlenül modellszolgáltatót vagy motort, és soha nem ér el közvetlenül várólistát (queue) vagy munkafolyamat-kiszolgálót sem. Ön egyetlen borítékot küld az indítási (dispatch) végpontnak, és azonosítókkal ellátott 202 választ kap vissza; az eredmény lekérdezéssel (polling) vagy visszahívással (callback) érkezik meg.

Ebből három szokás következik, és a sablon már mindhármat tartalmazza.

  • Egyetlen fájl birtokolja az indítási URL-t. A UNO_DISPATCH_URL beolvasása egyszer történik meg a konfigurációbetöltőben, és klaszteren belüli címnek kell lennie. A nyilvános címeket a rendszer indításkor elutasítja, mivel semmi sem hagyhatja el a telepítést.
  • Egyetlen zárt engedélyezési lista (allow-list) arról, hogy ez a felület mit indíthat el. Egy olyan háttérrendszer (backend), amely a böngészőtől kapott bármilyen képességazonosítót (skill id) elindít, általános célú proxyként működik a regisztrációs adatbázis összes képessége számára, beleértve más bővítmények képességeit és az olyan képességeket is, amelyek mások modellkeretét költik. A lista névtérrel ellátott feladattípusok modulszintű konstansa, soha nem környezeti változó. A listán nem szereplő azonosítókat a rendszer SKILL_NOT_ALLOWED hibával elutasítja.
  • Ellenőrizze újra a visszakapott adatokat. Amikor visszaolvas egy feladatot, az SDK kliense a hálózati hívásnak az Ön oldalán összehasonlítja a visszaadott sor organization_id értékét a hívó bérlőjével. Az a válaszfal, amely csak a hívás másik oldalán létezik, csupán konvenció.

3. szabály: minden AI-hívás az AI Provider Routeren keresztül történik

Egy bővítmény sehol sem intéz hívást modellhez. Nincs szolgáltatói SDK a package.json fájlban, nincs modellkulcs a környezetben, és nincs továbbító (relay) sem. Kizárólag az útválasztó (router) birtokolja a szervezet szolgáltatói hitelesítő adatait, és ő hozza meg a végső döntést a szolgáltatóról és a modellről.

Amit egy bővítmény megtehet, az az, hogy a regisztrációkor kívánságokat fogalmaz meg a manifesztumbeli képesség regisztrációs sorában:

{
  "execution_config_skill": {
    "preferredProvider": "gemini",
    "preferredModel": "gemini-3.5-flash",
    "capabilityProfile": { "needsToolUse": true, "minContextWindow": 200000 }
  }
}

Az útválasztó csak akkor teljesít egy kívánságot, ha a szervezetnél az adott szolgáltató engedélyezve van, és rendelkezik hitelesítő adatokkal. Ellenkező esetben a szervezet saját készletéből helyettesíti azt. A capabilityProfile soha nem választ ki; csak szűr, a dataResidency mezője pedig egy szigorú joghatósági megkötés, amelyet az útválasztó vagy teljesít, vagy elutasít. A legtöbb képesség esetében mindezek elhagyása a megfelelő alapértelmezés: ekkor a szervezet saját szerepkör-hozzárendelései döntenek, hiszen a számlát is a szervezet fizeti.

Kétféle elutasítás érkezhet vissza, és ezek nagyon eltérő dolgokat jelentenek.

Kód Állapot Mit jelent
MISSING_CALLER_IDENTITY, UNAUTHORIZED_CALLER 403 Az Ön kódja megpróbálta közvetlenül meghívni az útválasztót. Álljon meg: itt az illesztési felület a tervezéséből adódóan utasítja el a kérést, és a művelet nem próbálható újra
MODEL_CAPABILITY_UNAVAILABLE 422 Egyetlen engedélyezett szolgáltatónak sincs olyan modellje, amely megfelelne a profilnak. Enyhítsen a profilon, vagy a szervezet engedélyezzen egy megfelelő szolgáltatót
NO_PROVIDER_FOR_ROLE 422 A szervezet nem konfigurálta az útválasztást ehhez a szerepkörhöz. Jelenítse meg az útválasztó javítási szövegét a felhasználónak

A második párnak a képernyőn a helye, nem a naplóban. Nincs alapértelmezett modell és nincs tartalék szolgáltató: az a szerepkör, amelyet a szervezet nem állított be, feltűnően hibára fut egy mondattal, amely megmondja, mit kell konfigurálni.

Az egyetlen olvasási művelet, amelyet egy bővítmény az útválasztón végezhet, a runtime/ai-route elemből származó effectiveRoute(). Ez AI-kérés elküldése nélkül megválaszolja, hogy az útválasztó melyik szolgáltatót és modellt választaná a bejelentkezett szervezet számára, és szövegesen visszaadja az útválasztó elutasítását, ha nincs elérhető modell. A 2.22. fejezet (A bővítmény futtatókörnyezete) bemutatja ezt.

A bizalmi létra még egy szabályt hozzáad. Csak a core és a verified bővítmények deklarálhatják azt a két, útválasztót elérő manifesztumbeli képességszintet, amely a tool_using és a llm_only. Mindenki más determinisztikus munkát közvetít, és a modellek elérését a platformra bízza.

4. szabály: a kulcsok a szervezethez tartoznak

Minden szervezet a saját szolgáltatói fiókját és kulcsát hozza, és a saját számláját fizeti. A kulcs a szervezet AI-szolgáltatói készletében él, amelyet a saját adminisztrátorai kezelnek a konzolról, az útválasztó pedig a hívás pillanatában oldja fel. A bérlők mögött nincs megosztott platformkulcs, így egyik szervezet sem költi a másik költségvetését.

Egy kiterjesztés számára ez három dolgot jelent.

  • Ön soha nem tárol modellkulcsot, sem kódban, sem konfigurációban, sem titoktárolóban. A no-credentials kapu megbuktatja a buildet, ha egy kulcs olvasható, a konfigurációbetöltő pedig megtagadja az indulást, ha ilyet észlel.
  • Ön soha nem listázza ki egy szervezet kulcsait. Ha a bővítménye úgy gondolja, hogy erre van szüksége, akkor a követelmény rossz helyen van.
  • A kulccsal nem rendelkező szervezet nem kap AI-válaszokat. Ez egy várt állapot, amelyhez valódi képernyő tartozik. Nevezze meg a hiányzó szerepkört, idézze a javítási javaslatot, majd irányítsa a felhasználót a szolgáltatói beállításokhoz. Ne jelenítse meg üres eredményként.

5. szabály: a licenchez kötött funkciókat a rendszer a licenc alapján ellenőrzi

Az, hogy egy telepítés mit használhat a Community alapszinten túl, egyetlen helyről származik: az Adverant által aláírt licencdokumentumból, amelyet a telepítésen kizárólag nyilvános kulcsokkal ellenőriznek. A kiterjesztése soha nem hozhat döntést ennél gyengébb információ – például egy tokenben lévő csomagnév vagy egy konfigurációs jelző (flag) – alapján.

Egy bővítményben a legegyszerűbb módja annak, hogy egy funkciót a licenchez kössön, az azt védő jogosultságon keresztül vezet. A manifesztum rights regiszterében szereplő jogosultság megnevezhet egy licence funkciót:

"rights": {
  "evidence.export": {
    "summary": "Export the evidence pack for an inspection.",
    "roles": ["owner", "admin", "member"],
    "licence": "compliance-packs"
  }
}

Bárki, aki egy ilyen jogosultsággal védett útvonalat hív meg, LICENCE_LOCKED (403) elutasítást kap – bármilyen szerepkörrel és hellyel (seat) rendelkezzen is –, ha a szervezet licence nem tartalmazza a compliance-packs elemet. Az elutasítás megnevezi a funkciót és azt, hogy mi tartalmazza, valamint megmondja, ki tudja bekapcsolni.

A licenc állapota is számít. Amíg egy licenc érvényes vagy a figyelmeztetési időszakában van, a licenchez kötött funkciók működnek; a türelmi időszakban (grace) is tovább működnek, miközben megjelenik a LICENCE_IN_GRACE értesítés. Amint a licenc túllépi a türelmi időszakot, korlátozás lép életbe: a futó munkák és az olvasások folytatódnak, ahogy az exportálások és a biztonsági frissítések is, de a licenchez kötött funkciók alatt új elemek létrehozását a rendszer LICENCE_LOCKED kóddal elutasítja. A létrehozási útvonalait úgy építse fel, hogy számítsanak erre a válaszra.

Amikor a bővítménye megkérdezi a jogosultság-ellenőrzőtől, hogy egy szervezet rendelkezik-e egy adott funkcióval, egy ítéletet kap vissza, soha nem egy puszta logikai értéket (boolean). A „nem elérhető” és az „elérhető, és nem” két különböző tény, eltérő kódokkal: ENTITLEMENT_UNREACHABLE (502) és ENTITLEMENT_DENIED (403). Egy pillanatnyi elérhetőségi hiba soha nem minősíthet vissza csendben minden ügyfelet az ingyenes alapszintre.

Manifesztum és engedélyek
Manifesztum és engedélyek
A Manifesztum és engedélyek nézet összehasonlítja az új kiadás deklarációit az előzőével. Itt a 0.4.0-s verzió e-mail-küldést és egy külső címet ad hozzá, ezért a kiadás MANIFEST_SCOPE_WIDENED állapottal várakozik, amíg két felülvizsgáló és a megfelelőségi tisztviselő (compliance officer) jóvá nem hagyja.

A manifesztum rögzíti a szabályokat

Minden v2-es manifesztum tartalmaz egy architecture blokkot három kötelező mondattal, és az érvényesítő (validator) megköveteli a pontos megfogalmazásukat. Egy saját telepítésre készített bővítményben ezek így szólnak:

"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."
}

Ezeket a mondatokat a rendszer ellenőrzi. Egy olyan bővítmény, amelynek a manifesztuma elfogadta a törvényeket, miközben a kódja közvetlenül hívott meg egy modellszolgáltatót, hazudna a saját szerződésében – a kapuk pedig azért léteznek, hogy ezt a hazugságot kimutathatóvá tegyék.

Az egyes szabályokat kikényszerítő kapuk

Az SDK huszonkét megfelelőségi kaput (adherence gate) szállít egyetlen parancsként: nexus-gates. A 2.21. fejezet (A Plugin SDK) mindegyiket részletesen leírja. Itt az általuk betartatott szabályok szerint csoportosítva láthatók.

Szabály Kapuk Mi buktatja meg a buildet
Izoláció az útvonalrétegben scope-adherence, one-fence, rights-register, crud-adherence Hatókör-őr nélküli /api útvonal; egy második, kézzel írt bérlői predikátum; jogosultság nélküli hatókör-útvonal; olyan módosító útvonal, amelynek a jogosultsága nem nevez meg semmit
Izoláció az SQL-ben sql-fence, no-set-config Válaszfal nélküli utasítás egy hatókörhöz kötött táblán; a bérlői beállítást saját maga hozzákötő bővítménykód
Izoláció az adatbázisban migrations-are-scoped, rls-present, db-role-honest Tengelyt vagy bérlővel kezdődő kulcsot nélkülöző tábla; kötelező sorszintű biztonság nélküli tábla; tulajdonosként vagy szuperfelhasználóként csatlakozó kérési útvonal
Az egyetlen átlépés grants-declared Migrációkban engedélyezett olyan tábla, amelyet a manifesztum nem deklarál, vagy kézzel átadott jogosultságokkal rendelkező olvasási hely (read seat)
Számítási műveletek az UNO-n keresztül no-direct-compute Közvetlen lekérés modellszolgáltatóhoz vagy motorhoz, illetve várólistához vagy munkafolyamat-kiszolgálóhoz; az indítási URL második beolvasója
AI és kulcsok no-credentials Az adattárban vagy a környezetben olvasható modellszolgáltatói hitelesítő adat
A deklarált szerződés api-contract, platform-clients, declared-input Regisztrált, de nem deklarált, vagy deklarált, de nem regisztrált útvonal; importált, de meg nem nevezett platformkliens

Minden kapu rendelkezik egy önteszttel, amely bizonyítja, hogy megbukik egy kifejezetten a kiváltására épített tesztadaton (fixture). A npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test mindegyiket lefuttatja, és az a kapu, amelyik már nem bukik meg a saját tesztadatán, nem működik többé.

Mit érhet el egy alkalmazás
Mit érhet el egy alkalmazás
A Mit érhet el egy alkalmazás nézet felsorol minden olyan külső címet, amelyet egy alkalmazás deklarált, valamint azt, hogy a megfelelőségi tisztviselő jóváhagyta-e. A senki által nem deklarált címekre irányuló hívásokat a rendszer megállítja és számlálja, mielőtt bármilyen adat elhagyná a rendszert.

Mielőtt ellenőrzést (review) kérne

Ezt a listát járom végig, mielőtt megkérnék egy kollégát egy bővítmény felülvizsgálatára. Minden egyes sor olyan dolog, amit a Corrán Orbital valamelyik felülvizsgálója legalább egyszer már visszadobott nekem.

  1. Minden /api útvonal regisztrálja a hatókör-őrt, és az egyetlen névtelen útvonalak a pontos elérési úttal, allowAnonymous: true értékkel auth: public módon deklarált útvonalak.
  2. A hatókör-őr által kiszolgált minden útvonal megnevez egy right elemet a manifesztum regiszteréből, és egyetlen kezelő sem tartalmaz saját jogosultság-ellenőrzést.
  3. Egyetlen kezelő sem olvas ki szervezetet, személyt vagy egységet a törzsből, a lekérdezésből vagy fejlécből.
  4. A hatókörhöz kötött táblákon végrehajtott minden utasítás a withScopedTx belsejében lévő tenantFence elemen megy keresztül, és az adattárban (repository) semmi sem hívja meg a set_config függvényt.
  5. Minden tábla rendelkezik a három tengelyoszloppal, egy organization_id oszloppal kezdődő elsődleges kulccsal, valamint a bérlőt hordozó összetett idegen kulcsokkal.
  6. Az indítási URL beolvasása egyetlen fájlban történik, az indítási engedélyezési lista pedig névtérrel ellátott feladattípusok konstansa.
  7. A package.json fájlban semmi sem kommunikál modellszolgáltatóval, és a környezetben nem található kulcs.
  8. Minden olyan funkció, amelyet csak bizonyos licencek tartalmaznak, megnevezi a licence értékét az őt védő jogosultságon.
  9. A npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test zöld, és a npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json is.

Ha mind a kilenc teljesül, a felülvizsgálat a termékéről fog szólni, amire a felülvizsgáló idejét valójában fordítani kell.

Miért kényszeríti ki a platform ezeket a szabályokat

A fenti szabályok mindegyike valaha csupán konvenció volt valahol, és minden konvenció ugyanúgy vallott kudarcot: azok az útvonalak, amelyek emlékeztek rá, rendben voltak, az az egy pedig, amelyik elfelejtette, maga volt az incidens. Egy opcionális köztes szoftverként (middleware) alkalmazott üzletiegység-válaszfalat hat egymástól független módon kerültek meg, és mindegyik egy olyan útvonal volt, amely soha nem iratkozott fel rá. Egy környezeti változó, amely átírta a bérlői identitást, egy másik szervezet 1406 névjegyét szolgáltatta ki egy szervezetnek, és a felülvizsgálat során helyesnek tűnt, mert arra a podra nézve, amelyre írták, helyes is volt.

Ezért a platform oda helyezi a predikátumot, ahol minden felület eleve áthalad rajta: a hatókör-őrbe és a válaszfal-függvénybe, a tranzakció-burkolóba és a kötelező sorszintű biztonságba, valamint az indítókliensbe. Egy kapu ezután számbavesz minden útvonalat, utasítást és importálást, és megbuktatja a buildet, ha valamelyikük e mechanizmusok megkerülésével ér el egy hatókörhöz kötött táblát, modellt vagy számítási motort. Ennek a kialakításnak az az ára, hogy az első bővítménye korlátozottnak érződik. A hozadéka viszont az, hogy az ezredik bővítmény úgy lesz izolálva, hogy a szerzője nem is tud a funkció létezéséről, mert egyszerűen nincs más út az adatokhoz, amelyet választhatna.

Mindennek van egy őszinte korlátja. A kapuk azt bizonyítják, hogy a kódja áthalad a mechanizmusokon; azt nem tudják bizonyítani, hogy a terméklogikája helyes. Egy útvonal, amely helyesen korlátoz egy lekérdezést a tulajdonos soraira, ettől még mutathatja a rossz sorokat a megfelelő tulajdonosnak. A 2.22. fejezetben (A bővítmény futtatókörnyezete) található izolációs tesztkészlet minden útvonalat megtámad egy másik szervezetként és egy kollégaként is, sorra eltávolítva az egyes válaszfalakat – és ez az a teszt, amelyet lefuttatnék, mielőtt megbíznék a saját értelmezésemben a fentiek bármelyikét illetően.