Prihlásiť saRezervovať brífing

Kapitola 2.2

Edície pod kapotou

Ako sú Community a Enterprise zostavené z jedného produktu, ako licencia zapína skupiny funkcií za behu, čo inštalácia Community zobrazuje pre stránku Enterprise a čo to znamená pre obrazy, ktoré sťahujete, a rozšírenia, ktoré vytvárate.

Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

17 min čítania

Dva riadky v súbore hodnôt rozhodujú o tom, ktorú edíciu inštalácia prevádzkuje:

# harrow-values.yaml (Helm values): the edition of this installation
edition: enterprise
enterprise:
  enabled: true

Musia sa zhodovať. Ak nastavíte edition: community s enterprise.enabled: true, chart sa zastaví s chybou „edition=community but enterprise.enabled=true: they must agree“. Ak nastavíte edition na čokoľvek iné ako community alebo enterprise, zastaví sa s chybou NEXUS_EDITION_INVALID. Tieto dve hodnoty vyberajú, ktoré obrazy inštalácia preberá. Čo tieto obrazy následne zapnú, je záležitosťou licencie počas behu, postupne po jednej skupine funkcií.

Táto kapitola to rozoberá podrobne: čo jednotlivé edície obsahujú, ako sa z jedného produktu stanú dve zostavy, ako sa licencia v bežiacej službe premení na „áno“ alebo „nie“ a čo to znamená, keď vytvárate niečo vlastné. Kapitola 1.6, Edície a licencie zrozumiteľne, ponúka pohľad kupujúceho; toto je pohľad inžiniera.

Matica edícií

Všetko v tejto kapitole pochádza z jedného súboru, matice edícií. Uvádza 97 spôsobilostí a každej priraďuje úroveň. Adverant z nej generuje katalóg licencií a pravidlá ponuky konzoly spolu s hranicou medzi otvoreným a uzavretým kódom. Keď sa zmení matica, zmenia sa všetky tieto časti naraz.

Existujú tri edície.

Edícia Licencia Kde beží
Community Apache-2.0, open source, bezplatná Váš hardvér alebo cloud Adverant
Team Licencia Adverant Enterprise Cloud Adverant: Community plus súbor Team
Enterprise Licencia Adverant Enterprise, podľa skupín funkcií Váš hardvér alebo cloud Adverant

Inštalácia prevádzkuje jednu z dvoch možností: hodnota edition v charte akceptuje iba community a enterprise. Team je cloudová edícia a Enterprise zahŕňa aj súbor Team, takže na vašom vlastnom hardvéri prichádzajú spôsobilosti edície Team (pracovný panel ukotvený vedľa každého záznamu, zdieľané zápisníky, politika pamäte pre organizáciu a ďalšie) spolu s edíciou Enterprise.

Samotná edícia Enterprise je vrstvená. Základ Enterprise tvorí uzavreté jadro: viacero organizácií a obchodných jednotiek, vynucovanie jednotného prihlásenia (SSO) pomocou SAML (Security Assertion Markup Language) a synchronizácie adresárov, vlastné roly so schvaľovaním štyrmi očami, dlhodobé uchovávanie auditných záznamov, ochrana údajov, stránky operátora a správa klastrov. Nad základom sa nachádzajú doplnky, z ktorých každý je licencovaný samostatne, a doménové balíky. Prvý doplnok v tabuľke, AI Gateway vo veľkom rozsahu, rozkladá záťaž smerovača AI (umelej inteligencie) medzi repliky a poskytovateľov.

Doplnok Vyžaduje aj
Brána AI vo veľkom rozsahu Základ
Továreň na modely Základ
Nápady Základ
Hovory a hlas Základ
Pošta Základ
Iné firmy a informačné bariéry Základ
Štúdio zápisníkov Základ
Mapa a GeoAI Základ
Dátové konektory Základ
Agent-agentovi (Agent-to-agent) Základ
Rozhodovacie miestnosti a zapečatené záznamy Základ
Riadenie príjmov (Revenue operations) Základ
Predajňa / white-label Základ
Nexus Edge Základ
Mobilné aplikácie Základ
Pracovná sila (Workforce) Základ; agenti na okrajových zariadeniach vyžadujú aj Nexus Edge, schvaľovanie v telefóne vyžaduje aj Mobilné aplikácie
Štít (Shield) Základ
Sandboxy Základ
Kvalita (NexusQA) Základ

