Kirjaudu sisäänVaraa esittely

Luku 2.2

Versiot konepellin alla

Miten Community ja Enterprise rakennetaan yhdestä tuotteesta, miten lisenssi kytkee ominaisuusryhmät päälle ajon aikana, mitä Community-asennus näyttää Enterprise-sivun kohdalla ja mitä tämä tarkoittaa noudettaville levykuville ja rakennettaville laajennuksille.

Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

17 minuutin lukuaika

Kaksi riviä arvotiedostossa ratkaisevat, mitä versiota asennus käyttää:

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

Niiden on oltava yhteneväiset. Jos määritätte arvon edition: community yhdessä arvon enterprise.enabled: true kanssa, kaavio pysähtyy virheeseen "edition=community but enterprise.enabled=true: they must agree". Jos määritätte arvon edition joksikin muuksi kuin community tai enterprise, se pysähtyy koodiin NEXUS_EDITION_INVALID. Nämä kaksi arvoa valitsevat, mitkä levykuvat asennus ottaa käyttöön. Se, mitä nämä levykuvat sitten kytkevät päälle, on lisenssin asia ajon aikana, ominaisuusryhmä kerrallaan.

Tässä luvussa puretaan tämä osiin: mitä versiot sisältävät, miten yhdestä tuotteesta tulee kaksi koontiversiota, miten lisenssi muuttuu kyllä- tai ei-päätökseksi käynnissä olevan palvelun sisällä, ja mitä se tarkoittaa, kun rakennatte jotain omaa. Luku 1.6, Versiot ja lisenssit selkokielellä, esittää ostajan näkökulman; tämä on insinöörin.

Versiomatriisi

Kaikki tässä luvussa esitetty on peräisin yhdestä tiedostosta, versiomatriisista. Se luettelee 97 kyvykkyyttä ja määrittää kullekin tason. Adverant luo siitä lisenssiluettelon ja konsolin valikkosäännöt sekä avoimen ja suljetun koodin välisen rajan. Kun matriisi muuttuu, ne kaikki muuttuvat yhdessä.

Versioita on kolme.

Versio Lisenssi Missä sitä ajetaan
Community Apache-2.0, avoin lähdekoodi, ilmainen Oma laitteistonne tai Adverant-pilvi
Team Adverant Enterprise -lisenssi Adverant-pilvi: Community sekä Team-kokonaisuus
Enterprise Adverant Enterprise -lisenssi, ominaisuusryhmittäin Oma laitteistonne tai Adverant-pilvi

Asennus käyttää jompaakumpaa kahdesta: kaavion edition-arvo hyväksyy vain arvot community ja enterprise. Team on pilviversio, ja Enterprise sisältää myös Team-kokonaisuuden, joten omalla laitteistollanne Team-kyvykkyydet (jokaisen tietueen viereen telakoitu työpaneeli, jaetut muistikirjat, organisaation muistikäytäntö ja muut) tulevat Enterprisen mukana.

Enterprise itsessään on kerroksellinen. Enterprise-perusosa on suljettu ydin: useita organisaatioita ja liiketoimintayksiköitä, kertakirjautumisen pakottaminen SAML:llä (Security Assertion Markup Language) ja hakemistosynkronoinnilla, mukautetut roolit kahden hyväksyjän periaatteella, pitkä auditointilokien säilytys, tietosuoja, operaattorisivut ja klusterinhallinta. Perusosan päällä ovat lisäosat, joista jokainen lisensoidaan erikseen, sekä toimialapaketit. Taulukon ensimmäinen lisäosa, skaalautuva AI Gateway, jakaa tekoälyreitittimen (AI, artificial intelligence) kuorman replikoiden ja palveluntarjoajien kesken.

