Prihlásiť saRezervovať brífing

Kapitola 2.1

Architektúra

Čo vlastní každá služba v charte Nexus a ktoré úložiská sa pod ňou nachádzajú, a následne pravidlá, ktoré ich držia pohromade, od identity medzi službami až po cestu, ktorou prechádza každé volanie modelu.

Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

19 min čítania

Keď Tomás Reilly dokončil prvú inštaláciu v Harrow Port Authority, kubectl -n nexus get pods zobrazil desať objektov Deployment a sedem objektov StatefulSet, plus tri objekty CronJob. Migračné úlohy Job, ktoré vytvorili databázu, už zmizli, pretože každá z nich sa po úspešnom dokončení sama odstráni. Tento výpis predstavuje celú platformu. Naučte sa ho, pretože väčšina otázok pri bežnej prevádzke začína slovami „ktorá z týchto častí vlastní tamto?“

Táto kapitola na to odpovedá pre každú časť, sleduje cez ne jednu požiadavku a následne sa venuje pravidlám, ktorými sa všetky riadia. Zvyšok 2. časti stavia na tomto obraze.

Služby a čo každá z nich vlastní

Chart tvorí jeden Helm chart, nexus, verzia 1.0.0-alpha.1, pre Kubernetes 1.33 alebo novší. Každá pracovná záťaž beží pod vlastným účtom ServiceAccount, ako používateľ bez oprávnení root, so všetkými odobratými schopnosťami (capabilities) systému Linux. Volania do služieb, ktoré chránia identitu a kľúče, prebiehajú cez vzájomné TLS (Transport Layer Security) a verejné API (aplikačné programovacie rozhranie) zdieľa proces so smerovačom AI (umelej inteligencie).

Komponent Deployment a Service Port služby Čo vlastní
Konzola nexus-alpha 3000 Stránky, ktoré ľudia vidia; poskytuje HTML (Hypertext Markup Language) na hostiteľovi konzoly
BFF (backend pre frontend) nexus-alpha-bff 8080 Vlastné údaje konzoly, ponuku, ktorú každá osoba dostane, register vydaní
Auth nexus-auth 9101 (vzájomné TLS na 8443) Ľudí, organizácie, relácie, tokeny, kľúče API, fond kľúčov modelov organizácie
Brána nexus-gateway 9092, WebSocket 8093 AI Provider Router a okraj verejného API pre REST (representational state transfer) a MCP (Model Context Protocol)
Orchestrátor nexus-orchestrator 8080 Odosielanie UNO: prijatie každej úlohy a jej zaradenie do frontu
Workflows nexus-workflows 8081 Vykonávanie UNO: pracovný proces (worker), ktorý spúšťa úlohy zaradené do frontu
GraphRAG nexus-graphrag 8090, WebSocket 8091 Pamäť: znalostný graf a vyhľadávanie v ňom
Probitas nexus-probitas 9151 (HTTPS) Dôkazy: záznamy o riadení (governance) a zapečatenú účtovnú knihu (ledger)
Engine zručností nexus-skills-engine 8095 Knižnicu zručností; vyhľadávanie a spúšťanie zručností
Kľúče nexus-keys 8080 (HTTPS, vzájomné TLS) Kľúče pre jednotlivé organizácie v OpenBao, úschovu (custody), identitu inštalácie
Zásuvné moduly nexus-plugins 9111 Register zásuvných modulov a katalógové záznamy; predvolene vypnuté
Spracovanie súborov nexus-fileprocess 9109 Čítanie nahraných dokumentov a obrázkov; predvolene vypnuté

Prvých desať je povinných. Posledné dva sú voliteľné a zapínajú sa pomocou components.plugins.enabled a components.fileprocess.enabled tam, kde ich využíva inštalácia Enterprise alebo doménový balík. Ešte jedna voliteľná služba, nexus-alive na porte 8080, má vlastný prepínač components.alive.enabled a je tiež predvolene vypnutá. Repliky a prostriedky pre každú z nich sa nachádzajú pod components.<name>.

