Version 1.0.0-alpha.1aktuell
Kapitel 2.25
Erstellen für jede Edition
Was sich ändert, wenn eine Erweiterung in jeder Edition, an einem Air-Gapped-Standort, auf einem Nexus Edge Payload oder hinter der eigenen Marke eines Kunden funktionieren muss. Behandelt die Lizenzgrenze für Enterprise-Module und die signierte Offline-Auslieferung, mit einer Matrix dessen, was für jedes Ziel anders zu handhaben ist.
Diese Seite wurde mithilfe von KI aus dem englischen Original übersetzt. Bei Unklarheiten gilt die englische Seite als Referenz. Diese Seite auf Englisch lesen

Bei Corrán Orbital liefern wir an mehr Zielumgebungen aus als die meisten Teams. Unsere eigenen Ingenieure betreiben Enterprise am Boden. Ein Satellit, CORR-3, führt ein Missionspaket auf Nexus Edge aus. Zwei Kunden betreiben Community auf einem einzelnen Server, einer betreibt eine vom Netz getrennte (Air-Gapped) Enterprise-Installation, die niemals mit dem Internet verbunden ist, und für einen Versicherer haben wir ein Paket auf dessen eigener Installation entwickelt. Der zugrunde liegende Code ist größtenteils identisch; die Unterschiede betreffen vor allem die Frage, wohin er gelangen darf und wie er dorthin kommt.
Dieses Kapitel behandelt nacheinander jede Zielumgebung: wogegen Sie entwickeln, was Sie nicht antasten dürfen und wie das Ergebnis den Kunden erreicht. Eine Matrix am Ende fasst alles auf einer Seite zusammen. Kapitel 2.18, Das Erweiterungsmodell, erläutert, wie sich Skills, Plugins, Pakete und Module unterscheiden. Kapitel 2.2, Editionen unter der Haube, beschreibt die Editionen selbst.
Community und der Open Core
Community ist der Open Core unter der Apache-Lizenz, Version 2.0. Sie können ihn forken und Änderungen daran ausliefern. Die mitgelieferte NOTICE-Datei enthält einen wichtigen Hinweis, den Sie kennen sollten, bevor Sie ein eigenes Branding vornehmen: Die Lizenz gewährt kein Nutzungsrecht an den Namen oder Marken von Adverant, das über die Angabe der Herkunft des Werks hinausgeht.
Sie erweitern Community auf dieselbe Weise wie Enterprise. Das Plugin SDK (Software Development Kit) ist in beiden Editionen dasselbe Paket, und weder die Full-Service-Vorlage noch die 22 Konformitäts-Gates ändern sich; Kapitel 2.21, Das Plugin SDK, behandelt dies im Detail. Skills funktionieren ebenfalls. Community erhält den gesamten Creator und die Bibliothek der Skills Engine einschließlich Versionierung und Tests, während Canary-Releases und die Zwei-Personen-Freigabe Enterprise vorbehalten bleiben.
Die Entwicklerseiten in Community bieten dieselben Golden Paths, jedoch mit drei Unterschieden, die Sie sofort bemerken werden:
- Ihr Code liegt in GitHub statt in den eigenen Repositories der Installation. Der Golden Path für Plugins erstellt ein GitHub-Repository und einen Dev-Space aus derselben fixierten Vorlage, die auch Enterprise verwendet; Ansicht DV18 zeigt, wie dabei
room-bookingserstellt wird. - Die Golden Paths für Domänenpakete und die Plattform sind Enterprise vorbehalten. In Community erstellen Sie Plugins und Skills sowie Lenses und Workflows für das, was Sie betreiben.
- Community-Pässe enden unterhalb der Stufe Elevate. Auf einem einzelnen Server gibt es keine Produktionsumgebung, auf die aus einer IDE (Integrated Development Environment, integrierte Entwicklungsumgebung) zugegriffen werden könnte, und Sie verwalten den Server direkt. Ein Zugriffsversuch aus der IDE wird mit
PASS_TIER_REQUIREDabgewiesen.
Ein Community-Dev-Space auf einem kleinen Server ist bescheiden dimensioniert. Unserer verfügte über 2 Kerne und 8 GiB Arbeitsspeicher, war bis auf die Deklarationen im Manifest abgeschlossen und wurde nach 7 Tagen Inaktivität beendet.
Beiträge zurückfließen lassen
Die Skills Engine steht ebenfalls unter der Apache-2.0-Lizenz und nimmt Beiträge auf dem üblichen Weg entgegen. Forken Sie das Repository, erstellen Sie einen Branch von main, nehmen Sie die Änderung samt zugehöriger Tests vor und führen Sie die Prüfungen aus, bevor Sie einen Pull Request eröffnen:
git checkout -b feature/skill-synthesis-validation
npm test
npm run lint
npm run typecheckEin Beitrag, der das Verhalten ändert, erfordert einen Test, der ohne diese Änderung fehlschlägt. Das ist keine bloße Hausregel: Die eigenen Testregeln des SDK schreiben vor, dass jeder neue Test im Verzeichnisbaum vor der Änderung nachweislich fehlschlagen muss, und die Prüfer verlangen den entsprechenden Nachweis.
Enterprise-Module und die Lizenzgrenze
Enterprise besteht aus Community plus lizenzierten Modulen. Ein lizenziertes Modul ist ein separates Artefakt, das ein Community-Dienst beim Start lädt; auf diese Weise werden Enterprise-Funktionen sowie jedes geschlossene Modul, das Sie für Enterprise-Kunden entwickeln, an den Open Core angebunden.
Die Regel, die dies ermöglicht, ist die Lizenzgrenze. Ein geschlossenes Modul darf nur über ein einziges Paket auf die Community-Edition zugreifen: @adverant/nexus-spi, das Service Provider Interface. Es steht unter der Apache-2.0-Lizenz und enthält Schnittstellen sowie die Type Guards, mit denen sich Host und Modul gegenseitig prüfen, jedoch keinerlei sonstige Laufzeitlogik. Die Kopplung über die Grenze hinweg erfolgt über eine Schnittstelle oder ein Netzwerkprotokoll, niemals über Quellcode.
| Export | Was es ist |
|---|---|
RouteModule |
Ein lizenziertes Routen-Modul: id, featureGroup, bodies und register(app, ctx), das seine Router in die Anwendung des Hosts einbindet |
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 Lizenz-Reader, den Scoped-Query-Pool, das Schema des Dienstes, die Upstream-Adressen und die Plattform-Clients |
SpiRuntime |
Die Werte des Plugin SDK, die ein Host einem Modul übergibt, sodass das Modul die Laufzeitumgebung des SDK niemals selbst importiert |
SpiPlane |
Was eine lizenzierte Ebene neben Routen zusätzlich bereitstellt, wie etwa die Lesezugriffe für Ansichten, die sie bedient |
ScreenModule |
Eine lizenzierte Ansichtengruppe einer Konsole: group, featureGroup, routes, screens und menu |
GrantCheck |
(featureGroup) => Promise<{ entitled, code?: 'LICENCE_LOCKED' }> |
Das HTTP-Framework und der Ansichtentyp der Konsole sind Typparameter, sodass die Schnittstelle keines von beiden fest vorgibt. Hier ist das Grundgerüst eines Routen-Moduls mit einem Express-Handler-Typ:
import type { GrantCheck, RouteModule, SpiApp, SpiContext } from "@adverant/nexus-spi";
import { Router, type RequestHandler } from "express";
export function auditTrail(checkGrant: GrantCheck): RouteModule<RequestHandler> {
return {
id: "audit-trail",
featureGroup: "<feature-group>",
bodies: [],
register(app: SpiApp<RequestHandler>, ctx: SpiContext<RequestHandler>) {
const router = Router();
router.get("/api/audit-trail", ...ctx.requireScope, async (_req, res) => {
const verdict = await checkGrant("<feature-group>");
if (!verdict.entitled) {
res.status(403).json({
error: true,
code: verdict.code,
message: "This organisation's licence does not carry the audit trail.",
troubleshooting: ["An owner or administrator can turn it on with a licence from Adverant."],
});
return;
}
res.json({ entries: [] });
});
app.use(router);
},
};
}<feature-group> ist die Funktionsgruppe der Editionsmatrix, die das Modul bedient. Jede lizenzierte Route läuft hinter ctx.requireScope, dem Produkt-Gate und Scope-Guard des Hosts, und das Modul prüft zudem seine eigene Berechtigung, bevor es antwortet. Ein Modul ohne entsprechende Berechtigung verweigert den Zugriff mit LICENCE_LOCKED und zeigt lediglich die Vorschau der Funktion an, niemals deren Daten. Ihr Modul importiert auch niemals die Laufzeitumgebung des Plugin SDK, da das SDK ein Community-Paket ist, das die Lizenzgrenze nicht zulässt. Der Host übergibt ihm die SDK-Werte, die es aufruft. Bevor der Host ein Modul lädt, installiert er ein SpiHost auf globalThis unter Symbol.for(SPI_HOST_KEY), das die SDK-Laufzeitumgebung und das eigene Routen-Kit der Anwendung enthält. Dies muss zuerst geschehen: Ein zu einem einzigen Bundle kompiliertes Modul wird als Ganzes ausgewertet, und ein Aufruf von register käme zu spät für Code, der die SDK-Werte bereits während des Ladevorgangs liest. Für Typen re-exportiert @adverant/nexus-spi/sdk/<module> die Deklarationen des SDK – unverändert übernommen (vendored) aus einem SDK-Release und per Prüfsumme fixiert –, sodass Ihr Modul die Typprüfung gegen dieselben Ablehnungs-Bodies und Clients durchführt, die auch ein Plugin verwendet.
Ein Ansichten-Modul folgt einer weiteren Regel: ein Modul pro Funktionsgruppe. Eine Gruppe, deren Ansichten zu zwei Funktionsgruppen gehören, wird daher als zwei Module ausgeliefert, und nur eines davon enthält den Menüeintrag.
Was das Lizenzgrenzen-Gate abweist
Das Lizenzgrenzen-Gate von Adverant verpflichtet jedes Enterprise-Modul auf diese Grenze, und es empfiehlt sich, Ihre eigenen geschlossenen Module derselben Regel zu unterwerfen. Seine Konfiguration besteht aus einer einzigen Datei:
{
"communityScopes": ["@adverant/", "@adverant-nexus/"],
"allowedCommunityPackages": ["@adverant/nexus-spi"],
"enterprisePrefixes": ["@adverant/enterprise-", "@adverant-enterprise/"],
"communityRepos": ["nexus-community", "nexus-core", "Adverant-Nexus-Open-Core"],
"allowedCommunityGoModules": []
}Jeder der folgenden Punkte führt zu einem Befund mit Angabe von Datei und Zeile:
- jeder Import eines Pakets unter einem Community-Scope, bei dem es sich nicht um die zulässige Schnittstelle oder ein Enterprise-Paket handelt, einschließlich dynamischer Importe;
- jeder Bezeichner, Go-Importpfad oder Abhängigkeits-URL, der ein Community-Repository benennt, sofern es sich nicht um ein in
allowedCommunityGoModulesaufgeführtes Go-Modul handelt; - ein relativer Import, der aus dem Repository herausführt;
- eine
package.json-Abhängigkeit, die einfile:-,link:-,portal:- oderworkspace:-Pfad außerhalb des Repositorys oder eine Git-URL zu einem Community-Repository ist; - ein
go.mod-replace, das nach außerhalb des Repositorys verweist.
Es beendet sich mit dem Code 0, wenn alles fehlerfrei ist, und mit 1 bei Befunden. Exit-Code 2 bedeutet, dass die Ausführung verweigert wurde, weil die Konfiguration fehlerhaft war oder nichts gescannt wurde. Das Schnittstellenpaket wird nicht in einer Registry veröffentlicht. Sie führen eine bytegenau fixierte Kopie des gebauten Pakets innerhalb Ihres Repositorys als lokales file:-Paket mit, versehen mit einer SHA256SUMS-Fixierung und einer Prüfung in Ihrer Pipeline, die jede abweichende Kopie abweist. Da sich die Kopie innerhalb des Repositorys befindet, wird sie vom Gate akzeptiert.
Editions-Builds
Wenn Ihre Erweiterung an Kunden beider Editionen ausgeliefert wird, erstellen Sie den Build einmal pro Edition, und jeder Build erfolgt in seinem eigenen zusammengestellten Verzeichnisbaum. Einen Verzeichnisbaum zusammenzustellen bedeutet, nur diejenigen Dateien zu übernehmen, die zu der jeweiligen Edition gehören. Der eigene Export von Adverant erledigt dies anhand einer Abgrenzungsliste, in der jede versionierte Datei nach Regeln zugewiesen wird, bei denen der erste Treffer zählt (First-Match-Wins): Eine Regel benennt eine Fähigkeit, und die Edition der Datei ergibt sich aus der Stufe dieser Fähigkeit in der Editionsmatrix – oder sie benennt unter Angabe eines Grundes eine Dateiklasse, die in keiner der beiden Editionen ausgeliefert wird. Dateien, die nur für den Build benötigt werden, werden im Enterprise-Verzeichnisbaum und, sofern entsprechend markiert, auch im Community-Verzeichnisbaum ausgeliefert. Die Migrationskette eines Moduls gehört zu den Installationsdaten und wird im Verzeichnisbaum jeder Edition mitgeliefert.
Führen Sie anschließend in jedem zusammengestellten Verzeichnisbaum einen vollständigen Clean-Build durch. Das bedeutet jedes Mal alle drei Befehle:
npm ci
npm test
npm run buildWir haben dies auf die teure Tour gelernt: Ein Enterprise-Verzeichnisbaum bestand seine Tests, während beim Community-Verzeichnisbaum der Produktions-Build fehlschlug, weil ein benötigter Typ nur in einer Enterprise-Datei existierte. Bestandene Tests in einem Verzeichnisbaum sagen nichts über den anderen aus. Die Tests einer Edition dürfen nur das importieren, was der Verzeichnisbaum dieser Edition enthält, und der Export weist jeden Test ab, der darüber hinausgreift.
Der Export schreibt außerdem die Lizenz der jeweiligen Edition. Community-Dateien tragen den SPDX-Bezeichner (Software Package Data Exchange) Apache-2.0; Enterprise-Dateien tragen LicenseRef-Adverant-Enterprise, und in ihrer package.json steht UNLICENSED. Bearbeiten Sie diese Felder nicht manuell: Der Export überschreibt sie, und eine Kopie, die nicht mehr mit ihrem fixierten Lizenztext übereinstimmt, wird abgewiesen.
Team: Nur Cloud
Team besteht aus Community plus dem Team-Funktionsumfang und läuft ausschließlich in der Adverant-Cloud. Es gibt kein selbst gehostetes Team. Der Team-Funktionsumfang erweitert Community um sechs Fähigkeiten, darunter der konsolidierte Arbeitsbereich, geteilte Notebooks, die Verwaltung der Skills-Bibliothek sowie der Workflow-Betrieb mit Stufenübergängen (Promotion) zwischen Umgebungen.
Für Entwickler bedeutet der reine Cloud-Betrieb eines: Ein Team-Kunde erhält Ihr Plugin als signiertes Release über den Katalog, niemals von Ihren eigenen Servern. Sie entwickeln es genau so wie ein externer Herausgeber – auf einem Publisher-Cluster.
Ein Publisher-Cluster ist ein virtueller Cluster in der Adverant-Cloud mit einem von Adverant festgelegten Kontingent. Er enthält ausschließlich Beispieldaten und verfügt über keine Route zu einem Kunden. Die Anforderung einer maskierten Kopie von Kundendaten wird dort mit TENANT_BOUNDARY abgewiesen; ein Kunde kann Testergebnisse mit Ihnen teilen, niemals jedoch seine Daten. Ihr dortiger Pass reicht niemals bis in eine Kundenumgebung hinein. Wenn das Release fertiggestellt ist, wird es signiert und von Adverant geprüft, bevor es im Katalog gelistet wird. Jeder Kunde entscheidet dann selbst, ob er es installiert, und gewährt ihm Einheit für Einheit nur genau die Berechtigungen, die im Manifest deklariert sind. Ein Aufruf von Ressourcen, die nicht im Manifest deklariert wurden, wird auf Kundenseite mit CONNECTION_SCOPE_EXCEEDED abgewiesen, und die einzige Möglichkeit, dies nachzutragen, ist ein neues Release, das der Kunde prüft.
Air-Gapped-Kunden
Einer unserer Kunden betreibt Nexus in einer Umgebung, in der keinerlei Datenverkehr über ein Netzwerk ein- oder ausgeht. Diese Installation wird in Kapitel 2.10, Air-Gapped-Installation, beschrieben. Für uns bedeutete dies, unser Plugin auf signierten Datenträgern auszuliefern; das Werkzeug dafür ist nexus-airgap aus dem Sovereign Delivery Kit @adverant/nexus-sovereign.
Ein versiegeltes Bundle ist ein einzelnes, signiertes und in sich geschlossenes Tar-Archiv (Tarball). Es kann Images und Migrationen, vorsignierte Skills und Modellgewichte sowie eine SBOM (Software Bill of Materials, Software-Stückliste) mit den Lizenzen aller enthaltenen Komponenten umfassen. Sein Manifest listet jede Datei samt ihrem SHA-256-Hash auf und wird mit Ed25519 signiert. Das Erstellen eines solchen Bundles aus dem Quellcode sieht wie folgt aus:
import { SealedBundleExporter } from "@adverant/nexus-sovereign";
const { bundleDigest } = await new SealedBundleExporter().export(source, {
outPath: "./cold-chain-0.4.0.tar.gz",
profile: "airgap",
signerPrivateKeyPem,
});signerPrivateKeyPem ist Ihr Schlüssel zum Signieren von Releases. Der Befehl nexus-airgap bundle führt dasselbe über die Befehlszeile aus. Der Administrator des Kunden prüft das Bundle anschließend noch vor allen anderen Schritten:
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapDie Verifizierung berechnet für jede Datei erneut den Hash-Wert und gleicht ihn mit dem Manifest ab, weist jede nicht im Manifest aufgeführte Datei zurück, erfordert einen vertrauenswürdigen Ed25519-Unterzeichner und lehnt jedes Bundle ab, dessen Netzwerk-Positivliste (Allow-List) nicht leer ist. Eine nach dem Signieren geänderte Datei führt zum Fehlschlag mit BUNDLE_INTEGRITY_VIOLATION. Weisen Sie den Administrator an, an dieser Stelle abzubrechen und Sie zu kontaktieren; es gibt zwar einen Schalter für einen weniger strikten Modus, doch dieser sollte niemals verwendet werden.
Drei Regeln bestimmten unsere Auslieferung:
- Der vertrauenswürdige Schlüssel wird getrennt vom Bundle übermittelt. Wir senden den öffentlichen Schlüssel und den SHA-256-Hash des Bundles über einen anderen Weg als die Datenträger, sodass ein Bundle sich nicht selbst beglaubigen kann.
- Nichts im Bundle darf bei der Installation eine Netzwerkverbindung benötigen. Kein Abrufen von Paketen, kein Herunterladen von Modellen, kein Lizenzaufruf. Wenn das Plugin ein Modell benötigt, stellt der eigene Modellserver des Kunden dieses über den KI-Provider-Router (AI Provider Router) bereit.
- Nach der Verifizierung spielt der Administrator das Release über die eigenen Release-Kanäle der Installation ein – genau so, wie es auch ein vernetzter Kunde tun würde. Das Bundle ist lediglich der Transportweg für die Bytes, keine Umgehung der Promotion-Gates.
Die Arbeit mit Air-Gapped-Umgebungen ist langsamer, und daran lässt sich von unserer Seite aus nichts ändern. Ein einziges falsches Byte kostet einen neuen Satz Datenträger und eine weitere Anreise; deshalb verifizieren wir das Bundle vor dem Versand selbst auf einem sauberen Rechner mit genau demselben Befehl.
Nexus Edge Mission Packs
Nexus Edge ist ein kleineres Nexus, das auf Satelliten und Drohnen läuft – auf Missionsrechnern, die vom Flugrechner getrennt sind. Es handelt sich um ein Add-on mit einer Lizenz pro Plattform oder Flotte. Was sich von einer Mission zur nächsten ändert, ist das Missionspaket, und das Erstellen dieser Pakete macht einen guten Teil meiner Arbeit aus.
Ein Missionspaket enthält alles, was die Nutzlast (Payload) für eine bestimmte Mission benötigt. Neben den Modellen und Adaptern umfasst es die Ontologie mit einem Startgraphen, Agentenschritte, Alarmregeln, die Prioritäten für die Reihenfolge der Datenübertragung zur Erde, eine Platzierungstabelle, die festlegt, welcher Rechner was ausführt, die reduzierten Betriebsstufen (Degraded Steps), auf die die Plattform bei Ausfall eines Rechners zurückfallen kann, sowie die Testfälle, die an Bord bestanden werden müssen.
Pakete werden am Boden gebaut und signiert. Einige praktische Regeln aus unseren Builds:
- Halten Sie die großen Komponenten stabil. Maritime watch 1.5 fügte einen Adapter zur Schiffserkennung und zwei Alarmregeln hinzu; das Sprachmodell und die Ontologie änderten sich nicht, sodass das Paket 412 MB statt 9,8 GB groß war. Der Uplink ist schmalbandig, und Basismodelle werden bereits vor dem Start geladen.
- Verwenden Sie ein einziges Embedding-Modell für die gesamte Missionsfamilie am Boden wie auch auf der Nutzlast, damit die heruntergesendeten Graphenänderungen mit dem Graphen am Boden zusammengeführt werden können.
- Die Nutzlast sendet niemals einen direkten Befehl an die Flugsysteme. Sie sendet typisierte Anforderungen über den Supervisor an den Flugrechner, der jede davon mit einer Begründung beantwortet.
- Jeder Hardwaretyp erfordert eine eigene Prüfung des Pakets. Die Installation eines Pakets, das nicht für die Hardware des jeweiligen Geräts geprüft wurde, wird mit
PACK_NOT_CHECKED_FOR_HARDWAREabgewiesen.
Für die Freigabe sind zwei von drei Signaturen erforderlich. Unsere eigene und die von Adverant bilden das übliche Paar; der dritte ist ein Offline-Schlüssel, den wir in einem Tresor aufbewahren, falls einer der beiden anderen verloren geht. Das Paket wird in den inaktiven Slot (Idle Slot) hochgeladen, verifiziert, führt seine Testfälle auf den realen Platinen aus und wird nur dann aktiviert, wenn alle Tests bestanden werden – geschützt durch einen Zähler, der verhindert, dass ein älteres Paket erneut installiert wird. Schlägt ein Test fehl, verbleibt die Plattform auf dem vorherigen Paket und der Fehlerbericht wird beim nächsten Überflug heruntergesendet. Wir rollen Änderungen immer nur auf einer Plattform gleichzeitig aus, jeweils nach einer fehlerfreien Woche. Pakete behalten ihre Gültigkeit, während eine Plattform außer Funkkontakt ist, sodass ein Satellit ohne Verbindung mit dem vorhandenen Paket weiterarbeitet.
Auf Land- und Wasserfahrzeugen kann Edge auf k3s laufen. Ein Raumfahrzeug führt anstelle von Kubernetes einen Supervisor mit signierten Images oder statischen Binärdateien und einer festen Platzierungstabelle aus – und genau deshalb wird die Platzierungstabelle innerhalb des Pakets mitgeliefert.
White-Label-Storefronts
Mit dem Add-on Storefront / White-Label kann ein Kunde die Benutzeroberfläche für seine Nutzer mit seiner eigenen Marke und Domain sowie eigenen Anmeldeansichten versehen und Zahlungen über seine eigenen Gateways abwickeln. Kartendaten kommen niemals mit Nexus in Berührung.
Ein für einen White-Label-Kunden entwickeltes Plugin darf an keiner Stelle den Namen Adverant zeigen. Das Manifest enthält alle markenspezifischen Angaben, und die Plattform löst alles Weitere über das eigene Branding der Organisation auf statt über fest in Ihrem Code hinterlegte Werte:
{
"domains": [
{ "primary": "<app-domain>", "aliases": ["www.<app-domain>"] }
],
"branding": {
"appName": "<app name>",
"tagline": "<one line>",
"primaryColor": "<hex>",
"accentColor": "<hex>",
"passkeyRpId": "<app-domain>",
"oauthClientRef": "brand:<plugin name>:google"
}
}<app-domain> ist die eigene Domain des Kunden, und passkeyRpId muss mit ihr übereinstimmen, da Passkeys an die Domain gebunden sind, unter der sich eine Person anmeldet. Eine Webanwendung unter ihrem eigenen Origin meldet Personen über die Anmelde-Helper des SDK an, deren zwei öffentliche Routen die einzigen ungeschützten /api-Routen sind, die das Scope-Gate akzeptiert – und auch das nur, wenn das Manifest sie als auth: public mit allowAnonymous: true deklariert. Frontend-Aufrufe laufen über den Backend-for-Frontend-Allow-List-Proxy, niemals direkt an eine Dienstadresse. Der Administrator des Kunden konfiguriert die Zahlungsseite, von den Gateways bis hin zum Checkout im eigenen Markenstil. Ihr Plugin tut dies nicht.
Die Matrix
| Zielumgebung | Entwickelt gegen | Was Sie anders machen | Wie es den Kunden erreicht |
|---|---|---|---|
| Community | Plugin SDK, Skills Engine | Code in GitHub; keine Pfade für Domänenpakete oder Plattform; kein Elevate | Der Kunde installiert es selbst; keine Katalogprüfung erforderlich |
| Enterprise (Ihre eigene Installation) | Plugin SDK, Skills Engine, Paketvorlagen | Dev-Spaces, Daten-Branches, maskierte Kopien über den Dateneigentümer; Pakete und Lenses | Promotion von Staging in eine Piloteinheit, danach flächendeckend |
| Enterprise-Modul (geschlossen) | Nur @adverant/nexus-spi |
Lizenzgrenzen-Regel; Berechtigungsprüfung für die eigene Funktionsgruppe; LICENCE_LOCKED bei fehlender Berechtigung |
Wird beim Start von einem Community-Dienst auf lizenzierten Installationen geladen |
| Beide Editionen | Plugin SDK | Verzeichnisbaum jeder Edition zusammenstellen; jeweils npm ci, Tests und Produktions-Build ausführen |
Ein Release pro Edition |
| Team | Plugin SDK auf einem Publisher-Cluster | Nur Beispieldaten; nur Cloud | Signiertes Release, Prüfung durch Adverant, Katalog |
| Air-Gapped | Plugin SDK, @adverant/nexus-sovereign |
Versiegeltes Bundle; Schlüssel und Prüfsumme separat übermittelt; kein Abruf über das Netzwerk bei der Installation | Signierte Datenträger, verifiziert, danach über die Release-Kanäle der Installation |
| Nexus Edge | Inhalte des Missionspakets | Platzierungstabelle, reduzierte Betriebsstufen, Tests an Bord, Hardwareprüfungen | Zwei von drei Signaturen, inaktiver Slot, Aktivierung nach bestandenen Tests |
| White-Label | Plugin SDK | domains und branding im Manifest; nirgendwo der Name Adverant |
Wie bei Enterprise, unter der eigenen Domain des Kunden |
Unabhängig von der Zielumgebung erfolgt die Bereitstellung ausschließlich über die Release-Kanäle der jeweiligen Installation. Kapitel 2.28, Veröffentlichung Ihrer Erweiterung, behandelt diese Kanäle. Kapitel 2.27, Build-Szenarien, enthält eine Anleitung für jede der oben aufgeführten Zeilen.



