Verze 1.0.0-alpha.1nejnovější
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ě

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).
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.
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.
- Její prohlížeč načte
https://console.harrow.example. Ingressnexus-consolepožadavek odešle nanexus-alphana portu 3000. - Přihlásí se pomocí svého přístupového klíče (passkey). Přihlašovací stránky komunikují s
nexus-authpřesauth.harrow.examplea 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. - 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.
- 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.
- 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.
- 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). - 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í.
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-postgresDvojice 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-schemaTo 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.