Existuje desať doménových balíkov:

  • Poisťovníctvo
  • Bankovníctvo a platby
  • Kapitálové trhy a správa aktív
  • Štátna správa a verejný sektor
  • Zdravotníctvo
  • Vedy o živej prírode (Life sciences)
  • Kritická infraštruktúra a energetika
  • Obrana a bezpečnosť
  • Právne a profesionálne služby
  • Logistika a námorná doprava

Každý balík vyžaduje základ Enterprise a päť z nich vyžaduje aj doplnok. Balík Poisťovníctvo vyžaduje Rozhodovacie miestnosti a zapečatené záznamy. Rovnako aj balík Kapitálové trhy a správa aktív. Balík Právne a profesionálne služby vyžaduje tieto dva doplnky plus Poštu. Logistika a námorná doprava vyžaduje Mapy a GeoAI. V balíku Obrana a bezpečnosť vyžadujú platformové výstrahy aj Nexus Edge. Obrazovky pre telefón v akomkoľvek balíku vyžadujú aj Mobilné aplikácie. Kapitola 1.7, Doménové balíky a odvetvia, uvádza, čo jednotlivé balíky obsahujú.

Skupiny funkcií

Jednotkou, ktorú licencia menuje, je skupina funkcií. Je ich 32: základňa Community, súbor Team, základ Enterprise, jedna pre každý doplnok a jedna pre každý balík. Každá spôsobilosť patrí presne do jednej skupiny, takže licencia, ktorá uvádza „Enterprise base, Map and GeoAI, Logistics and maritime“, presne určuje, ktoré spôsobilosti môže táto inštalácia prevádzkovať.

Úroveň Spôsobilosti
Community 36
Team 6
Základ Enterprise 18
Doplnky 23
Doménové balíky 14

Rozsah oprávnenia

Každá licencovaná spôsobilosť má rozsah oprávnenia, ktorý určuje, na čo sa oprávnenie viaže.

  • Rozsah nájomcu (tenant) pokrýva časti, v ktorých ľudia pracujú: Nápady, Pošta, Riadenie výnosov, balíky. Licencia ich sprístupní inštalácii a následne sa zapínajú alebo vypínajú pre jednotlivé organizácie a obchodné jednotky. Nová organizácia nikdy nededí stav „všetko zapnuté“.
  • Rozsah nasadenia pokrýva päť vecí, ktoré patria inštalácii ako celku: import licencie spolu s artefaktmi, ktoré sťahuje, dodacie formy Enterprise, stránky operátora, správu klastrov a Nexus Edge.

Spôsobilosti Community nemajú žiadny rozsah oprávnenia. Nevyžadujú žiadnu licenciu.

Správca môže zúžiť to, čo licencia povoľuje, pre organizáciu alebo jednotku. Nikto to však nemôže rozšíriť zvnútra inštalácie.

Zvislý stĺpec šiestich pásov. Zospodu: „Základňa (každá edícia, nikdy nespoplatnené)“; „Community, Apache-2.0“; hrubá dvojitá čiara označená „@adverant/nexus-spi, jediné zdieľané rozhranie“; „Základ Enterprise, uzavreté moduly“; „Doplnky (19), každý licencovaný samostatne“; „Doménové balíky (10)“. Vpravo je pole „Podpísaný licenčný dokument“ so šípkou do troch horných pásov označenou „kontrolované vnútri každého uzavretého modulu“. Naľavo od pásu Community je poznámka „Obrazy Community: iba open source“.
Edície ako vrstvy s licenčným dokumentom ako jedinou autoritou.

Jeden produkt, dve zostavy

Existuje len jedna kódová základňa Nexus. Zostava Community je jej open-source exportom a zostava Enterprise je týmto exportom doplneným o uzavreté moduly.

