Logg innBestill en gjennomgang

Kapittel 2.2

Utgaver under panseret

Hvordan Community og Enterprise bygges fra ett produkt, hvordan en lisens slår på funksjonsgrupper under kjøring, hva en Community-installasjon viser for en Enterprise-side, og hva det betyr for avbildningene du henter og utvidelsene du bygger.

Denne siden er oversatt med KI fra den engelske originalen. Hvis noe er uklart, er den engelske siden referansen. Les denne siden på engelsk

17 minutter å lese

To linjer i en verdifil avgjør hvilken utgave en installasjon kjører:

# harrow-values.yaml (Helm values): the edition of this installation
edition: enterprise
enterprise:
  enabled: true

De må stemme overens. Sett edition: community med enterprise.enabled: true, så stopper chartet med «edition=community but enterprise.enabled=true: they must agree». Sett edition til noe annet enn community eller enterprise, så stopper det med NEXUS_EDITION_INVALID. Disse to verdiene velger hvilke avbildninger installasjonen tar i bruk. Hva disse avbildningene deretter slår på, er lisensens sak, ved kjøretid, én funksjonsgruppe om gangen.

Dette kapittelet tar det fra hverandre: hva utgavene inneholder, hvordan ett produkt blir til to bygg, hvordan en lisens blir til et ja eller et nei inne i en kjørende tjeneste, og hva det betyr når du bygger noe eget. Kapittel 1.6, Utgaver og lisenser i klartekst, gir kjøperens perspektiv; dette er ingeniørens.

Utgavematrisen

Alt i dette kapittelet stammer fra én fil: utgavematrisen. Den lister opp 97 kapabiliteter og gir hver av dem et nivå. Adverant genererer lisenskatalogen og konsollens menyregler ut fra den, sammen med grensen mellom åpen og lukket kode. Når matrisen endres, endres alle disse i takt.

Det finnes tre utgaver.

Utgave Lisens Hvor den kjører
Community Apache-2.0, åpen kildekode, gratis Din maskinvare, eller Adverant-skyen
Team Adverant Enterprise-lisens Adverant-skyen: Community pluss Team-settet
Enterprise Adverant Enterprise-lisens, per funksjonsgruppe Din maskinvare, eller Adverant-skyen

En installasjon kjører én av to: chartets edition-verdi godtar kun community og enterprise. Team er en skyutgave, og Enterprise inneholder også Team-settet, så på din egen maskinvare følger Team-kapabilitetene (arbeidspanelet som er dokket ved siden av hver oppføring, delte notatbøker, minnepolicy for organisasjonen og resten) med Enterprise.

Selve Enterprise er lagdelt. Enterprise-basen er den lukkede kjernen: flere organisasjoner og forretningsenheter, håndheving av enkeltpålogging (SSO) med SAML (Security Assertion Markup Language) og katalogsynkronisering, egendefinerte roller med fire-øyne-godkjenning, lang oppbevaring av revisjonslogger, databeskyttelse, operatørsidene og klyngeadministrasjon. Oppå basen ligger tillegg, som hvert er lisensiert separat, og domenepakker. Det første tillegget i tabellen, KI-gateway i stor skala, fordeler belastningen til KI-ruteren (kunstig intelligens) på tvers av replikaer og leverandører.

Tillegg Krever også
KI-gateway i stor skala Basis
Modellfabrikk Basis
Ideer Basis
Samtaler og tale Basis
E-post Basis
Andre foretak og vegger Basis
Notatbokstudio Basis
Kart og GeoAI Basis
Datatilkoblinger Basis
Agent-til-agent Basis
Beslutningsrom og forseglede poster Basis
Inntektsoperasjoner Basis
Butikkfront / hvitmerking Basis
Nexus Edge Basis
Mobilapper Basis
Arbeidsstyrke Base; agenter på kantenheter krever også Nexus Edge, godkjenninger på telefon krever også Mobilapper
Shield Basis
Sandkasser Basis
Kvalitet (NexusQA) Basis

Det finnes ti domenepakker:

  • Forsikring
  • Bank og betalinger
  • Kapitalmarkeder og kapitalforvaltning
  • Forvaltning og offentlig sektor
  • Helsevesen
  • Livsvitenskap
  • Kritisk infrastruktur og energi
  • Forsvar og sikkerhet
  • Juridiske og profesjonelle tjenester
  • Logistikk og maritim sektor

