AnmeldenBriefing buchen

Kapitel 2.2

Editionen unter der Haube

Wie Community und Enterprise aus einem einzigen Produkt erstellt werden, wie eine Lizenz Funktionsgruppen zur Laufzeit aktiviert, was eine Community-Installation bei einer Enterprise-Seite anzeigt und was das für die von Ihnen abgerufenen Images und die von Ihnen entwickelten Erweiterungen bedeutet.

Diese Seite wurde mithilfe von KI aus dem englischen Original übersetzt. Bei Unklarheiten gilt die englische Seite als Referenz. Diese Seite auf Englisch lesen

17 Minuten Lesezeit

Zwei Zeilen in einer Values-Datei entscheiden darüber, mit welcher Edition eine Installation läuft:

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

Sie müssen übereinstimmen. Setzen Sie edition: community zusammen mit enterprise.enabled: true, bricht das Chart mit der Meldung „edition=community but enterprise.enabled=true: they must agree“ ab. Setzen Sie edition auf einen anderen Wert als community oder enterprise, bricht es mit NEXUS_EDITION_INVALID ab. Diese beiden Werte bestimmen, welche Images die Installation bezieht. Was diese Images anschließend aktivieren, entscheidet die Lizenz zur Laufzeit – Funktionsgruppe für Funktionsgruppe.

Dieses Kapitel schlüsselt das im Detail auf: was die Editionen enthalten, wie aus einem Produkt zwei Builds entstehen, wie eine Lizenz innerhalb eines laufenden Dienstes zu einem Ja oder Nein wird und was das bedeutet, wenn Sie etwas Eigenes entwickeln. Kapitel 1.6, Editionen und Lizenzen verständlich erklärt, zeigt die Perspektive des Einkäufers; hier folgt die Sicht der Entwickler.

Die Editionsmatrix

Alles in diesem Kapitel stammt aus einer einzigen Datei: der Editionsmatrix. Sie führt 97 Fähigkeiten auf und ordnet jeder eine Stufe zu. Adverant generiert daraus den Lizenzkatalog und die Menüregeln der Konsole sowie die Grenze zwischen quelloffenem und proprietärem Code. Ändert sich die Matrix, ändert sich all das gemeinsam.

Es gibt drei Editionen.

Edition Lizenz Ausführungsort
Community Apache-2.0, Open Source, kostenlos Ihre Hardware oder Adverant Cloud
Team Adverant Enterprise-Lizenz Adverant Cloud: Community plus das Team-Paket
Enterprise Adverant Enterprise-Lizenz, pro Funktionsgruppe Ihre Hardware oder Adverant Cloud

Auf einer Installation läuft eine von zweien: Der Wert edition des Charts akzeptiert nur community und enterprise. Team ist eine Cloud-Edition, und Enterprise umfasst auch das Team-Paket. Auf Ihrer eigenen Hardware sind die Team-Fähigkeiten (das neben jedem Datensatz angedockte Arbeitsfeld, geteilte Notizbücher, Speicher-Richtlinien für die Organisation und die übrigen Funktionen) daher in Enterprise enthalten.

Enterprise selbst ist in Schichten aufgebaut. Die Enterprise-Basis bildet den proprietären Kern: mehrere Organisationen und Geschäftseinheiten, Durchsetzung von Single Sign-on mit SAML (Security Assertion Markup Language) und Verzeichnissynchronisierung, benutzerdefinierte Rollen mit Vier-Augen-Freigaben, lange Aufbewahrungsfristen für Audit-Protokolle, Datenschutz, die Betreiberseiten und die Cluster-Verwaltung. Auf der Basis setzen Add-ons, die jeweils separat lizenziert werden, sowie Domänenpakete auf. Das erste Add-on in der Tabelle, AI Gateway at scale, verteilt die Last des KI-Routers (künstliche Intelligenz) über Replikate und Anbieter hinweg.