Hraničný zoznam priraďuje každý sledovaný súbor k určitej edícii. Väčšinou to robí tak, že pomenuje spôsobilosť, ktorú súbor implementuje, a edícia súboru vyplýva z úrovne danej spôsobilosti: spôsobilosť Community vytvára súbor Community a čokoľvek zo súboru Team, základu, doplnkov alebo balíkov vytvára súbor Enterprise. Súbory, ktoré sa nedodávajú v žiadnej edícii, sú uvedené s dôvodom. Jedno pravidlo má prednosť pred ostatnými: databázové migrácie každého modulu sa dodávajú v oboch edíciách. Databáza Community a databáza Enterprise majú teda rovnakú schému a prechod inštalácie z jednej edície na druhú je len zmenou toho, čo je zapnuté, bez nutnosti migrovať údaje.

Export Community obsahuje hlavičky Apache-2.0 a súbor NOTICE a každý balík v ňom je licencovaný pod Apache-2.0, s výnimkou kódu tretích strán, ktorý si ponecháva vlastnú licenciu (MIT, BSD a iné) a kopíruje sa v pôvodnom stave, a niekoľkých balíkov súprav na vývoj softvéru (SDK) a rozhrania príkazového riadka (CLI), ktoré si ponechávajú vlastnú licenciu MIT. Zostava Enterprise je licencovaná pod licenciou Adverant Enterprise. Jej podmienky povoľujú používanie len na základe písomnej licencie, počas obdobia, pre nasadenia a skupiny funkcií, ktoré táto licencia uvádza. Zákaz spätného inžinierstva výslovne zachováva práva, ktoré vám dáva právo EÚ na štúdium softvéru a jeho dekompiláciu na účely interoperability.

Licenčná hranica

Kód Enterprise sa prepája s kódom Community len cez jediný balík: @adverant/nexus-spi, rozhranie poskytovateľa služieb (SPI). Má licenciu Apache-2.0 a obsahuje rozhrania a typové ochrany (type guards) bez vlastnej behovej logiky.

Export Čo to je
RouteModule Licencovaný smerovací modul: jeho id, jeho skupina funkcií, telá požiadaviek, ktoré číta, a register(app, ctx)
SpiApp Časť HTTP aplikácie hostiteľa, ktorej sa modul dotýka: use
SpiContext Čo hostiteľ odovzdáva modulu: produktovú bránu a ochranu rozsahu, čítačku licencií, fond dotazov s obmedzeným rozsahom, nadradené adresy, klientov platformy
SpiRuntime Hodnoty SDK (súpravy na vývoj softvéru) zásuvných modulov, ktoré hostiteľ odovzdáva modulu
SpiPlane Skupiny obrazoviek a čítania obrazoviek, ktoré pridáva licencovaná rovina
ScreenModule Licencovaná skupina obrazoviek konzoly: jej trasy, obrazovky a ponuka
GrantCheck Kontrola, ktorú licencovaný modul spúšťa nad vlastnou skupinou funkcií

Kontrola pri zostavovaní túto hranicu vynucuje. Vnútri kódu Enterprise spôsobí import z rozsahov balíkov Community (@adverant/ a @adverant-nexus/) zlyhanie zostavenia, pokiaľ nejde o @adverant/nexus-spi alebo balík Enterprise. Rovnako zlyhá aj relatívny import, ktorý vystupuje mimo repozitára, závislosť file:, link: alebo workspace: smerujúca mimo neho, adresa Git URL pomenúvajúca repozitár Community a direktíva replace jazyka Go, ktorá smeruje mimo neho. Cez túto hranicu prebieha prepojenie len cez sieťový protokol alebo modul načítaný pri štarte, nikdy nie cez zdieľaný zdrojový kód. SPI dokonca obsahuje vlastnú fixovanú kópiu deklarácií typov SDK pre zásuvné moduly, pretože toto SDK je balík Community, ktorý hranica nepripúšťa; hostiteľ namiesto toho odovzdá modulu behové hodnoty SDK.

Profily zostavenia