Konzola pozostáva zo stránok vykresľovaných na serveri bez databázy. Komunikuje s BFF a so službou nexus-auth vo vnútri klastra, nikdy nie smerom von cez verejného hostiteľa overovania a späť dnu. Odmietne sa spustiť bez svojej edície, ktorú chart odovzdáva ako NEXUS_EDITION z jedinej hodnoty edition. Každý člen organizácie v nej pracuje podľa svojej roly. Stránky správy sú určené pre vlastníkov a správcov a členovi, ktorý takúto stránku otvorí, sa zobrazí stránka „Nie ste správca“.

BFF je serverová polovica konzoly a je vytvorená ako zásuvný modul platformy, zaregistrovaný ako produkt Nexus Alpha. Uchováva vlastné tabuľky konzoly v samostatnej databáze nexus_alpha a rozhoduje o tom, ktoré skupiny ponuky osoba uvidí. Keď konzola potrebuje vykonať prácu, BFF o to požiada službu, ktorá ju vlastní.

Služba nexus-auth je napísaná v jazyku Go a je jedinou službou, ktorá vydáva tokeny. Prístupové tokeny majú predvolene životnosť 15 minút a obnovovacie tokeny 12 hodín (auth.accessTokenTTL, auth.refreshTokenTTL). Obmedzuje každú prihlásenú osobu na 5 000 požiadaviek za minútu, po ktorých odpovie kódom 429 (auth.rateLimitPerMinute). Prevádzkuje dva načúvacie procesy (listeners): obyčajný na porte kontajnera 8080, na ktorý sa pripája verejný Ingress, a proces so vzájomným TLS na porte 8443, ktorý musí používať každý volajúci vo vnútri klastra. Hlavičke X-Forwarded-For dôveruje iba zo skokov (hops) v proxy.trustedCIDRs, čo je zoznam rozsahov Classless Inter-Domain Routing (CIDR), ktorý je predvolene nastavený na 10.42.0.0/16, sieť podov k3s. Ak váš kontrolér Ingress beží inde, zmeňte to. V opačnom prípade bude každé prihlásenie vyzerať, akoby prišlo z kontroléra.

Brána má dve úlohy, ktoré zdieľajú jeden proces. Vo vnútri klastra je to AI Provider Router (ústredňa AI v 1. časti a na stránkach konzoly), jediný držiteľ prihlasovacích údajov k modelom organizácie (viac o tom nižšie). Na okraji siete je to miesto, kam smeruje api.<domain>: klienti REST a klienti MCP, ktorých tokeny nesú publikum (audience) https://<hosts.api>/mcp a pochádzajú z autorizačného servera OAuth 2.1 na hostiteľovi overovania (OAuth je otvorený štandard pre delegovanú autorizáciu).

Orchestrátor a workflows spolu tvoria UNO, workflow engine. Všetky výpočty prebiehajú cez ne. Orchestrátor prijme úlohu na POST /api/v1/dispatch, odpovie kódom 202 s jobId, runId a traceId a zaradí ju do frontu. Neexistuje žiadna priama (inline) cesta vykonávania: klient sa vždy dopytuje (polls) na GET /api/v1/dispatch/{jobId} alebo prijme spätné volanie (callback). Pracovný proces workflows vyberá úlohy z frontu, predvolene štyri naraz na jednu repliku (workflows.concurrency), a má presne jednu trasu HTTP, GET /health.

Probitas je dôkazová služba. Sama poskytuje TLS z certifikátu, ktorý vydáva chart, a svoje tabuľky uchováva v schéme trust so samostatnou rolou pre účtovnú knihu (ledger). Jej funkcie riadenia (governance) sa prepínajú pomocou probitas.flags. Viaceré sa dodávajú v režime shadow: verdikt sa vypočíta a zaznamená, ale nič sa neblokuje, kým nezmeníte príznak.