Lisäosa Vaatii myös
Skaalautuva tekoäly yhdyskäytävä Perusosa
Mallitehdas Perusosa
Ideat Perusosa
Puhelut ja ääni Perusosa
Sähköposti Perusosa
Muut yritykset ja eettiset muurit Perusosa
Muistikirjastudio Perusosa
Kartta ja GeoAI Perusosa
Tietoliittimet Perusosa
Agentilta agentille Perusosa
Päätöshuoneet ja sinetöidyt asiakirjat Perusosa
Myyntitoiminnot Perusosa
Kauppapaikka / white-label Perusosa
Nexus Edge Perusosa
Mobiilisovellukset Perusosa
Työvoima Perusosa; reunalaitteiden agentit tarvitsevat myös Nexus Edgen, puhelimella tehtävät hyväksynnät tarvitsevat myös Mobiilisovellukset
Shield Perusosa
Hiekkalaatikot Perusosa
Laatu (NexusQA) Perusosa

Toimialapaketteja on kymmenen:

  • Vakuutusala
  • Pankkitoiminta ja maksuliikenne
  • Pääomamarkkinat ja varainhoito
  • Valtionhallinto ja julkinen sektori
  • Terveydenhuolto
  • Biotieteet
  • Kriittinen infrastruktuuri ja energia
  • Puolustus ja turvallisuus
  • Lakiasiain- ja asiantuntijapalvelut
  • Logistiikka ja merenkulku

Jokainen paketti vaatii Enterprise-perusosan, ja viisi niistä vaatii myös lisäosan. Vakuutus-paketti tarvitsee Päätöshuoneet ja sinetöidyt tietueet. Niin tarvitsee myös Pääomamarkkinat ja varainhoito -paketti. Lakiasiat ja asiantuntijapalvelut -paketti tarvitsee nämä kaksi sekä Sähköpostin. Logistiikka ja merenkulku tarvitsee Kartan ja GeoAI:n. Puolustus ja turvallisuus -paketissa alustahälytykset tarvitsevat myös Nexus Edgen. Minkä tahansa paketin puhelinnäkymät tarvitsevat myös Mobiilisovellukset. Luku 1.7, Toimialapaketit ja vertikaalit, kertoo, mitä kukin sisältää.

Ominaisuusryhmät

Yksikkö, jonka lisenssi nimeää, on ominaisuusryhmä. Niitä on 32: Community-perustaso, Team-kokonaisuus, Enterprise-perusosa, yksi kutakin lisäosaa ja yksi kutakin pakettia kohden. Jokainen kyvykkyys kuuluu täsmälleen yhteen ryhmään, joten lisenssi, jossa luetellaan "Enterprise-perusosa, Kartta ja GeoAI, Logistiikka ja merenkulku", määrittää tarkasti, mitä kyvykkyyksiä tämä asennus saa suorittaa.

Taso Kyvykkyydet
Community 36
Team 6
Enterprise-perusosa 18
Lisäosat 23
Toimialapaketit 14

Käyttöoikeuden laajuus

Jokaisella lisensoidulla kyvykkyydellä on käyttöoikeuden laajuus, joka määrittää, mihin käyttöoikeus kiinnittyy.

  • Ympäristölaajuus (tenant scope) kattaa osat, joissa ihmiset työskentelevät: Ideat, Sähköposti, Tulonhankinnan toiminnot ja paketit. Lisenssi tuo ne asennuksen saataville, ja ne kytketään sitten päälle tai pois päältä organisaatio- ja liiketoimintayksikkökohtaisesti. Uusi organisaatio ei koskaan peri tilaa, jossa kaikki on valmiiksi päällä.
  • Asennuslaajuus (deployment scope) kattaa viisi asiaa, jotka kuuluvat asennukselle kokonaisuutena: lisenssin tuonti ja sen noutamat artefaktit, Enterprise-toimitusmuodot, operaattorisivut, klusterinhallinta ja Nexus Edge.

Community-kyvykkyyksillä ei ole lainkaan käyttöoikeuden laajuutta. Ne eivät tarvitse lisenssiä.

