Verze 1.0.0-alpha.1nejnovější
Kapitola 2.2
Edice pod kapotou
Jak jsou edice Community a Enterprise sestaveny z jednoho produktu, jak licence zapíná skupiny funkcí za běhu, co instalace Community zobrazuje místo stránky Enterprise a co to znamená pro obrazy, které stahujete, a rozšíření, která vytváříte.
Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

O tom, kterou edici instalace spouští, rozhodují dva řádky v souboru hodnot (values):
# harrow-values.yaml (Helm values): the edition of this installation
edition: enterprise
enterprise:
enabled: trueMusí se shodovat. Pokud nastavíte edition: community s enterprise.enabled: true, chart se zastaví s chybou „edition=community but enterprise.enabled=true: they must agree“. Pokud nastavíte edition na cokoli jiného než community nebo enterprise, zastaví se s chybou NEXUS_EDITION_INVALID. Tyto dvě hodnoty určují, které obrazy instalace použije. Co pak tyto obrazy zapnou, je věcí licence za běhu, vždy po jedné skupině funkcí.
Tato kapitola to rozebírá: co jednotlivé edice obsahují, jak se z jednoho produktu stávají dvě sestavení, jak se licence uvnitř běžící služby mění v „ano“ či „ne“ a co to znamená, když vytváříte něco vlastního. Kapitola 1.6, Edice a licence srozumitelně, přináší pohled nákupčího; toto je pohled inženýra.
Matice edic
Vše v této kapitole pochází z jednoho souboru – z matice edic. Ta vyjmenovává 97 schopností a každé přiřazuje úroveň. Společnost Adverant z ní generuje katalog licencí a pravidla nabídek v konzoli, stejně jako hranici mezi otevřeným a uzavřeným kódem. Když se změní matice, změní se společně s ní i toto všechno.
Existují tři edice.
| Edice | Licence | Kde běží |
|---|---|---|
| Community | Apache-2.0, open source, zdarma | Váš hardware nebo cloud Adverant |
| Team | Licence Adverant Enterprise | Cloud Adverant: Community plus sada Team |
| Enterprise | Licence Adverant Enterprise, podle skupin funkcí | Váš hardware nebo cloud Adverant |
Instalace běží v jedné ze dvou: hodnota edition v chartu přijímá pouze community a enterprise. Team je cloudová edice a edice Enterprise obsahuje i sadu Team, takže na vašem vlastním hardwaru jsou schopnosti edice Team (pracovní panel ukotvený vedle každého záznamu, sdílené zápisníky, zásady paměti pro organizaci a zbytek) součástí edice Enterprise.
Samotná edice Enterprise je vrstevnatá. Základ Enterprise tvoří uzavřené jádro: více organizací a obchodních jednotek, vynucení jednotného přihlašování (SSO) pomocí SAML (Security Assertion Markup Language) a synchronizace adresářů, vlastní role se schvalováním čtyř očí, dlouhé uchovávání auditních záznamů, ochrana dat, operátorské stránky a správa clusteru. Nad základem stojí doplňky, z nichž každý je licencován samostatně, a oborové balíčky. První doplněk v tabulce, AI Gateway ve velkém měřítku, rozkládá zátěž směrovače AI (umělé inteligence) mezi repliky a poskytovatele.
| Doplněk | Vyžaduje také |
|---|---|
| AI Gateway ve velkém měřítku | Základ |
| Továrna na modely | Základ |
| Nápady | Základ |
| Hovory a hlas | Základ |
| Pošta | Základ |
| Jiné firmy a informační bariéry | Základ |
| Studio zápisníků | Základ |
| Mapa a GeoAI | Základ |
| Datové konektory | Základ |
| Komunikace mezi agenty (Agent-to-agent) | Základ |
| Rozhodovací místnosti a zapečetěné záznamy | Základ |
| Řízení příjmů (Revenue operations) | Základ |
| Vlastní výloha / white-label | Základ |
| Nexus Edge | Základ |
| Mobilní aplikace | Základ |
| Pracovní síla (Workforce) | Základ; agenti na koncových zařízeních (edge) vyžadují také Nexus Edge, schvalování na telefonu vyžaduje také Mobilní aplikace |
| Shield | Základ |
| Sandboxy | Základ |
| Kvalita (NexusQA) | Základ |
Existuje deset oborových balíčků:
- Pojišťovnictví
- Bankovnictví a platby
- Kapitálové trhy a správa aktiv
- Státní správa a veřejný sektor
- Zdravotnictví
- Vědy o živé přírodě (Life sciences)
- Kritická infrastruktura a energetika
- Obrana a bezpečnost
- Právní a profesní služby
- Logistika a námořní doprava
Každý balíček vyžaduje základ Enterprise a pět z nich vyžaduje také doplněk. Balíček Pojišťovnictví vyžaduje Rozhodovací místnosti a zapečetěné záznamy. Totéž platí pro balíček Kapitálové trhy a správa aktiv. Balíček Právní a profesionální služby vyžaduje tyto dva doplňky a navíc Poštu. Logistika a námořní doprava vyžaduje Mapy a GeoAI. V balíčku Obrana a bezpečnost vyžadují výstrahy platformy také Nexus Edge. Obrazovky pro telefony v jakémkoli balíčku vyžadují také Mobilní aplikace. Kapitola 1.7, Oborové balíčky a vertikály, uvádí, co jednotlivé balíčky obsahují.
Skupiny funkcí
Jednotkou, kterou licence jmenuje, je skupina funkcí. Je jich 32: základní minimum Community, sada Team, základ Enterprise, jedna pro každý doplněk a jedna pro každý balíček. Každá schopnost patří právě do jedné z nich, takže licence, která uvádí „Základ Enterprise, Mapy a GeoAI, Logistika a námořní doprava“, přesně určuje, které schopnosti smí tato instalace provozovat.
| Úroveň | Schopnosti |
|---|---|
| Community | 36 |
| Team | 6 |
| Základ Enterprise | 18 |
| Doplňky | 23 |
| Oborové balíčky | 14 |
Rozsah oprávnění
Každá licencovaná schopnost má rozsah oprávnění, který určuje, k čemu se oprávnění váže.
- Rozsah tenanta pokrývá části, ve kterých lidé pracují: Nápady, Poštu, Řízení příjmů (Revenue operations) a balíčky. Licence je zpřístupní instalaci a následně se zapínají nebo vypínají pro jednotlivé organizace a obchodní jednotky. Nová organizace nikdy nedědí stav, ve kterém je „vše zapnuto“.
- Rozsah nasazení pokrývá pět věcí, které patří instalaci jako celku: import licence s artefakty, které stahuje, formy dodání Enterprise, operátorské stránky, správu clusteru a Nexus Edge.
Schopnosti edice Community nemají vůbec žádný rozsah oprávnění. Nepotřebují žádnou licenci.
Správce může rozsah povolený licencí pro organizaci nebo jednotku zúžit. Nikdo jej však nemůže zevnitř instalace rozšířit.
Jeden produkt, dvě sestavení
Existuje jedna kódová základna Nexus. Sestavení Community je jejím open-source exportem a sestavení Enterprise představuje tento export plus uzavřené moduly.
Seznam hranic přiřazuje každý sledovaný soubor k určité edici. Většinou tak činí uvedením schopnosti, kterou soubor implementuje, a edice souboru vyplývá z úrovně dané schopnosti: schopnost Community vytváří soubor Community a cokoli z úrovně Team, základ, doplněk nebo balíček vytváří soubor Enterprise. Soubory, které nejsou součástí žádné edice, jsou uvedeny s odůvodněním. Jedno pravidlo však platí napříč všemi ostatními: databázové migrace každého modulu jsou součástí obou edic. Databáze Community a databáze Enterprise tak mají stejné schéma a přechod instalace z jedné edice na druhou znamená pouze změnu toho, co je zapnuté, bez nutnosti migrovat data.
Export Community obsahuje hlavičky Apache-2.0 a soubor NOTICE a každý balíček v něm je licencován pod Apache-2.0, s výjimkou kódu třetích stran, který si ponechává vlastní licenci (MIT, BSD a další) a je zkopírován v původním stavu, a několika balíčků sady pro vývoj softwaru (SDK) a rozhraní příkazového řádku (CLI), které si ponechávají vlastní licenci MIT. Sestavení Enterprise je licencováno pod licencí Adverant Enterprise. Její podmínky povolují použití pouze na základě písemné licence, a to po dobu, pro nasazení a pro skupiny funkcí, které tato licence jmenuje. Zákaz zpětného inženýrství výslovně zachovává práva, která vám dává právo EU ke studiu softwaru a k jeho dekompilaci za účelem interoperability.
Licenční hranice
Kód Enterprise přistupuje ke kódu Community pouze prostřednictvím jediného balíčku: @adverant/nexus-spi, což je rozhraní poskytovatele služeb (SPI). Má licenci Apache-2.0 a obsahuje rozhraní a typové stráže (type guards), bez vlastní běhové logiky.
| Export | Co to je |
|---|---|
RouteModule |
Licencovaný modul tras (route): jeho identifikátor, jeho skupina funkcí, těla požadavků, která čte, a register(app, ctx) |
SpiApp |
Část aplikace HTTP hostitele, které se modul dotýká: use |
SpiContext |
Co hostitel předává modulu: produktovou bránu a strážce rozsahu, čtečku licencí, fond dotazů s omezeným rozsahem, nadřazené (upstream) adresy, klienty platformy |
SpiRuntime |
Hodnoty sady pro vývoj softwaru (SDK) pro zásuvné moduly, které hostitel předává modulu |
SpiPlane |
Skupiny obrazovek a čtení obrazovek, které přidává licencovaná rovina |
ScreenModule |
Licencovaná skupina obrazovek konzole: její trasy, obrazovky a nabídka |
GrantCheck |
Kontrola, kterou licencovaný modul spouští pro svou vlastní skupinu funkcí |
Dodržování této hranice vynucuje kontrola při sestavení. Uvnitř kódu Enterprise způsobí import z rozsahů balíčků Community (@adverant/ a @adverant-nexus/) selhání sestavení, pokud se nejedná o @adverant/nexus-spi nebo o balíček Enterprise. Stejně dopadne i relativní import, který vystupuje mimo repozitář, závislost file:, link: nebo workspace: ukazující mimo něj, adresa URL systému Git jmenující repozitář Community a direktiva replace jazyka Go, která ukazuje mimo něj. Napříč touto hranicí probíhá propojení přes síťový protokol nebo přes modul načtený při startu, nikdy přes sdílený zdrojový kód. Rozhraní SPI si dokonce nese vlastní pevně ukotvenou kopii deklarací typů sady SDK pro zásuvné moduly, protože samotná sada SDK je balíčkem Community, který hranice nepřipouští; hostitel místo toho předává modulu běhové hodnoty sady SDK.
Profily sestavení
Konzole a BFF (backend for frontend) se kompilují s profilem sestavení, který pevně určuje třídy kódu uvnitř obrazu. Profil Community obsahuje kód Community; profil Enterprise obsahuje kód Community a Enterprise. Každý z nich se odmítne spustit, pokud jeho profil obsahuje kód, který edice dané instalace nemá. BFF to oznámí pomocí PROFILE_OUTSIDE_EDITION a uvede obraz, který se má nasadit místo něj. Konzoli Enterprise nemůžete nasadit na instalaci Community pouhým přeznačením (retagging) obrazu.
Jak licence zapíná skupiny funkcí
Licence je podepsaný dokument. Společnost Adverant podepisuje každou licenci dvěma nezávislými klíči a o tom, co je licencováno, nerozhoduje v instalaci nic jiného. Importujete ji prostřednictvím stránek Licence v konzoli, pomocí nexusctl licence import <file> nebo odesláním dokumentu na https://<hosts.auth>/api/v1/installation/licence. Licence není nikdy hodnotou v chartu ani připojeným souborem. Kapitola 2.13, Licence, pojednává o importu a obnovení a o všech stavech, kterými licence prochází.
Rozhodující kontrola běží uvnitř každého uzavřeného modulu pro jeho vlastní skupinu funkcí ještě předtím, než modul odpoví. To je kontrakt GrantCheck z rozhraní SPI:
type GrantCheck = (featureGroup: string) => Promise<{ entitled: boolean; code?: "LICENCE_LOCKED" }>;Kontrola je umístěna v uzavřeném modulu, protože kontrolu napsanou v open-source kódu by šlo jednoduše smazat. Padělaná licence se počítá jako žádná licence. Modul, jehož skupinu funkcí licence nejmenuje, odpoví kódem LICENCE_LOCKED.
Kontrolují se i samotné moduly. Služba nexus-keys uchovává podepsaný manifest částí daného vydání a klíč, kterým byl podepsán. Každý zkompilovaný modul kontroluje oproti tomuto manifestu při spuštění a poté každou noc v 03:53 UTC. Modul, jehož podpis neodpovídá, se nikdy nenačte a nadále běží podepsaná kopie, kterou měl nahradit; operátorské stránky to zobrazí s kódem MODULE_SIGNATURE_INVALID.
Nad kontrolou modulů leží zobrazovací vrstva, která rozhoduje o tom, jak se schopnost zobrazí jednotlivým uživatelům. Kombinuje oprávnění z licence s plánem organizace a rolí dané osoby, přičemž každý ovládací prvek skončí v jednom ze čtyř stavů.
| Stav | Co uživatel vidí |
|---|---|
| S oprávněním | Ovládací prvek vykreslený běžným způsobem |
| Ukázka (Teaser) | Ovládací prvek je zašedlý a doplněný zámkem; po jeho otevření se zobrazí vysvětlení, o co jde a kdo to může zapnout |
| Skryto | Nic; používá se pouze pro věci, o jejichž existenci role této osoby nesmí vědět, jako je soukromá poštovní schránka jiné osoby |
| Zamítnuto s kódem | Štítek zamítnutí uvádějící kód, když se někdo pokusí o úkon, který není povolen |
Své vlastní stavy má i licence, jak se blíží datum jejího vypršení a jakmile toto datum překročí. V každém z nich platí dvě pravidla: licence nikdy nezastaví běžící práci a bezpečnostní opravy nejsou nikdy odepřeny.
Co Community zobrazuje místo stránky Enterprise
Instalace Community si zachovává tvar produktu. Nabídka má stejné řádky jako edice Enterprise a položky z Enterprise (Nápady, Rozhodnutí, Pošta, Hovory, Jiné firmy, Agenti, Zásady, Soulad s předpisy) jsou vykresleny zašedle s ikonou zámku. Nic se neskrývá jen proto, aby edice vypadala uceleně, a nic uživatele neobtěžuje.
Otevřením uzamčeného řádku se zobrazí ukázka. U položky Nápady stojí „Nápady jsou součástí edice Enterprise“, následuje jeden odstavec o tom, co Nápady dělají, a poté „Kdo to může zapnout: váš správce, prostřednictvím licence od společnosti Adverant“. Nabízí dvě tlačítka: „Požádat správce“ a „Podívat se, co to umí“. Není zde uvedena žádná cena. Otevření stránky nic nenačítá ani nic neodesílá a tato informace se zobrazí pouze jednou.
K užitečnému výsledku vede i zadání adresy stránky, která je dostupná pouze v edici Enterprise. Konzole Community zná adresy stránek, které sama neobsahuje, a každou z nich přesměruje na svou stránku edice, uvnitř běžného rámce s nabídkou. Stránka vykreslí štítek uzamčené funkce:
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 slouží pro referenci; věty jsou určeny pro osobu, která je čte.
Základní minimum
Některé věci nejsou nikdy zpoplatněny, v žádné edici a v žádném stavu licence: základy správy a zabezpečení, oddělení tenantů, export dat, odhlášení a každá obrazovka zamítnutí. Instalace Community má všechny z nich. Ponechává si je i instalace Enterprise, jejíž licence skončila: artefakty Enterprise se přestanou nabízet, ale základní minimum Community a export dat zůstávají. Svá data tak můžete vždy získat zpět.
Obrazy podle edice
Každý obraz ve vydání je uveden pomocí otisku (digest) v zámku obrazů daného chartu a samotný zámek patří k jedné edici. Chart kontroluje každý obraz, který vykresluje, oproti zámku a oproti edici, o kterou jste požádali. Instalace Community přijímá pouze obrazy Community. Pokud ji požádáte o cokoli jiného, zastaví se: „a community install takes only community images“. Zámek Enterprise obsahuje obrazy Community a navíc sestavení Enterprise.
To je důležité pro to, odkud obrazy stahujete. Obrazy Community jsou veřejné na adrese registry.adverant.ai/nexus/<service>@sha256:…. Obrazy Enterprise pocházejí ze stejného registru s použitím stahovacího tokenu (pull token), který získáte na stránce „Pull tokens and install commands“ ve svém účtu Adverant. Instalace Community tento token nikdy nepotřebuje a nikdy neobsahuje ani bajt uzavřeného kódu.
Cesta upgradu zachovává stávající instalaci. Když správce edice Community naimportuje licenci Enterprise, konzole ji přečte a ověří a poté zobrazí části, které stáhne (zkompilované moduly a balíčky a doplňky uvedené v licenci), včetně jejich velikostí. Každá část se zkontroluje oproti klíči vydání společnosti Adverant a skupiny se postupně zapínají jedna po druhé. Uživatelé i soubory zůstávají tak, jak jsou, a totéž platí pro pracovní postupy a kanály, protože schéma již bylo stejné. Kapitola 2.7, Instalace edice Enterprise a použití licence, tento postup prochází v prostředí Kubernetes; pracoviště v izolovaném prostředí (air-gapped) importují tytéž části z médií, jak popisuje kapitola 2.10, Instalace v izolovaném prostředí.
Formy dodání a třídy ochrany
Nexus se dodává v šesti formách dodání, které matice nazývá SKU (skladové jednotky). Pět z nich kromě varianty Edge sdílí jeden podepsaný balíček a liší se zabalením a způsobem, jakým dorazí licence.
| SKU | Co to je | Jak dorazí licence |
|---|---|---|
saas |
Cloud Adverant | Vydává se s předplatným |
onprem-connected |
Helm do vašeho vlastního prostředí Kubernetes | Stahuje si ji instalace přes své odchozí připojení |
airgap |
Tentýž balíček, importovaný offline | Importuje se jako soubor, s podepsaným výkazem o využití jednou ročně |
self-serve-image |
Obraz stroje ve vašem vlastním cloudovém účtu | Samotný obraz nese pouze licence Community a zkušební licence; moduly Enterprise dorazí po vydání licence, včetně licence zakoupené v obchodě daného cloudu |
appliance |
Hardware sestavený výrobcem původního zařízení (OEM), který je jeho oficiálním výrobcem | Licence Enterprise; zařízení (appliance) je jednou z forem jejího dodání |
edge |
Nexus Edge, náklad na satelitech a dronech nebo na plavidlech a vozidlech | Jedna licence na platformu nebo flotilu, s dlouhou platností, platná i v režimu offline |
Druhou polovinou dodání je ochrana a stojí za to mluvit o ní otevřeně. Jakmile kód běží na hardwaru, který máte pod kontrolou, žádná technika jej neučiní nečitelným. Společnost Adverant proto třídí svůj kód do tříd ochrany a pro každou formu dodání rozhoduje, jak daleko smí jednotlivé třídy putovat. Existují čtyři úrovně:
| Třída | Co to znamená |
|---|---|
| P1, nikdy se nedodává | Logika běží u společnosti Adverant; instalace obsahuje podepsaného klienta. |
| P2, zapečetěno | Důvěrný virtuální počítač (VM), do kterého se nemůžete přihlásit, na hardwaru, kterého se nemůžete dotknout. |
| P3, zabezpečený nativní kód | Zkompilovaný, očištěný o symboly (stripped) a sestavený pro konkrétního držitele licence. Zvyšuje náročnost přečtení kódu z hodin na týdny. |
| P4, čitelný | Běžný JavaScript nebo TypeScript, stejně jako open source. |
| Třída ochrany | Cloud Adverant | Připojený on-prem | Izolované prostředí (air-gap) | Nexus Edge |
|---|---|---|---|---|
| Open source (celá edice Community) | P4 | P4 | P4 | P4 |
| Kód s nejvyšší hodnotou: hodnocení nápadů, jádro úložiště zapečetěných záznamů, modul zásad směrování, čtyři rozhodovací moduly balíčku Pojišťovnictví | P1 | P3, nebo P2 jako důvěrný VM zapečetěný společností Adverant ve vašem cloudovém tenantu | P3 | Nedodává se |
| Uzavřené serverové moduly, které rozhodují: serverový kód balíčků, mobilní brána | P1 | P3 | P3 | Nedodává se |
| Serverový kód balíčku Obrana a bezpečnost | P1 | P3 | P3 | P3 |
| Kód nákladu Nexus Edge | Nedodává se | Nedodává se | Nedodává se | P3 |
| Čitelné klientské definice: aplikace pro telefony, obrazovky balíčků pro telefony | P4 | P4 | P4 | P4 |
Z toho plynou dva důsledky. V aplikaci pro telefony se nedodává nic chráněného: každé pravidlo a pokyn (prompt) zůstává na serveru. A hodnota obsažená v pokynech, rubrikách nebo řetězcích agentů je čitelná pro každého, kdo provozuje model, kterému se odesílá. Tam, kde model vlastní vaše organizace, je tato hodnota chráněna licenční smlouvou a ničím jiným. Každý dodávaný obraz v jazyce TypeScript je sbalený (bundled) a minifikovaný bez map zdrojového kódu (source maps), což slouží spíše k pořádku než k ochraně.
Co to znamená, když vytváříte rozšíření
Vaše rozšíření stojí na stejné hranici jako vlastní moduly společnosti Adverant. Téměř celá tato kapitola se vztahuje i na ně.
Izolace, identita a cesta AI jsou součástí platformy v obou edicích. Zásuvný modul vytvořený pomocí @adverant-nexus/plugin-sdk dědí ohraničení dotazů s omezeným rozsahem, ověřovač tokenů a odesílání UNO, bez ohledu na to, ve které edici skončí. Kapitola 2.19, Pravidla, která dědí každé rozšíření, je vyjmenovává.
Omezování podle edic funguje pro vás stejným způsobem. Zásuvný modul deklaruje své identifikátory funkcí v bloku entitlements svého manifestu (featureIdPattern plus krátký seznam alwaysOn ponechaný pro kontroly stavu a stránku nastavení) a předtím, než obslouží chráněnou část, požádá platformu o verdikt. Verdiktem není nikdy prostá logická hodnota (boolean). Hodnota ENTITLEMENT_DENIED (403) znamená, že platforma odpověděla „ne“. Hodnota ENTITLEMENT_UNREACHABLE (502) znamená, že nepřišla žádná odpověď, a váš zásuvný modul musí přístup zamítnout namísto vytváření domněnek, protože výpadek interpretovaný jako „bez oprávnění“ by v tichosti snížil úroveň všem zákazníkům najednou. Odpověď „ano“ ukládejte do mezipaměti jen krátce a zamítnutí neukládejte do mezipaměti nikdy.
V edici Community dostává vývojář stejné výchozí šablony jako v edici Enterprise, a to jak pro zásuvné moduly a pohledy (lenses), tak pro dovednosti a pracovní postupy. Každý vývojář pracuje ve vývojovém prostoru s větvemi dat na jednom serveru a kód je uložen na platformě GitHub. Šablony oborových balíčků a platformy patří do edice Enterprise. Totéž platí pro časově omezené navýšení přístupu z vývojového prostředí IDE (integrated development environment): v edici Community neexistuje žádné oddělené produkční prostředí, do něhož by bylo možné přístup navýšit, a konzole to oznámí kódem PASS_TIER_REQUIRED.
Rozšíření, které využívá pouze rozhraní edice Community, běží beze změny v obou edicích. Rozšíření, které závisí na doplňku, například na Poště, se zobrazí jako uzamčené všude tam, kde licence danou skupinu nejmenuje. Kapitola 2.25, Vývoj pro jednotlivé edice, ukazuje, jak strukturovat rozšíření pro obě edice a jak jej oproti každé z nich otestovat.