Hver pakke krever Enterprise-basen, og fem av dem krever også et tillegg. Forsikringspakken krever Beslutningsrom og forseglede oppføringer. Det samme gjør pakken for Kapitalmarkeder og kapitalforvaltning. Pakken for Juridiske og profesjonelle tjenester krever disse to pluss E-post. Logistikk og maritim krever Kart og GeoAI. I Forsvars- og sikkerhetspakken krever plattformvarsler også Nexus Edge. Telefonskjermbilder i enhver pakke krever også Mobilapper. Kapittel 1.7, Domenepakker og vertikaler, forklarer hva hver enkelt inneholder.

Funksjonsgrupper

Enheten en lisens navngir, er funksjonsgruppen. Det finnes 32: Community-grunnflaten, Team-settet, Enterprise-basen, én per tillegg og én per pakke. Hver kapabilitet tilhører nøyaktig én, så en lisens som lister opp «Enterprise-base, Kart og GeoAI, Logistikk og maritim» angir presist hvilke kapabiliteter denne installasjonen kan kjøre.

Nivå Kapabiliteter
Community 36
Team 6
Enterprise-base 18
Tillegg 23
Domenepakker 14

Tildelingsomfang

Hver lisensierte kapabilitet har et tildelingsomfang, som angir hva en tildeling knyttes til.

  • Leietakeromfang dekker delene folk arbeider i: Ideer, E-post, Inntektsoperasjoner, pakkene. Lisensen gjør dem tilgjengelige for installasjonen, og deretter slås de på eller av per organisasjon og per forretningsenhet. En ny organisasjon arver aldri en tilstand der alt er slått på.
  • Distribusjonsomfang dekker de fem tingene som tilhører installasjonen som helhet: lisensimport med artefaktene den henter, leveringsformene for Enterprise, operatørsidene, klyngeadministrasjon og Nexus Edge.

Community-kapabiliteter har ikke noe tildelingsomfang i det hele tatt. De krever ingen lisens.

En administrator kan snevre inn det lisensen tillater, for en organisasjon eller en enhet. Ingen kan utvide det fra innsiden av installasjonen.

En vertikal stabel med seks bånd. Fra bunnen: «Grunnflate (hver utgave, aldri bak betalingsmur)»; «Community, Apache-2.0»; en tykk dobbeltlinje merket «@adverant/nexus-spi, det eneste delte grensesnittet»; «Enterprise-base, lukkede moduler»; «Tillegg (19), hvert lisensiert separat»; «Domenepakker (10)». Til høyre, en boks «Signert lisensdokument» med en pil inn i de tre øverste båndene merket «kontrollert inne i hver lukkede modul». Til venstre for Community-båndet, et notat «Community-avbildninger: kun åpen kildekode».
Utgavene som lag, med lisensdokumentet som eneste autoritet.

Ett produkt, to bygg

Det finnes én Nexus-kodebase. Community-bygget er eksporten med åpen kildekode, og Enterprise-bygget er denne eksporten pluss lukkede moduler.

En grenseliste tilordner hver sporet fil til en utgave. Som oftest gjør den det ved å navngi kapabiliteten en fil implementerer, og filens utgave følger av nivået til den kapabiliteten: en Community-kapabilitet gir en Community-fil, og alt som er Team, base, tillegg eller pakke gir en Enterprise-fil. Filer som ikke leveres i noen av utgavene, er oppført med en begrunnelse. Én regel går på tvers av resten: databasemigreringene til hver modul leveres i begge utgaver. Dermed har en Community-database og en Enterprise-database samme skjema, og det å flytte en installasjon fra den ene til den andre er en endring i hva som er slått på, uten data som må migreres.