Pääkäyttäjä voi kaventaa sitä, mitä lisenssi sallii organisaatiolle tai yksikölle. Kukaan ei voi laajentaa sitä asennuksen sisältä käsin.

Pystysuora pino, jossa on kuusi kaistaa. Alhaalta lukien: "Perustaso (jokainen versio, ei koskaan maksumuurin takana)"; "Community, Apache-2.0"; paksu kaksoisviiva, jossa lukee "@adverant/nexus-spi, ainoa jaettu rajapinta"; "Enterprise-perusosa, suljetut moduulit"; "Lisäosat (19), jokainen lisensoitu erikseen"; "Toimialapaketit (10)". Oikealla laatikko "Allekirjoitettu lisenssiasiakirja", josta lähtee nuoli kolmeen ylimpään kaistaan tekstillä "tarkistetaan jokaisen suljetun moduulin sisällä". Community-kaistan vasemmalla puolella huomautus "Community-levykuvat: vain avointa lähdekoodia".
Versiot kerroksina, joissa lisenssiasiakirja on ainoa auktoriteetti.

Yksi tuote, kaksi käännöstä

Nexus-koodikantoja on vain yksi. Community-koontiversio on sen avoimen lähdekoodin vienti, ja Enterprise-koontiversio on tuo sama vienti täydennettynä suljetuilla moduuleilla.

Rajaluettelo määrittää jokaisen seuratun tiedoston johonkin versioon. Useimmiten se tekee tämän nimeämällä kyvykkyyden, jonka tiedosto toteuttaa, ja tiedoston versio määräytyy kyseisen kyvykkyyden tason mukaan: Community-kyvykkyys tekee tiedostosta Community-tiedoston, ja mikä tahansa Team-, perusosa-, lisäosa- tai pakettikyvykkyys tekee siitä Enterprise-tiedoston. Tiedostot, joita ei toimiteta kummassakaan versiossa, on lueteltu syyn kera. Yksi sääntö ohittaa muut: jokaisen moduulin tietokantamigraatiot toimitetaan molemmissa versioissa. Näin ollen Community-tietokannalla ja Enterprise-tietokannalla on sama skeema, ja asennuksen siirtäminen versiosta toiseen on vain muutos siinä, mikä on kytketty päälle, ilman tarvetta migroida tietoja.

Community-vienti sisältää Apache-2.0-otsikkotiedot ja NOTICE-tiedoston, ja jokainen sen paketti on lisensoitu Apache-2.0-lisenssillä, lukuun ottamatta kolmannen osapuolen koodia, joka säilyttää oman lisenssinsä (MIT, BSD ja muut) ja kopioidaan sellaisenaan, sekä muutamia ohjelmistokehityspaketti- (SDK) ja komentorivikäyttöliittymäpaketteja (CLI), jotka säilyttävät oman MIT-lisenssinsä. Enterprise-koontiversio on lisensoitu Adverant Enterprise -lisenssillä. Sen ehdot sallivat käytön vain kirjallisella lisenssillä ja vain sen voimassaoloajan, niiden asennusten ja niiden ominaisuusryhmien puitteissa, jotka lisenssi nimeää. Takaisinmallinnuksen (reverse engineering) kielto säilyttää nimenomaisesti EU-lainsäädännön teille antamat oikeudet tutkia ohjelmistoa ja purkaa sen koodia yhteentoimivuuden varmistamiseksi.

Lisenssiraja

Enterprise-koodi on yhteydessä Communityyn vain yhden paketin kautta: @adverant/nexus-spi, joka on palveluntarjoajan rajapinta (SPI, service provider interface). Se on Apache-2.0-lisensoitu ja sisältää rajapintoja ja tyyppivartijoita (type guards), mutta ei lainkaan omaa ajonaikaista logiikkaa.

