Kirjaudu sisäänVaraa esittely

Luku 2.19

Säännöt, jotka jokainen laajennus perii

Eristys kolmella akselilla, laskenta UNOn kautta, tekoäly (AI) reitittimen kautta, organisaation omistamat avaimet ja lisenssitarkistukset. Mitä kukin sääntö tarkoittaa koodillesi, mikä portti valvoo sitä ja miksi perit sen sen sijaan, että kirjoittaisit sen itse.

Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

15 minuutin lukuaika

Ensimmäinen hylkäys, jonka poikkeamien tarkastukseen tehty liitännäiseni koskaan lähetti, tuli minulle itselleni. Olin kirjoittanut testiasiakasohjelman, joka lähetti uuden tarkastuksen ja sisällytti organisaation tunnisteen pyynnön runkoon vanhasta tottumuksesta toiselta alustalta, ja liitännäinen vastasi ennen kuin käsittelijäni ehti käynnistyä:

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

En ollut kirjoittanut kyseistä tarkistusta. Se tuli näkyvyysalueen vartijasta (scope guard), jonka SDK:n (ohjelmistokehityspaketin) mallipohja kytkee jokaiseen /api-reittiin, ja se laukeaa, vaikka rungossa oleva tunniste olisi kutsujan oma. Tämä on koko tämän luvun kaava: pieni määrä sääntöjä, joista jokaista valvoo perimäsi mekanismi ja joista jokaisella on portti, joka kaataa käännöksen, jos koodisi yrittää kiertää sen. Nexus-alustalla liitännäisesi perii eristyksensä alustalta, ja portit auditoivat sen.

Sääntöjä on viisi, ja alla olevat osiot käyvät ne läpi vuorotellen: eristys kolmella akselilla; laskenta, joka ajetaan vain UNO-välityksen kautta; tekoäly (AI, artificial intelligence), joka kulkee vain AI Provider Router -reitittimen kautta; organisaatiolle kuuluvat malliavaimet; sekä lisensoidut ominaisuudet, jotka tarkistetaan lisenssiä vasten. Jokainen manifesti myös toistaa niistä kolme yhdessä lauselohkossa.

Sääntö 1: eristys kolmella akselilla todennetusta pyynnöstä

Jokainen luku- ja kirjoitusoperaatio laajennuksessa rajataan kolmella akselilla, ja samoin jokainen työkalukutsu ja taitojen välitys (skill dispatch).

Akseli Sarake Vastaa kysymykseen Kuinka ehdoton raja on
Vuokraaja (Tenant) organization_id Mikä organisaatio Ehdoton raja, joka ylitetään vain kirjatulla vain luku -oikeudella
Omistaja owner_user_id Kuka henkilö organisaation sisällä Yksityinen jopa yhden organisaation sisällä kaikelle henkilökohtaiselle
Yksikkö business_unit_id Mikä organisaation osa Valinnainen aita vuokraajan (tenant) sisällä

Omistaja-akseli on se, jonka uudet tulokkaat ymmärtävät väärin. Sähköpostilaatikko on henkilökohtainen, ja niin on myös tallennettu näkymä tai yhden henkilön datasta johdettu graafi. Saman organisaation kaksi jäsentä, samassa yksikössä ja samassa roolissa, eivät näe toistensa omistajarajattuja rivejä. Organisaation artefaktissa, esimerkiksi hyväksynnässä tai tapauskirjauksessa, omistaja ilmaisee sen sijaan alkuperän: se kirjaa kuka toimi, ja lukuoikeudet rajataan vuokraajaan, jotta kirjausketju pysyy näkyvissä sitä tarvitseville henkilöille. Päätätte taulukohtaisesti, kummasta on kyse, ja tietovarastokerros (repository layer) koodaa sen – ei koskaan erikoistapauksena reitissä.

