Přihlásit seDomluvit prezentaci

Kapitola 2.1

Architektura

Co vlastní každá služba v chartu Nexus a jaká úložiště se pod ní nacházejí, a dále pravidla, která je drží pohromadě, od identity mezi službami až po cestu, kterou prochází každé volání modelu.

Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

19 min čtení

Když Tomás Reilly dokončil první instalaci v Harrow Port Authority, kubectl -n nexus get pods ukázal deset objektů Deployment a sedm objektů StatefulSet, plus tři objekty CronJob. Migrační objekty Job, které vytvořily databázi, už zmizely, protože každý z nich po úspěšném dokončení smaže sám sebe. Tento výpis představuje celou platformu. Naučte se ho, protože většina otázek při běžném provozu začíná slovy „který z nich tohle vlastní?“

Tato kapitola na to odpovídá pro každou část, sleduje jimi jeden požadavek a poté probírá pravidla, kterými se všechny řídí. Zbytek části 2 na tento obraz navazuje.

Služby a co každá z nich vlastní

Balíček je jeden Helm chart, nexus, verze 1.0.0-alpha.1, pro Kubernetes 1.33 nebo novější. Každá úloha běží pod svým vlastním účtem ServiceAccount, jako uživatel bez oprávnění root a se všemi odebranými linuxovými oprávněními (capabilities). Volání do služeb, které chrání identitu a klíče, probíhají přes oboustranné TLS (Transport Layer Security) a veřejné API (aplikační programové rozhraní) sdílí proces se směrovačem AI (umělé inteligence).

Komponenta Deployment a Service Port služby Co vlastní
Konzole nexus-alpha 3000 Stránky, které lidé vidí; poskytuje HTML (Hypertext Markup Language) na hostiteli konzole
BFF (backend pro frontend) nexus-alpha-bff 8080 Vlastní data konzole, nabídku, kterou každý uživatel dostane, registr vydání
Auth nexus-auth 9101 (oboustranné TLS na 8443) Lidé, organizace, relace, tokeny, klíče API, fond klíčů modelů organizace
Brána nexus-gateway 9092, WebSocket 8093 Směrovač poskytovatelů AI (AI Provider Router) a hrana veřejného API pro REST (representational state transfer) a MCP (Model Context Protocol)
Orchestrátor nexus-orchestrator 8080 Odbavení v UNO: přijetí každé úlohy a její zařazení do fronty
Workflow nexus-workflows 8081 Provádění v UNO: proces worker, který spouští úlohy z fronty
GraphRAG nexus-graphrag 8090, WebSocket 8091 Paměť: znalostní graf a vyhledávání nad ním
Probitas nexus-probitas 9151 (HTTPS) Důkazy: záznamy o řízení (governance) a zapečetěná účetní kniha (ledger)
Engine dovedností nexus-skills-engine 8095 Knihovna dovedností; vyhledávání a spouštění dovedností
Klíče nexus-keys 8080 (HTTPS, oboustranné TLS) Klíče pro jednotlivé organizace v OpenBao, úschova klíčů (custody), identita instalace
Pluginy nexus-plugins 9111 Registr pluginů a katalogové záznamy; ve výchozím nastavení vypnuto
Zpracování souborů nexus-fileprocess 9109 Čtení nahraných dokumentů a obrázků; ve výchozím nastavení vypnuto

Prvních deset je povinných. Poslední dvě jsou volitelné a zapínají se pomocí components.plugins.enabled a components.fileprocess.enabled, pokud je využívá instalace Enterprise nebo doménový balíček. Další volitelná služba, nexus-alive na portu 8080, má svůj vlastní přepínač components.alive.enabled a ve výchozím nastavení je rovněž vypnutá. Repliky a prostředky pro každou z nich jsou umístěny pod components.<name>.