Vienti Mikä se on
RouteModule Lisensoitu reittimoduuli: sen tunniste, ominaisuusryhmä, sen lukemat rungot sekä register(app, ctx)
SpiApp Isäntäjärjestelmän HTTP-sovelluksen osa, johon moduuli koskee: use
SpiContext Mitä isäntäjärjestelmä antaa moduulille: tuoteportin ja laajuusvartijan, lisenssinlukijan, rajattujen kyselyiden varannon, ylävirran osoitteet, alusta-asiakkaat
SpiRuntime Lisäosien ohjelmistokehityspaketin (SDK, software development kit) arvot, jotka isäntäjärjestelmä antaa moduulille
SpiPlane Näkymäryhmät ja näkymäluvut, jotka lisensoitu taso lisää
ScreenModule Konsolin lisensoitu näkymäryhmä: sen reitit, näkymät ja valikko
GrantCheck Tarkistus, jonka lisensoitu moduuli suorittaa omalle ominaisuusryhmälleen

Koontivaiheen tarkistus valvoo rajaa. Enterprise-koodin sisällä tuonti Community-pakettien nimiavaruuksista (@adverant/ ja @adverant-nexus/) keskeyttää koonnin virheeseen, ellei kyseessä ole @adverant/nexus-spi tai Enterprise-paketti. Samoin tekee suhteellinen tuonti, joka nousee tietovaraston ulkopuolelle, file:-, link:- tai workspace:-riippuvuus, joka osoittaa sen ulkopuolelle, Community-tietovaraston nimeävä Git-URL-osoite sekä Gon replace, joka osoittaa sen ulkopuolelle. Rajan yli kytkentä tapahtuu aina verkkoprotokollan tai käynnistyksen yhteydessä ladattavan moduulin kautta, ei koskaan jaettuna lähdekoodina. SPI:llä on jopa oma kiinnitetty kopionsa lisäosa-SDK:n tyyppimäärittelyistä, koska SDK on Community-paketti, jota raja ei päästä läpi; isäntäjärjestelmä antaa sen sijaan moduulille SDK:n ajonaikaiset arvot.

Koontiprofiilit

Konsoli ja BFF (backend for frontend) käännetään koontiprofiililla, joka lukitsee levykuvan sisällä olevat koodiluokat. Community-profiili sisältää Community-koodia; Enterprise-profiili sisältää Community- ja Enterprise-koodia. Kumpikin kieltäytyy käynnistymästä, jos sen profiili sisältää koodia, jota asennuksen versiossa ei ole. BFF ilmoittaa tästä koodilla PROFILE_OUTSIDE_EDITION ja nimeää levykuvan, joka tulee ottaa käyttöön sen sijaan. Enterprise-konsolia ei voi asettaa Community-asennukseen nimeämällä levykuvan tunnisteen uudelleen.

Vasemmalla yksi laatikko "Nexus-lähdekoodi", jonka sisällä on pienempi laatikko "versiomatriisi". Nuoli, jossa lukee "rajaluettelo", haarautuu kahdeksi. Ylempi nuoli menee kohtaan "Community-vienti (Apache-2.0)" ja siitä eteenpäin kohtaan "Community-levykuvat". Alempi nuoli menee kohtaan "Enterprise-koontiversio", johon tulee nuoli myös Community-viennistä ja toinen laatikosta "suljetut moduulit", ja se tuottaa "Enterprise-levykuvat". Suljettujen moduulien ja Community-viennin välissä on aita, jossa lukee "lisenssiraja: vain @adverant/nexus-spi". Molempien levykuvalaatikoiden alla on pieni huomautus, jossa lukee "sama tietokantaskeema".
Miten yhdestä lähdekoodipuusta tulee kaksi versiota.

Miten lisenssi kytkee ominaisuusryhmät päälle

Lisenssi on allekirjoitettu asiakirja. Adverant allekirjoittaa jokaisen lisenssin kahdella toisistaan riippumattomalla avaimella, eikä mikään muu asennuksessa päätä, mikä on lisensoitua. Tuotte sen konsolin Lisenssit-sivujen kautta komennolla nexusctl licence import <file> tai lähettämällä asiakirjan osoitteeseen https://<hosts.auth>/api/v1/installation/licence. Lisenssi ei ole koskaan kaavioarvo eikä liitetty tiedosto. Luku 2.13, Lisenssit, käsittelee tuonnin ja uusimisen sekä jokaisen tilan, jonka läpi lisenssi kulkee.