nexus-keys je kľúčová služba platformy, napísaná v jazyku Go. Uchováva kľúč pre každú organizáciu v úložisku kľúčov OpenBao a každú noc ich rotuje. Jej nočné úlohy tiež ničia kľúče, ktorým uplynul dátum uchovávania, a exportujú potvrdenia na vlastný zväzok. Vymazaním kľúča organizácie sa údaje pod ním uzamknuté stanú natrvalo nečitateľnými. Pri prvom zavádzaní (bootstrap) tiež vytvorí identitu inštalácie pod keys.installationName a tento názov je trvalý. Vyberajte ho starostlivo: chart odmietne prázdny názov (INSTALLATION_NAME_MISSING) a odmietne aj názov zo svojich vlastných príkladových hodnôt (INSTALLATION_NAME_EXAMPLE).

Táto inštalácia (Community)
Táto inštalácia (Community)
Vlastná stránka inštalácie Community zobrazuje jej verziu a stav enginu. Jasne uvádza, že nie je potrebná žiadna licencia. Časti stránky určené pre edíciu Enterprise sú vykreslené ako ukážky.

Traja verejní hostitelia

Chart publikuje presne tri názvy hostiteľov, ktoré spolu tvoria identitu inštalácie. Každá služba sa bez nich odmietne spustiť.

Ingress Hodnota hostiteľa Backend
nexus-console hosts.console nexus-alpha, port 3000
nexus-api hosts.api nexus-gateway, port 9092
nexus-auth hosts.auth nexus-auth, port 9101

Príklady v tejto knihe používajú console.harrow.example, api.harrow.example a auth.harrow.example. Objekty Ingress sú obyčajné objekty networking.k8s.io/v1, z ktorých každý má jedno pravidlo a cestu /. TLS na okraji siete sa riadi hodnotou tls.mode: existing (objekt Secret, ktorý ste vytvorili, pomenovaný v tls.existingSecret), cert-manager (ClusterIssuer, ktorý prevádzkujete, pomenovaný v tls.clusterIssuer) alebo none (TLS končí pred klastrom). Chart nepridáva žiadne vlastné presmerovanie, takže výzva HTTP protokolu ACME (Automated Certificate Management Environment) dorazí k vášmu riešiteľovi (solver) nezmenená. Kapitola 2.11, Variácie: externé úložiská, TLS a ingress, sa venuje každému režimu.

Nič iné nie je vystavené navonok. Dátové úložiská, OpenBao a každá interná služba načúvajú iba vo vnútri menného priestoru.

Tri vodorovné pásy. Horný pás je „Edge“ s tromi poľami Ingress označenými console, api a auth, z ktorých každé smeruje nadol na svoju službu Service (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). Stredný pás je „Platform services“: pole pre nexus-alpha-bff; nexus-orchestrator vedľa nexus-workflows, zoskupené a označené UNO; potom nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; a dve prerušované polia pre voliteľné nexus-plugins a nexus-fileprocess. Spodný pás je „Data tier“ s jedným poľom pre každé úložisko (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS) a samostatným ohraničeným poľom označeným „Key store“, ktoré obsahuje openbao a openbao-unsealer, dostupné iba pre nexus-keys.
Komponenty inštalácie Nexus a úložiská pod nimi.

Požiadavka, od začiatku do konca

Tu je to, čo sa stane, keď Aoife Brennan, vedúca IT v spoločnosti Harrow, otvorí konzolu a opýta sa asistenta na rozvrh kotvísk na tento mesiac.

  1. Jej prehliadač načíta https://console.harrow.example. Ingress nexus-console to odošle do nexus-alpha na porte 3000.
  2. Prihlási sa pomocou svojho prístupového kľúča (passkey). Prihlasovacie stránky komunikujú s nexus-auth cez auth.harrow.example a služba nexus-auth jej vydá prístupový token nesúci jej používateľa, jej organizáciu a, ak ju jej relácia má, aj jej organizačnú jednotku.
  3. Server konzoly zavolá BFF, ktorý skontroluje jej token a opýta sa služby nexus-auth, či jej organizácia disponuje daným produktom a či je jej rola povolená. Odpovie skupinami ponuky, ktoré môže vidieť.
  4. Jej otázka putuje z BFF na odosielaciu trasu orchestrátora spolu s jej organizáciou a používateľom prevzatými z overeného tokenu. Orchestrátor odpovie kódom 202 a vloží úlohu do frontu v úložisku Valkey.
  5. Pracovný proces workflows prevezme úlohu. Zručnosť, ktorú spúšťa, vyhodnotí engine zručností a vyhľadávanie v dokumentoch spoločnosti Harrow smeruje do služby GraphRAG, ktorá číta Neo4j, Qdrant a svoju schému v PostgreSQL.
  6. Volanie modelu smeruje do smerovača AI Provider Router na /internal/ai/chat. Smerovač vyberie poskytovateľa a model z vlastného fondu kľúčov a politiky smerovania spoločnosti Harrow, vykoná volanie pomocou kľúča spoločnosti Harrow a vráti odpoveď (completion).
  7. Výsledok sa zapíše do riadka behu danej úlohy. BFF ho prečíta a konzola vykreslí odpoveď aj s jej citáciami.