Konzole představuje stránky vykreslované na serveru bez databáze. Komunikuje s BFF a se službou nexus-auth uvnitř clusteru, nikdy ne směrem ven přes veřejného hostitele auth a zase dovnitř. Odmítne naběhnout bez uvedení své edice, kterou chart předává jako NEXUS_EDITION z jediné hodnoty edition. Každý člen organizace v ní pracuje podle své role. Stránky správy jsou určeny pro vlastníky a administrátory a člen, který některou z nich otevře, dostane stránku „Nejste administrátor“.

BFF je serverová polovina konzole a je postavena jako plugin platformy, zaregistrovaný jako produkt Nexus Alpha. Udržuje vlastní tabulky konzole v oddělené databázi nexus_alpha a rozhoduje o tom, které skupiny nabídek daný člověk uvidí. Když konzole potřebuje vykonat nějakou práci, BFF požádá službu, která danou agendu vlastní.

nexus-auth je napsána v jazyce Go a je jedinou službou, která vydává tokeny. Přístupové tokeny platí ve výchozím nastavení 15 minut a obnovovací tokeny 12 hodin (auth.accessTokenTTL, auth.refreshTokenTTL). Omezuje každého přihlášeného uživatele na 5 000 požadavků za minutu, než odpoví kódem 429 (auth.rateLimitPerMinute). Provozuje dva naslouchající procesy (listenery): prostý na portu kontejneru 8080, na který přistupuje veřejný Ingress, a druhý s oboustranným TLS na portu 8443, který musí používat každý volající uvnitř clusteru. Hlavičce X-Forwarded-For důvěřuje pouze ze směrovacích skoků (hopů) uvedených v proxy.trustedCIDRs, což je seznam rozsahů CIDR (Classless Inter-Domain Routing), jehož výchozí hodnotou je 10.42.0.0/16, síť podů k3s. Pokud váš kontroler Ingress běží jinde, změňte to. Jinak bude každé přihlášení vypadat, jako by přišlo z tohoto kontroleru.

Brána má dvě úlohy, které sdílejí jeden proces. Uvnitř clusteru je to směrovač poskytovatelů AI (AI Provider Router – přepojovna AI v části 1 a na stránkách konzole), jediný držitel přístupových údajů k modelům organizace (více o tom níže). Na hraně sítě je to místo, kam míří api.<domain>: klienti REST a klienti MCP, jejichž tokeny nesou cílovou skupinu (audience) https://<hosts.api>/mcp a pocházejí z autorizačního serveru OAuth 2.1 na hostiteli auth (OAuth je otevřený standard pro delegovanou autorizaci).

Orchestrátor a workflow tvoří dohromady UNO, engine pro zpracování workflow. Veškeré výpočty běží přes ně. Orchestrátor přijme úlohu na POST /api/v1/dispatch, odpoví kódem 202 s jobId, runId a traceId a zařadí ji do fronty. Neexistuje žádná cesta pro přímé (inline) vykonání: klient se vždy dotazuje na GET /api/v1/dispatch/{jobId} nebo přijme zpětné volání (callback). Proces worker pro workflow si bere úlohy z fronty, ve výchozím nastavení čtyři najednou na každou repliku (workflows.concurrency), a má přesně jednu cestu HTTP, GET /health.

Probitas je služba pro správu důkazů. Sama obsluhuje TLS z certifikátu, který vydává chart, a své tabulky uchovává ve schématu trust s oddělenou rolí pro účetní knihu (ledger). Její funkce pro řízení (governance) se přepínají pomocí probitas.flags. Několik z nich je dodáváno v režimu shadow: verdikt se vypočítá a zaznamená, ale nic se neblokuje, dokud tento příznak nezměníte.