Ratkaiseva tarkistus suoritetaan jokaisen suljetun moduulin sisällä, kyseisen moduulin omalle ominaisuusryhmälle, ennen kuin se vastaa. Tämä on SPI:n GrantCheck-sopimus:

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

Tarkistus sijaitsee suljetussa moduulissa, koska avoimeen lähdekoodiin kirjoitettu tarkistus voitaisiin yksinkertaisesti poistaa. Väärennetty lisenssi tulkitaan puuttuvaksi lisenssiksi. Moduuli, jonka ominaisuusryhmää lisenssi ei nimeä, vastaa koodilla LICENCE_LOCKED.

Myös itse moduulit tarkistetaan. nexus-keys säilyttää julkaisun allekirjoitettua osien luetteloa (manifestia) ja sen allekirjoittanutta avainta. Se tarkistaa jokaisen käännetyn moduulin tätä luetteloa vasten käynnistyksen yhteydessä ja uudelleen joka yö klo 03:53 UTC. Moduulia, jonka allekirjoitus ei täsmää, ei koskaan ladata, ja allekirjoitettu kopio, jonka se olisi korvannut, jatkaa toimintaansa; operaattorisivut näyttävät sen koodilla MODULE_SIGNATURE_INVALID.

Käännetyt osat
Käännetyt osat
Käännetyt osat -sivulla luetellaan jokainen lisensoitu moduuli sekä sen ominaisuusryhmä, versio ja allekirjoituksen tarkistus. Muutettu kopio, joka ei läpäissyt tarkistusta, näkyy hylkäyskilpenä, ja allekirjoitettu kopio jatkoi toimintaansa.

Moduulitarkistuksen yläpuolella on näyttökerros, joka päättää, miten kyvykkyys näkyy kullekin henkilölle. Se yhdistää lisenssin käyttöoikeudet organisaation tilaukseen ja henkilön rooliin, ja jokainen ohjauselementti päätyy yhteen neljästä tilasta.

Tila Mitä henkilö näkee
Oikeutettu Ohjauselementti piirrettynä normaalisti
Esittely Ohjauselementti harmaana lukkokuvakkeen kera; sen avaaminen selittää, mikä se on ja kuka voi kytkeä sen päälle
Piilotettu Ei mitään; käytetään vain asioihin, joiden olemassaolosta tämän henkilön rooli ei saa tietää, kuten toisen henkilön yksityiseen postilaatikkoon
Estetty koodilla Koodin nimeävä hylkäyskilpi, kun joku yrittää toimintoa, joka ei ole sallittu

Lisenssillä on myös omat tilansa, kun se lähestyy päättymispäiväänsä ja ohittaa sen. Kaksi sääntöä pätee jokaisessa tilassa: lisenssi ei koskaan pysäytä käynnissä olevaa työtä, eikä tietoturvakorjauksia koskaan pidätetä.

Mitä Community näyttää Enterprise-sivun kohdalla

Community-asennus säilyttää tuotteen muodon. Valikossa on samat rivit kuin Enterprisessa, ja Enterprise-rivit (Ideat, Päätökset, Sähköposti, Puhelut, Muut yritykset, Agentit, Käytännöt, Vaatimustenmukaisuus) piirretään harmaina lukkokuvakkeen kera. Mitään ei piiloteta, jotta versio näyttäisi täydelliseltä, eikä mikään häiritse muistutuksilla.