Add-on Benötigt außerdem
KI-Gateway im großen Maßstab Basis
Modellfabrik Basis
Ideen Basis
Anrufe und Sprache Basis
E-Mail Basis
Andere Firmen und Schutzmauern Basis
Notizbuch-Studio Basis
Karte und GeoAI Basis
Datenkonnektoren Basis
Agent-zu-Agent Basis
Entscheidungsräume und versiegelte Datensätze Basis
Revenue Operations Basis
Storefront / White-Label Basis
Nexus Edge Basis
Mobile Apps Basis
Workforce Basis; Agenten auf Edge-Geräten benötigen zudem Nexus Edge, Freigaben auf einem Smartphone erfordern außerdem Mobile Apps
Shield Basis
Sandboxes Basis
Qualität (NexusQA) Basis

Es gibt zehn Domänenpakete:

  • Versicherungswesen
  • Bankwesen und Zahlungsverkehr
  • Kapitalmärkte und Vermögensverwaltung
  • Regierung und öffentlicher Sektor
  • Gesundheitswesen
  • Biowissenschaften
  • Kritische Infrastruktur und Energie
  • Verteidigung und Sicherheit
  • Rechtsberatung und professionelle Dienstleistungen
  • Logistik und Schifffahrt

Jedes Paket setzt die Enterprise-Basis voraus, und fünf davon benötigen zusätzlich ein Add-on. Das Paket für Versicherungen (Insurance) benötigt Entscheidungsräume und versiegelte Datensätze (Decision rooms and sealed records). Dasselbe gilt für das Paket für Kapitalmärkte und Vermögensverwaltung (Capital markets and asset management). Das Paket für Rechts- und Beratungsdienstleistungen (Legal and professional services) benötigt diese beiden sowie Mail. Logistik und Schifffahrt (Logistics and maritime) erfordert Karten und GeoAI (Map and GeoAI). Im Paket für Verteidigung und Sicherheit (Defence and security) benötigen Plattformwarnungen zusätzlich Nexus Edge. Die Smartphone-Ansichten sämtlicher Pakete erfordern außerdem Mobile Apps. Kapitel 1.7, Domänenpakete und Branchenlösungen, beschreibt den Inhalt jedes Pakets.

Funktionsgruppen

Die Einheit, die in einer Lizenz benannt wird, ist die Funktionsgruppe. Es gibt 32 davon: das Community-Fundament, das Team-Paket, die Enterprise-Basis, je eine pro Add-on und je eine pro Domänenpaket. Jede Fähigkeit gehört zu genau einer Gruppe. Eine Lizenz mit den Einträgen „Enterprise base, Map and GeoAI, Logistics and maritime“ legt somit präzise fest, welche Fähigkeiten diese Installation ausführen darf.

Stufe Fähigkeiten
Community 36
Team 6
Enterprise-Basis 18
Add-ons 23
Domain Packs 14

Berechtigungsumfang

Jede lizenzierte Fähigkeit hat einen Berechtigungsumfang (Grant Scope), der festlegt, woran eine Berechtigung gebunden ist.

  • Der Mandantenumfang (Tenant Scope) deckt die Bereiche ab, in denen Benutzer arbeiten: Ideen (Ideas), Mail, Revenue Operations und die Domänenpakete. Die Lizenz stellt sie der Installation zur Verfügung; anschließend werden sie pro Organisation und pro Geschäftseinheit ein- oder ausgeschaltet. Eine neue Organisation erbt niemals einen Zustand, in dem alles aktiviert ist.
  • Der Bereitstellungsumfang (Deployment Scope) umfasst die fünf Dinge, die zur Installation als Ganzes gehören: den Lizenzimport samt der abgerufenen Artefakte, die Enterprise-Auslieferungsformen, die Betreiberseiten, die Cluster-Verwaltung und Nexus Edge.