nexus-keys je služba platformy pro správu klíčů, napsaná v jazyce Go. Pro každou organizaci uchovává klíč v úložišti klíčů OpenBao a každou noc klíče rotuje. Její noční úlohy také ničí klíče, u nichž nastalo datum ukončení úschovy, a exportují příslušné potvrzenky do vlastního svazku. Smazáním klíče organizace se data jím uzamčená stanou trvale nečitelnými. Při prvotním zavedení (bootstrapu) také vytváří identitu instalace pod keys.installationName a tento název je trvalý. Zvolte jej pečlivě: chart odmítne prázdný název (INSTALLATION_NAME_MISSING) a odmítne i název uvedený ve svých vlastních ukázkových hodnotách (INSTALLATION_NAME_EXAMPLE).

Tato instalace (Community)
Tato instalace (Community)
Vlastní stránka instalace Community zobrazuje její verzi a stav enginu. Jasně uvádí, že není potřeba žádná licence. Části stránky určené pro edici Enterprise jsou vykresleny jako upoutávky.

Tři veřejní hostitelé

Chart publikuje přesně tři názvy hostitelů, které dohromady tvoří identitu instalace. Bez nich každá služba odmítne naběhnout.

Ingress Hodnota hostitele 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

Příklady v této knize používají console.harrow.example, api.harrow.example a auth.harrow.example. Objekty Ingress jsou běžné objekty networking.k8s.io/v1, z nichž každý má jedno pravidlo s cestou /. TLS na hraně sítě se řídí hodnotou tls.mode: existing (objekt Secret, který jste vytvořili, pojmenovaný v tls.existingSecret), cert-manager (objekt ClusterIssuer, který provozujete, pojmenovaný v tls.clusterIssuer) nebo none (TLS končí před clusterem). Chart nepřidává žádné vlastní přesměrování, takže výzva HTTP protokolu ACME (Automated Certificate Management Environment) dorazí k vašemu řešiteli (solveru) beze změny. Kapitola 2.11, Varianty: externí úložiště, TLS a ingress, popisuje každý z těchto režimů.

Nic dalšího není vystaveno navenek. Datová úložiště, OpenBao a každá interní služba naslouchají pouze uvnitř jmenného prostoru.

Tři vodorovné pásy. Horní pás je „Edge“ se třemi poli Ingress označenými console, api a auth, z nichž každé směřuje dolů ke své službě Service (nexus-alpha :3000, nexus-gateway :9092, nexus-auth :9101). Prostřední pás je „Platform services“: pole pro nexus-alpha-bff; nexus-orchestrator vedle nexus-workflows, seskupené a označené UNO; dále nexus-graphrag, nexus-probitas, nexus-skills-engine, nexus-keys; a dvě čárkovaná pole pro volitelné nexus-plugins a nexus-fileprocess. Spodní pás je „Data tier“ s jedním polem pro každé úložiště (PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS) a samostatným ohraničeným polem označeným „Key store“, které obsahuje openbao a openbao-unsealer a ke kterému má přístup pouze nexus-keys.
Komponenty instalace Nexus a úložiště pod nimi.

Požadavek, od začátku do konce

Zde je popsáno, co se stane, když Aoife Brennan, vedoucí IT ve společnosti Harrow, otevře konzoli a položí asistentovi otázku ohledně rozpisu kotvišť na tento měsíc.

  1. Její prohlížeč načte https://console.harrow.example. Ingress nexus-console požadavek odešle na nexus-alpha na portu 3000.
  2. Přihlásí se pomocí svého přístupového klíče (passkey). Přihlašovací stránky komunikují s nexus-auth přes auth.harrow.example a služba nexus-auth jí vydá přístupový token nesoucí jejího uživatele, její organizaci a – pokud ji její relace má – také její obchodní jednotku.
  3. Server konzole zavolá BFF, který zkontroluje její token a zeptá se služby nexus-auth, zda její organizace drží daný produkt a zda je její role připuštěna. Odpoví skupinami nabídek, které smí vidět.
  4. Její otázka putuje z BFF na odbavovací cestu orchestrátoru, přičemž její organizace a uživatel jsou převzaty z ověřeného tokenu. Orchestrátor odpoví kódem 202 a vloží úlohu do fronty v úložišti Valkey.
  5. Proces worker pro workflow si úlohu převezme. Dovednost, kterou spouští, je vyhodnocena enginem dovedností a vyhledávání v dokumentech společnosti Harrow směřuje do služby GraphRAG, která čte z databází Neo4j, Qdrant a ze svého schématu v PostgreSQL.
  6. Volání modelu směřuje do směrovače poskytovatelů AI (AI Provider Router) na /internal/ai/chat. Směrovač vybere poskytovatele a model z vlastního fondu klíčů a směrovací politiky společnosti Harrow, provede volání s klíčem společnosti Harrow a vrátí vygenerovanou odpověď (completion).
  7. Výsledek se zapíše do řádku běhu dané úlohy. BFF jej přečte a konzole vykreslí odpověď včetně citací.