Lukitun rivin avaaminen näyttää esittelyn. Ideat-osion kohdalla siinä lukee "Ideat on osa Enterprisea", sitten yksi kappale siitä, mitä Ideat tekee, ja sen jälkeen "Kuka voi kytkeä sen päälle: pääkäyttäjänne, Adverantin lisenssillä". Se tarjoaa kaksi painiketta: "Kysy pääkäyttäjältä" ja "Katso mitä se tekee". Hintaa ei näytetä. Sivun avaaminen ei lataa eikä lähetä mitään, ja esittely näytetään kerran.

Ominaisuus, jota sinulla ei ole
Ominaisuus, jota sinulla ei ole
Lukittu alue Communityssa kertoo, kuka voi kytkeä sen päälle ja mitä Community jo tarjoaa teille. Rivi pysyy valikossa harmaana lukon kera, joten tuote näyttää samalta molemmissa versioissa.

Vain Enterpriseen kuuluvan sivun osoitteen kirjoittaminen vie sekin hyödylliseen paikkaan. Community-konsoli tuntee niiden sivujen osoitteet, joita se ei sisällä, ja ohjaa minkä tahansa niistä omalle versiosivulleen normaalin kehyksen ja valikon sisällä. Sivu piirtää lukitun ominaisuuden kilven:

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

Koodi on mukana viitteenä; lauseet ovat lukijaa varten.

Perustaso

Joitakin asioita ei koskaan aseteta maksumuurin taakse missään versiossa tai missään lisenssin tilassa: hallinnon ja tietoturvan perusteet, ympäristöjen (tenant) eriyttäminen, tietojen vienti, uloskirjautuminen ja jokainen hylkäysnäkymä. Community-asennuksessa on ne kaikki. Enterprise-asennus, jonka lisenssi on päättynyt, säilyttää ne myös: Enterprise-artefaktien tarjoaminen loppuu, mutta Community-perustaso ja tietojen vienti säilyvät. Voitte aina saada tietonne ulos.

Communitysta Enterpriseen
Communitysta Enterpriseen
Lisenssin tuominen Community-asennukseen näyttää ennen kuin mitään tapahtuu, mitä noudetaan, mikä muuttuu ja mikä säilytetään. Painikkeessa lukee "Nouda ja kytke päälle", eikä mitään noudeta ennen kuin sitä painetaan.

Levykuvat versioittain

Jokainen julkaisun levykuva on lueteltu tiivisteen (digest) mukaan kaavion levykuvalukossa, ja itse lukko kuuluu yhteen versioon. Kaavio tarkistaa jokaisen renderöimänsä levykuvan lukkoa ja pyytämäänne versiota vasten. Community-asennus ottaa vain Community-levykuvia. Jos pyydätte siltä jotain muuta, se pysähtyy: "a community install takes only community images". Enterprise-lukko sisältää Community-levykuvat sekä Enterprise-koontiversiot.

Tällä on merkitystä sen kannalta, mistä noudatte levykuvat. Community-levykuvat ovat julkisia osoitteessa registry.adverant.ai/nexus/<service>@sha256:…. Enterprise-levykuvat tulevat samasta rekisteristä noutotunnuksella (pull token), jonka saatte Adverant-tilinne "Noutotunnukset ja asennuskomennot" -sivulta. Community-asennus ei koskaan tarvitse tätä tunnusta, eikä se koskaan sisällä tavuakaan suljettua koodia.

Päivityspolku säilyttää asennuksen. Kun Community-pääkäyttäjä tuo Enterprise-lisenssin, konsoli lukee ja vahvistaa sen ja näyttää sitten noudettavat osat (käännetyt moduulit sekä lisenssin nimeämät paketit ja lisäosat) ja niiden koot. Jokainen osa tarkistetaan Adverantin julkaisuavainta vasten, ja ryhmät kytketään päälle yksi kerrallaan. Henkilöt ja tiedostot pysyvät ennallaan, samoin kuin työnkulut ja kanavat, koska skeema oli jo valmiiksi sama. Luku 2.7, Enterprisen asentaminen ja lisenssin käyttöönotto, käy tämän läpi Kubernetesissa; verkkoyhteydettömät (air-gapped) toimipaikat tuovat samat osat tallennusvälineeltä, kuten luvussa 2.10, Verkkoyhteydetön asennus, kuvataan.

