IdħolIbbukkja laqgħa informattiva

Kapitlu 2.19

Ir-regoli li tiret kull estensjoni

Iżolament fuq tliet assi, komputazzjoni permezz ta' UNO, IA (intelliġenza artifiċjali) permezz tar-router, ċwievet proprjetà tal-organizzazzjoni u kontrolli tal-liċenzja. Xi tfisser kull regola għall-kodiċi tiegħek u liema gate tinforzaha, u għaliex tiritha minflok ma tiktibha.

Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

15 minuti qari

L-ewwel rifjut li l-plugin tiegħi għar-reviżjoni tal-anomaliji qatt bagħat kien lili. Kont ktibt klijent tat-test li bagħat reviżjoni ġdida bl-id tal-organizzazzjoni fil-body, bil-vizzju minn pjattaforma oħra, u l-plugin wieġeb qabel ma ħadem il-handler tiegħi:

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

Ma kontx ktibt dik il-verifika jien. Ġiet mal-protezzjoni tal-ambitu (scope guard) li l-mudell tal-SDK (software development kit) jgħaqqad ma' kull rotta /api, u tiskatta anke meta l-id fil-body ikun dak ta' min qed jagħmel is-sejħa stess. Dak hu l-mudell għal dan il-kapitlu kollu: numru żgħir ta' regoli, kull waħda infurzata minn mekkaniżmu li tiret, kull waħda b'gate li jfalli l-build tiegħek jekk il-kodiċi tiegħek idur magħha. Fuq Nexus il-plugin tiegħek jiret l-iżolament tiegħu mill-pjattaforma, u l-gates jawditjawh.

Hemm ħames regoli, u t-taqsimiet t'hawn taħt jeħduhom waħda waħda: iżolament fuq tliet assi; komputazzjoni li taħdem biss permezz ta' UNO dispatch; IA (intelliġenza artifiċjali) li tgħaddi biss mill-AI Provider Router; ċwievet tal-mudelli li jappartjenu lill-organizzazzjoni; u karatteristiċi liċenzjati vverifikati mal-liċenzja. Kull manifest jerġa' jiddikjara wkoll tlieta minnhom fi blokk wieħed ta' sentenzi.

Regola 1: iżolament fuq tliet assi, mit-talba awtentikata

Kull qari u kitba f'estensjoni huma limitati fl-ambitu fuq tliet assi, u l-istess kull sejħa ta' għodda u kull dispatch ta' ħila.

Assi Kolonna iwieġeb Kemm hi iebsa l-linja
Inkwilin organization_id Liema organizzazzjoni Konfini iebsa, li tinqabeż biss permezz ta' konċessjoni rreġistrata għall-qari biss
Sid owner_user_id Liema persuna ġewwa l-organizzazzjoni Privata anke ġewwa organizzazzjoni waħda, għal kull ħaġa personali
Unità business_unit_id Liema parti mill-organizzazzjoni Ilqugħ fakultattiv ġewwa tenant

L-assi tas-sid (owner) huwa dak li l-ġodda jiżbaljaw fih. Kaxxa tal-ittri hija personali, u l-istess hija dehra ssejvjata jew graff imnebbaħ mid-dejta ta' persuna waħda. Żewġ membri tal-istess organizzazzjoni, fl-istess unità bl-istess rwol, ma jarawx ir-ringieli limitati għas-sid ta' xulxin. Fuq artefatt tal-organizzazzjoni, approvazzjoni jew rekord ta' każ pereżempju, is-sid huwa minflok provenjenza: jirreġistra min aġixxa, u l-qari huwa limitat għat-tenant sabiex ir-rekord tal-awditjar jibqa' viżibbli għan-nies li għandhom bżonnu. Inti tiddeċiedi għal kull tabella liema tip hu, u s-saff tar-repożitorju jikkodifikah, qatt bħala każ speċjali f'rotta.

