Versie 1.0.0-alpha.1nieuwste
Hoofdstuk 2.2
Edities onder de motorkap
Hoe Community en Enterprise uit één product worden gebouwd, hoe een licentie functiegroepen tijdens het draaien inschakelt, wat een Community-installatie toont voor een Enterprise-pagina, en wat dat betekent voor de images die u ophaalt en de extensies die u bouwt.
Deze pagina is door AI vertaald vanuit het Engelse origineel. Als er iets onduidelijk is, geldt de Engelse pagina als referentie. Lees deze pagina in het Engels

Twee regels in een values-bestand bepalen welke editie een installatie draait:
# harrow-values.yaml (Helm values): the edition of this installation
edition: enterprise
enterprise:
enabled: trueZe moeten overeenkomen. Stel edition: community in met enterprise.enabled: true en de chart stopt met "edition=community but enterprise.enabled=true: they must agree". Stel edition in op iets anders dan community of enterprise en hij stopt met NEXUS_EDITION_INVALID. Deze twee waarden kiezen welke images de installatie gebruikt. Wat die images vervolgens inschakelen is de zaak van de licentie, tijdens runtime, één functiegroep tegelijk.
Dit hoofdstuk ontleedt dat: wat de edities bevatten, hoe één product twee builds wordt, hoe een licentie verandert in een ja of een nee binnen een draaiende service, en wat dat betekent wanneer u zelf iets bouwt. Hoofdstuk 1.6, Edities en licenties in gewone taal, biedt het perspectief van de koper; dit is dat van de engineer.
De editiematrix
Alles in dit hoofdstuk komt uit één bestand: de editiematrix. Deze somt 97 mogelijkheden op en geeft elk daarvan een niveau. Adverant genereert hieruit de licentiecatalogus en de menuregels van de console, samen met de grens tussen open en gesloten code. Wanneer de matrix wijzigt, beweegt dit alles mee.
Er zijn drie edities.
| Editie | Licentie | Waar het draait |
|---|---|---|
| Community | Apache-2.0, open source, gratis | Uw hardware, of Adverant cloud |
| Team | Adverant Enterprise-licentie | Adverant cloud: Community plus de Team-set |
| Enterprise | Adverant Enterprise-licentie, per functiegroep | Uw hardware, of Adverant cloud |
Een installatie draait een van de twee: de waarde edition van de chart accepteert alleen community en enterprise. Team is een cloudeditie en Enterprise bevat ook de Team-set, dus op uw eigen hardware worden de Team-mogelijkheden (het werkpaneel dat naast elk record is vastgezet, gedeelde notebooks, geheugenbeleid voor de organisatie en de rest) geleverd bij Enterprise.
Enterprise zelf is gelaagd. De Enterprise-basis is de gesloten kern: meerdere organisaties en bedrijfsonderdelen, handhaving van single sign-on met SAML (Security Assertion Markup Language) en directorysynchronisatie, aangepaste rollen met vier-ogen-goedkeuringen, lange bewaartermijnen voor audits, gegevensbescherming, de operatorpagina's en clusterbeheer. Boven op de basis bevinden zich add-ons, elk afzonderlijk gelicentieerd, en domeinpakketten. De eerste add-on in de tabel, AI Gateway op schaal, verdeelt de belasting van de AI-router (kunstmatige intelligentie) over replica's en providers.
| Add-on | Vereist ook |
|---|---|
| AI Gateway op schaal | Basis |
| Modelfabriek | Basis |
| Ideeën | Basis |
| Oproepen en spraak | Basis |
| Basis | |
| Andere bedrijven en afscherming | Basis |
| Notitieboekstudio | Basis |
| Kaart en GeoAI | Basis |
| Dataconnectoren | Basis |
| Agent-naar-agent | Basis |
| Besluitvormingsruimtes en verzegelde dossiers | Basis |
| Omzetbeheer | Basis |
| Storefront / whitelabel | Basis |
| Nexus Edge | Basis |
| Mobiele apps | Basis |
| Workforce | Basis; voor agents op edge-apparaten is ook Nexus Edge vereist, voor goedkeuringen op een telefoon zijn ook Mobiele apps vereist |
| Shield | Basis |
| Sandboxes | Basis |
| Kwaliteit (NexusQA) | Basis |
Er zijn tien domeinpakketten:
- Verzekeringen
- Bankwezen en betalingsverkeer
- Kapitaalmarkten en vermogensbeheer
- Overheid en publieke sector
- Gezondheidszorg
- Biowetenschappen
- Kritieke infrastructuur en energie
- Defensie en veiligheid
- Juridische en zakelijke dienstverlening
- Logistiek en maritieme sector
Elk pakket vereist de Enterprise-basis, en vijf ervan vereisen ook een add-on. Het pakket Verzekeringen vereist Besluitvormingsruimtes en verzegelde records. Dat geldt ook voor het pakket Kapitaalmarkten en vermogensbeheer. Het pakket Juridische en zakelijke dienstverlening vereist die twee plus Mail. Logistiek en maritiem vereist Kaart en GeoAI. In het pakket Defensie en veiligheid vereisen platformmeldingen ook Nexus Edge. De telefoonschermen van elk pakket vereisen ook Mobiele apps. Hoofdstuk 1.7, Domeinpakketten en sectoren, beschrijft wat elk pakket bevat.
Functiegroepen
De eenheid die een licentie benoemt, is de functiegroep. Er zijn er 32: de Community-basislaag, de Team-set, de Enterprise-basis, één per add-on en één per pakket. Elke mogelijkheid behoort tot precies één groep, dus een licentie die "Enterprise-basis, Kaart en GeoAI, Logistiek en maritiem" vermeldt, geeft precies aan welke mogelijkheden deze installatie mag draaien.
| Niveau | Mogelijkheden |
|---|---|
| Community | 36 |
| Team | 6 |
| Enterprise-basis | 18 |
| Add-ons | 23 |
| Domeinpakketten | 14 |
Toekenningsbereik
Elke gelicentieerde mogelijkheid heeft een toekenningsbereik, dat aangeeft waaraan een toekenning is gekoppeld.
- Het tenantbereik dekt de onderdelen waarin mensen werken: Ideeën, Mail, Revenue operations, de pakketten. De licentie stelt deze beschikbaar voor de installatie, en ze worden vervolgens per organisatie en per bedrijfsonderdeel in- of uitgeschakeld. Een nieuwe organisatie erft nooit een status waarin alles is ingeschakeld.
- Het implementatiebereik dekt de vijf zaken die bij de installatie als geheel horen: licentie-import met de bijbehorende artefacten die worden opgehaald, de Enterprise-leveringsvormen, de operatorpagina's, clusterbeheer en Nexus Edge.
Community-mogelijkheden hebben helemaal geen toekenningsbereik. Ze hebben geen licentie nodig.
Een beheerder kan voor een organisatie of een onderdeel inperken wat de licentie toestaat. Niemand kan dit van binnenuit de installatie verruimen.
Één product, twee builds
Er is één Nexus-codebase. De Community-build is de open-source-export daarvan, en de Enterprise-build is die export plus gesloten modules.
Een grenslijst wijst elk gevolgd bestand toe aan een editie. Meestal gebeurt dit door de mogelijkheid te benoemen die een bestand implementeert, waarna de editie van het bestand volgt uit het niveau van die mogelijkheid: een Community-mogelijkheid maakt het een Community-bestand, en alles wat onder Team, basis, add-on of pakket valt, maakt het een Enterprise-bestand. Bestanden die in geen van beide edities worden meegeleverd, worden met een reden vermeld. Eén regel doorbreekt de rest: de databasemigraties van elke module worden in beide edities meegeleverd. Een Community-database en een Enterprise-database hebben dus hetzelfde schema, en het overzetten van een installatie van de ene naar de andere editie is een wijziging van wat er is ingeschakeld, zonder dat er gegevens hoeven te worden gemigreerd.
De Community-export bevat Apache-2.0-headers en een NOTICE-bestand, en elk pakket daarin is gelicentieerd onder Apache-2.0, behalve code van derden die zijn eigen licentie behoudt (MIT, BSD en andere) en ongewijzigd wordt gekopieerd, en enkele software development kit- (SDK) en command-line interface-pakketten (CLI) die hun eigen MIT-licentie behouden. De Enterprise-build is gelicentieerd onder de Adverant Enterprise-licentie. De voorwaarden hiervan staan gebruik alleen toe onder een schriftelijke licentie, voor de looptijd, implementaties en functiegroepen die in die licentie worden genoemd. Het verbod op reverse engineering behoudt uitdrukkelijk de rechten die de EU-wetgeving u geeft om software te bestuderen en te decompileren ten behoeve van interoperabiliteit.
De licentiegrens
Enterprise-code bereikt Community uitsluitend via één pakket: @adverant/nexus-spi, de service provider interface (SPI). Dit valt onder Apache-2.0 en bevat interfaces en type guards, zonder eigen runtime-logica.
| Export | Wat het is |
|---|---|
RouteModule |
Een gelicentieerde routemodule: de id, de functiegroep, de gelezen bodies en register(app, ctx) |
SpiApp |
Het deel van de HTTP-app van de host dat door een module wordt aangesproken: use |
SpiContext |
Wat de host aan een module overhandigt: de productpoort en scopebewaker, de licentielezer, de scoped-query-pool, upstream-adressen, platformclients |
SpiRuntime |
De waarden van de plug-in-SDK (software development kit) die de host aan een module overhandigt |
SpiPlane |
De schermgroepen en schermuitlezingen die een gelicentieerd vlak toevoegt |
ScreenModule |
De gelicentieerde schermgroep van een console: de routes, schermen en het menu |
GrantCheck |
De controle die een gelicentieerde module uitvoert op zijn eigen functiegroep |
Een controle in de build handhaaft de grens. Binnen de Enterprise-code zorgt een import vanuit de Community-pakketscopes (@adverant/ en @adverant-nexus/) ervoor dat de build mislukt, tenzij het @adverant/nexus-spi of een Enterprise-pakket betreft. Dat geldt ook voor een relatieve import die buiten de repository treedt, een file:-, link:- of workspace:-afhankelijkheid die naar buiten verwijst, een Git-URL die een Community-repository noemt, en een Go-replace die naar buiten verwijst. Over de grens heen vindt koppeling plaats via een netwerkprotocol of een bij het opstarten geladen module, nooit via gedeelde broncode. De SPI bevat zelfs zijn eigen vastgezette kopie van de typedeclaraties van de plug-in-SDK, omdat de SDK een Community-pakket is dat niet over de grens wordt toegelaten; de host overhandigt in plaats daarvan de runtime-waarden van de SDK aan een module.
Buildprofielen
De console en de BFF (backend for frontend) worden gecompileerd met een buildprofiel, dat de codeklassen binnen de image vastlegt. Het Community-profiel bevat Community-code; het Enterprise-profiel bevat Community- en Enterprise-code. Beide weigeren te starten wanneer hun profiel code bevat die de editie van de installatie niet heeft. De BFF meldt dit met PROFILE_OUTSIDE_EDITION en noemt de image die in plaats daarvan moet worden geïmplementeerd. U kunt geen Enterprise-console op een Community-installatie plaatsen door een image opnieuw te taggen.
Hoe een licentie functiegroepen inschakelt
Een licentie is een ondertekend document. Adverant ondertekent elke licentie met twee onafhankelijke sleutels, en niets anders op de installatie bepaalt wat er gelicentieerd is. U importeert deze via de licentiepagina's van de console, met nexusctl licence import <file>, of door het document te posten naar https://<hosts.auth>/api/v1/installation/licence. Een licentie is nooit een chart-waarde en nooit een gekoppeld bestand. Hoofdstuk 2.13, Licenties, behandelt het importeren en verlengen, en elke status die een licentie doorloopt.
De controle die ertoe doet, draait binnen elke gesloten module, op de eigen functiegroep van die module, voordat deze antwoordt. Dat is het GrantCheck-contract vanuit de SPI:
type GrantCheck = (featureGroup: string) => Promise<{ entitled: boolean; code?: "LICENCE_LOCKED" }>;De controle bevindt zich in de gesloten module, omdat een controle die in open-sourcecode is geschreven eenvoudigweg zou kunnen worden verwijderd. Een vervalste licentie telt als geen licentie. Een module waarvan de functiegroep niet in de licentie wordt genoemd, antwoordt met LICENCE_LOCKED.
De modules zelf worden ook gecontroleerd. nexus-keys bevat het ondertekende onderdelenmanifest van de release en de sleutel waarmee het is ondertekend. Het controleert elke gecompileerde module aan de hand van dat manifest bij het opstarten en vervolgens elke nacht om 03:53 UTC. Een module waarvan de handtekening niet overeenkomt, wordt nooit geladen en het ondertekende exemplaar dat zou worden vervangen, blijft draaien; de operatorpagina's tonen dit met MODULE_SIGNATURE_INVALID.
Boven de modulecontrole bevindt zich de weergavelaag, die bepaalt hoe een mogelijkheid aan elke persoon wordt getoond. Deze combineert de toekenningen van de licentie met het abonnement van de organisatie en de rol van de persoon, waardoor elk bedieningselement in een van de vier statussen terechtkomt.
| Status | Wat de persoon ziet |
|---|---|
| Gerechtigd | Het bedieningselement, normaal weergegeven |
| Teaser | Het bedieningselement in het grijs met een slotje; bij het openen wordt uitgelegd wat het is en wie het kan inschakelen |
| Verborgen | Niets; alleen gebruikt voor zaken waarvan de rol van deze persoon niet mag weten dat ze bestaan, zoals de privémailbox van een ander |
| Geweigerd met een code | Een weigeringspaneel met vermelding van de code, wanneer iemand een handeling probeert uit te voeren die niet is toegestaan |
De licentie heeft ook eigen statussen naarmate de einddatum nadert en verstrijkt. In elke status gelden twee regels: een licentie stopt nooit lopend werk, en beveiligingsupdates worden nooit achtergehouden.
Wat Community toont voor een Enterprise-pagina
Een Community-installatie behoudt de vorm van het product. Het menu heeft dezelfde rijen als Enterprise, en de Enterprise-rijen (Ideeën, Besluiten, Mail, Gesprekken, Andere bedrijven, Agents, Beleid, Compliance) worden in het grijs weergegeven met een slotpictogram. Er wordt niets verborgen om de editie compleet te laten lijken, en er zijn geen storende meldingen.
Het openen van een vergrendelde rij toont een teaser. Voor Ideeën luidt deze "Ideeën maakt deel uit van Enterprise", gevolgd door één alinea over wat Ideeën doet, en daarna "Wie dit kan inschakelen: uw beheerder, via een licentie van Adverant". Er worden twee knoppen aangeboden: "Vraag het uw beheerder" en "Bekijk wat het doet". Er staat geen prijs bij. Het openen van de pagina laadt niets en verzendt niets, en de promotie wordt slechts één keer getoond.
Het intypen van het adres van een pagina die alleen voor Enterprise is, leidt ook naar een nuttige plek. De Community-console kent de adressen van de pagina's die hij niet bevat, en stuurt elk daarvan door naar de bijbehorende editiepagina, binnen het normale kader met het menu. De pagina toont het paneel voor vergrendelde functies:
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
De code staat er ter referentie; de zinnen zijn voor de persoon die het leest.
De basislaag
Sommige zaken zitten nooit achter een betaalmuur, in geen enkele editie en onder geen enkele licentiestatus: basisbeheer en -beveiliging, tenantscheiding, gegevensexport, uitloggen en elk weigeringsscherm. Een Community-installatie beschikt over dit alles. Een Enterprise-installatie waarvan de licentie is verlopen, behoudt ze ook: de Enterprise-artefacten worden niet langer aangeboden, en de Community-basislaag en gegevensexport blijven behouden. U kunt uw gegevens er altijd uithalen.
Images per editie
Elke image in een release wordt op basis van digest vermeld in de image-lock van de chart, en de lock zelf behoort tot één editie. De chart controleert elke image die hij rendert aan de hand van de lock en de editie waarom u hebt gevraagd. Een Community-installatie accepteert alleen Community-images. Vraagt u om iets anders, dan stopt hij: "a community install takes only community images". Een Enterprise-lock bevat de Community-images plus de Enterprise-builds.
Dat is van belang voor de locatie waar u vandaan pullt. Community-images zijn openbaar, op registry.adverant.ai/nexus/<service>@sha256:…. Enterprise-images komen uit hetzelfde register met een pull-token, dat u verkrijgt via de pagina "Pull tokens and install commands" van uw Adverant-account. Een Community-installatie heeft dat token nooit nodig en bevat geen enkele byte aan gesloten code.
Het upgradepad behoudt de installatie. Wanneer een Community-beheerder een Enterprise-licentie importeert, leest en verifieert de console deze en toont vervolgens de onderdelen die hij zal ophalen (de gecompileerde modules en de pakketten en add-ons die de licentie noemt) met hun groottes. Elk onderdeel wordt gecontroleerd aan de hand van de Adverant-releasesleutel, en de groepen worden één voor één ingeschakeld. Personen en bestanden blijven zoals ze zijn, en dat geldt ook voor workflows en kanalen, omdat het schema al hetzelfde was. Hoofdstuk 2.7, Enterprise installeren en een licentie toepassen, doorloopt dit proces op Kubernetes; air-gapped locaties importeren dezelfde onderdelen vanaf gegevensdragers, zoals hoofdstuk 2.10, Air-gapped installatie, beschrijft.
Leveringsvormen en beschermingsklassen
Nexus wordt geleverd in zes leveringsvormen, die in de matrix SKU's (stock-keeping units) worden genoemd. De vijf vormen naast Edge delen één ondertekende bundel en verschillen in verpakking en in de manier waarop de licentie binnenkomt.
| SKU | Wat het is | Hoe de licentie binnenkomt |
|---|---|---|
saas |
Adverant cloud | Uitgegeven bij het abonnement |
onprem-connected |
Helm op uw eigen Kubernetes | Opgehaald door de installatie via de uitgaande verbinding |
airgap |
Dezelfde bundel, offline geïmporteerd | Geïmporteerd als een bestand, met eenmaal per jaar een ondertekende gebruiksverklaring |
self-serve-image |
Een machine-image in uw eigen cloudaccount | De image zelf bevat alleen Community- en evaluatielicenties; Enterprise-modules komen binnen zodra er een licentie is uitgegeven, inclusief een licentie die via de store van de cloud is aangeschaft |
appliance |
Hardware gebouwd door een original equipment manufacturer (OEM), die tevens de geregistreerde fabrikant is | Een Enterprise-licentie; de appliance is een van de leveringsvormen |
edge |
Nexus Edge, de payload op satellieten en drones, of op vaartuigen en voertuigen | Eén licentie per platform of vloot, met lange levensduur, geldig terwijl deze offline is |
Bescherming vormt de andere helft van de levering, en het is goed om daar duidelijk over te zijn. Zodra code draait op hardware die u beheert, kan geen enkele techniek deze onleesbaar maken. Daarom verdeelt Adverant zijn code in beschermingsklassen en bepaalt het voor elke leveringsvorm hoe ver elke klasse mag reizen. Er zijn vier niveaus:
| Klasse | Wat het betekent |
|---|---|
| P1, nooit meegeleverd | De logica draait bij Adverant; de installatie bevat een ondertekende client. |
| P2, verzegeld | Een vertrouwelijke virtuele machine (VM) waarop u niet kunt inloggen, op hardware die u niet kunt aanraken. |
| P3, geharde native code | Gecompileerd, gestript en gebouwd per licentiehouder. Het verhoogt de inspanning om de code te lezen van uren naar weken. |
| P4, leesbaar | Gewoon JavaScript of TypeScript, zoals open source dat is. |
| Beschermingsklasse | Adverant cloud | Verbonden on-prem | Air-gap | Nexus Edge |
|---|---|---|---|---|
| Open source (heel Community) | P4 | P4 | P4 | P4 |
| Code met de hoogste waarde: ideescores, de kern van de opslag voor verzegelde records, de engine voor routeringsbeleid, de vier beslissingsengines van het pakket Verzekeringen | P1 | P3, of P2 als een door Adverant verzegelde vertrouwelijke VM in uw cloud-tenancy | P3 | Niet meegeleverd |
| Gesloten servermodules die beslissen: pakketservercode, de mobiele gateway | P1 | P3 | P3 | Niet meegeleverd |
| Servercode van het pakket Defensie en veiligheid | P1 | P3 | P3 | P3 |
| Payloadcode van Nexus Edge | Niet meegeleverd | Niet meegeleverd | Niet meegeleverd | P3 |
| Leesbare clientdefinities: telefoon-apps, telefoonschermen van pakketten | P4 | P4 | P4 | P4 |
Hieruit volgen twee consequenties. Er wordt niets beschermds meegeleverd in een telefoon-app: elke regel en prompt blijft op de server. En waarde die is vervat in prompts, rubrieken of agentketens is leesbaar voor degene die het model draait waarnaar deze wordt verzonden. Wanneer uw organisatie eigenaar is van het model, wordt die waarde uitsluitend beschermd door het licentiecontract en door niets anders. Elke meegeleverde TypeScript-image is gebundeld en geminificeerd zonder source maps, wat eerder voor netheid zorgt dan voor bescherming.
Wat dit betekent wanneer u een extensie bouwt
Uw extensie bevindt zich op dezelfde lijn als de eigen modules van Adverant. Bijna dit hele hoofdstuk is erop van toepassing.
Isolatie, identiteit en het AI-pad worden in beide edities met het platform meegeleverd. Een plug-in die is gebouwd met @adverant-nexus/plugin-sdk erft de scoped-query-afscherming, de tokenverificateur en UNO-dispatch, op welke editie deze ook terechtkomt. Hoofdstuk 2.19, De regels die elke extensie erft, somt deze op.
Editie-afscherming werkt voor u op dezelfde manier. Een plug-in declareert zijn functie-id's in het entitlements-blok van zijn manifest (featureIdPattern, plus een korte alwaysOn-lijst die wordt bijgehouden voor statuscontroles en de instellingenpagina) en vraagt het platform om een oordeel voordat het een afgeschermd oppervlak bedient. Het oordeel is nooit een kale boolean. ENTITLEMENT_DENIED (403) betekent dat het platform nee heeft geantwoord. ENTITLEMENT_UNREACHABLE (502) betekent dat er geen antwoord was, en uw plug-in moet in dat geval weigeren in plaats van aannames te doen, omdat een storing die wordt gelezen als "niet gerechtigd" elke klant tegelijkertijd stilzwijgend degradeert. Cache een 'ja' kortstondig en cache een weigering nooit.
Op Community krijgt een ontwikkelaar dezelfde startsjablonen als op Enterprise, zowel voor plug-ins en lenzen als voor vaardigheden en workflows. Elke ontwikkelaar werkt in een ontwikkelruimte met datavertakkingen op die ene server, en de code staat in GitHub. Domeinpakket- en platformsjablonen zijn voorbehouden aan Enterprise. Dat geldt ook voor tijdelijke verhoging van toegangsrechten vanuit een IDE (integrated development environment): op Community is er geen afzonderlijke productieomgeving waarvoor u uw toegangsrechten kunt verhogen, en de console meldt dit met PASS_TIER_REQUIRED.
Een extensie die alleen Community-koppelpunten gebruikt, draait ongewijzigd op beide edities. Een extensie die afhankelijk is van een add-on, bijvoorbeeld Mail, wordt als vergrendeld weergegeven overal waar de licentie die groep niet noemt. Hoofdstuk 2.25, Bouwen voor elke editie, laat zien hoe u een extensie voor beide structureert, en hoe u deze tegen elke editie test.



