Verzió 1.0.0-alpha.1legújabb
2.1. fejezet
Architektúra
Melyik szolgáltatás miért felel a Nexus chartban, milyen adattárolók találhatók alattuk, és milyen szabályok tartják össze őket, a szolgáltatások közötti identitástól kezdve az útvonalig, amelyet minden modellhívás bejár.
Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

Amikor Tomás Reilly végzett az első telepítéssel a Harrow Port Authoritynél, a kubectl -n nexus get pods tíz Deploymentet és hét StatefulSetet, valamint három CronJobot mutatott. Az adatbázist felépítő migrációs Jobok már eltűntek, mivel sikeres futás után mindegyik törli önmagát. Ez a lista a teljes platform. Érdemes megtanulni, mert a mindennapi üzemeltetési kérdések többsége így kezdődik: „ezek közül melyik felel azért?”
Ez a fejezet minden egyes elemre megválaszolja ezt a kérdést, végigkövet rajtuk egy kérést, majd bemutatja a szabályokat, amelyeknek mindegyikük engedelmeskedik. A 2. rész további fejezetei erre a képre építenek.
A szolgáltatások és amiért felelnek
A chart egyetlen Helm chart, a nexus, 1.0.0-alpha.1 verzió, Kubernetes 1.33 vagy újabb rendszerhez. Minden számítási feladat saját ServiceAccount alatt, nem root felhasználóként fut, az összes Linux capability eldobásával. A személyazonosságot és a kulcsokat védő szolgáltatásokba irányuló hívások kölcsönös TLS (Transport Layer Security) kapcsolaton keresztül zajlanak, a nyilvános API (alkalmazásprogramozási felület) pedig közös folyamatban fut az AI-útválasztóval (mesterséges intelligencia).
| Komponens | Deployment és Service | Szolgáltatásport | Amiért felel |
|---|---|---|---|
| Konzol | nexus-alpha |
3000 | A felhasználók által látott oldalak; HTML-t (Hypertext Markup Language) szolgál ki a konzol hosztján |
| BFF (backend for frontend, a frontendet kiszolgáló backend) | nexus-alpha-bff |
8080 | A konzol saját adatai, az egyes felhasználók menüje, a kiadási nyilvántartás |
| Hitelesítés | nexus-auth |
9101 (kölcsönös TLS a 8443-on) | Személyek, szervezetek, munkamenetek, tokenek, API-kulcsok, a szervezet modellkulcs-készlete |
| Átjáró (Gateway) | nexus-gateway |
9092, WebSocket 8093 | Az AI Provider Router, valamint a nyilvános API-végpont a REST (representational state transfer) és az MCP (Model Context Protocol) számára |
| Orchestrator | nexus-orchestrator |
8080 | UNO feladatindítás: minden feladat fogadása és sorba állítása |
| Munkafolyamatok | nexus-workflows |
8081 | UNO végrehajtás: a sorba állított feladatokat futtató feldolgozó (worker) |
| GraphRAG | nexus-graphrag |
8090, WebSocket 8091 | Memória: a tudásgráf és a rajta végzett visszakeresés |
| Probitas | nexus-probitas |
9151 (HTTPS) | Bizonyítékok: irányítási (governance) rekordok és a lezárt főkönyv |
| Skill-motor | nexus-skills-engine |
8095 | A képességtár (skill library); képességek keresése és futtatása |
| Kulcsok | nexus-keys |
8080 (HTTPS, kölcsönös TLS) | Szervezetenkénti kulcsok az OpenBao-ban, kulcsőrzés (custody), a telepítési identitás |
| Bővítmények (Plugins) | nexus-plugins |
9111 | A bővítmény-nyilvántartás és a katalógusrekordok; alapértelmezetten kikapcsolva |
| Fájlfeldolgozás | nexus-fileprocess |
9109 | Feltöltött dokumentumok és képek olvasása; alapértelmezetten kikapcsolva |
Az első tíz kötelező. Az utolsó kettő opcionális, a components.plugins.enabled és components.fileprocess.enabled beállításokkal kapcsolható be ott, ahol egy Enterprise telepítés vagy egy szakterületi csomag (domain pack) használja őket. Egy további opcionális szolgáltatás, a 8080-as porton futó nexus-alive saját kapcsolóval rendelkezik (components.alive.enabled), és alapértelmezetten szintén ki van kapcsolva. Az egyes elemek replikái és erőforrásai a components.<name> alatt találhatók.
A konzol szerveroldalon renderelt oldalakból áll, adatbázis nélkül. A BFF-fel, valamint a klaszteren belül a nexus-auth szolgáltatással kommunikál, soha nem megy ki a nyilvános auth hoszton keresztül, majd vissza. Nem indul el a kiadási típusa (edition) nélkül, amelyet a chart NEXUS_EDITION értékként ad át az egyetlen edition értékből. Egy szervezet minden tagja a saját szerepkörének megfelelően dolgozik benne. Az adminisztrációs oldalak a tulajdonosoknak és az adminisztrátoroknak szólnak; ha egy egyszerű tag nyit meg egy ilyet, a „Nem adminisztrátor” oldalt kapja.
A BFF a konzol szerveroldali fele, amely a platform bővítményeként épül fel, és Nexus Alpha termékként van regisztrálva. A konzol saját tábláit egy külön adatbázisban, a nexus_alpha adatbázisban tárolja, és ez dönti el, hogy egy felhasználó mely menücsoportokat látja. Amikor a konzolnak el kell végeztetnie egy munkát, a BFF megkéri rá az azért felelős szolgáltatást.
A nexus-auth Go nyelven íródott, és ez az egyetlen szolgáltatás, amely tokeneket bocsát ki. A hozzáférési tokenek élettartama alapértelmezetten 15 perc, a frissítési tokeneké pedig 12 óra (auth.accessTokenTTL, auth.refreshTokenTTL). Minden bejelentkezett felhasználót percenként 5000 kérésre korlátoz, mielőtt 429-es válasszal térne vissza (auth.rateLimitPerMinute). Két figyelőprocesst (listener) futtat: egy egyszerűt a 8080-as konténerporton, amelyet a nyilvános Ingress ér el, és egy kölcsönös TLS-t használót a 8443-as porton, amelyet minden klaszteren belüli hívónak használnia kell. A X-Forwarded-For fejlécnek csak a proxy.trustedCIDRs listában szereplő ugrásoktól (hop) hisz; ez egy Classless Inter-Domain Routing (CIDR) tartományokból álló lista, amelynek alapértelmezett értéke 10.42.0.0/16, a k3s podhálózata. Ha az Ön ingress vezérlője máshol fut, módosítsa ezt az értéket. Ellenkező esetben minden bejelentkezés úgy fog kinézni, mintha a vezérlőtől érkezett volna.
Az átjáró (gateway) két feladatot lát el egyetlen közös folyamatban. A klaszteren belül ez az AI Provider Router (az 1. részben és a konzol oldalain szereplő AI-kapcsolóközpont), a szervezet modell-hitelesítő adatainak egyedüli birtokosa (erről bővebben alább). A peremhálózaton (edge) ezt éri el a api.<domain>: a REST-kliensek és az MCP-kliensek, amelyek tokenjei a https://<hosts.api>/mcp célközönséget (audience) hordozzák, és az auth hoszton futó OAuth 2.1 engedélyezési szervertől származnak (az OAuth a delegált engedélyezés nyílt szabványa).
Az orchestrator és a workflows együtt alkotják az UNO munkafolyamat-motort. Minden számítási művelet rajtuk keresztül fut. Az orchestrator a POST /api/v1/dispatch útvonalon fogadja a feladatokat, 202-es kóddal, valamint egy jobId, runId és traceId értékkel válaszol, majd sorba állítja a feladatot. Nincs közvetlen (inline) végrehajtási útvonal: a kliens mindig lekérdezi (poll) a GET /api/v1/dispatch/{jobId} útvonalat, vagy visszahívást (callback) fogad. A workflows feldolgozó (worker) kiveszi a feladatokat a sorból – alapértelmezetten replikánként egyszerre négyet (workflows.concurrency) –, és pontosan egyetlen HTTP-útvonallal rendelkezik: GET /health.
A Probitas a bizonyítékszolgáltatás. Maga szolgálja ki a TLS-t egy olyan tanúsítványból, amelyet a chart bocsát ki, tábláit pedig a trust sémában tartja, külön szerepkörrel a főkönyv számára. Irányítási (governance) funkcióit a probitas.flags kapcsolja. Több funkció is shadow módban érkezik: a rendszer kiszámítja és rögzíti a döntést, de semmit sem blokkol, amíg Ön át nem állítja a jelzőt (flag).
A nexus-keys a platform Go nyelven írt kulcsszolgáltatása. Szervezetenként egy kulcsot tárol egy OpenBao kulcstárban, és éjszakánként forgatja (rotálja) őket. Éjszakai feladatai emellett megsemmisítik azokat a kulcsokat, amelyek megőrzési ideje lejárt, és a nyugtákat egy saját kötetre exportálják. Egy szervezet kulcsának törlése véglegesen olvashatatlanná teszi az alatta zárolt adatokat. Emellett az első rendszerindításkor (bootstrap) a keys.installationName alatt kibocsátja a telepítési identitást is, és ez a név végleges. Válassza meg körültekintően: a chart elutasítja az üres nevet (INSTALLATION_NAME_MISSING), és elutasítja a saját példaértékeiben szereplő nevet is (INSTALLATION_NAME_EXAMPLE).
Három nyilvános állomásnév (host)
A chart pontosan három hosztnevet tesz közzé, amelyek együtt alkotják a telepítési identitást. Ezek nélkül minden szolgáltatás megtagadja az elindulást.
| Ingress | Hosztnév értéke | Backend |
|---|---|---|
nexus-console |
hosts.console |
nexus-alpha, 3000-es port |
nexus-api |
hosts.api |
nexus-gateway, 9092-es port |
nexus-auth |
hosts.auth |
nexus-auth, 9101-es port |
A könyvben szereplő példák a console.harrow.example, api.harrow.example és auth.harrow.example értékeket használják. Az Ingressek egyszerű networking.k8s.io/v1 objektumok, egyenként egy szabállyal és / útvonallal. A peremhálózati TLS a tls.mode beállítást követi: existing (egy Ön által létrehozott Secret, amelynek neve a tls.existingSecret alatt szerepel), cert-manager (egy Ön által futtatott ClusterIssuer, amelynek neve a tls.clusterIssuer alatt szerepel) vagy none (a TLS a klaszter előtt ér véget). A chart nem ad hozzá saját átirányítást, így az ACME (Automated Certificate Management Environment) HTTP-kihívások változatlanul elérik a megoldót (solver). A 2.11. fejezet (Variációk: külső adattárak, TLS és ingress) minden módot részletesen bemutat.
Semmi más nincs kitéve a külvilág felé. Az adattárak, az OpenBao és minden belső szolgáltatás kizárólag a névtéren belül figyel.
Egy kérés útja az elejétől a végéig
Íme, mi történik, amikor Aoife Brennan, a Harrow IT-vezetője megnyitja a konzolt, és feltesz egy kérdést az asszisztensnek az e havi kikötőhely-beosztásról.
- A böngészője betölti a
https://console.harrow.examplecímet. Anexus-consoleIngress ezt a 3000-es porton figyelőnexus-alphaszolgáltatáshoz küldi. - Bejelentkezik az azonosítókulcsával (passkey). A bejelentkezési oldalak a
auth.harrow.exampleútvonalon keresztül kommunikálnak anexus-authszolgáltatással, a nexus-auth pedig kibocsát számára egy hozzáférési tokent, amely tartalmazza a felhasználóját, a szervezetét, és – ha a munkamenetnek van ilyen – az üzleti egységét. - A konzol szervere meghívja a BFF-et, amely ellenőrzi a tokent, és megkérdezi a nexus-auth szolgáltatást, hogy a szervezete rendelkezik-e a termékkel, és a szerepköre jogosult-e a hozzáférésre. Válaszként megkapja azokat a menücsoportokat, amelyeket a felhasználó láthat.
- A kérdése a BFF-től az orchestrator feladatindító (dispatch) útvonalára kerül, a szervezet és a felhasználó adatait pedig az ellenőrzött tokenből veszi a rendszer. Az orchestrator 202-es kóddal válaszol, és beteszi a feladatot egy Valkey-alapú várakozási sorba.
- Egy workflows feldolgozó (worker) átveszi a feladatot. A futtatott képességet (skill) a skills engine oldja fel, a Harrow dokumentumain végzett visszakeresés pedig a GraphRAG-hoz fut be, amely a Neo4j-t, a Qdrantot és a saját PostgreSQL sémáját olvassa.
- A modellhívás a
/internal/ai/chatcímen elérhető AI Provider Routerhez kerül. Az útválasztó kiválasztja a szolgáltatót és a modellt a Harrow saját kulcskészletéből és útválasztási szabályzatából, végrehajtja a hívást a Harrow kulcsával, majd visszaadja a választ (completion). - Az eredmény a feladat futási sorába kerül. A BFF kiolvassa azt, a konzol pedig kirajzolja a választ a hivatkozásokkal együtt.
A szolgáltatások közötti ugrások (hop) kivetített (projected) szolgáltatástokeneket hordoznak, a nexus-auth, a nexus-keys és a Probitas felé irányuló hívások a telepítés saját hitelesítésszolgáltatójától (CA) származó TLS-en keresztül futnak, a 4–6. lépésekben történő minden adathozzáférés pedig már magában az adatbázisban a Harrow szervezetére van korlátozva. Az alábbi szakaszok mindkettőt elmagyarázzák.
Az adatréteg
A Nexus minden adattárból saját, aláírt példányt szállít, a csomagban pedig mindegyikhez megtalálható a forráskódra vonatkozó felajánlás. Mindegyiket legalább annyira választottuk a licence, mint a funkciója miatt.
| Adattár | Verzió | Licenc | Miért van rá szükség | Kikötő | Alapértelmezett kötet |
|---|---|---|---|---|---|
| PostgreSQL PostGIS-szel és pgvectorral | PostgreSQL 16, PostGIS 3, pgvector 0.8 | PostgreSQL Licence; PostGIS GPL-2.0-or-later | Hiteles nyilvántartási rendszer (system of record) minden szolgáltatás számára; PostGIS a térképadatokhoz; pgvector a sorok mellett tárolt vektorokhoz | 5432 | 50 GiB |
| Valkey | 8.1 | BSD-3-Clause | Az UNO feladatsorok és a rövid élettartamú gyorsítótárak, például a nexus-auth API-kulcs gyorsítótára | 6379 | 5 GiB |
| Neo4j Community Edition | 5.26 | GPL-3.0 | A GraphRAG által épített és bejárt tudásgráf | 7687 (Bolt) | 20 GiB |
| Qdrant | 1.15 | Apache-2.0 | Vektoros keresés a GraphRAG és a skills engine számára | 6333 (HTTP), 6334 (gRPC távoli eljáráshívások) | 10 GiB |
| SeaweedFS | 4.48 | Apache-2.0 | Objektumtároló fájlok számára, kompatibilis az Amazon Simple Storage Service (S3) szolgáltatással | 8333 | 50 GiB |
| OpenBao | 2.6 | MPL-2.0 | A kulcstár és a hozzá tartozó feloldó (unsealer), a nexus-keys számára | 8200 | 5 GiB és 1 GiB |
Néhány választás valamilyen ismerősebb megoldást váltott ki. A Valkey a Redis 7.4 helyett áll, amelynek jelenlegi licenceit a kiadás elutasítja. A MinIO AGPL-3.0 licencű, így az objektumtároló a SeaweedFS lett. A GraphRAG a Bolt hálózati protokollon keresztül éri el a Neo4j Community Editiont, a szolgáltatások pedig a PostgreSQL protokollon keresztül érik el a PostGIS-t, így a GPL mindkettő esetében elszigetelt marad. Az OpenBao a Vault Linux Foundation által gondozott leágazása (fork), amely még a Vault licencváltása előtt jött létre.
Minden adattár bekapcsolt hitelesítéssel és generált hitelesítő adatokkal fut: jelszóval a Valkey, API-kulccsal a Qdrant, hozzáférési kulcsokkal a SeaweedFS esetében.
A dataTier alatti öt adattár mindegyike futhat a klaszteren belül (mode: in-cluster, ez az alapértelmezett), vagy lehet olyan is, amelyet Ön már eleve üzemeltet (mode: external, a external.host beállítással és egy external.existingSecret által megnevezett Secrettel). Külső PostgreSQL esetén állítsa a sslmode értéket verify-full vagy verify-ca értékre, és helyezze el a szerver hitelesítésszolgáltatói (CA) tanúsítványát ebben a Secretben; a részleteket a 2.11. fejezet (Variációk: külső adattárak, TLS és ingress) tartalmazza.
# harrow-values.yaml (Helm values): Harrow's own PostgreSQL, every other store in the cluster
dataTier:
postgres:
mode: external
sslmode: verify-full
external:
host: pg.harrow.example
existingSecret: harrow-postgresAz OpenBao páros kivétel: mindig a telepítésen belül fut, mivel a kulcsőrzési (custody) Job ott inicializálja.
Szolgáltatások közötti identitás
A Nexus service mesh nélkül fut. A kölcsönös TLS-t egy helyi hitelesítésszolgáltató (CA) biztosítja, amelyet a chart hoz létre a cert-manageren keresztül; ez utóbbit előzetesen telepíteni kell (a v1.21.3-as verzió tesztelt).
Egy önaláírt Issuer létrehoz egyetlen, tíz évig érvényes, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256 típusú CA-tanúsítványt (nexus-local-ca). Egy második Issuer ezzel a CA-val ír alá. Minden olyan számítási feladat, amely a telepítésen belül egy TLS-szervert hív meg, saját ügyféltanúsítványt kap <service-account>-client-tls néven, amely 90 napig érvényes, és a lejárat előtt 15 nappal megújul. Egyetlen neve egy SPIFFE identitásformátumú egységes erőforrás-azonosító (URI):
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
Minden számítási feladat ca.crt néven találja meg a CA nyilvános tanúsítványát a saját tanúsítvány-Secretjében. Egyetlen pod sem csatolja fel a CA kulcsát, és nincs szükség trust-managerre sem.
Három szolgáltatás ellenőrzi tanúsítvány alapján a hívókat. A nexus-auth ezt a második figyelőprocesszén (listener), a 8443-as porton teszi, és minden klaszteren belüli hívó ezt tárcsázza. A nexus-keys az egyetlen figyelőprocesszén végzi ezt. A Probitas a saját tanúsítványából (nexus-probitas-tls) szolgálja ki a TLS-t, amelyet újra beolvas, amikor a cert-manager megújítja. Egyikük sem bízik meg a X-Forwarded-Client-Cert fejlécben.
Minden számítási feladat egyórás Kubernetes-tokeneket is kap a /var/run/secrets/nexus útvonalon – minden általa hívott szolgáltatáshoz egyet, az adott szolgáltatást megjelölve célközönségként (audience). A nexus-service-identities ConfigMap minden <namespace>/<service-account> értéket hozzárendel egy szolgáltatás- vagy bővítménynévhez; az ebből hiányzó számítási feladatok nem rendelkeznek identitással, és a rendszer elutasítja őket. Az orchestrator és a Probitas a Kubernetes API segítségével ellenőrzi ezeket a tokeneket. A futó szolgáltatások közül csak ez a kettő rendelkezik system:auth-delegator jogosultsággal vagy felcsatolt API-tokennel; az egyetlen másik, tokennel rendelkező feladat a telepítéskor lefutó kulcsőrzési (custody) Job.
A hálózati szabályzat (NetworkPolicy) lezárja azt, amit az identitáskezelés nem. A chart az alapértelmezett tiltásból (default deny) indul ki, majd engedélyezi a forgalmat a telepítés saját podjai között, a DNS (Domain Name System) felé, az ingress vezérlő névteréből (networkPolicy.ingressNamespace, alapértelmezetten kube-system) a három nyilvános Service felé, valamint az API-szerver felé a két tokenellenőrző számára. Az OpenBao podok a platform többi részétől eltérő címkét (label) viselnek, így a névtéren belüli nyílt szabály nem terjed ki rájuk: csak a nexus-keys, a hozzá tartozó Jobok és a kulcsőrzési (custody) Job jutnak át, a 8200-as porton. Minden mást, amit egy számítási feladatnak a névtéren kívül el kell érnie – például az Ön levelezési továbbítóját (mail relay) –, a networkPolicy.externalEgressCIDRs alatt kell megadni, amely alapértelmezetten üres.
Migrációk és a sémanapló
A migrációk Helm hookokként futnak, post-install és pre-upgrade eseményeken. A post-install hook azután fut le, hogy a kiadás Deploymentjei létrejöttek. Így az első telepítéskor a szolgáltatások úgy indulnak el, hogy a sémáik még nem léteznek, és folyamatos összeomlási ciklusba (crash-loop) kerülnének egy olyan adatbázissal szemben, amelyben nincs szerepkör, nincs jelszó és nincsenek táblák. A Nexus ezt egy főkönyv (ledger) segítségével kerüli el.
A hookok súlyozási (weight) sorrendben futnak, és a Helm minden Jobot bevár, mielőtt a következő súlyérték elindulna:
| Súly | Hook | Mit csinál |
|---|---|---|
| -30 | nexus-migrations-env és előfeltételek |
Létrehozza a kizárólag hookok által használt Secretet a migráló hitelesítő adataival, valamint mindent, amit a kulcsőrzési (custody) Job olvas |
| -20 | nexus-db-bootstrap |
Létrehozza a nexus és nexus_alpha adatbázisokat, a migráló szerepkört, minden szolgáltatás futásidejű szerepkörét, a kiterjesztéseket és a főkönyvet |
| -15 | nexus-openbao-custody-init |
Inicializálja a kulcstárat és a feloldót (unsealer), valamint kibocsátja a telepítési identitást |
| -12 | nexus-graphrag-migrations |
A GraphRAG sémája, amely olyan objektumokat birtokol, amelyekre a nexus-auth alapállapota (baseline) hivatkozik |
| -10 | nexus-auth-migrations |
Az identitásséma |
| -5 | Az orchestrator, a gateway és a Probitas migrációi | A saját sémáik; a Probitas először ellenőrzi, hogy léteznek-e az auth táblák |
| 0 | nexus-alpha-bff-migrations |
A konzol saját adatbázisa |
Minden migrációs Job backoffLimit: 0 beállítással rendelkezik, így egy sikertelen migráció megszakítja a telepítést.
A főkönyv egyetlen tábla (nexus_release.schema_applied), lánconként és képfájl-lenyomatonként (image digest) egy-egy sorral. Minden hook csak azután írja be a saját sorát, hogy a migrációfuttatója visszatért. Minden PostgreSQL-t használó Deployment tartalmaz egy init konténert (wait-for-schema), amely egy olyan szerepkörként olvassa ezt a táblát, amely semmi mást nem olvashat (nexus_ledger_reader), és addig vár, amíg minden lánc, amelytől függ, nem mutat egy sort az adott kiadás képfájljához. Ekkor a szolgáltatás elindul. A workflows feldolgozó az orchestrator láncára vár, mivel osztozik vele az adatbázison, a skills engine pedig kizárólag a rendszerindításra (bootstrap) vár.
3 másodpercenként kérdez le (schemaWait.intervalSeconds), és 1800 másodperc után (schemaWait.timeoutSeconds) feladja egy olyan naplósorral, amely megnevezi a még hiányzó láncokat. A szolgáltatás saját konténere soha nem indul el hibás sémával.
kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schemaEzért nem szabad soha helm install --wait parancsot futtatnia. A --wait kapcsolóval a Helm a post-install hookok futtatása előtt vár a Deploymentekre, a Deploymentek pedig a hookokra várnak. Egyik sem mozdul. Telepítsen nélküle, és várjon utána; a 2.6. fejezet (A Community kiadás telepítése Kubernetesre) megadja a pontos parancsot.
Izoláció három tengely mentén
A Nexusban minden olvasás, írás, eszközhívás és képességindítás (skill dispatch) három tengely mentén van hatókörbe sorolva.
| Tengely | Mező | Mit választ el |
|---|---|---|
| Bérlő (Tenant) | organization_id |
Az egyik szervezetet a másiktól; szigorú határ |
| Tulajdonos (Owner) | owner_user_id |
Egy személy dolgait mindenki másétól, még egyazon szervezeten belül is |
| Egység (Unit) | business_unit_id |
Egy szervezet alegysége, opcionális |
A tulajdonosi tengely sokakat meglep. Egy postafiók vagy egy személyes jegyzetfüzet kizárólag a tulajdonosa számára privát, még az ugyanabban az egységben, azonos szerepkörben dolgozó kollégák elől is. Egy adminisztrátor szabályzatokat állít be, és nem olvas tartalmat.
A tengelyek a hitelesített kérésből származnak, és sehonnan máshonnan. Semmilyen környezeti változó, fejléc, lekérdezési paraméter vagy útvonalszegmens nem állíthatja be őket. A szervezetet megnevező kéréstörzseket a rendszer TENANT_NOT_A_PARAMETER hibával elutasítja. Az olyan felületek, amelyek nem tudják megállapítani, hogy egy sor melyik bérlőhöz, tulajdonoshoz és egységhez tartozik, 403 SCOPE_PREDICATE_MISSING hibával utasítják el a kérést, a törzs pedig felsorolja, hogy mely tengelyeket sikerült feloldani és melyeket nem. A rendszer soha nem lép vissza egy tágabb olvasási jogosultságra.
Ez egyszerre két helyen is érvényesül.
Az adatbázisban. Minden szolgáltatás a saját futásidejű szerepköreként csatlakozik: nexus_auth, auth_app és auth_platform az identitásszolgáltatás esetében, nexus_probitas és nexus_probitas_ledger a Probitas esetében, valamint nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app és a többi a további szolgáltatásoknál. Egyik sem superuser, és egyik sem rendelkezik BYPASSRLS jogosultsággal. Egyik sem birtokolja az általa használt táblákat sem, így minden sorszintű biztonsági (RLS) szabályzat vonatkozik rájuk. A szerepkörök egy közös csoporton (nexus_runtime) osztoznak, amely csatlakozási és sémahasználati jogot ad, de semmilyen táblajogosultságot nem biztosít; minden szolgáltatás a saját migrációin keresztül kap jogot a saját tábláihoz. Az RLS-szabályzatok által olvasott bérlői beállításokat kizárólag az egyes szolgáltatások saját bind_scope függvényén keresztül lehet beállítani, amely a saját tulajdonosaként fut. A rendszerindító (bootstrap) folyamat mindenki mástól visszavonja a set_config jogosultságot, az orchestrator és a Probitas pedig megtagadja az indulást, ha a futásidejű szerepkörük közvetlenül meg tudná hívni azt (a Probitas ezt DB_ROLE_SETS_SCOPE_DIRECTLY néven illeti). A teljes telepítésben az egyetlen superuser-kapcsolatok a rendszerindító Jobhoz és a BFF előkészítési (provisioning) lépéséhez tartoznak.
A megosztott, hatókörhöz kötött lekérdezési alapkomponensben (primitive). A platform minden adattára (repository) és az SDK-ra (szoftverfejlesztő készlet) épülő minden bővítmény örököl egy közös védőkorlátot, amely a feloldott hatókörből építi fel az SQL-predikátumot. A hatókörfüggvény az ellenőrzött identitást fogadja, és nincs szervezeti paramétere, így a hívó nem adhat át ilyet, és egyetlen útvonal sem kerülheti meg.
A bérlői határnak pontosan egyetlen átlépési módja van, és az is szűk: egy rögzített engedély (grant). A sorokat birtokló szervezet két munkatársa rögzíti, hogy melyik szervezet mely táblákat olvashatja, és meddig. Minden olvasás csak olvasható (read-only) tranzakcióban fut, és mindkét bérlőnél naplózásra kerül. A tulajdonosok és az adminisztrátorok soha nem látnak át a határon, az olvasó fél pedig nem tágíthatja ki az engedélyt.
Az AI-útvonal
A hívók kívánságokat fogalmaznak meg. Az AI Provider Router birtokolja a hitelesítő adatokat, és ő hozza meg a végső döntést.
A Nexusban minden modellhívás az útválasztó /internal/ai/* útvonalain keresztül zajlik, és az útválasztó csak megnevezett hívókat enged be. A chart három listát állít be az átjárón:
| Útvonalak | Ki hívhatja |
|---|---|
| Csevegés és csevegés-adatfolyam (streaming) | nexus-orchestrator, nexus-workflows, nexus-skills-engine |
| Beágyazások (embeddings) és újrarangsorolás (rerank) | nexus-graphrag, nexus-skills-engine, nexus-workflows |
| Minden más, beleértve az eszközvégrehajtást is | nexus-orchestrator, nexus-workflows |
A hívóidentitás nélküli hívásokat a rendszer 403 MISSING_CALLER_IDENTITY hibával, a listán nem szereplő hívókat pedig 403 UNAUTHORIZED_CALLER hibával utasítja el. A bővítmények egyik listán sem szerepelnek, és ez szándékos: egy bővítmény modellhívásai az ő nevében, az UNO feladatindításon keresztül történnek.
Amit a hívó küldhet, az egy kívánság: egy előnyben részesített szolgáltató és modell, valamint egy képességprofil, például minimális kontextushossz vagy eszközhasználat. Az útválasztó csak akkor teljesíti a kívánságot, ha a szervezetnél az adott szolgáltató engedélyezve van, és rendelkezik hitelesítő adatokkal; ellenkező esetben helyettesít, először ugyanazon szolgáltatón belül, majd a szervezet többi szolgáltatója között. A képességprofil csak szűr, a benne szereplő adathelyhez kötöttségi (data-residency) követelmény pedig szigorú feltétel. Ha semmi sem felel meg, nincs tartalék (fallback) modell: a hívó 422 MODEL_CAPABILITY_UNAVAILABLE vagy 422 NO_PROVIDER_FOR_ROLE hibát kap, egy hibaelhárítási szöveggel együtt, amelyet a konzol megjelenít az adminisztrátornak.
A kulcsok a szervezethez tartoznak. Minden szervezet adminisztrátorai a konzolon keresztül teszik be a saját szolgáltatói kulcsaikat a szervezet készletébe, az útválasztó pedig a hívás pillanatában oldja fel őket. Egyetlen modellkulcs sem szerepel chart-értékként, és a Nexus egyet sem szállít beépítve. A kulccsal nem rendelkező szervezet nem kap AI-válaszokat, és a konzol ezt nyíltan ki is írja; semmi sem pótolja a hiányt máshonnan.
Két chart-érték határozza meg az útválasztó működését. A ai.localProvider.baseUrl egy Ön által üzemeltetett, OpenAI-kompatibilis modellszervert nevez meg, amelyhez az irányítás ugyanúgy történik, mint bármely más szolgáltatóhoz. A ai.installationHosts a privát neveken elérhető modellszervereit sorolja fel, amelyeket az útválasztó a telepítésen belülinek tekint. A GraphRAG is az útválasztón keresztül végzi a beágyazást (embedding), azon szervezet nevében, amelyhez a tartalom tartozik. Az alapértelmezett beágyazási modell grafikus kártya nélkül fut a fürtben; a kiszervezett (hosted) beágyazások használata az egyes szervezetek saját döntése.
Nincs telemetria
Semmi sem hagyja el a telepítést, hacsak Ön nem küldi el. A chart telemetry.enabled értéke kizárólag false lehet; a séma minden mást elutasít. Az adatréteg saját jelentésküldése is ki van kapcsolva: a Neo4j használati jelentése és a Qdrant telemetriája le van tiltva a chartban.
Amikor a networkPolicy.enabled be van kapcsolva – ami az alapértelmezés –, egyetlen pod sem érheti el az internetet, hacsak Ön fel nem veszi a célhelyet a networkPolicy.externalEgressCIDRs listába. Ilyen célhely például egy külső modellszolgáltató, ahogyan az Ön levelezési továbbítója (mail relay) is.
Ugyanez a szabály megváltoztatott egy alapértelmezett beállítást, amelyet észre fog venni. A nexus-auth regisztrációs CAPTCHA-jához internetes szolgáltatásra van szükség, ezért egy telepítésen ez ki van kapcsolva, az ismeretlenek regisztrációja pedig rendszergazdai jóváhagyásra vár (403 SIGNUP_REQUIRES_APPROVAL). A tárhelyszolgáltatói hálózatokból érkező regisztrációkat blokkoló szűrés szintén ki van kapcsolva, mivel olyan licencelt adatbázisokat igényel, amelyeket a Nexus nem tartalmaz. Ezt az előszűrést így elveszíti.