Skoky medzi službami nesú projektované tokeny služieb, pričom volania do služieb nexus-auth, nexus-keys a Probitas prebiehajú cez TLS z vlastnej certifikačnej autority inštalácie a každý prístup k údajom v krokoch 4 až 6 je v samotnej databáze ohraničený na organizáciu Harrow. Nasledujúce časti vysvetľujú oboje.

Sekvencia zľava doprava. Pole prehliadača odosiela „1 page“ do Ingress console, potom do nexus-alpha. Bočná šípka „2 sign-in“ vedie z prehliadača cez Ingress auth do nexus-auth. nexus-alpha odosiela „3 menu“ do nexus-alpha-bff, ktorý vykoná overenie v nexus-auth. nexus-alpha-bff odosiela „4 dispatch, 202“ do nexus-orchestrator, ktorý zapisuje do ikony frontu Valkey. nexus-workflows si stiahne „5 job“ z frontu a volá nexus-skills-engine a nexus-graphrag (jeho tri úložiská sú nakreslené pod GraphRAG). nexus-workflows odosiela „6 chat“ do nexus-gateway, označeného „AI Provider Router: organisation key pool“, z ktorého vedie jedna šípka mimo hranice klastra k „model provider“. Bodkovaná spätná šípka „7 result on run row“ sa vracia späť do nexus-alpha-bff.
Jedna otázka pre asistenta, z prehliadača k poskytovateľovi modelu a späť.

Dátová vrstva

Nexus dodáva vlastnú podpísanú kópiu každého úložiska spolu s ponukou zdrojového kódu pre každé z nich v balíku. Každé bolo vybrané rovnako pre svoju licenciu, ako aj pre svoju funkciu.

Úložisko Verzia Licencia Prečo tam je Port Predvolený zväzok
PostgreSQL s PostGIS a pgvector PostgreSQL 16, PostGIS 3, pgvector 0.8 Licencia PostgreSQL; PostGIS GPL-2.0-or-later Systém záznamov pre každú službu; PostGIS pre mapové údaje; pgvector pre vektory uchovávané vedľa riadkov 5432 50 GiB
Valkey 8.1 BSD-3-Clause Fronty úloh UNO a krátkodobé vyrovnávacie pamäte, ako napríklad vyrovnávacia pamäť kľúčov API služby nexus-auth 6379 5 GiB
Neo4j Community Edition 5.26 GPL-3.0 Znalostný graf, ktorý GraphRAG vytvára a prechádza 7687 (Bolt) 20 GiB
Qdrant 1.15 Apache-2.0 Vektorové vyhľadávanie pre GraphRAG a engine zručností 6333 (HTTP), 6334 (vzdialené volania procedúr gRPC) 10 GiB
SeaweedFS 4.48 Apache-2.0 Objektové úložisko pre súbory, kompatibilné so službou Amazon Simple Storage Service (S3) 8333 50 GiB
OpenBao 2.6 MPL-2.0 Úložisko kľúčov a jeho odpečaťovač pre službu nexus-keys 8200 5 GiB a 1 GiB