Skoky mezi jednotlivými službami přenášejí projektované servisní tokeny, volání do služeb nexus-auth, nexus-keys a Probitas probíhají přes TLS z vlastní certifikační autority instalace a každý přístup k datům v krocích 4 až 6 je v samotné databázi ohraničen na organizaci Harrow. Následující oddíly vysvětlují obojí.

Sekvence zleva doprava. Pole prohlížeče odesílá „1 page“ do Ingress console a poté do nexus-alpha. Boční šipka „2 sign-in“ vede z prohlížeče přes Ingress auth do nexus-auth. Služba nexus-alpha odesílá „3 menu“ do nexus-alpha-bff, která provede ověření u nexus-auth. Služba nexus-alpha-bff odesílá „4 dispatch, 202“ do nexus-orchestrator, který provede zápis do ikony fronty Valkey. Služba nexus-workflows si z fronty vyzvedne „5 job“ a zavolá nexus-skills-engine a nexus-graphrag (jehož tři úložiště jsou zakreslena pod GraphRAG). Služba nexus-workflows odesílá „6 chat“ do nexus-gateway, označené „AI Provider Router: organisation key pool“, ze které vede jediná šipka mimo hranici clusteru k „model provider“. Tečkovaná zpětná šipka „7 result on run row“ se vrací do nexus-alpha-bff.
Jedna otázka pro asistenta, od prohlížeče k poskytovateli modelu a zpět.

Datová vrstva

Nexus dodává vlastní podepsanou kopii každého úložiště, přičemž nabídka zdrojového kódu pro každé z nich je součástí balíčku. Každé úložiště bylo vybráno stejnou měrou kvůli své licenci i kvůli své funkci.

Úložiště Verze Licence Proč tam je Přístav Výchozí svazek
PostgreSQL s PostGIS a pgvector PostgreSQL 16, PostGIS 3, pgvector 0.8 Licence PostgreSQL; PostGIS GPL-2.0-or-later Referenční systém záznamů (system of record) pro každou službu; PostGIS pro mapová data; pgvector pro vektory uchovávané vedle řádků 5432 50 GiB
Valkey 8.1 BSD-3-Clause Fronty úloh UNO a krátkodobé mezipaměti, jako je mezipaměť klíčů API služby nexus-auth 6379 5 GiB
Neo4j Community Edition 5.26 GPL-3.0 Znalostní graf, který GraphRAG vytváří a prochází 7687 (Bolt) 20 GiB
Qdrant 1.15 Apache-2.0 Vektorové vyhledávání pro GraphRAG a engine dovedností 6333 (HTTP), 6334 (vzdálená volání procedur gRPC) 10 GiB
SeaweedFS 4.48 Apache-2.0 Objektové úložiště pro soubory, kompatibilní s Amazon Simple Storage Service (S3) 8333 50 GiB
OpenBao 2.6 MPL-2.0 Úložiště klíčů a jeho odpečeťovač (unsealer) pro službu nexus-keys 8200 5 GiB a 1 GiB