Konzola a BFF (backend pre frontend) sa kompilujú s profilom zostavenia, ktorý pevne určuje triedy kódu vnútri obrazu. Profil Community obsahuje kód Community; profil Enterprise obsahuje kód Community aj Enterprise. Každý z nich sa odmietne spustiť, ak jeho profil obsahuje kód, ktorý edícia danej inštalácie neobsahuje. BFF to oznámi hlásením PROFILE_OUTSIDE_EDITION a uvedie obraz, ktorý sa má nasadiť namiesto neho. Konzolu Enterprise nemôžete nasadiť na inštaláciu Community len premenovaním značky (retagging) obrazu.

Vľavo je jedno pole „Zdrojový kód Nexus“ s menším poľom vnútri s názvom „matica edícií“. Šípka označená „hraničný zoznam“ sa rozdeľuje na dve. Horná šípka vedie do poľa „Export Community (Apache-2.0)“ a ďalej do poľa „Obrazy Community“. Dolná šípka vedie do poľa „Zostava Enterprise“, do ktorého smeruje aj šípka z exportu Community a šípka z poľa „uzavreté moduly“, a vytvára „Obrazy Enterprise“. Medzi uzavretými modulmi a exportom Community je bariéra označená „licenčná hranica: iba @adverant/nexus-spi“. Malá poznámka pod oboma poľami obrazov znie „rovnaká databázová schéma“.
Ako sa z jedného stromu zdrojového kódu stanú dve edície.

Ako licencia zapína skupiny funkcií

Licencia je podpísaný dokument. Adverant podpisuje každú licenciu dvoma nezávislými kľúčmi a nič iné v inštalácii nerozhoduje o tom, čo je licencované. Importujete ju cez stránky Licencie v konzole, pomocou nexusctl licence import <file> alebo odoslaním dokumentu na https://<hosts.auth>/api/v1/installation/licence. Licencia nikdy nie je hodnotou v charte ani pripojeným súborom. Kapitola 2.13, Licencie, sa venuje importu, obnoveniu a všetkým stavom, ktorými licencia prechádza.

Rozhodujúca kontrola beží vnútri každého uzavretého modulu nad jeho vlastnou skupinou funkcií predtým, než modul odpovie. To je kontrakt GrantCheck z rozhrania SPI:

type GrantCheck = (featureGroup: string) => Promise<{ entitled: boolean; code?: "LICENCE_LOCKED" }>;

Kontrola sa nachádza v uzavretom module, pretože kontrolu napísanú v open-source kóde by bolo možné jednoducho vymazať. Sfalšovaná licencia sa považuje za žiadnu licenciu. Modul, ktorého skupinu funkcií licencia neuvádza, odpovie kódom LICENCE_LOCKED.

Kontrolujú sa aj samotné moduly. Služba nexus-keys uchováva podpísaný manifest častí vydania a kľúč, ktorým bol podpísaný. Každý skompilovaný modul skontroluje voči tomuto manifestu pri štarte a potom každú noc o 03:53 UTC. Modul, ktorého podpis sa nezhoduje, sa nikdy nenačíta a podpísaná kópia, ktorú mal nahradiť, beží ďalej; stránky operátora to zobrazia s kódom MODULE_SIGNATURE_INVALID.

Skompilované časti
Skompilované časti
Stránka skompilovaných častí uvádza každý licencovaný modul s jeho skupinou funkcií, verziou a kontrolou podpisu. Zmenená kópia, ktorá neprešla kontrolou, sa zobrazí ako štítok odmietnutia a podpísaná kópia beží ďalej.

Nad kontrolou modulov sa nachádza zobrazovacia vrstva, ktorá rozhoduje o tom, ako sa spôsobilosť javí jednotlivým osobám. Kombinuje oprávnenia z licencie s plánom organizácie a rolou danej osoby, pričom každý ovládací prvok skončí v jednom zo štyroch stavov.

Stav Čo osoba vidí
Oprávnené Ovládací prvok vykreslený normálne
Ukážka Ovládací prvok je sivý so zámkom; po jeho otvorení sa zobrazí vysvetlenie, o čo ide a kto to môže zapnúť
Skryté Nič; používa sa len pre veci, o ktorých existencii rola tejto osoby nesmie vedieť, ako je napríklad súkromná poštová schránka inej osoby
Odmietnuté s kódom Štítok odmietnutia s uvedením kódu, keď sa niekto pokúsi o úkon, ktorý nie je povolený