Community-eksporten inneholder Apache-2.0-deklarasjoner og en NOTICE-fil, og hver pakke i den er lisensiert under Apache-2.0, bortsett fra tredjepartskode som beholder sin egen lisens (MIT, BSD og andre) og kopieres slik den var, samt noen få SDK- (software development kit) og CLI-pakker (command-line interface) som beholder sin egen MIT-lisens. Enterprise-bygget er lisensiert under Adverant Enterprise-lisensen. Vilkårene tillater bruk kun under en skriftlig lisens, for perioden, distribusjonene og funksjonsgruppene som lisensen navngir. Forbudet mot omvendt utvikling (reverse engineering) ivaretar uttrykkelig rettighetene EU-lovgivningen gir deg til å studere programvare og dekompilere den for interoperabilitet.

Lisensgrensen

Enterprise-kode når Community gjennom kun én pakke: @adverant/nexus-spi, tjenesteleverandørgrensesnittet (SPI – service provider interface). Den er lisensiert under Apache-2.0 og inneholder grensesnitt og typevakter (type guards), uten egen kjøretidslogikk.

Eksport Hva det er
RouteModule En lisensiert rutemodul: dens ID, dens funksjonsgruppe, meldingskroppene den leser, og register(app, ctx)
SpiApp Delen av vertens HTTP-app som en modul berører: use
SpiContext Det verten gir en modul: produktporten og omfangsvakten, lisensleseren, spørringspoolen med avgrenset omfang, oppstrømsadresser, plattformklienter
SpiRuntime Verdiene fra programtilleggs-SDK-et (software development kit) som verten gir en modul
SpiPlane Skjermgruppene og skjermlesningene et lisensiert plan legger til
ScreenModule En konsolls lisensierte skjermgruppe: dens ruter, skjermbilder og meny
GrantCheck Kontrollen en lisensiert modul kjører på sin egen funksjonsgruppe

En kontroll i bygget håndhever grensen. Inne i Enterprise-koden vil en import fra Community-pakkeomfangene (@adverant/ og @adverant-nexus/) gjøre at bygget feiler, med mindre det er @adverant/nexus-spi eller en Enterprise-pakke. Det samme gjelder en relativ import som går ut av kodelageret, en file:-, link:- eller workspace:-avhengighet som peker ut av det, en Git-URL som navngir et Community-kodelager, og en Go replace som peker ut av det. På tvers av grensen skjer kobling via en nettverksprotokoll eller en modul som lastes ved oppstart, aldri gjennom delt kildekode. SPI-et har til og med sin egen låste kopi av typedeklarasjonene til programtilleggs-SDK-et, fordi SDK-et er en Community-pakke som grensen ikke slipper gjennom; verten gir i stedet modulen SDK-ets kjøretidsverdier.

Byggeprofiler

Konsollen og BFF-en (backend for frontend) kompileres med en byggeprofil, som fastsetter hvilke klasser av kode som finnes inne i avbildningen. Community-profilen inneholder Community-kode; Enterprise-profilen inneholder Community- og Enterprise-kode. Begge nekter å starte når profilen inneholder kode som installasjonens utgave ikke har. BFF-en melder fra om dette med PROFILE_OUTSIDE_EDITION og navngir avbildningen som skal distribueres i stedet. Du kan ikke legge en Enterprise-konsoll på en Community-installasjon ved å endre taggen på en avbildning.

Til venstre, én boks «Nexus-kildekode» med en mindre boks inni, «utgavematrise». En pil merket «grenseliste» deler seg i to. Den øverste pilen går til «Community-eksport (Apache-2.0)» og videre til «Community-avbildninger». Den nederste pilen går til «Enterprise-bygg», som også mottar en pil fra Community-eksporten og en fra en boks «lukkede moduler», og produserer «Enterprise-avbildninger». Mellom de lukkede modulene og Community-eksporten er det et gjerde merket «lisensgrense: kun @adverant/nexus-spi». Et lite notat under begge avbildningsboksene lyder «samme databaseskjema».
Hvordan ett kildetre blir til to utgaver.

Hvordan en lisens slår på funksjonsgrupper

En lisens er et signert dokument. Adverant signerer hver lisens med to uavhengige nøkler, og ingenting annet på installasjonen avgjør hva som er lisensiert. Du importerer den gjennom konsollens Lisens-sider, med nexusctl licence import <file>, eller ved å sende dokumentet til https://<hosts.auth>/api/v1/installation/licence. En lisens er aldri en chart-verdi og aldri en montert fil. Kapittel 2.13, Lisenser, dekker import og fornyelse, samt hver tilstand en lisens går gjennom.