Niektoré voľby nahradili niečo známejšie. Valkey zastupuje Redis 7.4, ktorého súčasné licencie toto vydanie odmieta. MinIO má licenciu AGPL-3.0, takže objektovým úložiskom je SeaweedFS. GraphRAG sa pripája k Neo4j Community Edition cez Bolt, čo je sieťový protokol, a služby sa pripájajú k PostGIS cez protokol PostgreSQL, takže licencia GPL zostáva pri každom z nich. OpenBao je odnož (fork) nástroja Vault od organizácie Linux Foundation z obdobia pred zmenou licencie Vaultu.

Každé úložisko beží so zapnutým overovaním a vygenerovanými prihlasovacími údajmi: heslo pre Valkey, kľúč API pre Qdrant, prístupové kľúče pre SeaweedFS.

Každé z piatich úložísk pod dataTier beží v klastri (mode: in-cluster, predvolené) alebo ide o úložisko, ktoré už prevádzkujete (mode: external, s external.host a objektom Secret pomenovaným pomocou external.existingSecret). Pre externý PostgreSQL nastavte sslmode na verify-full alebo verify-ca a vložte certifikát certifikačnej autority (CA) servera do daného objektu Secret; podrobnosti nájdete v kapitole 2.11, Variácie: externé úložiská, TLS a ingress.

# 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-postgres

Dvojica OpenBao je výnimkou: vždy beží vo vnútri inštalácie, pretože úloha úschovy (custody Job) ju inicializuje práve tam.

Identita medzi službami

Nexus beží bez technológie service mesh. Vzájomné TLS pochádza z lokálnej certifikačnej autority (CA), ktorú chart vytvára prostredníctvom nástroja cert-manager, ktorý musí byť nainštalovaný ako prvý (otestovaná je verzia v1.21.3).

Samopodpísaný Issuer vytvorí jeden certifikát CA, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, platný desať rokov. Druhý Issuer podpisuje touto CA. Každá pracovná záťaž, ktorá volá server TLS vo vnútri inštalácie, dostane svoj vlastný klientsky certifikát s názvom <service-account>-client-tls, platný 90 dní a obnovovaný 15 dní pred vypršaním platnosti. Jeho jediným názvom je jednotný identifikátor zdroja (URI) vo forme identity SPIFFE:

spiffe://cluster.local/ns/<namespace>/sa/<service-account>

Každá pracovná záťaž nájde verejný certifikát CA ako ca.crt vo svojom vlastnom objekte Secret pre certifikát. Žiadny pod nepripája kľúč CA a nepotrebujete ani trust-manager.

Tri služby overujú volajúcich pomocou certifikátu. Služba nexus-auth to robí na svojom druhom načúvacom procese, na porte 8443, a každý volajúci vo vnútri klastra volá práve ten. Služba nexus-keys to robí na svojom jedinom načúvacom procese. Probitas poskytuje TLS zo svojho vlastného certifikátu nexus-probitas-tls, ktorý znova načíta, keď ho cert-manager obnoví. Žiadna z nich nedôveruje hlavičke X-Forwarded-Client-Cert.

Každá pracovná záťaž tiež dostane jednohodinové tokeny Kubernetes na /var/run/secrets/nexus, jeden pre každú službu, ktorú volá, s danou službou ako publikom (audience). Objekt ConfigMap nexus-service-identities mapuje každý <namespace>/<service-account> na názov služby alebo zásuvného modulu a pracovná záťaž, ktorá v ňom chýba, nemá žiadnu identitu a je odmietnutá. Orchestrátor a Probitas kontrolujú tieto tokeny pomocou rozhrania Kubernetes API. Z bežiacich služieb iba tieto dve disponujú oprávnením system:auth-delegator alebo majú pripojený token API; jedinou ďalšou pracovnou záťažou s tokenom je úloha úschovy (custody Job), ktorá sa spúšťa pri inštalácii.