Samotná licencia má tiež vlastné stavy, keď sa blíži ku dňu skončenia platnosti a keď ho prekročí. V každom z nich platia dve pravidlá: licencia nikdy nezastaví prebiehajúcu prácu a bezpečnostné opravy nie sú nikdy odopreté.

Čo Community zobrazuje pre stránku Enterprise

Inštalácia Community si zachováva tvar produktu. Ponuka má rovnaké riadky ako Enterprise a položky pre Enterprise (Nápady, Rozhodnutia, Pošta, Hovory, Iné firmy, Agenti, Politiky, Súlad s predpismi) sú vykreslené sivou farbou s ikonou zámku. Nič sa neskrýva, aby edícia vyzerala úplne, a nič používateľa neobťažuje.

Otvorením uzamknutého riadka sa zobrazí ukážka. Pre Nápady uvádza „Nápady sú súčasťou edície Enterprise“, nasleduje jeden odsek o tom, čo Nápady robia, a potom „Kto to môže zapnúť: váš správca prostredníctvom licencie od spoločnosti Adverant“. Ponúka dve tlačidlá: „Požiadať správcu“ a „Zistiť, čo to robí“. Nie je tam uvedená žiadna cena. Otvorenie stránky nič nenačítava ani nič neodosiela a táto informácia sa zobrazí len raz.

Niečo, čo nemáte k dispozícii
Niečo, čo nemáte k dispozícii
Uzamknutá oblasť v edícii Community uvádza, kto ju môže zapnúť a čo vám už edícia Community poskytuje. Riadok zostáva v ponuke sivý so zámkom, takže produkt vyzerá v oboch edíciách rovnako.

Zadanie adresy stránky určenej len pre Enterprise vás tiež privedie na užitočné miesto. Konzola Community pozná adresy stránok, ktoré neobsahuje, a každú z nich presmeruje na svoju stránku edície vnútri bežného rámca s ponukou. Stránka vykreslí štítok uzamknutej funkcie:

LICENCE_LOCKED
This page is part of Nexus Enterprise. This installation runs Nexus Community,
so the page is not here and nothing was read.
- To use it, the installation needs Nexus Enterprise: an administrator can ask Adverant about it
- Every page this installation holds is in the menu

Kód slúži ako referencia; vety sú určené pre osobu, ktorá ich číta.

Základňa

Niektoré veci nie sú nikdy spoplatnené, v žiadnej edícii a pri žiadnom stave licencie: základy správy a bezpečnosti, oddelenie nájomcov, export údajov, odhlásenie a všetky obrazovky odmietnutia. Inštalácia Community ich má všetky. Inštalácia Enterprise, ktorej licencia sa skončila, si ich ponecháva tiež: artefakty Enterprise sa prestanú ponúkať, no základňa Community a export údajov zostávajú zachované. Svoje údaje môžete kedykoľvek exportovať.

Z Community na Enterprise
Z Community na Enterprise
Import licencie v inštalácii Community ukáže, čo sa stiahne, čo sa zmení a čo zostane zachované ešte predtým, než sa čokoľvek udeje. Na tlačidle je nápis „Stiahnuť a zapnúť“ a nič sa nestiahne, kým ho nestlačíte.

Obrazy podľa edície

Každý obraz vo vydaní je uvedený pomocou odtlačku (digest) v zámku obrazov chartu a samotný zámok patrí jednej edícii. Chart kontroluje každý vykresľovaný obraz voči zámku a voči edícii, o ktorú ste požiadali. Inštalácia Community preberá len obrazy Community. Ak ju požiadate o čokoľvek iné, zastaví sa s hlásením: „a community install takes only community images“. Zámok Enterprise obsahuje obrazy Community plus zostavy Enterprise.

