Verzia 1.0.0-alpha.1najnovšia
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

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).
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.
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.
- Jej prehliadač načíta
https://console.harrow.example. Ingressnexus-consoleto odošle donexus-alphana porte 3000. - Prihlási sa pomocou svojho prístupového kľúča (passkey). Prihlasovacie stránky komunikujú s
nexus-authcezauth.harrow.examplea 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. - 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ť.
- 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.
- 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.
- 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). - 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.
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-postgresDvojica 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-schemaTo 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.