Community-Fähigkeiten haben überhaupt keinen Berechtigungsumfang. Sie benötigen keine Lizenz.

Ein Administrator kann für eine Organisation oder eine Geschäftseinheit einschränken, was die Lizenz erlaubt. Niemand kann diesen Rahmen innerhalb der Installation erweitern.

Ein vertikaler Stapel aus sechs Schichten. Von unten nach oben: „Fundament (jede Edition, niemals hinter einer Bezahlschranke)“; „Community, Apache-2.0“; eine dicke Doppellinie mit der Beschriftung „@adverant/nexus-spi, die einzige gemeinsame Schnittstelle“; „Enterprise-Basis, proprietäre Module“; „Add-ons (19), jeweils separat lizenziert“; „Domänenpakete (10)“. Rechts davon ein Kasten „Signiertes Lizenzdokument“ mit einem Pfeil auf die drei oberen Schichten, beschriftet mit „geprüft innerhalb jedes proprietären Moduls“. Links neben der Community-Schicht die Notiz „Community-Images: nur Open Source“.
Die Editionen als Schichten, mit dem Lizenzdokument als einziger maßgeblicher Instanz.

Ein Produkt, zwei Builds

Es gibt eine einzige Nexus-Codebasis. Der Community-Build ist deren Open-Source-Export, und der Enterprise-Build besteht aus diesem Export zuzüglich proprietärer Module.

Eine Grenzliste (Boundary List) ordnet jede versionsverwaltete Datei einer Edition zu. Meist geschieht dies durch Benennung der Fähigkeit, die eine Datei implementiert, woraus sich über die Stufe der Fähigkeit die Edition der Datei ergibt: Eine Community-Fähigkeit macht die Datei zu einer Community-Datei, und alles aus den Bereichen Team, Basis, Add-on oder Domänenpaket macht sie zu einer Enterprise-Datei. Dateien, die in keiner der beiden Editionen ausgeliefert werden, sind mit einer Begründung aufgeführt. Eine Regel gilt übergreifend: Die Datenbankmigrationen jedes Moduls werden in beiden Editionen ausgeliefert. Eine Community-Datenbank und eine Enterprise-Datenbank haben somit dasselbe Schema, und der Wechsel einer Installation von einer Edition zur anderen ändert lediglich, was aktiviert ist – ohne dass Daten migriert werden müssen.

Der Community-Export enthält Apache-2.0-Header und eine NOTICE-Datei. Jedes darin enthaltene Paket ist unter Apache-2.0 lizenziert, mit Ausnahme von Drittanbieter-Code, der seine eigene Lizenz behält (MIT, BSD und andere) und unverändert übernommen wird, sowie einigen SDK- (Software Development Kit) und CLI-Paketen (Command-Line Interface), die ihre eigene MIT-Lizenz behalten. Der Enterprise-Build wird unter der Adverant Enterprise-Lizenz lizenziert. Deren Bedingungen gestatten die Nutzung nur im Rahmen einer schriftlichen Lizenz für die darin genannten Laufzeiten, Bereitstellungen und Funktionsgruppen. Das Verbot des Reverse Engineering wahrt ausdrücklich die Rechte, die Ihnen das EU-Recht einräumt, um Software zu untersuchen und zur Herstellung der Interoperabilität zu dekompilieren.

Die Lizenzgrenze

Enterprise-Code greift nur über ein einziges Paket auf Community zu: @adverant/nexus-spi, das Service Provider Interface (SPI). Es steht unter der Apache-2.0-Lizenz und enthält Schnittstellen sowie Type Guards, jedoch keine eigene Laufzeitlogik.