Některé volby nahradily známější řešení. Valkey zastupuje Redis 7.4, jehož současné licence toto vydání odmítá. MinIO je pod licencí AGPL-3.0, takže objektovým úložištěm je SeaweedFS. GraphRAG přistupuje k Neo4j Community Edition přes síťový protokol Bolt a služby přistupují k PostGIS přes protokol PostgreSQL, takže licence GPL zůstává u každého z nich. OpenBao je odštěpení (fork) nástroje Vault pod záštitou Linux Foundation z doby před změnou licence Vaultu.

Každé úložiště běží se zapnutým ověřováním a vygenerovanými přístupovými údaji: heslem pro Valkey, klíčem API pro Qdrant a přístupovými klíči pro SeaweedFS.

Každé z pěti úložišť pod dataTier buď běží v clusteru (mode: in-cluster, výchozí nastavení), nebo jde o úložiště, které již sami provozujete (mode: external, s external.host a objektem Secret pojmenovaným pomocí external.existingSecret). U externího PostgreSQL nastavte sslmode na verify-full nebo verify-ca a vložte certifikát certifikační autority (CA) serveru do daného objektu Secret; podrobnosti uvádí kapitola 2.11, Varianty: externí úložiště, 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

Dvojice OpenBao je výjimkou: vždy běží uvnitř instalace, protože ji tam inicializuje úloha Job pro úschovu klíčů (custody).

Identita mezi službami

Nexus běží bez technologie service mesh. Oboustranné TLS pochází z lokální certifikační autority (CA), kterou chart vytváří prostřednictvím nástroje cert-manager; ten musí být nainstalován jako první (testována je verze v1.21.3).

Vydavatel (Issuer) s vlastním podpisem vytvoří jeden certifikát CA, nexus-local-ca, ECDSA (Elliptic Curve Digital Signature Algorithm) P-256, platný deset let. Druhý vydavatel (Issuer) podepisuje pomocí této CA. Každá úloha, která volá server TLS uvnitř instalace, dostane svůj vlastní klientský certifikát pojmenovaný <service-account>-client-tls, platný 90 dní a obnovovaný 15 dní před vypršením platnosti. Jeho jediným názvem je jednotný identifikátor zdroje (URI) ve formátu identity SPIFFE:

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

Každá úloha najde veřejný certifikát CA jako ca.crt ve svém vlastním objektu Secret s certifikátem. Žádný pod nepřipojuje klíč CA a nepotřebujete ani nástroj trust-manager.

Tři služby ověřují volající pomocí certifikátu. Služba nexus-auth to dělá na svém druhém naslouchajícím procesu (listeneru), na portu 8443, a každý volající uvnitř clusteru vytáčí právě ten. Služba nexus-keys to dělá na svém jediném naslouchajícím procesu. Služba Probitas poskytuje TLS ze svého vlastního certifikátu nexus-probitas-tls, který znovu načte, když jej cert-manager obnoví. Žádná z nich nedůvěřuje hlavičce X-Forwarded-Client-Cert.

Každá úloha také dostává jednohodinové tokeny Kubernetes na /var/run/secrets/nexus, jeden pro každou službu, kterou volá, s danou službou jako cílovou skupinou (audience). Objekt ConfigMap nexus-service-identities mapuje každý <namespace>/<service-account> na název služby nebo pluginu a úloha, která v něm chybí, nemá žádnou identitu a je odmítnuta. Orchestrátor a Probitas kontrolují tyto tokeny pomocí Kubernetes API. Z běžících služeb drží oprávnění system:auth-delegator nebo mají připojený token API pouze tyto dvě; jedinou další úlohou s tokenem je úloha Job pro úschovu klíčů (custody), která běží při instalaci.

