Verżjoni 1.0.0-alpha.1l-aħħar
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ż

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_URLjinqara 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_idtar-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-credentialsifalli 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_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.
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.
- Kull rotta
/apitirreġistra s-scope guard, u l-uniċi rotot anonimi huma mogħdijiet eżatti ddikjaratiauth: publicb'allowAnonymous: true. - Kull rotta li s-scope guard iservi ssemmi
rightmir-reġistru tal-manifest, u l-ebda handler ma jġorr verifika tad-drittijiet tiegħu stess. - L-ebda handler ma jaqra organizzazzjoni, persuna jew unità mill-body, mit-tfittxija jew minn header.
- Kull dikjarazzjoni fuq tabella b'ambitu limitat tgħaddi minn
tenantFenceġewwawithScopedTx, u xejn fir-repożitorju ma jsejjaħset_config. - 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. - Il-URL tad-dispatch jinqara f'fajl wieħed, u l-allow-list tad-dispatch hija kostanti ta' tipi ta' xogħol bin-namespace.
- Xejn f'
package.jsonma jkellem lil fornitur ta' mudell, u l-ebda ċavetta ma tinsab fl-ambjent. - Kull karatteristika li ċerti liċenzji biss iġorru ssemmi l-
licencetagħha fuq id-dritt li jipproteġiha. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testhuwa aħdar, u l-istessnpx -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.