Export Was es ist
RouteModule Ein lizenziertes Routenmodul: seine ID, seine Funktionsgruppe, die gelesenen Nachrichtenrümpfe und register(app, ctx)
SpiApp Der Teil der HTTP-Anwendung des Hosts, auf den ein Modul zugreift: use
SpiContext Was der Host einem Modul übergibt: das Produkt-Gate und den Scope Guard, den Lizenzleser, den Scoped-Query-Pool, Upstream-Adressen, Plattform-Clients
SpiRuntime Die Werte des Plugin-SDK (Software Development Kit), die der Host einem Modul übergibt
SpiPlane Die Ansichtsgruppen und Ansichtsabfragen, die eine lizenzierte Ebene hinzufügt
ScreenModule Eine lizenzierte Ansichtsgruppe der Konsole: ihre Routen, Ansichten und ihr Menü
GrantCheck Die Prüfung, die ein lizenziertes Modul für seine eigene Funktionsgruppe durchführt

Eine Prüfung im Build-Prozess setzt diese Grenze durch. Innerhalb des Enterprise-Codes führt ein Import aus den Community-Paketbereichen (@adverant/ und @adverant-nexus/) zum Abbruch des Builds, sofern es sich nicht um @adverant/nexus-spi oder ein Enterprise-Paket handelt. Gleiches gilt für einen relativen Import, der das Repository verlässt, eine file:-, link:- oder workspace:-Abhängigkeit, die nach außen verweist, eine Git-URL, die ein Community-Repository benennt, und eine Go-replace-Direktive, die nach außen zeigt. Über die Grenze hinweg erfolgt die Kopplung über ein Netzwerkprotokoll oder ein beim Start geladenes Modul, niemals über gemeinsam genutzten Quellcode. Das SPI führt sogar eine eigene, auf eine feste Version fixierte Kopie der Typdeklarationen des Plugin-SDK mit, da das SDK ein Community-Paket ist, das die Grenze nicht zulässt; stattdessen übergibt der Host einem Modul die Laufzeitwerte des SDK.

Build-Profile

Die Konsole und das BFF (Backend for Frontend) werden mit einem Build-Profil kompiliert, das die Codeklassen innerhalb des Images festlegt. Das Community-Profil enthält Community-Code; das Enterprise-Profil enthält Community- und Enterprise-Code. Beide verweigern den Start, wenn ihr Profil Code enthält, den die Edition der Installation nicht vorsieht. Das BFF meldet dies mit PROFILE_OUTSIDE_EDITION und nennt das Image, das stattdessen bereitgestellt werden muss. Sie können keine Enterprise-Konsole auf einer Community-Installation betreiben, indem Sie einfach ein Image umbenennen (Retagging).

Links ein Kasten „Nexus-Quellcode“ mit einem kleineren Kasten „Editionsmatrix“ darin. Ein mit „Grenzliste“ beschrifteter Pfeil teilt sich in zwei Zweige auf. Der obere Pfeil führt zu „Community-Export (Apache-2.0)“ und weiter zu „Community-Images“. Der untere Pfeil führt zu „Enterprise-Build“, der zudem einen Pfeil vom Community-Export und einen von einem Kasten „proprietäre Module“ erhält und zu „Enterprise-Images“ führt. Zwischen den proprietären Modulen und dem Community-Export verläuft eine Abgrenzung mit der Beschriftung „Lizenzgrenze: nur @adverant/nexus-spi“. Eine kleine Notiz unter beiden Image-Kästen lautet „dasselbe Datenbankschema“.
Wie aus einem Quellcodebaum zwei Editionen entstehen.

Wie eine Lizenz Funktionsgruppen aktiviert

Eine Lizenz ist ein signiertes Dokument. Adverant signiert jede Lizenz mit zwei unabhängigen Schlüsseln, und nichts anderes auf der Installation entscheidet darüber, was lizenziert ist. Sie importieren sie über die Lizenzseiten der Konsole, mit nexusctl licence import <file> oder indem Sie das Dokument per POST an https://<hosts.auth>/api/v1/installation/licence senden. Eine Lizenz ist niemals ein Chart-Wert und niemals eine eingebundene Datei. Kapitel 2.13, Lizenzen, behandelt den Import und die Verlängerung sowie jeden Status, den eine Lizenz durchläuft.