Síťová politika uzavírá to, co neuzavře identita. Chart začíná výchozím zákazem (default deny) a poté povoluje provoz mezi vlastními pody instalace, službou DNS (Domain Name System), jmenným prostorem kontroleru Ingress (networkPolicy.ingressNamespace, ve výchozím nastavení kube-system) ke třem veřejným objektům Service a k serveru API pro dva kontrolory tokenů. Pody OpenBao nesou jiný štítek (label) než zbytek platformy, takže otevřené pravidlo uvnitř jmenného prostoru se na ně nevztahuje: projdou pouze služba nexus-keys, její úlohy Job a úloha Job pro úschovu klíčů (custody), a to na portu 8200. Cokoli dalšího, kam musí úloha dosáhnout mimo jmenný prostor, jako například váš poštovní přenašeč (mail relay), patří do networkPolicy.externalEgressCIDRs, což je ve výchozím nastavení prázdné.

Migrace a účetní kniha schémat

Migrace běží jako háky (hooks) nástroje Helm při událostech post-install a pre-upgrade. Hák post-install běží až poté, co byly vytvořeny objekty Deployment daného vydání. Při první instalaci se tedy služby spouštějí v době, kdy jejich schémata ještě neexistují, a padaly by v nekonečné smyčce (crash-loop) proti databázi bez role, bez hesla a bez tabulek. Nexus tomu předchází pomocí účetní knihy (ledgeru).

Háky běží v pořadí podle váhy a Helm čeká na každou úlohu Job, než začne další váha:

Váha Hák Co dělá
-30 nexus-migrations-env a předpoklady Vytvoří objekt Secret určený pouze pro háky s přístupovými údaji migrátoru a vše, co čte úloha Job pro úschovu klíčů (custody)
-20 nexus-db-bootstrap Vytvoří databáze nexus a nexus_alpha, roli migrátoru, běhovou roli každé služby, rozšíření a účetní knihu (ledger)
-15 nexus-openbao-custody-init Inicializuje úložiště klíčů a odpečeťovač (unsealer) a vytvoří identitu instalace
-12 nexus-graphrag-migrations Schéma služby GraphRAG, které vlastní objekty, na něž odkazuje základní schéma služby nexus-auth
-10 nexus-auth-migrations Schéma identity
-5 Migrace orchestrátoru, brány a služby Probitas Jejich schémata; Probitas nejprve zkontroluje, zda existují tabulky auth
0 nexus-alpha-bff-migrations Vlastní databáze konzole

Každá migrační úloha Job má nastaveno backoffLimit: 0, takže neúspěšná migrace způsobí selhání celé instalace.

Účetní kniha (ledger) je jedna tabulka, nexus_release.schema_applied, s jedním řádkem pro každý řetězec a otisk obrazu (image digest). Každý hák zapíše svůj řádek až poté, co se jeho spouštěč migrace vrátí. Každý Deployment, který používá PostgreSQL, si nese inicializační kontejner wait-for-schema, jenž tuto tabulku čte pod rolí, která nesmí číst nic jiného (nexus_ledger_reader), a čeká, dokud každý řetězec, na němž závisí, nevykáže řádek pro obraz tohoto vydání. Poté se služba spustí. Proces worker pro workflow čeká na řetězec orchestrátoru, protože sdílí tuto databázi, a engine dovedností čeká pouze na zaváděcí proces (bootstrap).

Dotazuje se každé 3 sekundy (schemaWait.intervalSeconds) a po 1 800 sekundách (schemaWait.timeoutSeconds) to vzdá s řádkem jmenujícím řetězce, které stále chybí. Vlastní kontejner služby se nikdy nespustí proti nesprávnému schématu.

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

To je důvod, proč nikdy nesmíte spustit helm install --wait. S parametrem --wait čeká Helm na objekty Deployment, než spustí háky post-install, a objekty Deployment čekají na háky. Ani jedno se nepohne. Instalujte bez něj a počkejte až poté; kapitola 2.6, Instalace edice Community na Kubernetes, uvádí přesný příkaz.