Kontrollen som betyr noe, kjører inne i hver lukkede modul, på modulens egen funksjonsgruppe, før den svarer. Det er GrantCheck-kontrakten fra SPI-et:

type GrantCheck = (featureGroup: string) => Promise<{ entitled: boolean; code?: "LICENCE_LOCKED" }>;

Kontrollen ligger i den lukkede modulen fordi en kontroll skrevet i åpen kildekode enkelt kunne blitt slettet. En forfalsket lisens teller som ingen lisens. En modul hvis funksjonsgruppe ikke er nevnt i lisensen, svarer med LICENCE_LOCKED.

Selve modulene kontrolleres også. nexus-keys holder utgivelsens signerte delmanifest og nøkkelen som signerte det. Den kontrollerer hver kompilerte modul mot dette manifestet ved oppstart og igjen hver natt kl. 03:53 UTC. En modul hvis signatur ikke stemmer, lastes aldri inn, og den signerte kopien den skulle ha erstattet, fortsetter å kjøre; operatørsidene viser dette med MODULE_SIGNATURE_INVALID.

Kompilerte deler
Kompilerte deler
Siden for kompilerte deler lister opp hver lisensierte modul med funksjonsgruppe, versjon og signaturkontroll. En endret kopi som ikke bestod kontrollen, vises som en avvisningsplate, og den signerte kopien fortsatte å kjøre.

Over modulkontrollen ligger visningslaget, som avgjør hvordan en kapabilitet fremstår for hver enkelt person. Det kombinerer lisensens tildelinger med organisasjonens plan og personens rolle, og hver kontroll ender opp i én av fire tilstander.

Tilstand Hva personen ser
Berettiget Kontrollen, tegnet normalt
Smakebit Kontrollen nedtonet i grått med en hengelås; å åpne den forklarer hva den er og hvem som kan slå den på
Skjult Ingenting; brukes kun for ting denne personens rolle ikke skal vite at eksisterer, slik som en annen persons private postkasse
Avvist med en kode En avvisningsplate som navngir koden, når noen forsøker en handling som ikke er tillatt

Lisensen har også sine egne tilstander når den nærmer seg og passerer utløpsdatoen. To regler gjelder i hver eneste én: en lisens stopper aldri pågående arbeid, og sikkerhetsfikser holdes aldri tilbake.

Hva Community viser for en Enterprise-side

En Community-installasjon beholder produktets form. Menyen har de samme radene som Enterprise, og Enterprise-radene (Ideer, Beslutninger, E-post, Samtaler, Andre firmaer, Agenter, Policyer, Etterlevelse) er nedtonet i grått med et låseikon. Ingenting skjules for å få utgaven til å se komplett ut, og ingenting maser.

Å åpne en låst rad viser en smakebit. For Ideer står det «Ideer er en del av Enterprise», deretter ett avsnitt om hva Ideer gjør, og så «Hvem som kan slå det på: administratoren din, gjennom en lisens fra Adverant». Den tilbyr to knapper: «Spør administratoren din» og «Se hva den gjør». Det står ingen pris. Å åpne siden laster ingenting og sender ingenting, og promoteringen vises én gang.

Noe du ikke har
Noe du ikke har
Et låst område i Community navngir hvem som kan slå det på og hva Community allerede gir deg. Raden blir værende i menyen, nedtonet i grått med en lås, slik at produktet ser likt ut i begge utgaver.

Å skrive inn adressen til en side som kun finnes i Enterprise, fører også til et nyttig sted. Community-konsollen kjenner adressene til sidene den ikke inneholder, og sender enhver av dem til utgavesiden sin, inne i den vanlige rammen med menyen. Siden tegner platen for låst funksjonalitet:

LICENCE_LOCKED
This page is part of Nexus Enterprise. This installation runs Nexus Community,
so the page is not here and nothing was read.
- To use it, the installation needs Nexus Enterprise: an administrator can ask Adverant about it
- Every page this installation holds is in the menu

Koden er der som referanse; setningene er for personen som leser det.

Grunnflaten