Sieťová politika uzatvára to, čo neuzatvára identita. Chart začína predvoleným odmietnutím (default deny), potom povoľuje prevádzku medzi vlastnými podmi inštalácie, službou DNS (Domain Name System), menným priestorom kontroléra Ingress (networkPolicy.ingressNamespace, predvolene kube-system) k trom verejným objektom Service a k serveru API pre dvoch kontrolórov tokenov. Pody OpenBao nesú iné označenie (label) ako zvyšok platformy, takže otvorené pravidlo v rámci menného priestoru sa na ne nevzťahuje: prejdú len služba nexus-keys, jej úlohy Job a úloha úschovy (custody Job), a to na porte 8200. Všetko ostatné, kam sa pracovná záťaž musí dostať mimo menného priestoru, ako napríklad váš poštový prenosový server (mail relay), patrí do networkPolicy.externalEgressCIDRs, čo je predvolene prázdne.

Migrácie a kniha schém

Migrácie bežia ako háky (hooks) nástroja Helm pri udalostiach post-install a pre-upgrade. Hák po inštalácii (post-install hook) sa spúšťa až po vytvorení objektov Deployment daného vydania. Pri prvej inštalácii sa teda služby spustia, zatiaľ čo ich schémy ešte neexistujú, a upadli by do slučky zlyhaní (crash-loop) voči databáze bez roly, bez hesla a bez tabuliek. Nexus tomu predchádza pomocou účtovnej knihy (ledger).

Háky sa spúšťajú v poradí podľa váhy (weight) a Helm čaká na každú úlohu Job predtým, než sa spustí ďalšia váha:

Váha Hák Čo robí
-30 nexus-migrations-env a predpoklady Vytvorí objekt Secret určený len pre háky s prihlasovacími údajmi migrátora a všetko, čo číta úloha úschovy (custody Job)
-20 nexus-db-bootstrap Vytvorí databázy nexus a nexus_alpha, rolu migrátora, behové (runtime) roly každej služby, rozšírenia a účtovnú knihu (ledger)
-15 nexus-openbao-custody-init Inicializuje úložisko kľúčov a odpečaťovač a vytvorí identitu inštalácie
-12 nexus-graphrag-migrations Schéma služby GraphRAG, ktorá vlastní objekty, na ktoré odkazuje základná línia služby nexus-auth
-10 nexus-auth-migrations Schéma identity
-5 Migrácie pre orchestrátor, bránu a Probitas Ich schémy; Probitas najprv skontroluje, či existujú tabuľky overovania
0 nexus-alpha-bff-migrations Vlastná databáza konzoly

Každá migračná úloha Job má backoffLimit: 0, takže neúspešná migrácia spôsobí zlyhanie inštalácie.

Účtovná kniha (ledger) je jedna tabuľka, nexus_release.schema_applied, s jedným riadkom pre každý reťazec a súhrn obrazu (image digest). Každý hák zapíše svoj riadok až po tom, čo sa vráti jeho spúšťač migrácií. Každý Deployment, ktorý používa PostgreSQL, obsahuje inicializačný kontajner wait-for-schema, ktorý číta túto tabuľku pod rolou, ktorá nemá povolené čítať nič iné (nexus_ledger_reader), a čaká, kým každý reťazec, od ktorého závisí, neobsahuje riadok pre obraz tohto vydania. Až potom sa služba spustí. Pracovný proces workflows čaká na reťazec orchestrátora, keďže zdieľa túto databázu, a engine zručností čaká iba na zavedenie (bootstrap).

Dopytuje sa každé 3 sekundy (schemaWait.intervalSeconds) a vzdá to po 1 800 sekundách (schemaWait.timeoutSeconds) s riadkom uvádzajúcim reťazce, ktoré stále chýbajú. Vlastný kontajner služby sa nikdy nespustí voči nesprávnej schéme.

kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schema

To je dôvod, prečo nikdy nesmiete spustiť helm install --wait. S prepínačom --wait Helm čaká na objekty Deployment predtým, než spustí háky po inštalácii, a objekty Deployment zase čakajú na háky. Ani jedno sa nepohne. Inštalujte bez neho a počkajte až potom; kapitola 2.6, Inštalácia edície Community v prostredí Kubernetes, uvádza presný príkaz.

Izolácia na troch osiach

Každé čítanie, zápis, volanie nástroja a odoslanie zručnosti v systéme Nexus má vymedzený rozsah (scope) na troch osiach.