Die entscheidende Prüfung läuft innerhalb jedes proprietären Moduls für dessen eigene Funktionsgruppe ab, bevor es antwortet. Das ist der GrantCheck-Vertrag aus dem SPI:

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

Die Prüfung befindet sich im proprietären Modul, da eine Prüfung im Open-Source-Code schlicht gelöscht werden könnte. Eine gefälschte Lizenz gilt als nicht vorhandene Lizenz. Ein Modul, dessen Funktionsgruppe in der Lizenz nicht aufgeführt ist, antwortet mit LICENCE_LOCKED.

Die Module selbst werden ebenfalls geprüft. nexus-keys verwahrt das signierte Komponentenmanifest des Releases sowie den Schlüssel, mit dem es signiert wurde. Es prüft jedes kompilierte Modul beim Start und danach jede Nacht um 03:53 UTC gegen dieses Manifest. Ein Modul, dessen Signatur nicht übereinstimmt, wird niemals geladen, und die signierte Kopie, die es hätte ersetzen sollen, läuft weiter; die Betreiberseiten zeigen dies mit MODULE_SIGNATURE_INVALID an.

Kompilierte Komponenten
Kompilierte Komponenten
Die Seite für kompilierte Komponenten führt jedes lizenzierte Modul mit seiner Funktionsgruppe, Version und Signaturprüfung auf. Eine veränderte Kopie, die ihre Prüfung nicht bestanden hat, erscheint als Ablehnungshinweis, während die signierte Kopie weiterläuft.

Über der Modulprüfung liegt die Darstellungsschicht, die entscheidet, wie eine Fähigkeit für die jeweilige Person erscheint. Sie kombiniert die Berechtigungen der Lizenz mit dem Tarif der Organisation und der Rolle der Person, sodass jedes Steuerelement in einem von vier Zuständen landet.

Zustand Was die Person sieht
Berechtigt Das Steuerelement, normal dargestellt
Vorschau (Teaser) Das Steuerelement ausgegraut mit einem Schlosssymbol; beim Öffnen wird erklärt, worum es sich handelt und wer es aktivieren kann
Ausgeblendet Nichts; wird nur für Dinge verwendet, von deren Existenz die Rolle dieser Person nichts wissen darf, wie etwa das private Postfach einer anderen Person
Mit Code abgelehnt Ein Ablehnungshinweis mit Angabe des Codes, wenn jemand eine Aktion versucht, die nicht erlaubt ist

Auch die Lizenz selbst durchläuft eigene Zustände, wenn sie sich ihrem Ablaufdatum nähert und dieses überschreitet. In jedem Zustand gelten zwei Regeln: Eine Lizenz bricht niemals laufende Arbeiten ab, und Sicherheitsupdates werden niemals zurückgehalten.

Was Community bei einer Enterprise-Seite anzeigt

Eine Community-Installation behält die Form des Produkts bei. Das Menü weist dieselben Zeilen auf wie Enterprise, wobei die Enterprise-Einträge (Ideen, Entscheidungen, Mail, Anrufe, Andere Firmen, Agenten, Richtlinien, Compliance) ausgegraut und mit einem Schlosssymbol dargestellt werden. Nichts wird versteckt, um die Edition vollständig wirken zu lassen, und es gibt keine aufdringlichen Einblendungen.

Das Öffnen einer gesperrten Zeile zeigt eine Vorschau (Teaser). Für „Ideen“ lautet sie „Ideen ist Teil von Enterprise“, gefolgt von einem Absatz darüber, was die Funktion leistet, und dem Hinweis „Wer es aktivieren kann: Ihr Administrator, über eine Lizenz von Adverant“. Es werden zwei Schaltflächen angeboten: „Ihren Administrator fragen“ und „Funktionen ansehen“. Ein Preis wird nicht genannt. Beim Öffnen der Seite wird nichts nachgeladen und nichts gesendet, und der Hinweis wird nur einmal angezeigt.