Noen ting ligger aldri bak betalingsmur, i noen utgave, under noen lisenstilstand: grunnleggende administrasjon og sikkerhet, leietakerseparasjon, dataeksport, utlogging og hvert eneste avvisningsskjermbilde. En Community-installasjon har dem alle. En Enterprise-installasjon der lisensen har utløpt, beholder dem også: Enterprise-artefaktene slutter å bli tilbudt, mens Community-grunnflaten og dataeksporten består. Du kan alltid få ut dataene dine.

Fra Community til Enterprise
Fra Community til Enterprise
Import av en lisens på en Community-installasjon viser hva som vil bli hentet, hva som endres og hva som beholdes, før noe skjer. På knappen står det «Hent og slå på», og ingenting hentes før den trykkes.

Avbildninger etter utgave

Hver avbildning i en utgivelse er oppført, med sjekksum (digest), i chartets avbildningslås, og selve låsen tilhører én utgave. Chartet kontrollerer hver avbildning det gjengir mot låsen og mot utgaven du ba om. En Community-installasjon tar kun Community-avbildninger. Ber du den om noe annet, stopper den: «a community install takes only community images». En Enterprise-lås inneholder Community-avbildningene pluss Enterprise-byggene.

Det har betydning for hvor du henter fra. Community-avbildninger er offentlige, på registry.adverant.ai/nexus/<service>@sha256:…. Enterprise-avbildninger kommer fra det samme registeret med et hentetoken (pull token), som du får fra siden «Pull tokens and install commands» på Adverant-kontoen din. En Community-installasjon trenger aldri dette tokenet, og inneholder aldri en eneste byte med lukket kode.

Oppgraderingsløpet bevarer installasjonen. Når en Community-administrator importerer en Enterprise-lisens, leser og verifiserer konsollen den, og viser deretter delene den vil hente (de kompilerte modulene samt pakkene og tilleggene lisensen navngir) med størrelsene deres. Hver del kontrolleres mot Adverants utgivelsesnøkkel, og gruppene slås på én om gangen. Personer og filer forblir som de er, og det samme gjelder arbeidsflyter og kanaler, fordi skjemaet allerede var det samme. Kapittel 2.7, Installere Enterprise og legge inn en lisens, gjennomgår dette på Kubernetes; nettverksisolerte (air-gapped) anlegg importerer de samme delene fra lagringsmedier, slik kapittel 2.10, Nettverksisolert installasjon, beskriver.

Leveranseformer og beskyttelsesklasser

Nexus leveres i seks leveringsformer, som matrisen kaller SKU-er (stock-keeping units). De fem andre enn Edge deler én signert pakke og skiller seg fra hverandre i pakking og i hvordan lisensen ankommer.

SKU Hva det er Hvordan lisensen ankommer
saas Adverant-skyen Utstedt med abonnementet
onprem-connected Helm inn på din egen Kubernetes Hentet av installasjonen over dens utgående forbindelse
airgap Den samme pakken, importert frakoblet Importert som en fil, med en signert brukserklæring én gang i året
self-serve-image En maskinavbildning i din egen skykonto Selve avbildningen inneholder kun Community- og evalueringslisenser; Enterprise-moduler ankommer så snart en lisens er utstedt, inkludert en som er kjøpt gjennom skyens markedsplass
appliance Maskinvare bygget av en original utstyrsprodusent (OEM), som er dens registrerte produsent En Enterprise-lisens; appliancen er én av dens leveringsformer
edge Nexus Edge, nyttelasten på satellitter og droner, eller på fartøyer og kjøretøyer Én lisens per plattform eller flåte, langvarig, gyldig i frakoblet tilstand

Beskyttelse er den andre halvdelen av leveransen, og det er verdt å være tydelig om det. Så snart kode kjører på maskinvare du kontrollerer, finnes det ingen teknikk som gjør den uleselig. Derfor sorterer Adverant koden sin i beskyttelsesklasser og avgjør, for hver leveringsform, hvor langt hver klasse kan reise. Det finnes fire nivåer:

Klasse Hva det betyr
P1, sendes aldri ut Logikken kjører hos Adverant; installasjonen har en signert klient.
P2, forseglet En konfidensiell virtuell maskin (VM) som du ikke kan logge inn på, på maskinvare du ikke kan røre.
P3, herdet maskinkode Kompilert, strippet og bygget per lisensinnehaver. Det øker kostnaden ved å lese koden fra timer til uker.
P4, lesbar Vanlig JavaScript eller TypeScript, slik åpen kildekode er.
Beskyttelsesklasse Adverant-skyen Tilkoblet lokalt (on-prem) Nettverksisolert (air-gap) Nexus Edge
Åpen kildekode (hele Community) P4 P4 P4 P4
Kode med høyest verdi: idépoengberegning, kjernen i lageret for forseglede oppføringer, motoren for rutingspolicy, de fire beslutningsmotorene i Forsikringspakken P1 P3, eller P2 som en Adverant-forseglet konfidensiell VM i din skyleietaker P3 Sendes ikke ut
Lukkede servermoduler som tar beslutninger: serverkode for pakker, mobilgatewayen P1 P3 P3 Sendes ikke ut
Serverkode for Forsvars- og sikkerhetspakken P1 P3 P3 P3
Nyttelastkode for Nexus Edge Sendes ikke ut Sendes ikke ut Sendes ikke ut P3
Lesbare klientdefinisjoner: telefonapper, telefonskjermbilder for pakker P4 P4 P4 P4

To konsekvenser følger av dette. Ingenting beskyttet sendes ut i en telefonapp: hver regel og hver instruks (prompt) blir værende på serveren. Og verdi som ligger i instrukser, vurderingsmatriser (rubrics) eller agentkjeder, kan leses av den som kjører modellen det sendes til. Der organisasjonen din eier modellen, er denne verdien beskyttet av lisenskontrakten og ingenting annet. Hver utsendte TypeScript-avbildning er pakket og minifisert uten kildekart (source maps), noe som handler mer om ryddighet enn beskyttelse.

Hva dette betyr når du bygger en utvidelse

Utvidelsen din ligger på samme linje som Adverants egne moduler. Nesten alt i dette kapittelet gjelder for den.

Isolasjon, identitet og KI-stien følger med plattformen i begge utgaver. Et programtillegg bygget med @adverant-nexus/plugin-sdk arver spørringsgjerdet med avgrenset omfang, tokenverifikatoren og UNO-utsendelsen, uansett hvilken utgave det havner på. Kapittel 2.19, Reglene enhver utvidelse arver, lister dem opp.

Utgavestyring fungerer på samme måte for deg. Et programtillegg deklarerer funksjons-ID-ene sine i manifestets entitlements-blokk (featureIdPattern, pluss en kort alwaysOn-liste som beholdes for helsesjekker og innstillingssiden) og ber plattformen om en avgjørelse før det betjener en styrt flate. Avgjørelsen er aldri en ren boolsk verdi. ENTITLEMENT_DENIED (403) betyr at plattformen svarte nei. ENTITLEMENT_UNREACHABLE (502) betyr at det ikke kom noe svar, og programtillegget ditt må avvise fremfor å anta, fordi et driftsavbrudd som tolkes som «ikke berettiget» i det stille nedgraderer alle kunder på én gang. Mellomlagre et ja kortvarig, og mellomlagre aldri en avvisning.

På Community får en utvikler de samme startmalene som på Enterprise, for programtillegg og linser så vel som ferdigheter og arbeidsflyter. Hver utvikler arbeider i et utviklingsområde med datagrener på den ene serveren, og koden ligger i GitHub. Maler for domenepakker og plattform er Enterprise. Det samme gjelder tidsbegrenset heving av tilgang fra et IDE (integrert utviklingsmiljø): på Community finnes det ikke noe separat produksjonsmiljø å heve tilgangen din inn i, og konsollen melder fra om dette med PASS_TIER_REQUIRED.

Bygge på Community
Bygge på Community
Å bygge på Community gir de samme malene som Enterprise på én server, med koden i GitHub. Siden navngir hva Enterprise legger til og avviser hevet tilgang med en enkel begrunnelse.

En utvidelse som kun bruker Community-skjøter, kjører uendret på begge utgaver. En som avhenger av et tillegg, for eksempel E-post, vises som låst overalt der lisensen ikke navngir den gruppen. Kapittel 2.25, Bygge for hver utgave, viser hvordan du strukturerer en utvidelse for begge, og hvordan du tester den mot hver av dem.