Izolace na třech osách

Každé čtení, zápis, volání nástroje a odbavení dovednosti v systému Nexus je vymezeno na třech osách.

Osa Pole Co odděluje
Tenant organization_id Jednu organizaci od druhé, pevná hranice
Vlastník owner_user_id Věci jednoho člověka od věcí všech ostatních, a to i uvnitř jedné organizace
Jednotka business_unit_id Pododdělení organizace, volitelné

Osa vlastníka lidi překvapuje. Poštovní schránka nebo osobní zápisník jsou pro svého vlastníka soukromé i před kolegy ve stejné jednotce se stejnou rolí. Administrátor nastavuje politiku a nečte obsah.

Tyto osy pocházejí z ověřeného požadavku a odnikud jinud. Žádná proměnná prostředí, hlavička, parametr dotazu ani segment cesty je nemůže nastavit. Tělo požadavku, které jmenuje organizaci, je odmítnuto s kódem TENANT_NOT_A_PARAMETER. Rozhraní, které nedokáže uvést, kterému tenantovi, vlastníkovi a jednotce řádek patří, požadavek odmítne s kódem 403 SCOPE_PREDICATE_MISSING a v těle vypíše, které osy se podařilo vyhodnotit a které ne. Nikdy se neuchýlí k širšímu čtení.

To platí na dvou místech současně.

V databázi. Každá služba se připojuje pod svými vlastními běhovými rolemi: nexus_auth, auth_app a auth_platform pro službu identity, nexus_probitas a nexus_probitas_ledger pro Probitas a nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app a zbytek pro ostatní. Žádná z nich není superuživatel ani nemá oprávnění BYPASSRLS. Žádná také nevlastní tabulky, které používá, takže se na ni vztahuje každá politika zabezpečení na úrovni řádků (RLS – row-level security). Role sdílejí skupinu nexus_runtime, která uděluje právo na připojení a použití schématu, ale vůbec žádná práva k tabulkám; každé službě jsou její vlastní tabulky přiděleny jejími vlastními migracemi. Nastavení tenanta, která čtou politiky RLS, lze nastavit pouze prostřednictvím funkce bind_scope dané služby, která běží pod svým vlastníkem. Zaváděcí proces (bootstrap) odebere oprávnění k set_config všem ostatním a orchestrátor i Probitas se odmítnou spustit, pokud by ji jejich běhová role mohla zavolat přímo (Probitas to nazývá DB_ROLE_SETS_SCOPE_DIRECTLY). Jediná připojení superuživatele v celé instalaci patří zaváděcí úloze Job a kroku zřizování (provisioningu) v BFF.

Ve sdíleném primitivu pro vymezené dotazy. Každý repozitář v platformě a každý plugin postavený na SDK (sadě pro vývoj softwaru) dědí jedno ohraničení, které sestavuje predikát SQL z vyhodnoceného rozsahu (scope). Jeho funkce rozsahu přebírá ověřenou identitu a nemá žádný parametr organizace, takže volající tam žádný předat nemůže a žádná cesta se z toho nemůže vyvázat.

Existuje přesně jeden způsob překročení hranice tenanta a je úzce vymezený: zaznamenané udělení přístupu (grant). Dva lidé v organizaci, která drží řádky, zaznamenají, která organizace smí číst které tabulky a do kdy. Každé čtení běží v transakci pouze pro čtení a je protokolováno u obou tenantů. Vlastníci ani administrátoři nikdy nečtou napříč organizacemi a čtenář nemůže udělený přístup rozšířit.

Cesta AI

Volající vyjadřují přání. Směrovač poskytovatelů AI (AI Provider Router) vlastní přístupové údaje a činí konečnou volbu.