Toimitusmuodot ja suojausluokat

Nexus toimitetaan kuudessa toimitusmuodossa, joita matriisi kutsuu nimellä SKU (stock-keeping unit, varastointiyksikkö). Viisi muuta kuin Edge jakavat yhden allekirjoitetun paketin ja eroavat toisistaan paketoinnin sekä lisenssin saapumistavan osalta.

SKU Mikä se on Miten lisenssi saapuu
saas Adverant-pilvi Myönnetään tilauksen yhteydessä
onprem-connected Helm omaan Kubernetesiinne Asennus noutaa sen ulosmenevän yhteytensä kautta
airgap Sama paketti, tuotuna ilman verkkoyhteyttä Tuodaan tiedostona, kerran vuodessa toimitettavan allekirjoitetun käyttöilmoituksen kera
self-serve-image Konelevykuva omalla pilvitilillänne Itse levykuva sisältää vain Community- ja arviointilisenssit; Enterprise-moduulit saapuvat, kun lisenssi on myönnetty, mukaan lukien pilven kauppapaikan kautta ostettu lisenssi
appliance Alkuperäisen laitevalmistajan (OEM, original equipment manufacturer) rakentama laitteisto, kun tämä toimii sen virallisena valmistajana Enterprise-lisenssi; laite on yksi sen toimitusmuodoista
edge Nexus Edge, hyötykuorma satelliiteissa ja drooneissa tai aluksissa ja ajoneuvoissa Yksi lisenssi alustaa tai kalustoa kohden, pitkäikäinen, voimassa ilman verkkoyhteyttä

Suojaus on toimituksen toinen puoli, ja siitä on syytä puhua suoraan. Kun koodia ajetaan hallitsemallanne laitteistolla, mikään tekniikka ei tee siitä lukukelvotonta. Niinpä Adverant lajittelee koodinsa suojausluokkiin ja päättää jokaisen toimitusmuodon osalta, kuinka pitkälle kukin luokka saa kulkea. Tasoja on neljä:

Luokka Mitä se tarkoittaa
P1, ei koskaan toimiteta Logiikka ajetaan Adverantilla; asennuksessa on allekirjoitettu asiakasohjelma.
P2, sinetöity Luottamuksellinen virtuaalikone (VM, virtual machine), johon ette voi kirjautua sisään, laitteistolla, johon ette pääse käsiksi.
P3, kovennettu natiivikoodi Käännetty, riisuttu (stripped) ja rakennettu lisenssinhaltijakohtaisesti. Se nostaa koodin lukemisen työmäärän tunneista viikkoihin.
P4, luettava Tavallinen JavaScript tai TypeScript, kuten avoin lähdekoodi on.
Suojausluokka Adverant-pilvi Verkkoon kytketty oma laitteisto (on-prem) Verkkoyhteydetön (air-gap) Nexus Edge
Avoin lähdekoodi (koko Community) P4 P4 P4 P4
Korkeimman arvon koodi: ideoiden pisteytys, sinetöityjen tietueiden varaston ydin, reitityskäytäntömoottori, Vakuutus-paketin neljä päätösmoottoria P1 P3, tai P2 Adverantin sinetöimänä luottamuksellisena virtuaalikoneena pilviympäristössänne P3 Ei toimiteta
Suljetut palvelinmoduulit, jotka tekevät päätöksiä: pakettien palvelinkoodi, mobiiliyhdyskäytävä P1 P3 P3 Ei toimiteta
Puolustus ja turvallisuus -paketin palvelinkoodi P1 P3 P3 P3
Nexus Edgen hyötykuormakoodi Ei toimiteta Ei toimiteta Ei toimiteta P3
Luettavat asiakasmäärittelyt: puhelinsovellukset, pakettien puhelinnäkymät P4 P4 P4 P4