Os Pole Čo oddeľuje
Nájomca (Tenant) organization_id Jednu organizáciu od druhej, pevná hranica
Vlastník owner_user_id Veci jednej osoby od vecí všetkých ostatných, dokonca aj v rámci jednej organizácie
Jednotka business_unit_id Pododdelenie organizácie, voliteľné

Os vlastníka ľudí prekvapuje. Poštová schránka alebo osobný zápisník sú súkromné pre svojho vlastníka dokonca aj pred kolegami v rovnakej jednotke s rovnakou rolou. Správca nastavuje politiku a nečíta obsah.

Osi pochádzajú z overenej požiadavky a odnikiaľ inak. Žiadna premenná prostredia, hlavička, parameter dopytu ani segment cesty ich nemôže nastaviť. Telo požiadavky, ktoré uvádza organizáciu, je odmietnuté s TENANT_NOT_A_PARAMETER. Rozhranie, ktoré nedokáže určiť, ktorému nájomcovi, vlastníkovi a jednotke riadok patrí, ho odmietne s kódom 403 SCOPE_PREDICATE_MISSING a telo vypíše, ktoré osi sa podarilo vyhodnotiť a ktoré nie. Nikdy sa neuchýli k širšiemu čítaniu.

To platí na dvoch miestach súčasne.

V databáze. Každá služba sa pripája pod svojimi vlastnými behovými (runtime) rolami: nexus_auth, auth_app a auth_platform pre službu identity, nexus_probitas a nexus_probitas_ledger pre Probitas a nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app a zvyšok pre ostatné. Žiadna z nich nie je superpoužívateľ (superuser) ani nemá oprávnenie BYPASSRLS. Žiadna tiež nevlastní tabuľky, ktoré používa, takže sa na ňu vzťahuje každá politika zabezpečenia na úrovni riadkov (RLS). Roly zdieľajú skupinu nexus_runtime, ktorá udeľuje právo na pripojenie a používanie schémy, ale vôbec žiadne práva na tabuľky; každej službe sú práva na jej vlastné tabuľky udelené jej vlastnými migráciami. Nastavenia nájomcu, ktoré čítajú politiky RLS, je možné nastaviť iba prostredníctvom funkcie bind_scope každej služby, ktorá beží pod svojím vlastníkom. Zavádzací proces (bootstrap) odoberie oprávnenie na set_config všetkým ostatným a orchestrátor a Probitas sa odmietnu spustiť, ak by ju ich behová rola mohla zavolať priamo (Probitas to označuje ako DB_ROLE_SETS_SCOPE_DIRECTLY). Jediné pripojenia superpoužívateľa v celej inštalácii patria zavádzacej úlohe (bootstrap Job) a kroku zriaďovania (provisioning) v BFF.

V zdieľanom primitíve dopytov s vymedzeným rozsahom. Každý repozitár v platforme a každý zásuvný modul postavený na SDK (súprave na vývoj softvéru) dedí jedno ohraničenie, ktoré zostavuje predikát SQL z vyhodnoteného rozsahu. Jeho funkcia rozsahu prijíma overenú identitu a nemá žiadny parameter organizácie, takže volajúci ho nemôže odovzdať a žiadna trasa sa z toho nemôže vyňať.

Existuje presne jeden prechod cez hranicu nájomcu a ten je úzky: zaznamenané udelenie prístupu (grant). Dve osoby v organizácii, ktorá vlastní riadky, zaznamenajú, ktorá organizácia môže čítať ktoré tabuľky a dokedy. Každé čítanie prebieha v transakcii určenej len na čítanie a zaznamenáva sa u oboch nájomcov. Vlastníci a správcovia nikdy nečítajú naprieč organizáciami a čitateľ nemôže udelený prístup rozšíriť.

Cesta AI

Volajúci vyjadrujú želania. AI Provider Router vlastní prihlasovacie údaje a robí konečné rozhodnutie.