Záleží na tom pri určovaní zdroja, odkiaľ obrazy sťahujete. Obrazy Community sú verejné na adrese registry.adverant.ai/nexus/<service>@sha256:…. Obrazy Enterprise pochádzajú z toho istého registra so sťahovacím tokenom (pull token), ktorý získate na stránke „Sťahovacie tokeny a inštalačné príkazy“ vo vašom účte Adverant. Inštalácia Community tento token nikdy nepotrebuje a nikdy neobsahuje ani bajt uzavretého kódu.

Prechod na vyššiu verziu zachováva existujúcu inštaláciu. Keď správca Community importuje licenciu Enterprise, konzola ju prečíta a overí, a potom zobrazí časti, ktoré stiahne (skompilované moduly, balíky a doplnky uvedené v licencii) spolu s ich veľkosťami. Každá časť sa skontroluje voči kľúču vydania Adverant a skupiny sa zapínajú postupne jedna po druhej. Ľudia a súbory zostávajú tak, ako sú, a rovnako aj pracovné postupy a kanály, pretože databázová schéma už bola rovnaká. Kapitola 2.7, Inštalácia Enterprise a použitie licencie, opisuje tento postup v prostredí Kubernetes; izolované (air-gapped) prevádzky importujú tie isté časti z médií, ako opisuje kapitola 2.10, Izolovaná inštalácia.

Formy dodania a triedy ochrany

Nexus sa dodáva v šiestich dodacích formách, ktoré matica nazýva SKU (skladové jednotky). Päť z nich okrem Edge zdieľa jeden podpísaný balík a líšia sa balením a spôsobom doručenia licencie.

SKU Čo to je Ako prichádza licencia
saas Cloud Adverant Vydaná spolu s predplatným
onprem-connected Helm do vášho vlastného prostredia Kubernetes Stiahnutá inštaláciou cez jej odchádzajúce pripojenie
airgap Ten istý balík, importovaný offline Importovaná ako súbor, s podpísaným výkazom o používaní raz ročne
self-serve-image Obraz stroja vo vašom vlastnom cloudovom účte Samotný obraz obsahuje len licencie Community a skúšobné licencie; moduly Enterprise prichádzajú po vydaní licencie, vrátane licencie zakúpenej cez obchod daného cloudu
appliance Hardvér zostavený výrobcom pôvodného zariadenia (OEM), ktorý je jeho oficiálnym výrobcom Licencia Enterprise; zariadenie (appliance) je jednou z jej dodacích foriem
edge Nexus Edge, programové vybavenie na satelitoch a dronoch alebo na plavidlách a vozidlách Jedna licencia na platformu alebo flotilu, dlhodobá, platná aj v režime offline

Ochrana je druhou polovicou dodania a je dobré hovoriť o nej otvorene. Keď kód beží na hardvéri, ktorý máte pod kontrolou, žiadna technika ho neurobí nečitateľným. Preto Adverant triedi svoj kód do tried ochrany a pre každú dodaciu formu rozhoduje, ako ďaleko môže jednotlivá trieda putovať. Existujú štyri úrovne:

Trieda Čo to znamená
P1, nikdy sa nedodáva Logika beží v spoločnosti Adverant; inštalácia obsahuje podpísaného klienta.
P2, zapečatený Dôverný virtuálny stroj (VM), do ktorého sa nemôžete prihlásiť, na hardvéri, ktorého sa nemôžete dotknúť.
P3, zabezpečený natívny kód Skompilovaný, očistený o symboly (stripped) a zostavený pre konkrétneho držiteľa licencie. Zvyšuje náklady na prečítanie kódu z hodín na týždne.
P4, čitateľný Bežný JavaScript alebo TypeScript, rovnako ako open source.
Trieda ochrany Cloud Adverant Pripojené on-prem Air-gap (izolované) Nexus Edge
Open source (celá edícia Community) P4 P4 P4 P4
Kód s najvyššou hodnotou: hodnotenie nápadov, jadro úložiska zapečatených záznamov, nástroj politiky smerovania, štyri rozhodovacie nástroje balíka Poisťovníctvo P1 P3 alebo P2 ako dôverný VM zapečatený spoločnosťou Adverant vo vašom cloudovom prostredí P3 Nedodáva sa
Uzavreté serverové moduly, ktoré rozhodujú: serverový kód balíkov, mobilná brána P1 P3 P3 Nedodáva sa
Serverový kód balíka Obrana a bezpečnosť P1 P3 P3 P3
Kód programového vybavenia Nexus Edge Nedodáva sa Nedodáva sa Nedodáva sa P3
Čitateľné klientske definície: aplikácie pre telefón, obrazovky balíkov pre telefón P4 P4 P4 P4