Každé volání modelu v systému Nexus prochází přes cesty /internal/ai/* směrovače a směrovač připouští pouze jmenované volající. Chart nastavuje na bráně tři seznamy:

Cesty Kdo smí volat
Chat a streamování chatu nexus-orchestrator, nexus-workflows, nexus-skills-engine
Vektorové reprezentace (embeddings) a přeřazení (rerank) nexus-graphrag, nexus-skills-engine, nexus-workflows
Vše ostatní, včetně spouštění nástrojů nexus-orchestrator, nexus-workflows

Volání bez identity volajícího je odmítnuto s kódem 403 MISSING_CALLER_IDENTITY a volající, který není na seznamu, s kódem 403 UNAUTHORIZED_CALLER. Pluginy nejsou na žádném seznamu a je to záměr: volání modelů z pluginu probíhají jeho jménem prostřednictvím odbavení v UNO.

To, co volající může poslat, je přání: preferovaný poskytovatel a model, plus profil schopností, jako je minimální délka kontextu nebo použití nástrojů. Směrovač vyhoví přání pouze tehdy, když má organizace daného poskytovatele povoleného a vybaveného přístupovými údaji; v opačném případě provede náhradu, nejprve v rámci stejného poskytovatele a poté napříč ostatními poskytovateli organizace. Profil schopností pouze filtruje a požadavek na umístění dat (data residency) v něm uvedený je nekompromisní. Když nic nevyhovuje, neexistuje žádný záložní model: volající dostane kód 422 MODEL_CAPABILITY_UNAVAILABLE nebo 422 NO_PROVIDER_FOR_ROLE s textem pro nápravu, který konzole zobrazí administrátorovi.

Klíče patří organizaci. Administrátoři každé organizace vkládají své vlastní klíče poskytovatelů do jejího fondu z konzole a směrovač je vyhodnocuje v okamžiku volání. Žádný klíč modelu není hodnotou v chartu a žádný se s platformou Nexus nedodává. Organizace bez klíče nedostane žádné odpovědi AI a konzole to jasně oznámí; nic tuto mezeru nevyplní odjinud.

Podobu routeru určují dvě hodnoty chartu. ai.localProvider.baseUrl určuje vámi provozovaný modelový server kompatibilní s OpenAI, který je směrován jako kterýkoli jiný poskytovatel. ai.installationHosts uvádí seznam vašich modelových serverů na privátních názvech, které router považuje za součást instalace. GraphRAG vytváří embeddingy rovněž prostřednictvím routeru, a to pod identitou organizace, jíž daný obsah patří. Výchozí model pro embedding běží v clusteru bez grafické karty; hostované embeddingy jsou volbou každé organizace.

Žádná telemetrie

Z instalace nic neodchází, pokud to sami neodešlete. Hodnota telemetry.enabled v chartu může být pouze false; schéma cokoliv jiného odmítne. Vlastní hlášení datové vrstvy je rovněž vypnuto: hlášení o využití v Neo4j a telemetrie v Qdrant jsou v chartu zakázány.

Když je zapnuto networkPolicy.enabled (výchozí stav), žádný pod se nedostane do internetu, pokud cíl neuvedete v networkPolicy.externalEgressCIDRs. Jedním takovým cílem je poskytovatel hostovaných modelů a dalším váš poštovní relay.

Totéž pravidlo změnilo jedno výchozí nastavení, čehož si povšimnete. CAPTCHA služby nexus-auth pro registrace vyžaduje internetovou službu, takže v instalaci je vypnutá a registrace neznámého uživatele čeká na schválení administrátorem (403 SIGNUP_REQUIRES_APPROVAL). Filtr, který blokuje registrace z hostingových sítí, je také vypnutý, protože vyžaduje licencované databáze, které Nexus nedodává. O tuto kontrolu přicházíte.

Jak si instalace vede
Jak si instalace vede
V edici Enterprise zobrazuje stránka stavu cluster pod systémem Nexus: jak je každá část vytížená a kolik kapacity zbývá, přičemž u každého varování je uvedeno, jak na něj reagovat.