Etwas, das Sie nicht haben
Etwas, das Sie nicht haben
Ein gesperrter Bereich in der Community-Edition nennt, wer ihn aktivieren kann und was Community Ihnen bereits bietet. Die Zeile verbleibt ausgegraut mit einem Schloss im Menü, sodass das Produkt in beiden Editionen gleich aussieht.

Auch die direkte Eingabe der Adresse einer reinen Enterprise-Seite führt zu einem nützlichen Ziel. Die Community-Konsole kennt die Adressen der Seiten, über die sie nicht verfügt, und leitet jede davon an ihre Editionsseite weiter – innerhalb des normalen Rahmens mit dem Menü. Die Seite zeigt den Hinweis für gesperrte Funktionen an:

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

Der Code dient als Referenz; die Sätze richten sich an die lesende Person.

Das Fundament

Einige Dinge liegen niemals hinter einer Bezahlschranke – in keiner Edition und in keinem Lizenzstatus: Grundlagen der Administration und Sicherheit, Mandantentrennung, Datenexport, Abmeldung sowie jede Ablehnungsansicht. Eine Community-Installation verfügt über all dies. Eine Enterprise-Installation, deren Lizenz abgelaufen ist, behält diese Funktionen ebenfalls: Die Enterprise-Artefakte werden nicht mehr angeboten, aber das Community-Fundament und der Datenexport bleiben erhalten. Sie können Ihre Daten jederzeit exportieren.

Von Community zu Enterprise
Von Community zu Enterprise
Beim Importieren einer Lizenz auf einer Community-Installation wird vorab angezeigt, was abgerufen wird, was sich ändert und was erhalten bleibt, bevor irgendetwas geschieht. Die Schaltfläche lautet „Abrufen und aktivieren“, und es wird nichts abgerufen, solange sie nicht betätigt wurde.

Images nach Edition

Jedes Image in einem Release ist über seinen Digest im Image-Lock des Charts aufgeführt, und das Lock selbst gehört zu einer bestimmten Edition. Das Chart prüft jedes gerenderte Image gegen das Lock und gegen die von Ihnen angeforderte Edition. Eine Community-Installation akzeptiert nur Community-Images. Fordern Sie etwas anderes an, bricht sie mit der Meldung ab: „a community install takes only community images“. Ein Enterprise-Lock enthält die Community-Images sowie die Enterprise-Builds.

Das ist entscheidend dafür, woher Sie die Images beziehen. Community-Images sind öffentlich unter registry.adverant.ai/nexus/<service>@sha256:… verfügbar. Enterprise-Images stammen aus derselben Registry, erfordern jedoch ein Pull-Token, das Sie auf der Seite „Pull-Tokens und Installationsbefehle“ Ihres Adverant-Kontos erhalten. Eine Community-Installation benötigt dieses Token niemals und enthält kein einziges Byte proprietären Codes.

Der Upgrade-Pfad erhält die bestehende Installation. Wenn ein Community-Administrator eine Enterprise-Lizenz importiert, liest und verifiziert die Konsole diese und zeigt anschließend die abzurufenden Komponenten (die kompilierten Module sowie die in der Lizenz genannten Pakete und Add-ons) samt ihrer Größe an. Jede Komponente wird gegen den Release-Schlüssel von Adverant geprüft, und die Gruppen werden nacheinander aktiviert. Benutzer und Dateien bleiben unverändert, ebenso wie Workflows und Kanäle, da das Datenbankschema bereits identisch war. Kapitel 2.7, Enterprise installieren und eine Lizenz anwenden, führt Schritt für Schritt durch diesen Vorgang unter Kubernetes; vom Internet getrennte (Air-Gapped) Standorte importieren dieselben Komponenten über Datenträger, wie in Kapitel 2.10, Air-Gapped-Installation, beschrieben.