Vyplývajú z toho dva dôsledky. V aplikácii pre telefón sa nedodáva nič chránené: každé pravidlo a každý prompt zostáva na serveri. A hodnota obsiahnutá v promptoch, hodnotiacich kritériách alebo reťazcoch agentov je čitateľná pre každého, kto prevádzkuje model, ktorému sa odosiela. Tam, kde model vlastní vaša organizácia, je táto hodnota chránená licenčnou zmluvou a ničím iným. Každý dodaný obraz TypeScript je zbalený a minifikovaný bez zdrojových máp (source maps), čo slúži skôr na udržanie poriadku než na ochranu.

Čo to znamená, keď vytvárate rozšírenie

Vaše rozšírenie sa nachádza na tej istej hranici ako vlastné moduly spoločnosti Adverant. Vzťahuje sa naň takmer celá táto kapitola.

Izolácia, identita a cesta pre AI sú súčasťou platformy v oboch edíciách. Zásuvný modul vytvorený pomocou @adverant-nexus/plugin-sdk dedí ohraničenie dotazov podľa rozsahu, overovač tokenov a odosielanie UNO bez ohľadu na to, v ktorej edícii sa ocitne. Kapitola 2.19, Pravidlá, ktoré dedí každé rozšírenie, uvádza ich zoznam.

Obmedzovanie podľa edície (gating) funguje pre vás rovnakým spôsobom. Zásuvný modul deklaruje svoje identifikátory funkcií v bloku entitlements svojho manifestu (featureIdPattern plus krátky zoznam alwaysOn ponechaný pre kontroly stavu a stránku nastavení) a pred poskytnutím obmedzeného rozhrania požiada platformu o verdikt. Verdikt nikdy nie je len jednoduchou booleovskou hodnotou. ENTITLEMENT_DENIED (403) znamená, že platforma odpovedala nie. ENTITLEMENT_UNREACHABLE (502) znamená, že neprišla žiadna odpoveď, a váš zásuvný modul musí požiadavku odmietnuť namiesto toho, aby niečo predpokladal, pretože výpadok interpretovaný ako „neoprávnené“ by potichu znížil úroveň všetkým zákazníkom naraz. Odpoveď „áno“ ukladajte do vyrovnávacej pamäte len krátko a odmietnutie neukladajte nikdy.

V edícii Community dostáva vývojár rovnaké úvodné šablóny ako v Enterprise, pre zásuvné moduly a pohľady (lenses), ako aj pre zručnosti a pracovné postupy. Každý vývojár pracuje vo vývojovom priestore s vetvami údajov na jednom serveri a kód je uložený v službe GitHub. Šablóny doménových balíkov a platformy sú súčasťou edície Enterprise. To isté platí pre časovo obmedzené zvýšenie oprávnení prístupu z IDE (integrovaného vývojového prostredia): v edícii Community neexistuje samostatné produkčné prostredie, do ktorého by ste si mohli zvýšiť prístup, a konzola to oznámi kódom PASS_TIER_REQUIRED.

Vývoj v edícii Community
Vývoj v edícii Community
Vývoj v edícii Community ponúka rovnaké šablóny ako Enterprise na jednom serveri s kódom v službe GitHub. Stránka uvádza, čo pridáva edícia Enterprise, a odmieta zvýšený prístup s jasným odôvodnením.

Rozšírenie, ktoré využíva iba rozhrania edície Community, beží v oboch edíciách bez zmeny. Rozšírenie, ktoré závisí od doplnku, napríklad od Pošty, sa zobrazí ako uzamknuté všade tam, kde licencia túto skupinu neuvádza. Kapitola 2.25, Vývoj pre jednotlivé edície, ukazuje, ako štruktúrovať rozšírenie pre obe edície a ako ho voči nim otestovať.