L-assi jiġu mit-talba awtentikata u minn imkien ieħor. Varjabbli tal-ambjent ma jistax jipprovdihom, u lanqas parametru ta' tfittxija, segment tal-mogħdija, header tal-klijent jew kostanti tal-build. L-SDK jagħmilha diffiċli li tikteb il-ħaġa l-ħażina: resolveScope(identity, options) m'għandu l-ebda parametru tal-organizzazzjoni. L-organizzazzjoni tinsab ġewwa identity, u token ivverifikat biss jipproduċi wieħed. M'hemm xejn minn fejn tgħaddi id.

Huwa għalhekk li body li jsemmi t-tenant jiġi rrifjutat minflok injorat. Il-guard jirrifjuta kwalunkwe wieħed minn ħames ismijiet ta' oqsma: orgId, organizationId, organization_id, tenant u tenantId. Qasam injorat fis-skiet jgħallem lil min qed jgħajjat li l-qasam jaħdem. L-ewwel wieħed li jgħajjat jittestjah u jara d-dejta tiegħu stess; it-tieni wieħed jibgħat l-id ta' organizzazzjoni differenti. Ir-rifjut mal-ewwel talba jsemmi l-kuntratt qabel ma xi ħadd jibni fuq dak ħażin. L-istess regola tgħodd għall-inputParams ta' dispatch: input ta' ħila li jġorr id ta' organizzazzjoni jiġi rrifjutat waqt id-dispatch.

L-assi tal-unità jew jiġi ddikjarat u infurzat jew ma jintużax. Rotta li tiddikjara needsUnit: true tirrifjuta meta l-kredenzjali ma tirriżolvix unità, b'unit imsemmi f'missing[]. Tissintetizzax unità minn sottodominju jew header, u tissettjax waħda b'mod awtomatiku. Unità ivvintata tagħmel ilqugħ b'mod differenti mill-unitajiet reali tal-organizzazzjoni, u tgħaqqad ringieli li m'għandhiex tgħaqqad.

Wiċċ li ma jistax jesprimi l-predikat jirrifjuta

Jekk rotta ma tistax tgħid għal liema tenant u sid tappartjeni ringiela, u liema unità meta jkollha bżonn waħda, tirrifjuta. M'hemm l-ebda qari fuq livell ta' organizzazzjoni bħala riżerva u l-ebda valur segnapost (placeholder). Segnapost huwa l-agħar għażla, għax segnapost huwa valur u l-valuri jaqblu mar-ringieli: tool router li ssettja b'mod awtomatiku kemm it-tenant kif ukoll l-utent għall-istring 'unknown' serva dejta tal-organizzazzjoni kollha lil kull min sejjaħlu. Fuq konfini ta' tenant, ?? 'unknown' huwa difett.

Ir-rifjut għandu forma waħda kullimkien fuq il-pjattaforma, u jġorr biżżejjed biex klijent juri t-tiswija:

{
  "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 huwa dejjem true. code ġej mill-katalgu tal-kodiċijiet tal-pjattaforma. resolved[] isemmi l-assi li ġew derivati u missing[] dawk li r-rotta kellha bżonn u ma setgħetx tikseb. troubleshooting[] jgħid x'inhu dak li fil-fatt isewwiha. Sempliċi "forbidden" ma jgħallem xejn lil ħadd.

Żomm 401 u 403 separati, għax il-klijenti jaġixxu fuqhom b'mod differenti.

Stat Tifsira X'jagħmel il-klijent
401 Mhux awtentikat Jiffirma mill-ġdid
403 Awtentikat, iżda t-talba ma tistax tiġi limitata fl-ambitu, jew min qed jgħajjat m'għandux id-dritt Jieqaf jipprova mill-ġdid u jibdel it-talba

Rifjut tal-ambitu mwieġeb bħala 401 jibgħat klijent f'ċiklu ta' dħul li l-ebda dħul ma jista' jwaqqaf: jarmi s-sessjoni u jidħol mill-ġdid, jerġa' jipprova u jerġa' jikseb 401, filwaqt li l-persuna toqgħod tħares lejn ikona ddur għal dejjem.

Żewġ mekkaniżmi oħra jagħmlu r-rifjut totali. Ġewwa handler, scopeOf(req) huwa l-uniku mod kif taqra l-ambitu, u jarmi żball jekk il-guard ma ħadimx. U l-guard jaħdem wara l-analiżi tal-body u qabel kwalunkwe handler; handler li jsir aċċessibbli mingħajr il-predikat iwieġeb 500 b'MIDDLEWARE_ORDERING_ERROR, apposta, sabiex jispiċċa fil-baġit tal-iżbalji tiegħek minflok f'rapport ta' inċident.

Id-database iżżomm l-istess linja waħedha

L-ilqugħ tal-kodiċi u l-ilqugħ tad-database huma żewġ mekkaniżmi għal liġi waħda, u inti tikseb it-tnejn.

Kull dikjarazzjoni kontra tabella b'ambitu limitat tikkomponi tenantFence(scope) mill-SDK; inti qatt ma tikteb il-predikat bl-idejn. Kull dikjarazzjoni taħdem ukoll ġewwa withScopedTx, li jorbot it-tliet assi għal dik it-tranżazzjoni waħda permezz ta' funzjoni waħda tad-database u jirrifjuta t-tieni rabta (SCOPE_ALREADY_BOUND). Taħt, kull tabella fl-iskema tiegħek għandha sigurtà fil-livell tar-ringiela infurzata, u r-rwol li l-mogħdija tat-talba tiegħek tikkonnettja bħalu ma jistax jibdel it-tenant marbut huwa stess. Proċess li jikkonnettja bħala rwol li kapaċi jaqbeż is-sigurtà fil-livell tar-ringiela jirrifjuta li jibda b'DB_ROLE_BYPASSES_ISOLATION. Kapitlu 2.22, The plugin runtime, juri l-kodiċi; kapitlu 2.21, The Plugin SDK, juri kif ir-rwoli jiġu ġġenerati għalik.

L-uniku qsim: għotja rreġistrata

Hemm eżattament mod wieħed kif taqsam il-konfini tat-tenant. L-organizzazzjoni li żżomm ir-ringieli tirreġistra konċessjoni li ssemmi liema organizzazzjoni tista' taqra liema tabelli, taħt liema ftehim u għal kemm żmien. Id-database tagħmel il-qari għall-qari biss, u kull ħarsa tinkiteb qabel il-qari, fiż-żewġ organizzazzjonijiet, bl-id biss. Il-kitbiet qatt ma jaqsmu; xogħol mgħoddi lil ditta oħra jivvjaġġa bħala messaġġ. Ir-rwoli ta' sid u amministratur qatt ma jaqraw lil hinn mill-konfini, u l-manifest jiġi rrifjutat jekk id-dritt li jippermetti qari bejn l-organizzazzjonijiet ma jimblokkahomx. Plugin li jrid mod ieħor kif jaqsam ma jikseb l-ebda wieħed.

Regola 2: il-komputazzjoni kollha taħdem permezz ta' UNO dispatch

UNO, il-magna tal-fluss tax-xogħol, hija l-unika mogħdija tal-komputazzjoni. Il-kodiċi tiegħek qatt ma jsejjaħ fornitur ta' mudell jew magna direttament, u lanqas kju jew host tal-fluss tax-xogħol. Inti tibgħat envelope wieħed lill-endpoint tad-dispatch u tikseb 202 b'identifikaturi lura; ir-riżultat jasal permezz ta' polling jew callback.

Minn dan joħorġu tliet drawwiet, u l-mudell diġà għandu t-tlieta li huma.

  • Fajl wieħed huwa s-sid tal-URL tad-dispatch. UNO_DISPATCH_URL jinqara darba fil-config loader u jrid ikun indirizz ġewwa l-cluster. Wieħed pubbliku jiġi rrifjutat mal-bidu, għax xejn ma joħroġ mill-installazzjoni.
  • Allow-list waħda magħluqa ta' dak li dan il-wiċċ jista' jibgħat (dispatch). Backend li jibgħat kwalunkwe id ta' ħila li browser jagħtih huwa proxy għal skop ġenerali għal kull ħila fir-reġistru, inklużi ħiliet ta' plugins oħra u ħiliet li jonfqu l-baġit tal-mudell ta' ħaddieħor. Il-lista hija kostanti fil-livell tal-modulu ta' tipi ta' xogħol bin-namespace, qatt varjabbli tal-ambjent. Id li mhux fuqha jiġi rrifjutat b'SKILL_NOT_ALLOWED.
  • Erġa' vverifika dak li jiġi lura. Meta taqra xogħol lura, il-klijent tal-SDK iqabbel l-organization_id tar-ringiela rritornata mat-tenant ta' min qed jgħajjat fuq in-naħa tiegħek tas-sejħa tan-netwerk. Ilqugħ li jeżisti biss fuq in-naħa l-oħra ta' sejħa huwa konvenzjoni.

Regola 3: l-IA kollha tgħaddi mir-Router tal-Fornituri tal-IA

Plugin ma jagħmel l-ebda sejħa lil mudell, imkien. M'hemm l-ebda SDK tal-fornitur f'package.json, l-ebda ċavetta tal-mudell fl-ambjent u l-ebda relay. Ir-router waħdu jżomm il-kredenzjali tal-fornitur tal-organizzazzjoni u jieħu d-deċiżjoni finali dwar il-fornitur u l-mudell.

Dak li plugin jista' jagħmel huwa li jesprimi xewqat, fil-ħin tar-reġistrazzjoni, fuq ir-ringiela tar-reġistru tal-ħila tal-manifest:

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

Ir-router jonora xewqa biss meta l-organizzazzjoni jkollha dak il-fornitur attivat u bil-kredenzjali. Inkella jissostitwixxi, mill-pool tal-organizzazzjoni stess. capabilityProfile qatt ma jagħżel; jiffiltra, u l-qasam dataResidency tiegħu huwa restrizzjoni ġurisdizzjonali iebsa li r-router jissodisfa jew jirrifjuta. Li tħalli dawn kollha barra hija l-għażla awtomatika t-tajba għall-biċċa l-kbira tal-ħiliet: l-assenjazzjonijiet tar-rwoli tal-organizzazzjoni stess imbagħad jiddeċiedu, u l-organizzazzjoni hija dik li qed tħallas.

Jiġu lura żewġ tipi ta' rifjut, u jfissru affarijiet differenti ħafna.

Kodiċi Stat Xi tfisser
MISSING_CALLER_IDENTITY, UNAUTHORIZED_CALLER 403 Il-kodiċi tiegħek ipprova jsejjaħ lir-router innifsu. Ieqaf: din hija l-konnessjoni li qed tirrifjuta b'disinn, u ma tistax terġa' tiġi ppruvata
MODEL_CAPABILITY_UNAVAILABLE 422 L-ebda fornitur attivat m'għandu mudell li jissodisfa l-profil. Illaxka l-profil, jew l-organizzazzjoni tattiva fornitur kapaċi
NO_PROVIDER_FOR_ROLE 422 L-organizzazzjoni ma kkonfiguratx ir-routing għal dan ir-rwol. Uri t-test ta' rimedju tar-router lill-persuna

It-tieni par jappartjeni fuq l-iskrin, mhux f'log. M'hemm l-ebda mudell awtomatiku u l-ebda fornitur ta' riżerva: rwol li l-organizzazzjoni ma waqqfitx ifalli b'mod ċar, b'sentenza li tgħid x'għandu jiġi kkonfigurat.

L-uniku qari li plugin jista' jagħmel mir-router huwa effectiveRoute() minn runtime/ai-route. Iwieġeb liema fornitur u mudell ir-router jagħżel għall-organizzazzjoni li tkun daħlet mingħajr ma jibgħat talba tal-IA, u jirritorna r-rifjut tar-router fi kliem meta ma jkunx hemm mudell. Kapitlu 2.22, The plugin runtime, jurih.

Is-sellum tal-fiduċja jżid linja oħra. Il-plugins core u verified biss jistgħu jiddikjaraw iż-żewġ livelli ta' ħiliet tal-manifest li jilħqu r-router, tool_using u llm_only. Kulħadd ieħor jimmedja xogħol deterministiku u jħalli lill-pjattaforma tagħmel il-parti li tilħaq il-mudell.

Regola 4: iċ-ċwievet jappartjenu lill-organizzazzjoni

Kull organizzazzjoni ġġib il-kont u ċ-ċavetta tal-fornitur tagħha stess, u tħallas il-kont tagħha stess. Iċ-ċavetta tgħix fil-pool tal-fornituri tal-IA tal-organizzazzjoni, immaniġġjata mill-amministraturi tagħha stess mill-console, u r-router jirriżolviha fil-ħin tas-sejħa. M'hemm l-ebda ċavetta tal-pjattaforma kondiviża wara tenant, għalhekk l-ebda organizzazzjoni ma tonfoq il-baġit ta' oħra.

Għal estensjoni dan ifisser tliet affarijiet.

  • Inti qatt ma żżomm ċavetta ta' mudell, kemm fil-kodiċi kif ukoll fil-konfigurazzjoni jew f'maħżen tas-sigrieti. Il-gate no-credentials ifalli l-build jekk waħda tkun tista' tinqara, u l-config loader jirrifjuta li jibda jekk waħda tkun preżenti.
  • Inti qatt ma telenka ċ-ċwievet ta' organizzazzjoni. Jekk il-plugin tiegħek jaħseb li għandu bżonn jagħmel dan, ir-rekwiżit qiegħed fil-post il-ħażin.
  • Organizzazzjoni mingħajr ċavetta ma tikseb l-ebda tweġiba tal-IA. Dak huwa stat mistenni bi skrin reali. Semmi r-rwol nieqes u kkwota r-rimedju, imbagħad idderieġi lill-persuna lejn is-settings tal-fornitur tagħha. Turihx bħala riżultat vojt.

Regola 5: il-karatteristiċi liċenzjati jiġu ċċekkjati mal-liċenzja

Dak li installazzjoni tista' tuża lil hinn mil-livell bażiku tal-Community ġej minn post wieħed: id-dokument tal-liċenzja li Adverant jiffirma, ivverifikat fuq l-installazzjoni bi ċwievet pubbliċi biss. L-estensjoni tiegħek qatt ma tiddeċiedi minn xi ħaġa aktar dgħajfa, bħal isem ta' pjan f'token jew flag fil-konfigurazzjoni.

F'plugin, l-aktar mod sempliċi biex torbot karatteristika mal-liċenzja huwa fuq id-dritt li jipproteġiha. Dritt fir-reġistru rights tal-manifest jista' jsemmi karatteristika licence:

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

Kull min isejjaħ rotta protetta minn dak id-dritt jiġi rrifjutat b'LICENCE_LOCKED (403), ikunu xi jkunu r-rwoli u s-siġġijiet li għandu, meta l-liċenzja tal-organizzazzjoni ma ġġorrx compliance-packs. Ir-rifjut isemmi l-karatteristika u x'iġorrha, u jgħid min jista' jixgħelha.

L-istat tal-liċenzja huwa importanti wkoll. Filwaqt li liċenzja tkun valida jew fit-tieqa ta' twissija tagħha, il-karatteristiċi liċenzjati jaħdmu, u jibqgħu jaħdmu fil-perjodu ta' grazzja, u l-perjodu ta' grazzja juri l-avviż LICENCE_IN_GRACE. Ladarba liċenzja tkun qabżet il-perjodu ta' grazzja, din tirrestrinġi: ix-xogħol li jkun għaddej u l-qari jkomplu, u l-istess l-esportazzjonijiet u l-aġġornamenti tas-sigurtà, iżda l-ħolqien ta' xi ħaġa ġdida taħt karatteristika liċenzjata jiġi rrifjutat b'LICENCE_LOCKED. Ibni l-mogħdijiet tal-ħolqien tiegħek billi tistenna dik it-tweġiba.

Meta l-plugin tiegħek jistaqsi lill-verifika tal-intitolament jekk organizzazzjoni għandhiex karatteristika, jikseb verdett, qatt sempliċi boolean. "Ma jistax jintlaħaq" u "jista' jintlaħaq u le" huma fatti differenti b'kodiċijiet differenti: ENTITLEMENT_UNREACHABLE (502) u ENTITLEMENT_DENIED (403). Nuqqas temporanju ta' konnessjoni qatt m'għandu jniżżel fis-skiet lil kull klijent għal-livell bla ħlas.

Manifest u permessi
Manifest u permessi
Manifest u permessi jqabbel dak li tiddikjara verżjoni ma' ta' qabilha. Hawnhekk il-verżjoni 0.4.0 iżżid l-ibgħat ta' posta u indirizz wieħed estern, għalhekk il-verżjoni tinżamm b'MANIFEST_SCOPE_WIDENED sakemm żewġ reviżuri u l-uffiċjal tal-konformità jaqblu.

Il-manifest jerġa' jiddikjara l-liġi

Kull manifest v2 iġorr blokk architecture bi tliet sentenzi meħtieġa, u l-validatur jiffissa l-kliem tagħhom. F'plugin li tibni għall-installazzjoni tiegħek stess dawn jaqraw:

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

Dawk is-sentenzi jiġu vverifikati. Plugin li l-manifest tiegħu qabel mal-liġijiet filwaqt li l-kodiċi tiegħu sejjaħ fornitur ta' mudell ikun qed jigdeb fil-kuntratt tiegħu stess, u l-gates jeżistu biex jagħmlu l-gidba tista' tinqabad.

Il-gates li jinforzaw kull regola

L-SDK jinkludi tnejn u għoxrin gate ta' aderenza bħala kmand wieħed, nexus-gates. Kapitlu 2.21, The Plugin SDK, jiddeskrivi kull wieħed. Hawnhekk huma miġbura skont ir-regola li jżommu.

Regola Kontrolli X'ifalli l-build
Iżolament fis-saff tar-rotta scope-adherence, one-fence, rights-register, crud-adherence Rotta /api mingħajr is-scope guard, it-tieni predikat tat-tenant miktub bl-idejn, rotta tal-ambitu mingħajr dritt, rotta li tibdel id-dejta li d-dritt tagħha ma jsemmi xejn
Iżolament fl-SQL sql-fence, no-set-config Dikjarazzjoni fuq tabella b'ambitu limitat mingħajr l-ilqugħ; kodiċi tal-plugin li jorbot is-setting tat-tenant huwa stess
Iżolament fid-database migrations-are-scoped, rls-present, db-role-honest Tabella nieqsa minn assi jew ċavetta li tibda bit-tenant, tabella mingħajr sigurtà infurzata fil-livell tar-ringiela, mogħdija ta' talba li tikkonnettja bħala s-sid jew superuser
L-uniku qsim grants-declared Tabella mogħtija konċessjoni fil-migrazzjonijiet li l-manifest ma jiddikjarax, jew siġġu tal-qari mogħti privileġġi bl-idejn
Komputazzjoni permezz ta' UNO no-direct-compute Sejħa diretta lil fornitur ta' mudell jew magna, jew lil kju jew host tal-fluss tax-xogħol; it-tieni qarrej tal-URL tad-dispatch
IA u ċwievet no-credentials Kredenzjali ta' fornitur ta' mudell li tista' tinqara fir-repożitorju jew fl-ambjent
Il-kuntratt iddikjarat api-contract, platform-clients, declared-input Rotta rreġistrata iżda mhux iddikjarata, jew iddikjarata iżda mhux irreġistrata; klijent tal-pjattaforma importat iżda mhux imsemmi

Kull gate għandu awtotest li jipprova li jfalli fuq fixture mibnija apposta biex tiskattah. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test iħaddimhom kollha, u gate li waqaf ifalli fuq il-fixture tiegħu stess waqaf jaħdem.

X'tista' tilħaq app
X'tista' tilħaq app
X'tista' tilħaq app jelenka kull indirizz estern li app iddikjarat u jekk l-uffiċjal tal-konformità approvahx. Sejħa lil indirizz li ħadd ma ddikjara titwaqqaf u tiġi magħduda qabel ma joħroġ xi ħaġa.

Qabel ma titlob reviżjoni

Din hija l-lista li ngħaddi minnha qabel ma nitlob lil kollega jirrevedi plugin. Kull linja hija xi ħaġa li reviżur f'Corrán Orbital bagħatli lura mill-inqas darba.

  1. Kull rotta /api tirreġistra s-scope guard, u l-uniċi rotot anonimi huma mogħdijiet eżatti ddikjarati auth: public b'allowAnonymous: true.
  2. Kull rotta li s-scope guard iservi ssemmi right mir-reġistru tal-manifest, u l-ebda handler ma jġorr verifika tad-drittijiet tiegħu stess.
  3. L-ebda handler ma jaqra organizzazzjoni, persuna jew unità mill-body, mit-tfittxija jew minn header.
  4. Kull dikjarazzjoni fuq tabella b'ambitu limitat tgħaddi minn tenantFence ġewwa withScopedTx, u xejn fir-repożitorju ma jsejjaħ set_config.
  5. Kull tabella għandha t-tliet kolonni tal-assi, primary key li tibda b'organization_id, u composite foreign keys li jġorru t-tenant.
  6. Il-URL tad-dispatch jinqara f'fajl wieħed, u l-allow-list tad-dispatch hija kostanti ta' tipi ta' xogħol bin-namespace.
  7. Xejn f'package.json ma jkellem lil fornitur ta' mudell, u l-ebda ċavetta ma tinsab fl-ambjent.
  8. Kull karatteristika li ċerti liċenzji biss iġorru ssemmi l-licence tagħha fuq id-dritt li jipproteġiha.
  9. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test huwa aħdar, u l-istess npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json.

Jekk id-disgħa kollha jgħoddu, ir-reviżjoni tkun dwar il-prodott tiegħek, li huwa fejn għandu jmur il-ħin ta' reviżur.

Għaliex il-pjattaforma tinforza dawn ir-regoli

Kull regola hawn fuq darba kienet konvenzjoni x'imkien, u kull konvenzjoni falliet bl-istess mod: ir-rotot li ftakruha kienu tajbin u dik li nsietha kienet l-inċident. Ilqugħ ta' unità tan-negozju applikat bħala middleware fakultattiv inqabeż b'sitt modi indipendenti, kull wieħed rotta li qatt ma għażlet li tidħol. Varjabbli tal-ambjent li kiteb mill-ġdid l-identità tat-tenant serva 1,406 kuntatti ta' organizzazzjoni lil oħra, u deher korrett fir-reviżjoni għax kien korrett għall-pod li kien miktub għalih.

Għalhekk il-pjattaforma tpoġġi l-predikat fejn kull wiċċ diġà jgħaddi minnu: fis-scope guard u fil-funzjoni tal-ilqugħ, fit-transaction wrapper u fis-sigurtà infurzata fil-livell tar-ringiela, u fil-klijent tad-dispatch. Gate mbagħad jelenka kull rotta u dikjarazzjoni u kull importazzjoni, u jfalli l-build meta waħda minnhom tilħaq tabella b'ambitu limitat jew mudell jew magna tal-komputazzjoni mingħajr ma tgħaddi minn dawk il-mekkaniżmi. L-ispiża ta' dak id-disinn hija li l-ewwel plugin tiegħek iħossu ristrett. Ir-ritorn huwa li l-elf plugin ikun iżolat mingħajr ma l-awtur tiegħu jkun jaf li l-karatteristika teżisti, għax m'hemm l-ebda mogħdija oħra lejn id-dejta li jista' jieħu.

Hemm limitu onest għal dan kollu. Il-gates jippruvaw li l-kodiċi tiegħek jgħaddi mill-mekkaniżmi; ma jistgħux jippruvaw li l-loġika tal-prodott tiegħek hija tajba. Rotta li tillimita b'mod korrett tfittxija għar-ringieli tas-sid xorta tista' turi r-ringieli l-ħżiena lis-sid it-tajjeb. Il-kit tat-test tal-iżolament f'kapitlu 2.22, The plugin runtime, jattakka kull rotta bħala organizzazzjoni oħra u bħala kollega, b'kull ilqugħ imneħħi wieħed wieħed, u dak huwa t-test li kont inħaddem qabel ma nafda l-qari tiegħi stess ta' kwalunkwe parti minn dan.