Akselit tulevat todennetusta pyynnöstä eivätkä mistään muualta. Ympäristömuuttuja ei voi tarjota niitä, eikä myöskään kyselyparametri, polun segmentti, asiakasohjelman otsake tai käännösvakio. SDK tekee vääränlaisen koodin kirjoittamisesta vaikeaa: funktiolla resolveScope(identity, options) ei ole lainkaan organisaatioparametria. Organisaatio on rakenteen identity sisällä, ja vain vahvistettu poletin (token) tuottaa sellaisen. Mitään kautta ei voi välittää tunnistetta.

Siksi pyynnön runko, joka nimeää vuokraajan, hylätään sen sijaan, että se jätettäisiin huomiotta. Vartija hylkää minkä tahansa viidestä kentän nimestä: orgId, organizationId, organization_id, tenant ja tenantId. Hiljaisesti huomiotta jätetty kenttä opettaa kutsujalle, että kenttä toimii. Ensimmäinen kutsuja testaa sitä ja näkee oman datansa; toinen lähettää toisen organisaation tunnisteen. Hylkääminen ensimmäisellä pyynnöllä tekee sopimuksen selväksi ennen kuin kukaan rakentaa väärän oletuksen varaan. Sama sääntö pätee välityksen inputParams-osioon: taidon syöte, joka sisältää organisaatiotunnisteen, hylätään välityksessä.

Yksikköakseli on joko määritelty ja pakotettu tai poissa käytöstä. Reitti, joka määrittelee needsUnit: true, hylkää pyynnön, kun valtuustieto ei selvitä yksikköä, jolloin unit nimetään kentässä missing[]. Älkää muodostako yksikköä aliverkkotunnuksesta tai otsakkeesta älkääkä käyttäkö oletusarvoa. Keksitty yksikkö rajaa datan eri tavalla kuin organisaation oikeat yksiköt ja yhdistää rivejä, joita sen ei pitäisi.

Rajapinta, joka ei pysty ilmaisemaan ehtoa, kieltäytyy

Jos reitti ei pysty sanomaan, mille vuokraajalle ja omistajalle rivi kuuluu, ja mille yksikölle silloin kun sellaista tarvitaan, se hylkää pyynnön. Organisaationlaajuista lukua ei ole vararatkaisuna eikä paikkamerkkiarvoa käytetä. Paikkamerkki on huonoin vaihtoehto, koska paikkamerkki on arvo ja arvot täsmäävät riveihin: työkalureititin, joka asetti sekä vuokraajan että käyttäjän oletusarvoksi merkkijonon 'unknown', tarjoili organisaationlaajuista dataa kenelle tahansa, joka sitä kutsui. Vuokraajarajalla ?? 'unknown' on virhe.

Hylkäyksellä on sama muoto kaikkialla alustalla, ja se sisältää riittävästi tietoa, jotta asiakasohjelma voi esittää korjausehdotuksen:

{
  "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 on aina true. code tulee alustan koodikatalogista. resolved[] nimeää akselit, jotka johdettiin, ja missing[] ne, joita reitti tarvitsi mutta ei saanut. troubleshooting[] kertoo, mikä asian varsinaisesti korjaisi. Pelkkä "forbidden" ei opeta kenellekään mitään.

Pitäkää 401 ja 403 erillään, sillä asiakasohjelmat reagoivat niihin eri tavoin.

Tila Merkitys Mitä asiakasohjelma tekee
401 Ei todennettu Kirjautuu sisään uudelleen
403 Todennettu, mutta pyyntöä ei voida rajata tai kutsujalta puuttuu oikeus Lopettaa uudelleenyritykset ja muuttaa pyyntöä

Näkyvyysalueen hylkäys, johon vastataan koodilla 401, ajaa asiakasohjelman kirjautumissilmukkaan, jota mikään kirjautuminen ei voi päättää: se heittää istunnon pois ja kirjautuu uudelleen, yrittää uudelleen ja saa jälleen koodin 401, samalla kun käyttäjä katselee latauskuvaketta loputtomiin.

Kaksi muuta mekanismia tekevät hylkäyksestä aukottoman. Käsittelijän sisällä scopeOf(req) on ainoa tapa lukea näkyvyysalue, ja se heittää poikkeuksen, jos vartijaa ei ajettu. Lisäksi vartija ajetaan rungon jäsentämisen jälkeen ja ennen mitään käsittelijää; käsittelijä, johon päästään käsiksi ilman predikaattia, vastaa tarkoituksella koodilla 500 ja virheellä MIDDLEWARE_ORDERING_ERROR, jotta se päätyy virhebudjettiinne poikkeamaraportin sijaan.

Tietokanta pitää saman linjan itsenäisesti

Koodiaita ja tietokanta-aita ovat kaksi mekanismia yhdelle laille, ja saatte molemmat.

Jokainen lauseke rajattua taulua vasten koostaa tenantFence(scope)-kutsun SDK:sta; ette koskaan kirjoita predikaattia käsin. Jokainen lauseke ajetaan myös withScopedTx-rakenteen sisällä, joka sitoo nuo kolme akselia kyseisen yksittäisen transaktion ajaksi yhden tietokantafunktion kautta ja hylkää toisen sidonnan (SCOPE_ALREADY_BOUND). Pinnan alla jokaisessa skeemanne taulussa on rivitason tietoturva (row-level security) pakotettuna päälle, eikä rooli, jolla pyyntöpolkunne yhdistää, voi itse muuttaa sidottua vuokraajaa. Prosessi, joka yhdistää roolilla, joka pystyy ohittamaan rivitason tietoturvan, kieltäytyy käynnistymästä virheellä DB_ROLE_BYPASSES_ISOLATION. Luku 2.22, Liitännäisen ajonaikainen ympäristö, näyttää koodin; luku 2.21, Liitännäisen SDK, näyttää, kuinka roolit muodostetaan puolestanne.

Ainoa ylitys: kirjattu valtuutus

Vuokraajarajan yli on täsmälleen yksi reitti. Rivejä hallussaan pitävä organisaatio kirjaa luvan, joka nimeää, mikä organisaatio saa lukea mitäkin tauluja, minkä sopimuksen nojalla ja kuinka kauan. Tietokanta tekee lukuoperaatiosta vain luku -muotoisen, ja jokainen katselukerta kirjataan ennen lukua molemmissa organisaatioissa vain tunnisteen perusteella. Kirjoitusoperaatiot eivät koskaan ylitä rajaa; toiselle yritykselle luovutettu työ kulkee viestinä. Omistaja- ja pääkäyttäjäroolit eivät koskaan lue rajan yli lainkaan, ja manifesti hylätään, jos organisaatioiden välisen luvun salliva oikeus ei sulje niitä pois. Liitännäinen, joka haluaa toisen reitin rajan yli, ei sellaista saa.

Sääntö 2: kaikki laskenta suoritetaan UNO-välityksen kautta

UNO, työnkulkumoottori, on ainoa laskentapolku. Koodinne ei koskaan kutsu mallintarjoajaa tai moottoria suoraan, eikä myöskään jonoa tai työnkulkupalvelinta. Lähetätte yhden kirjekuoren (envelope) välityspäätepisteeseen ja saatte takaisin 202-vastauksen tunnisteineen; tulos saapuu kyselyllä (polling) tai takaisinkutsulla (callback).

Tästä seuraa kolme käytäntöä, ja mallipohjassa on jo ne kaikki kolme.

  • Yksi tiedosto omistaa välitys-URL-osoitteen. UNO_DISPATCH_URL luetaan kerran konfiguraation lataajassa, ja sen on oltava klusterin sisäinen osoite. Julkinen osoite hylätään käynnistyksen yhteydessä, koska mikään ei poistu asennuksesta.
  • Yksi suljettu sallittujen lista sille, mitä tämä pinta saa välittää. Taustajärjestelmä, joka välittää minkä tahansa selaimen sille antaman taitotunnisteen, toimii yleiskäyttöisenä välityspalvelimena jokaiselle rekisterin taidolle, mukaan lukien muiden liitännäisten taidot ja taidot, jotka kuluttavat jonkun toisen mallibudjettia. Lista on moduulitason vakio nimiavaruudellisista työtyypeistä, ei koskaan ympäristömuuttuja. Tunniste, joka ei ole listalla, hylätään virheellä SKILL_NOT_ALLOWED.
  • Tarkistakaa uudelleen se, mikä tulee takaisin. Kun luette työn takaisin, SDK:n asiakasohjelma vertaa palautetun rivin organization_id-arvoa kutsujan vuokraajaan verkkokutsun teidän puolellanne. Aita, joka on olemassa vain kutsun toisella puolella, on pelkkä käytäntö.

Sääntö 3: kaikki tekoäly kulkee tekoälyn Provider Routerin kautta

Liitännäinen ei tee kutsuja malliin missään. Tiedostossa package.json ei ole palveluntarjoajan SDK:ta, ympäristössä ei ole malliavainta eikä välityskanavaa (relay) ole. Reititin yksin pitää hallussaan organisaation palveluntarjoajan valtuustietoja ja tekee lopullisen päätöksen palveluntarjoajasta ja mallista.

Liitännäinen voi sen sijaan esittää toiveita rekisteröintihetkellä manifestin taidon rekisteririvillä:

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

Reititin toteuttaa toiveen vain, kun organisaatio on ottanut kyseisen palveluntarjoajan käyttöön ja asettanut sille valtuustiedot. Muussa tapauksessa se korvaa sen organisaation omasta varannosta. capabilityProfile ei koskaan valitse; se suodattaa, ja sen dataResidency-kenttä on ehdoton lainkäyttöalueen rajoite, jonka reititin joko täyttää tai hylkää. Kaikkien näiden pois jättäminen on oikea oletusarvo useimmille taidoille: tällöin organisaation omat roolimääritykset päättävät, ja organisaatio on se, joka maksaa.

Takaisin tulee kahdenlaisia hylkäyksiä, ja ne tarkoittavat hyvin eri asioita.

Koodi Tila Mitä se tarkoittaa
MISSING_CALLER_IDENTITY, UNAUTHORIZED_CALLER 403 Koodinne yritti kutsua reititintä itse. Lopettakaa: tämä on rajapinta, joka hylkää pyynnön suunnitellusti, eikä sitä voi yrittää uudelleen
MODEL_CAPABILITY_UNAVAILABLE 422 Yhdelläkään käyttöön otetulla palveluntarjoajalla ei ole profiilia vastaavaa mallia. Lieventäkää profiilia, tai organisaatio ottaa käyttöön kykenevän palveluntarjoajan
NO_PROVIDER_FOR_ROLE 422 Organisaatio ei ole määrittänyt reititystä tälle roolille. Näyttäkää reitittimen korjausohjeteksti käyttäjälle

Jälkimmäinen pari kuuluu näytölle, ei lokiin. Oletusmallia ja varapalveluntarjoajaa ei ole: rooli, jota organisaatio ei ole määrittänyt, epäonnistuu näkyvästi lauseella, joka kertoo, mitä pitää määrittää.

Ainoa lukuoperaatio, jonka liitännäinen saa tehdä reitittimeen, on effectiveRoute() paketista runtime/ai-route. Se vastaa, minkä palveluntarjoajan ja mallin reititin valitsisi sisäänkirjautuneelle organisaatiolle lähettämättä tekoälypyyntöä, ja se palauttaa reitittimen hylkäyksen sanallisesti, kun mallia ei ole. Luku 2.22, Liitännäisen ajonaikainen ympäristö, näyttää sen.

Luottamusportaat lisäävät vielä yhden rajan. Vain core- ja verified-liitännäiset saavat määritellä ne kaksi manifestin taitotasoa, jotka saavuttavat reitittimen, eli tool_using ja llm_only. Kaikki muut välittävät determinististä työtä ja antavat alustan hoitaa mallia kutsuvan osan.

Sääntö 4: avaimet kuuluvat organisaatiolle

Jokainen organisaatio tuo oman palveluntarjoajatilinsä ja avaimensa ja maksaa oman laskunsa. Avain sijaitsee organisaation tekoälypalveluntarjoajien varannossa, jota sen omat pääkäyttäjät hallinnoivat konsolista, ja reititin selvittää sen kutsuhetkellä. Vuokraajan takana ei ole jaettua alusta-avainta, joten mikään organisaatio ei kuluta toisen budjettia.

Laajennukselle tämä tarkoittaa kolmea asiaa.

  • Ette koskaan pidä hallussanne malliavainta, olipa kyseessä koodi, konfiguraatio tai salaisuuksien säilö. no-credentials-portti kaataa käännöksen, jos sellainen on luettavissa, ja konfiguraation lataaja kieltäytyy käynnistymästä, jos sellainen on läsnä.
  • Ette koskaan luettele organisaation avaimia. Jos liitännäisenne luulee tarvitsevansa sitä, vaatimus on väärässä paikassa.
  • Organisaatio, jolla ei ole avainta, ei saa tekoälyvastauksia. Se on odotettu tila, jolle kuuluu oikea näkymä. Nimetkää puuttuva rooli ja lainatkaa korjausohjetta, ja ohjatkaa sitten käyttäjä palveluntarjoajan asetuksiin. Älkää esittäkö sitä tyhjänä tuloksena.

Sääntö 5: lisensoidut ominaisuudet tarkistetaan lisenssiä vasten

Se, mitä asennus saa käyttää Community-perustason lisäksi, tulee yhdestä paikasta: Adverantin allekirjoittamasta lisenssiasiakirjasta, joka vahvistetaan asennuksessa vain julkisilla avaimilla. Laajennuksenne ei koskaan tee päätöstä minkään heikomman tiedon perusteella, kuten poletissa olevan tilaustason nimen tai konfiguraatiossa olevan lipun perusteella.

Liitännäisessä yksinkertaisin tapa sitoa ominaisuus lisenssiin on tehdä se oikeudessa, joka vartioi sitä. Oikeus manifestin rights-rekisterissä voi nimetä licence-ominaisuuden:

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

Kuka tahansa, joka kutsuu kyseisen oikeuden vartioimaa reittiä, hylätään koodilla LICENCE_LOCKED (403) riippumatta siitä, mitä rooleja ja käyttöoikeuspaikkoja hänellä on, kun organisaation lisenssi ei sisällä ominaisuutta compliance-packs. Hylkäys nimeää ominaisuuden ja sen, mikä sen sisältää, ja kertoo, kuka voi kytkeä sen päälle.

Myös lisenssin tilalla on merkitystä. Kun lisenssi on voimassa tai varoitusikkunassaan, lisensoidut ominaisuudet toimivat, ja ne jatkavat toimintaansa lisäajalla (grace), jolloin lisäaika näyttää ilmoituksen LICENCE_IN_GRACE. Kun lisenssi on ohittanut lisäajan, se rajoittaa toimintaa: käynnissä oleva työ ja lukuoperaatiot jatkuvat, samoin viennit ja tietoturvapäivitykset, mutta uuden luominen lisensoidun ominaisuuden alaisuudessa hylätään koodilla LICENCE_LOCKED. Rakentakaa luontipolkunne odottamaan tätä vastausta.

Kun liitännäisenne kysyy oikeutustarkistukselta (entitlement check), onko organisaatiolla jokin ominaisuus, se saa päätöksen, ei koskaan pelkkää totuusarvoa. "Ei tavoitettavissa" ja "tavoitettavissa ja ei" ovat eri tosiasioita eri koodeilla: ENTITLEMENT_UNREACHABLE (502) ja ENTITLEMENT_DENIED (403). Hetkellinen yhteyskatkos ei saa koskaan hiljaisesti pudottaa jokaista asiakasta ilmaiselle perustasolle.

Manifesti ja käyttöoikeudet
Manifesti ja käyttöoikeudet
Manifesti ja käyttöoikeudet -näkymä vertaa sitä, mitä julkaisu määrittelee, edelliseen julkaisuun. Tässä versio 0.4.0 lisää sähköpostin lähetyksen ja yhden ulkoisen osoitteen, joten julkaisu pidätetään tilassa MANIFEST_SCOPE_WIDENED, kunnes kaksi tarkastajaa ja vaatimustenmukaisuusvastaava (compliance officer) hyväksyvät sen.

Manifesti vahvistaa säännöt uudelleen

Jokainen v2-manifesti sisältää architecture-lohkon, jossa on kolme pakollista lausetta, ja validaattori kiinnittää niiden sanamuodon. Liitännäisessä, jonka rakennatte omaa asennustanne varten, ne kuuluvat:

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

Nämä lauseet tarkistetaan. Liitännäinen, jonka manifesti sitoutuisi lakeihin samalla kun sen koodi kutsuisi suoraan mallintarjoajaa, valehtelisi omassa sopimuksessaan, ja portit ovat olemassa, jotta valhe voidaan havaita.

Portit, jotka valvovat kutakin sääntöä

SDK toimittaa kaksikymmentäkaksi vaatimustenmukaisuusporttia yhtenä komentona, nexus-gates. Luku 2.21, Liitännäisen SDK, kuvaa niistä jokaisen. Tässä ne on ryhmitelty sen säännön mukaan, jota ne valvovat.

Sääntö Portit Mikä kaataa käännöksen
Eristys reittikerroksessa scope-adherence, one-fence, rights-register, crud-adherence /api-reitti ilman näkyvyysalueen vartijaa, toinen käsin kirjoitettu vuokraajapredikaatti, näkyvyysaluereitti ilman oikeutta, muokkaava reitti jonka oikeus ei nimeä mitään
Eristys SQL:ssä sql-fence, no-set-config Lauseke rajattuun tauluun ilman aitaa; liitännäisen koodi, joka sitoo vuokraaja-asetuksen itse
Eristys tietokannassa migrations-are-scoped, rls-present, db-role-honest Taulu josta puuttuu akseli tai vuokraajalla alkava avain, taulu ilman pakotettua rivitason tietoturvaa, pyyntöpolku joka yhdistää omistajana tai pääkäyttäjänä (superuser)
Ainoa rajanylitys grants-declared Migraatioissa myönnetty taulu jota manifesti ei määrittele, tai lukuoikeuspaikka jolle on annettu oikeuksia käsin
Laskenta UNO:n kautta no-direct-compute Suora haku mallintarjoajalle tai moottorille tai jonolle tai työnkulkupalvelimelle; välitys-URL-osoitteen toinen lukija
Tekoäly ja avaimet no-credentials Mallintarjoajan valtuustieto, joka on luettavissa koodivarastossa tai ympäristössä
Määritelty sopimus api-contract, platform-clients, declared-input Reitti joka on rekisteröity mutta ei määritelty, tai määritelty mutta ei rekisteröity; alusta-asiakasohjelma joka on tuotu (imported) mutta ei nimetty

Jokaisella portilla on itsetesti, joka todistaa sen epäonnistuvan testiaineistolla (fixture), joka on rakennettu laukaisemaan se. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test ajaa ne kaikki, ja portti, joka ei enää epäonnistu omalla testiaineistollaan, on lakannut toimimasta.

Mihin sovellus saa ottaa yhteyden
Mihin sovellus saa ottaa yhteyden
Mihin sovellus saa ottaa yhteyden -näkymä listaa jokaisen ulkoisen osoitteen, jonka sovellus on määritellyt, ja sen, onko vaatimustenmukaisuusvastaava hyväksynyt sen. Kutsu osoitteeseen, jota kukaan ei ole määritellyt, pysäytetään ja lasketaan ennen kuin mitään lähtee ulos.

Ennen kuin pyydät katselmointia

Tämä on lista, jonka käyn läpi ennen kuin pyydän kollegaa tarkastamaan liitännäisen. Jokainen rivi on asia, jonka Corrán Orbitalin tarkastaja on palauttanut minulle vähintään kerran.

  1. Jokainen /api-reitti rekisteröi näkyvyysalueen vartijan, ja ainoat anonyymit reitit ovat tarkkoja polkuja, jotka on määritelty arvolla auth: public asetuksella allowAnonymous: true.
  2. Jokainen reitti, jota näkyvyysalueen vartija palvelee, nimeää right-oikeuden manifestin rekisteristä, eikä mikään käsittelijä sisällä omaa oikeustarkistustaan.
  3. Mikään käsittelijä ei lue organisaatiota, henkilöä tai yksikköä rungosta, kyselystä tai otsakkeesta.
  4. Jokainen lauseke rajatussa taulussa kulkee tenantFence-funktion kautta withScopedTx-rakenteen sisällä, eikä mikään koodivarastossa kutsu funktiota set_config.
  5. Jokaisessa taulussa on kolme akselisaraketta, pääavain joka alkaa sarakkeella organization_id, sekä yhdistetyt viiteavaimet jotka sisältävät vuokraajan.
  6. Välitys-URL-osoite luetaan yhdessä tiedostossa, ja välityksen sallittujen lista on vakio nimiavaruudellisista työtyypeistä.
  7. Mikään tiedostossa package.json ei keskustele mallintarjoajan kanssa, eikä ympäristössä ole yhtäkään avainta.
  8. Jokainen ominaisuus, joka sisältyy vain osaan lisensseistä, nimeää licence-arvonsa sitä vartioivassa oikeudessa.
  9. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test on vihreä, ja niin on myös npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json.

Jos kaikki yhdeksän pitävät paikkansa, tarkastus koskee tuotettanne, mihin tarkastajan ajan kuuluukin mennä.

Miksi alusta valvoo näitä sääntöjä

Jokainen yllä oleva sääntö oli kerran pelkkä käytäntö jossakin, ja jokainen käytäntö epäonnistui samalla tavalla: reitit, jotka muistivat sen, toimivat oikein, ja se yksi, joka unohti sen, aiheutti poikkeaman. Liiketoimintayksikön aita, jota sovellettiin valinnaisena väliohjelmistona (middleware), ohitettiin kuudella toisistaan riippumattomalla tavalla, joista jokainen oli reitti, joka ei koskaan ottanut sitä käyttöön. Ympäristömuuttuja, joka kirjoitti vuokraajan identiteetin yli, tarjoili yhdelle organisaatiolle toisen organisaation 1 406 yhteystietoa, ja se näytti tarkastuksessa oikealta, koska se oli oikein sille podille, jota varten se oli kirjoitettu.

Niinpä alusta sijoittaa predikaatin sinne, mistä jokainen pinta jo valmiiksi kulkee läpi: näkyvyysalueen vartijaan ja aitafunktioon, transaktiokääreeseen ja pakotettuun rivitason tietoturvaan sekä välitysasiakasohjelmaan. Portti luettelee sen jälkeen jokaisen reitin ja lausekkeen sekä jokaisen tuonnin (import) ja kaataa käännöksen, kun jokin niistä ottaa yhteyden rajattuun tauluun, malliin tai laskentamoottoriin kulkematta näiden mekanismien kautta. Tämän suunnittelun hintana on se, että ensimmäinen liitännäisenne tuntuu rajoitetulta. Hyötynä on se, että tuhannes liitännäinen on eristetty ilman, että sen tekijä edes tietää ominaisuuden olemassaolosta, koska datalle ei ole olemassa mitään muuta polkua.

Tällä kaikella on rehellinen rajansa. Portit todistavat, että koodinne kulkee mekanismien kautta; ne eivät voi todistaa, että tuotelogiikkanne on oikein. Reitti, joka rajaa kyselyn oikein omistajan riveihin, voi silti näyttää väärät rivit oikealle omistajalle. Eristystestipaketti luvussa 2.22, Liitännäisen ajonaikainen ympäristö, hyökkää jokaiseen reittiin toisena organisaationa ja kollegana poistaen jokaisen aidan vuorollaan, ja se on testi, jonka ajaisin ennen kuin luottaisin omaan tulkintaani mistään tästä.