Tästä seuraa kaksi asiaa. Puhelinsovelluksessa ei toimiteta mitään suojattua: jokainen sääntö ja kehote pysyy palvelimella. Lisäksi kehotteissa, arviointimatriiseissa tai agenttiketjuissa kulkeva arvo on sen luettavissa, joka ylläpitää mallia, johon se lähetetään. Jos organisaationne omistaa mallin, tätä arvoa suojaa lisenssisopimus eikä mikään muu. Jokainen toimitettu TypeScript-levykuva on paketoitu ja minimoitu ilman lähdekarttoja (source maps), mikä on enemmänkin siisteyttä kuin suojausta.

Mitä tämä tarkoittaa laajennusta rakennettaessa

Laajennuksenne asettuu samalle viivalle Adverantin omien moduulien kanssa. Lähes kaikki tässä luvussa esitetty pätee siihen.

Eristys, identiteetti ja tekoälypolku tulevat alustan mukana molemmissa versioissa. Paketilla @adverant-nexus/plugin-sdk rakennettu lisäosa perii rajattujen kyselyiden aidan, valtuustietojen tarkistajan ja UNO-välityksen riippumatta siitä, kumpaan versioon se päätyy. Luku 2.19, Säännöt, jotka jokainen laajennus perii, luettelee ne.

Versiorajoitus toimii samalla tavalla teillekin. Lisäosa ilmoittaa ominaisuustunnisteensa manifestinsa entitlements-lohkossa (featureIdPattern, sekä lyhyt alwaysOn-luettelo, jota pidetään kuntotarkistuksia ja asetussivua varten) ja pyytää alustalta päätöstä ennen kuin se tarjoaa rajoitetun pinnan. Päätös ei ole koskaan pelkkä totuusarvo (boolean). ENTITLEMENT_DENIED (403) tarkoittaa, että alusta vastasi ei. ENTITLEMENT_UNREACHABLE (502) tarkoittaa, että vastausta ei saatu, ja lisäosanne on kieltäydyttävä sen sijaan, että se tekisi oletuksia, koska käyttökatkon tulkitseminen "ei oikeutetuksi" alentaa hiljaisesti jokaisen asiakkaan tason kerralla. Tallentakaa kyllä-vastaus välimuistiin lyhyeksi aikaa, älkääkä koskaan tallentako hylkäystä välimuistiin.

Communityssa kehittäjä saa samat aloitusmallipohjat kuin Enterprisessa niin lisäosille ja linsseille kuin taidoille ja työnkuluillekin. Jokainen kehittäjä työskentelee kehitystilassa, jossa on tietohaaroja samalla palvelimella, ja koodi sijaitsee GitHubissa. Toimialapaketti- ja alustamallipohjat kuuluvat Enterpriseen. Niin kuuluu myös aikaan sidottu käyttöoikeuksien korottaminen integroidusta kehitysympäristöstä (IDE, integrated development environment): Communityssa ei ole erillistä tuotantoympäristöä, johon käyttöoikeuksia voisi korottaa, ja konsoli ilmoittaa tästä koodilla PASS_TIER_REQUIRED.

Rakentaminen Communityssa
Rakentaminen Communityssa
Rakentaminen Communityssa tarjoaa samat mallipohjat kuin Enterprise yhdellä palvelimella, koodin sijaitessa GitHubissa. Sivu nimeää, mitä Enterprise tuo lisää, ja epää korotetut käyttöoikeudet selkeällä syyllä.

Laajennus, joka käyttää vain Community-liitoskohtia, toimii kummassa tahansa versiossa muuttumattomana. Lisäosasta, esimerkiksi Sähköpostista, riippuvainen laajennus näkyy lukittuna kaikkialla, missä lisenssi ei nimeä kyseistä ryhmää. Luku 2.25, Rakentaminen kullekin versiolle, näyttää, miten laajennus jäsennetään molemmille ja miten sitä testataan kumpaakin vasten.