Bereitstellungsformen und Schutzklassen

Nexus wird in sechs Auslieferungsformen bereitgestellt, die in der Matrix als SKUs (Stock-Keeping Units) bezeichnet werden. Die fünf Formen außer Edge teilen sich ein einziges signiertes Bundle und unterscheiden sich in der Paketierung sowie darin, wie die Lizenz übermittelt wird.

SKU Was es ist Wie die Lizenz übermittelt wird
saas Adverant Cloud Wird mit dem Abonnement ausgestellt
onprem-connected Helm auf Ihrem eigenen Kubernetes Wird von der Installation über ihre ausgehende Verbindung abgerufen
airgap Dasselbe Bundle, offline importiert Wird als Datei importiert, mit einer signierten Nutzungserklärung einmal pro Jahr
self-serve-image Ein Machine Image in Ihrem eigenen Cloud-Konto Das Image selbst enthält nur Community- und Evaluierungslizenzen; Enterprise-Module werden nachgereicht, sobald eine Lizenz ausgestellt wird, einschließlich einer über den Store der Cloud erworbenen Lizenz
appliance Hardware eines Originalgeräteherstellers (OEM), der als eingetragener Hersteller fungiert Eine Enterprise-Lizenz; die Appliance ist eine ihrer Auslieferungsformen
edge Nexus Edge, die Nutzlast auf Satelliten und Drohnen oder auf Schiffen und Fahrzeugen Eine Lizenz pro Plattform oder Flotte, langlebig, auch im Offline-Betrieb gültig

Der Schutz des Codes ist die andere Seite der Auslieferung, und hier ist Offenheit angebracht. Sobald Code auf Hardware läuft, die Sie kontrollieren, kann keine Technik ihn vollständig unlesbar machen. Daher teilt Adverant seinen Code in Schutzklassen ein und entscheidet für jede Auslieferungsform, wie weit jede Klasse weitergegeben werden darf. Es gibt vier Stufen:

Klasse Bedeutung
P1, wird niemals ausgeliefert Die Logik läuft bei Adverant; die Installation enthält einen signierten Client.
P2, versiegelt Eine vertrauliche virtuelle Maschine (Confidential VM), bei der Sie sich nicht anmelden können, auf Hardware, auf die Sie keinen physischen Zugriff haben.
P3, gehärteter nativer Code Kompiliert, ohne Debug-Symbole (stripped) und individuell pro Lizenznehmer gebaut. Dies erhöht den Aufwand für das Lesen des Codes von Stunden auf Wochen.
P4, lesbar Gewöhnliches JavaScript oder TypeScript, wie bei Open Source üblich.
Schutzklasse Adverant Cloud On-Premises (verbunden) Air-Gap Nexus Edge
Open Source (gesamte Community-Edition) P4 P4 P4 P4
Besonders schützenswerter Code: Ideenbewertung, der Kern des Speichers für versiegelte Datensätze, die Routing-Richtlinien-Engine, die vier Entscheidungs-Engines des Versicherungspakets P1 P3 oder P2 als von Adverant versiegelte vertrauliche VM in Ihrem Cloud-Mandanten P3 Wird nicht ausgeliefert
Proprietäre Servermodule, die Entscheidungen treffen: Paket-Servercode, das Mobile-Gateway P1 P3 P3 Wird nicht ausgeliefert
Servercode des Pakets für Verteidigung und Sicherheit P1 P3 P3 P3
Nutzlastcode von Nexus Edge Wird nicht ausgeliefert Wird nicht ausgeliefert Wird nicht ausgeliefert P3
Lesbare Client-Definitionen: Smartphone-Apps, Smartphone-Ansichten der Pakete P4 P4 P4 P4

