Version 1.0.0-alpha.1aktuell
Kapitel 2.19
Die Regeln, die jede Erweiterung erbt
Isolierung auf drei Achsen, Berechnung über UNO, KI (künstliche Intelligenz) über den Router, organisationseigene Schlüssel und Lizenzprüfungen. Was jede Regel für Ihren Code bedeutet, welches Gate sie durchsetzt und warum Sie sie erben, anstatt sie selbst zu programmieren.
Diese Seite wurde mithilfe von KI aus dem englischen Original übersetzt. Bei Unklarheiten gilt die englische Seite als Referenz. Diese Seite auf Englisch lesen

Die erste Ablehnung, die mein Plugin zur Anomalieprüfung jemals gesendet hat, ging an mich selbst. Aus Gewohnheit von einer anderen Plattform hatte ich einen Test-Client geschrieben, der eine neue Prüfung mit der ID der Organisation im Body sendete, und das Plugin antwortete, noch bevor mein Handler ausgeführt wurde:
{
"error": true,
"code": "TENANT_NOT_A_PARAMETER",
"message": "The request body names the organisation. Tenancy comes from the token.",
"resolved": ["tenant", "owner"],
"missing": [],
"troubleshooting": ["Remove organizationId from the body. The organisation is read from your sign-in."]
}Ich hatte diese Prüfung nicht selbst geschrieben. Sie stammte aus dem Scope-Guard, den die Vorlage des SDK (Software Development Kit) in jede /api-Route einbindet, und sie schlägt selbst dann an, wenn die ID im Body die eigene des Aufrufers ist. Das ist das Muster für dieses gesamte Kapitel: eine kleine Anzahl von Regeln, von denen jede durch einen geerbten Mechanismus durchgesetzt wird und jede über ein Gate verfügt, das Ihren Build fehlschlagen lässt, wenn Ihr Code versucht, sie zu umgehen. Auf Nexus erbt Ihr Plugin seine Isolierung von der Plattform, und die Gates überprüfen dies.
Es gibt fünf Regeln, die in den folgenden Abschnitten nacheinander behandelt werden: Isolierung auf drei Achsen; Berechnungen, die ausschließlich über das UNO-Dispatch laufen; KI (künstliche Intelligenz), die ausschließlich über den AI Provider Router läuft; Modellschlüssel, die der Organisation gehören; und lizenzierte Funktionen, die gegen die Lizenz geprüft werden. Jedes Manifest wiederholt zudem drei dieser Regeln in einem Satzblock.
Regel 1: Isolierung auf drei Achsen, ausgehend von der authentifizierten Anfrage
Jeder Lese- und Schreibvorgang in einer Erweiterung wird auf drei Achsen eingegrenzt (Scoped), und dasselbe gilt für jeden Tool-Aufruf und jedes Skill-Dispatch.
| Achse | Spalte | Beantwortet | Wie strikt die Grenze ist |
|---|---|---|---|
| Mandant (Tenant) | organization_id |
Welche Organisation | Eine harte Grenze, die nur durch eine protokollierte schreibgeschützte Freigabe überschritten werden kann |
| Eigentümer (Owner) | owner_user_id |
Welche Person innerhalb der Organisation | Privat selbst innerhalb derselben Organisation, für alles Persönliche |
| Einheit (Unit) | business_unit_id |
Welcher Teil der Organisation | Eine optionale Abgrenzung innerhalb eines Mandanten |
Die Eigentümerachse (Owner) ist diejenige, die Neueinsteiger oft falsch verstehen. Ein Postfach ist persönlich, ebenso wie eine gespeicherte Ansicht oder ein Graph, der aus den Daten einer einzelnen Person abgeleitet wurde. Zwei Mitglieder derselben Organisation, in derselben Einheit und mit derselben Rolle, sehen die auf den Eigentümer eingegrenzten Zeilen des jeweils anderen nicht. Bei einem Organisationsartefakt, beispielsweise einer Genehmigung oder einem Falldatensatz, dient der Eigentümer stattdessen als Herkunftsnachweis: Er hält fest, wer gehandelt hat, und Lesevorgänge werden auf den Mandanten eingegrenzt, damit der Audit-Trail für die Personen sichtbar bleibt, die ihn benötigen. Sie entscheiden pro Tabelle, um welche Art es sich handelt, und die Repository-Schicht bildet dies ab – niemals als Sonderfall in einer Route.
Die Achsen stammen aus der authentifizierten Anfrage und von nirgendwo sonst. Weder eine Umgebungsvariable noch ein Abfrageparameter, ein Pfadsegment, ein Client-Header oder eine Build-Konstante können sie liefern. Das SDK macht es schwer, hier Fehler zu programmieren: resolveScope(identity, options) hat überhaupt keinen Parameter für die Organisation. Die Organisation befindet sich innerhalb von identity, und nur ein verifiziertes Token erzeugt ein solches Element. Es gibt keine Möglichkeit, eine ID durchzureichen.
Aus diesem Grund wird ein Body, der den Mandanten benennt, abgelehnt statt ignoriert. Der Guard lehnt jeden von fünf Feldnamen ab: orgId, organizationId, organization_id, tenant und tenantId. Ein stillschweigend ignoriertes Feld vermittelt dem Aufrufer den Eindruck, dass das Feld funktioniert. Der erste Aufrufer testet es und sieht seine eigenen Daten; der zweite sendet die ID einer anderen Organisation. Eine Ablehnung gleich bei der ersten Anfrage macht den Vertrag unmissverständlich klar, bevor jemand auf einer falschen Annahme aufbaut. Dieselbe Regel gilt für die inputParams eines Dispatches: Eine Skill-Eingabe, die eine Organisations-ID enthält, wird beim Dispatch abgelehnt.
Die Einheitsachse (Unit) wird entweder deklariert und durchgesetzt oder gar nicht verwendet. Eine Route, die needsUnit: true deklariert, lehnt die Anfrage ab, wenn der Berechtigungsnachweis keine Einheit auflöst, wobei unit in missing[] genannt wird. Synthetisieren Sie keine Einheit aus einer Subdomain oder einem Header, und verwenden Sie keinen Standardwert. Eine künstlich erzeugte Einheit zieht andere Grenzen als die realen Einheiten der Organisation und führt Zeilen zusammen, die nicht zusammengehören.
Eine Schnittstelle, die das Prädikat nicht ausdrücken kann, verweigert den Dienst
Wenn eine Route nicht angeben kann, zu welchem Mandanten und Eigentümer eine Zeile gehört – und zu welcher Einheit, sofern eine benötigt wird –, lehnt sie ab. Es gibt keinen organisationsweiten Lesevorgang als Fallback und keinen Platzhalterwert. Ein Platzhalter ist die schlechteste Option, denn ein Platzhalter ist ein Wert, und Werte stimmen mit Zeilen überein: Ein Tool-Router, der sowohl Mandant als auch Benutzer standardmäßig auf die Zeichenfolge 'unknown' setzte, lieferte jedem Aufrufer organisationsweite Daten aus. An einer Mandantengrenze ist ?? 'unknown' ein Defekt.
Die Ablehnung hat überall auf der Plattform dieselbe Form und enthält genügend Informationen, damit ein Client die Behebung darstellen kann:
{
"error": true,
"code": "SCOPE_PREDICATE_MISSING",
"message": "Request cannot be scoped to a tenant from the presented credential.",
"resolved": ["tenant", "owner"],
"missing": ["unit"],
"troubleshooting": [
"The credential resolved tenant+owner; this route additionally requires a business unit.",
"Select a business unit in the client and retry — re-authentication will not change this outcome."
]
}error ist immer true. code stammt aus dem Code-Katalog der Plattform. resolved[] benennt die Achsen, die abgeleitet wurden, und missing[] diejenigen, die die Route benötigte, aber nicht erhalten konnte. troubleshooting[] gibt an, was das Problem tatsächlich beheben würde. Ein bloßes „forbidden“ hilft niemandem weiter.
Halten Sie 401 und 403 strikt auseinander, da Clients unterschiedlich darauf reagieren.
| Status | Bedeutung | Was der Client tut |
|---|---|---|
| 401 | Nicht authentifiziert | Meldet sich erneut an |
| 403 | Authentifiziert, aber die Anfrage kann nicht eingegrenzt werden, oder dem Aufrufer fehlt die Berechtigung | Beendet die Wiederholungsversuche und ändert die Anfrage |
Eine Scope-Ablehnung, die mit 401 beantwortet wird, schickt einen Client in eine Anmeldeschleife, die durch keine Anmeldung beendet werden kann: Er verwirft die Sitzung und meldet sich erneut an, versucht es noch einmal und erhält wieder 401, während der Benutzer endlos auf ein Ladesymbol blickt.
Zwei weitere Mechanismen machen die Ablehnung lückenlos. Innerhalb eines Handlers ist scopeOf(req) der einzige Weg, den Scope auszulesen, und es wird ein Fehler ausgelöst, wenn der Guard nicht gelaufen ist. Zudem wird der Guard nach dem Parsen des Bodys und vor jedem Handler ausgeführt; ein Handler, der ohne das Prädikat erreichbar wird, antwortet absichtlich mit 500 und MIDDLEWARE_ORDERING_ERROR, sodass der Fehler in Ihrem Fehlerbudget statt in einem Vorfallsbericht landet.
Die Datenbank setzt dieselbe Grenze eigenständig durch
Die Code-Abgrenzung (Code Fence) und die Datenbank-Abgrenzung (Database Fence) sind zwei Mechanismen für ein und dasselbe Gesetz, und Sie erhalten beide.
Jede Anweisung gegen eine eingegrenzte Tabelle bindet tenantFence(scope) aus dem SDK ein; Sie schreiben das Prädikat niemals von Hand. Jede Anweisung läuft außerdem innerhalb von withScopedTx, was die drei Achsen für genau diese eine Transaktion über eine einzige Datenbankfunktion bindet und eine zweite Bindung ablehnt (SCOPE_ALREADY_BOUND). Darunter ist für jede Tabelle in Ihrem Schema Row-Level Security (Zeilenebenen-Sicherheit) zwingend aktiviert, und die Rolle, als die sich Ihr Anfragepfad verbindet, kann den gebundenen Mandanten selbst nicht ändern. Ein Prozess, der sich als eine Rolle verbindet, die Row-Level Security umgehen kann, verweigert den Start mit DB_ROLE_BYPASSES_ISOLATION. Kapitel 2.22, Die Plugin-Laufzeitumgebung, zeigt den Code; Kapitel 2.21, Das Plugin-SDK, zeigt, wie die Rollen für Sie bereitgestellt werden.
Der einzige Übergang: eine protokollierte Berechtigung
Es gibt genau einen Weg über die Mandantengrenze hinweg. Die Organisation, der die Zeilen gehören, zeichnet eine Freigabe (Grant) auf, in der benannt wird, welche Organisation welche Tabellen unter welcher Vereinbarung und wie lange lesen darf. Die Datenbank stellt sicher, dass der Lesevorgang schreibgeschützt ist, und jeder Zugriff wird vor dem Lesen in beiden Organisationen ausschließlich anhand der ID protokolliert. Schreibvorgänge überschreiten niemals die Grenze; Arbeit, die an ein anderes Unternehmen übergeben wird, wird als Nachricht übertragen. Die Eigentümer- und Administratorrollen lesen niemals über die Grenze hinweg, und das Manifest wird abgelehnt, wenn die Berechtigung, die einen organisationsübergreifenden Lesevorgang zulässt, diese Rollen nicht ausschließt. Ein Plugin, das einen anderen Weg über die Grenze sucht, bekommt keinen.
Regel 2: Alle Berechnungen laufen über den UNO-Dispatch
UNO, die Workflow-Engine, ist der einzige Berechnungspfad. Ihr Code ruft niemals direkt einen Modellanbieter oder eine Engine auf, und ebenso wenig eine Warteschlange oder einen Workflow-Host. Sie senden einen Umschlag (Envelope) an den Dispatch-Endpunkt und erhalten 202 mit Identifikatoren zurück; das Ergebnis trifft per Polling oder Callback ein.
Daraus ergeben sich drei Grundregeln, die in der Vorlage bereits alle drei umgesetzt sind.
- Eine einzige Datei verwaltet die Dispatch-URL.
UNO_DISPATCH_URLwird einmalig im Konfigurations-Loader ausgelesen und muss eine Cluster-interne Adresse sein. Eine öffentliche Adresse wird beim Start abgelehnt, da nichts die Installation verlässt. - Eine geschlossene Positivliste (Allow-List) für das, was diese Oberfläche dispatchen darf. Ein Backend, das jede beliebige vom Browser übergebene Skill-ID dispatcht, ist ein universeller Proxy für jeden Skill in der Registry – einschließlich der Skills anderer Plugins und solcher, die das Modellbudget anderer verbrauchen. Die Liste ist eine Konstante auf Modulebene mit namensraumgebundenen Job-Typen, niemals eine Umgebungsvariable. Eine ID, die nicht darauf steht, wird mit
SKILL_NOT_ALLOWEDabgelehnt. - Überprüfen Sie die Rückgabewerte erneut. Wenn Sie einen Job zurücklesen, vergleicht der Client des SDKs die
organization_idder zurückgegebenen Zeile auf Ihrer Seite des Netzwerkaufrufs mit dem Mandanten des Aufrufers. Eine Abgrenzung, die nur auf der anderen Seite eines Aufrufs existiert, ist lediglich eine Konvention.
Regel 3: Die gesamte KI läuft über den AI Provider Router
Ein Plugin ruft an keiner Stelle direkt ein Modell auf. Es gibt kein Anbieter-SDK in package.json, keinen Modellschlüssel in der Umgebung und kein Relay. Allein der Router hält die Anbieter-Anmeldedaten der Organisation und trifft die endgültige Entscheidung über Anbieter und Modell.
Was ein Plugin tun darf, ist, zum Zeitpunkt der Registrierung in der Registry-Zeile des Manifest-Skills Wünsche zu äußern:
{
"execution_config_skill": {
"preferredProvider": "gemini",
"preferredModel": "gemini-3.5-flash",
"capabilityProfile": { "needsToolUse": true, "minContextWindow": 200000 }
}
}Der Router erfüllt einen Wunsch nur dann, wenn die Organisation diesen Anbieter aktiviert und mit Anmeldedaten versehen hat. Andernfalls wählt er einen Ersatz aus dem eigenen Pool der Organisation. capabilityProfile wählt niemals aus; es filtert, und sein Feld dataResidency ist eine harte gerichtsbarkeitsbezogene Einschränkung, die der Router entweder erfüllt oder ablehnt. All dies wegzulassen, ist für die meisten Skills der richtige Standard: Dann entscheiden die eigenen Rollenzuweisungen der Organisation, schließlich ist es auch die Organisation, die bezahlt.
Es können zwei Arten von Ablehnungen zurückkommen, und sie bedeuten sehr unterschiedliche Dinge.
| Code | Status | Bedeutung |
|---|---|---|
MISSING_CALLER_IDENTITY, UNAUTHORIZED_CALLER |
403 | Ihr Code hat versucht, den Router selbst aufzurufen. Stopp: Hier verweigert die Schnittstelle absichtlich den Dienst, und ein erneuter Versuch ist zwecklos |
MODEL_CAPABILITY_UNAVAILABLE |
422 | Kein aktivierter Anbieter verfügt über ein Modell, das das Profil erfüllt. Lockern Sie das Profil, oder die Organisation aktiviert einen geeigneten Anbieter |
NO_PROVIDER_FOR_ROLE |
422 | Die Organisation hat für diese Rolle kein Routing konfiguriert. Zeigen Sie der Person den Behebungstext des Routers an |
Das zweite Paar gehört auf den Bildschirm, nicht in ein Protokoll. Es gibt kein Standardmodell und keinen Fallback-Anbieter: Eine Rolle, die die Organisation nicht eingerichtet hat, schlägt unübersehbar fehl – mit einem Satz, der erklärt, was konfiguriert werden muss.
Der einzige Lesevorgang, den ein Plugin beim Router durchführen darf, ist effectiveRoute() aus runtime/ai-route. Er beantwortet, welchen Anbieter und welches Modell der Router für die angemeldete Organisation wählen würde, ohne eine KI-Anfrage zu senden, und gibt die Ablehnung des Routers als Text zurück, wenn kein Modell vorhanden ist. Kapitel 2.22, Die Plugin-Laufzeitumgebung, zeigt dies im Detail.
Die Vertrauensstufen (Trust Ladder) fügen eine weitere Grenze hinzu. Nur core- und verified-Plugins dürfen die beiden Manifest-Skill-Stufen deklarieren, die den Router erreichen: tool_using und llm_only. Alle anderen vermitteln deterministische Arbeit und überlassen der Plattform den Teil, der das Modell anspricht.
Regel 4: Schlüssel gehören der Organisation
Jede Organisation bringt ihr eigenes Anbieterkonto und ihren eigenen Schlüssel mit und bezahlt ihre eigene Rechnung. Der Schlüssel befindet sich im KI-Anbieter-Pool der Organisation, wird von deren eigenen Administratoren über die Konsole verwaltet und vom Router zum Zeitpunkt des Aufrufs aufgelöst. Es gibt keinen gemeinsam genutzten Plattformschlüssel hinter einem Mandanten, sodass keine Organisation das Budget einer anderen verbraucht.
Für eine Erweiterung bedeutet das drei Dinge.
- Sie speichern niemals einen Modellschlüssel, weder im Code noch in der Konfiguration oder in einem Secret-Store. Das
no-credentials-Gate lässt den Build fehlschlagen, wenn ein Schlüssel lesbar ist, und der Konfigurations-Loader verweigert den Start, wenn einer vorhanden ist. - Sie zählen niemals die Schlüssel einer Organisation auf. Wenn Ihr Plugin meint, dies tun zu müssen, ist die Anforderung an der falschen Stelle angesiedelt.
- Eine Organisation ohne Schlüssel erhält keine KI-Antworten. Das ist ein erwarteter Zustand mit einer eigenen Bildschirmansicht. Benennen Sie die fehlende Rolle, zitieren Sie den Behebungshinweis und verweisen Sie die Person dann auf ihre Anbietereinstellungen. Stellen Sie dies nicht als leeres Ergebnis dar.
Regel 5: Lizenzierte Funktionen werden gegen die Lizenz geprüft
Was eine Installation über die Community-Basis hinaus nutzen darf, stammt aus einer einzigen Quelle: dem von Adverant signierten Lizenzdokument, das auf der Installation ausschließlich mit öffentlichen Schlüsseln verifiziert wird. Ihre Erweiterung trifft Entscheidungen niemals auf Grundlage schwächerer Kriterien, wie etwa eines Tarifnamens in einem Token oder eines Flags in der Konfiguration.
In einem Plugin besteht der einfachste Weg, eine Funktion an die Lizenz zu binden, über die Berechtigung, die sie schützt. Eine Berechtigung im rights-Register des Manifests kann eine licence-Funktion benennen:
"rights": {
"evidence.export": {
"summary": "Export the evidence pack for an inspection.",
"roles": ["owner", "admin", "member"],
"licence": "compliance-packs"
}
}Wer eine durch diese Berechtigung geschützte Route aufruft, wird mit LICENCE_LOCKED (403) abgelehnt – unabhängig von seinen Rollen und Lizenzen (Seats) –, wenn die Lizenz der Organisation compliance-packs nicht umfasst. Die Ablehnung benennt die Funktion und das Paket, das sie enthält, und gibt an, wer sie aktivieren kann.
Auch der Status der Lizenz spielt eine Rolle. Solange eine Lizenz gültig ist oder sich in ihrer Warnfrist befindet, funktionieren lizenzierte Funktionen; sie funktionieren auch in der Kulanzfrist (Grace Period) weiter, wobei dann der Hinweis LICENCE_IN_GRACE angezeigt wird. Sobald eine Lizenz die Kulanzfrist überschritten hat, greifen Einschränkungen: Laufende Arbeiten und Lesevorgänge werden fortgesetzt, ebenso Exporte und Sicherheitsupdates, aber das Erstellen neuer Elemente unter einer lizenzierten Funktion wird mit LICENCE_LOCKED abgelehnt. Gestalten Sie Ihre Erstellungspfade so, dass sie mit dieser Antwort umgehen können.
Wenn Ihr Plugin bei der Berechtigungsprüfung anfragt, ob eine Organisation über eine Funktion verfügt, erhält es ein eindeutiges Urteil, niemals einen bloßen booleschen Wert. „Nicht erreichbar“ und „Erreichbar und Nein“ sind unterschiedliche Tatsachen mit unterschiedlichen Codes: ENTITLEMENT_UNREACHABLE (502) und ENTITLEMENT_DENIED (403). Ein kurzer Ausfall der Erreichbarkeit darf niemals dazu führen, dass alle Kunden stillschweigend auf die kostenlose Basisstufe herabgestuft werden.
MANIFEST_SCOPE_WIDENED zurückgehalten wird, bis zwei Prüfer und der Compliance-Beauftragte zustimmen.Das Manifest bekräftigt das Gesetz
Jedes v2-Manifest enthält einen architecture-Block mit drei erforderlichen Sätzen, deren Wortlaut vom Validator exakt vorgegeben wird. In einem Plugin, das Sie für Ihre eigene Installation erstellen, lauten sie:
"architecture": {
"compute": "All compute runs via UNO dispatch (nexus-orchestrator /api/v1/dispatch + nexus-workflows). No direct engine, queue or model-provider calls from plugin code.",
"ai": "All AI goes through the AI Provider Router, which alone owns the credential and the final provider/model decision. This plugin holds no model credentials.",
"deploy": "Deploy is through the installation's release channels only."
}Diese Sätze werden überprüft. Ein Plugin, dessen Manifest den Gesetzen zustimmt, während sein Code direkt einen Modellanbieter aufruft, würde in seinem eigenen Vertrag lügen – und die Gates existieren, um diese Lüge aufzudecken.
Die Gates, die jede Regel durchsetzen
Das SDK liefert zweiundzwanzig Einhaltungs-Gates (Adherence Gates) in einem einzigen Befehl mit: nexus-gates. Kapitel 2.21, Das Plugin-SDK, beschreibt jedes einzelne davon. Hier sind sie nach der Regel gruppiert, die sie durchsetzen.
| Regel | Freigaben | Was den Build fehlschlagen lässt |
|---|---|---|
| Isolierung in der Routenschicht | scope-adherence, one-fence, rights-register, crud-adherence |
Eine /api-Route ohne Scope-Guard, ein zweites handgeschriebenes Mandantenprädikat, eine Scope-Route ohne Berechtigung, eine mutierende Route, deren Berechtigung nichts benennt |
| Isolierung in SQL | sql-fence, no-set-config |
Eine Anweisung auf einer eingegrenzten Tabelle ohne die Abgrenzung (Fence); Plugin-Code, der die Mandanteneinstellung selbst bindet |
| Isolierung in der Datenbank | migrations-are-scoped, rls-present, db-role-honest |
Eine Tabelle, der eine Achse oder ein Schlüssel mit führendem Mandanten fehlt, eine Tabelle ohne erzwungene Row-Level Security, ein Anfragepfad, der sich als Eigentümer oder Superuser verbindet |
| Der einzige Grenzübergang | grants-declared |
Eine in Migrationen freigegebene Tabelle, die das Manifest nicht deklariert, oder eine Leselizenz (Read Seat), der Berechtigungen manuell zugewiesen wurden |
| Berechnungen über UNO | no-direct-compute |
Ein direkter Abruf bei einem Modellanbieter oder einer Engine bzw. bei einer Warteschlange oder einem Workflow-Host; ein zweiter Lesevorgang auf die Dispatch-URL |
| KI und Schlüssel | no-credentials |
Ein im Repository oder in der Umgebung lesbarer Berechtigungsnachweis eines Modellanbieters |
| Der deklarierte Vertrag | api-contract, platform-clients, declared-input |
Eine Route, die registriert, aber nicht deklariert ist, oder deklariert, aber nicht registriert ist; ein Plattform-Client, der importiert, aber nicht benannt wurde |
Jedes Gate verfügt über einen Selbsttest, der beweist, dass es bei einer Testumgebung (Fixture), die speziell zum Auslösen des Fehlers gebaut wurde, auch tatsächlich fehlschlägt. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test führt sie alle aus, und ein Gate, das bei seiner eigenen Testumgebung nicht mehr fehlschlägt, hat aufgehört zu funktionieren.
Bevor Sie eine Überprüfung anfordern
Dies ist die Liste, die ich durchgehe, bevor ich einen Kollegen bitte, ein Plugin zu prüfen. Jede Zeile steht für etwas, das mir ein Prüfer bei Corrán Orbital mindestens einmal zurückgeschickt hat.
- Jede
/api-Route registriert den Scope-Guard, und die einzigen anonymen Routen sind exakte Pfade, die alsauth: publicmitallowAnonymous: truedeklariert sind. - Jede Route, die vom Scope-Guard bedient wird, benennt eine
rightaus dem Register des Manifests, und kein Handler führt eine eigene Berechtigungsprüfung durch. - Kein Handler liest eine Organisation, eine Person oder eine Einheit aus dem Body, der Abfrage oder einem Header aus.
- Jede Anweisung auf einer eingegrenzten Tabelle läuft über
tenantFenceinnerhalb vonwithScopedTx, und nichts im Repository ruftset_configauf. - Jede Tabelle verfügt über die drei Achsenspalten, einen Primärschlüssel, der mit
organization_idbeginnt, und zusammengesetzte Fremdschlüssel, die den Mandanten mitführen. - Die Dispatch-URL wird in einer einzigen Datei ausgelesen, und die Dispatch-Positivliste ist eine Konstante aus namensraumgebundenen Job-Typen.
- Nichts in
package.jsonkommuniziert mit einem Modellanbieter, und in der Umgebung befindet sich kein Schlüssel. - Jede Funktion, die nur in bestimmten Lizenzen enthalten ist, benennt ihr
licencebei der Berechtigung, die sie schützt. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testist grün, undnpx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonebenso.
Wenn alle neun Punkte erfüllt sind, geht es bei der Prüfung um Ihr Produkt – und genau dafür sollte ein Prüfer seine Zeit einsetzen.
Warum die Plattform diese Regeln durchsetzt
Jede der oben genannten Regeln war irgendwann einmal irgendwo eine bloße Konvention, und jede Konvention scheiterte auf dieselbe Weise: Die Routen, die sich daran hielten, waren in Ordnung, und die eine, die es vergaß, wurde zum Sicherheitsvorfall. Eine Abgrenzung für Geschäftseinheiten, die als optionale Middleware angewendet wurde, konnte auf sechs unabhängige Arten umgangen werden – jedes Mal über eine Route, die sich nie dafür registriert hatte. Eine Umgebungsvariable, die die Mandantenidentität überschrieb, lieferte einer Organisation 1.406 Kontakte einer anderen aus, und bei der Code-Prüfung sah es korrekt aus, weil es für den Pod, für den es geschrieben wurde, korrekt war.
Deshalb platziert die Plattform das Prädikat genau dort, wo ohnehin jede Oberfläche hindurch muss: im Scope-Guard und in der Abgrenzungsfunktion (Fence Function), im Transaktions-Wrapper und der erzwungenen Row-Level Security sowie im Dispatch-Client. Ein Gate zählt dann jede Route, jede Anweisung und jeden Import auf und lässt den Build fehlschlagen, wenn eines dieser Elemente auf eine eingegrenzte Tabelle, ein Modell oder eine Berechnungs-Engine zugreift, ohne diese Mechanismen zu durchlaufen. Der Preis dieses Designs ist, dass sich Ihr erstes Plugin eingeschränkt anfühlt. Der Gewinn ist, dass das tausendste Plugin isoliert ist, ohne dass sein Autor überhaupt wissen muss, dass diese Sicherheitsfunktion existiert, weil es schlicht keinen anderen Weg zu den Daten gibt.
Es gibt bei alldem eine ehrliche Grenze. Die Gates beweisen, dass Ihr Code die Mechanismen durchläuft; sie können nicht beweisen, dass Ihre Produktlogik richtig ist. Eine Route, die eine Abfrage korrekt auf die Zeilen des Eigentümers eingrenzt, kann dem richtigen Eigentümer immer noch die falschen Zeilen anzeigen. Das Isolierungstest-Kit in Kapitel 2.22, Die Plugin-Laufzeitumgebung, greift jede Route als eine andere Organisation und als ein Kollege an, wobei jede Abgrenzung nacheinander entfernt wird – und genau diesen Test würde ich ausführen, bevor ich meiner eigenen Einschätzung zu all diesen Punkten vertraue.