Každé volanie modelu v systéme Nexus prechádza cez trasy /internal/ai/* smerovača a smerovač pripúšťa iba vymenovaných volajúcich. Chart nastavuje na bráne tri zoznamy:

Trasy Kto môže volať
Chat a streamovanie chatu nexus-orchestrator, nexus-workflows, nexus-skills-engine
Vektorové reprezentácie (embeddings) a preusporiadanie (rerank) nexus-graphrag, nexus-skills-engine, nexus-workflows
Všetko ostatné vrátane vykonávania nástrojov nexus-orchestrator, nexus-workflows

Volanie bez identity volajúceho je odmietnuté s kódom 403 MISSING_CALLER_IDENTITY a volajúci, ktorý nie je na zozname, s kódom 403 UNAUTHORIZED_CALLER. Zásuvné moduly nie sú na žiadnom zozname a je to zámerné: volania modelov zásuvného modulu sa dejú v jeho mene prostredníctvom odosielania UNO.

To, čo môže volajúci odoslať, je želanie: preferovaný poskytovateľ a model plus profil schopností, ako je minimálna dĺžka kontextu alebo používanie nástrojov. Smerovač vyhovie želaniu iba vtedy, keď má organizácia daného poskytovateľa povoleného a má pre neho prihlasovacie údaje; v opačnom prípade ho nahradí, najprv v rámci toho istého poskytovateľa, potom naprieč ostatnými poskytovateľmi organizácie. Profil schopností iba filtruje a požiadavka na umiestnenie údajov (data-residency) v ňom je striktná. Keď nič nevyhovuje, neexistuje žiadny záložný model: volajúci dostane kód 422 MODEL_CAPABILITY_UNAVAILABLE alebo 422 NO_PROVIDER_FOR_ROLE s reťazcom nápravy, ktorý konzola zobrazí správcovi.

Kľúče patria organizácii. Správcovia každej organizácie vkladajú svoje vlastné kľúče poskytovateľov do jej fondu z konzoly a smerovač ich vyhodnocuje v čase volania. Žiadny kľúč modelu nie je hodnotou v charte a žiadny sa nedodáva so systémom Nexus. Organizácia bez kľúča nedostane žiadne odpovede AI a konzola to jasne oznámi; nič túto medzeru nevypĺňa odinakiaľ.

Smerovač formujú dve hodnoty chartu. ai.localProvider.baseUrl určuje vami prevádzkovaný modelový server kompatibilný s OpenAI, smerovaný ako každý iný poskytovateľ. ai.installationHosts uvádza vaše modelové servery na súkromných názvoch, ktoré smerovač počíta ako vnútro inštalácie. GraphRAG vytvára vloženia (embeddings) tiež cez smerovač, v mene organizácie, ktorej obsah patrí. Predvolený model vložení beží v klastri bez grafickej karty; hostované vloženia sú voľbou každej organizácie.

Žiadna telemetria

Nič neopustí inštaláciu, pokiaľ to neodošlete. Hodnota telemetry.enabled v charte môže byť iba false; schéma odmietne čokoľvek iné. Vlastné hlásenia dátovej vrstvy sú tiež vypnuté: hlásenie o používaní Neo4j a telemetria Qdrant sú v charte deaktivované.

Keď je zapnuté networkPolicy.enabled, čo je predvolené nastavenie, žiadny pod sa nedostane na internet, pokiaľ cieľ neuvediete v networkPolicy.externalEgressCIDRs. Hostovaný poskytovateľ modelov je jedným z takýchto cieľov a rovnako aj váš poštový relé server.

To isté pravidlo zmenilo jedno predvolené nastavenie, ktoré si všimnete. CAPTCHA služby nexus-auth pre registrácie potrebuje internetovú službu, takže v inštalácii je vypnutá a registrácia cudzej osoby čaká na schválenie správcom (403 SIGNUP_REQUIRES_APPROVAL). Filter, ktorý blokuje registrácie z hostingových sietí, je tiež vypnutý, pretože potrebuje licencované databázy, ktoré Nexus nedodáva. O túto kontrolu prídete.

Stav inštalácie
Stav inštalácie
Vo verzii Enterprise stránka stavu zobrazuje klaster pod systémom Nexus: ako je každá časť vyťažená a koľko kapacity zostáva, pričom pri každom varovaní je uvedené, čo s tým robiť.