Daraus ergeben sich zwei Konsequenzen. In einer Smartphone-App wird keinerlei geschützter Code ausgeliefert: Jede Regel und jeder Prompt verbleibt auf dem Server. Und Werte, die in Prompts, Bewertungsrastern oder Agentenketten übertragen werden, sind für denjenigen lesbar, der das Modell betreibt, an das sie gesendet werden. Wenn Ihre Organisation das Modell selbst betreibt, sind diese Werte ausschließlich durch den Lizenzvertrag geschützt. Jedes ausgelieferte TypeScript-Image ist gebündelt und ohne Source Maps minifiziert, was eher der Ordnung als dem Schutz dient.

Was das bedeutet, wenn Sie eine Erweiterung entwickeln

Ihre eigene Erweiterung unterliegt denselben Grenzregeln wie die Module von Adverant selbst. Nahezu dieses gesamte Kapitel gilt auch für sie.

Isolierung, Identitätsverwaltung und der KI-Pfad werden in beiden Editionen von der Plattform bereitgestellt. Ein mit @adverant-nexus/plugin-sdk erstelltes Plugin erbt die Scoped-Query-Abgrenzung, die Token-Prüfung und das UNO-Dispatching, unabhängig davon, auf welcher Edition es eingesetzt wird. Kapitel 2.19, Die Regeln, die jede Erweiterung erbt, führt diese im Einzelnen auf.

Die Editionsbeschränkung (Edition Gating) funktioniert für Sie auf dieselbe Weise. Ein Plugin deklariert seine Funktions-IDs im entitlements-Block seines Manifests (featureIdPattern sowie eine kurze alwaysOn-Liste für Zustandsprüfungen und die Einstellungsseite) und fragt die Plattform nach einer Entscheidung, bevor es eine geschützte Oberfläche ausliefert. Die Entscheidung ist niemals ein einfacher boolescher Wert. ENTITLEMENT_DENIED (403) bedeutet, dass die Plattform mit Nein geantwortet hat. ENTITLEMENT_UNREACHABLE (502) bedeutet, dass keine Antwort vorlag; Ihr Plugin muss den Zugriff dann verweigern, statt Annahmen zu treffen, da ein Ausfall, der als „nicht berechtigt“ interpretiert wird, stillschweigend alle Kunden gleichzeitig herabstufen würde. Speichern Sie ein Ja kurzzeitig im Cache, aber cachen Sie niemals eine Ablehnung.

In der Community-Edition erhält ein Entwickler dieselben Startvorlagen wie in Enterprise – sowohl für Plugins und Lenses als auch für Skills und Workflows. Jeder Entwickler arbeitet in einem Entwicklungsbereich mit Datenverzweigungen (Data Branches) auf demselben Server, und der Code liegt in GitHub. Vorlagen für Domänenpakete und die Plattform sind Enterprise vorbehalten. Gleiches gilt für die zeitlich begrenzte Ausweitung von Zugriffsrechten aus einer IDE (Integrated Development Environment): In Community gibt es keine separate Produktionsumgebung, für die Sie erweiterte Rechte anfordern könnten, was die Konsole mit PASS_TIER_REQUIRED quittiert.

Entwickeln mit Community
Entwickeln mit Community
Das Entwickeln mit Community bietet auf einem Server dieselben Vorlagen wie Enterprise, wobei der Code in GitHub liegt. Die Seite benennt, was Enterprise zusätzlich bietet, und lehnt erweiterte Zugriffsrechte mit einer klaren Begründung ab.

Eine Erweiterung, die ausschließlich Community-Schnittstellen nutzt, läuft unverändert auf beiden Editionen. Eine Erweiterung, die von einem Add-on wie beispielsweise Mail abhängt, wird überall dort als gesperrt angezeigt, wo die Lizenz diese Funktionsgruppe nicht aufführt. Kapitel 2.25, Für jede Edition entwickeln, zeigt, wie Sie eine Erweiterung für beide Editionen strukturieren und gegen jede testen.