PrisijungtiUžsisakyti pristatymą

2.13 skyrius

Licencijos

Kas yra Nexus licencijos faile, kaip diegimas jį tikrina be interneto ryšio, šešios jo galimos būsenos ir kaip jį užsakyti, importuoti, atnaujinti bei atšaukti.

Šį puslapį iš originalo anglų kalba išvertė DI. Jei kas nors neaišku, remkitės puslapiu anglų kalba. Skaityti šį puslapį anglų kalba

19 min. skaitymo

Harrow Port Authority naudoja Nexus Enterprise savajame Kubernetes klasteryje adresu harrow.example, neturinčiame ryšio su internetu. Kasmet IT skyriaus vadovė Aoife Brennan atnaujina sutartį, o platformos inžinierius Tomás Reilly perneša nedidelį JSON failą per oro tarpą ir jį importuoja. Nieko nereikia paleisti iš naujo, o licencijos puslapyje rodoma nauja pabaigos data.

Šis skyrius yra apie tą failą. Trumpai tariant, licencija yra vienas pasirašytas JSON dokumentas, susietas su vienu diegimu. Diegimas jį patikrina pats, naudodamas į atvaizdą integruotus viešuosius raktus, ir tam neatlieka jokios tinklo užklausos. Licencija niekada nėra Helm reikšmė ir niekada nėra prijungtas failas. Ją importuojate per pultą, nexusctl arba programų sąsają (API), ir niekur kitur.

Licencijos dokumentas

Licencija yra vienas JSON objektas nexus-licence/v1 formatu. Štai Harrow licencija su sutrumpintomis dviem parašų reikšmėmis.

{
  "format": "nexus-licence/v1",
  "licence_id": "8c1e4f2a-6b0d-4e7a-9f31-2d5c7a9e0b14",
  "issued_at": "2026-12-14T10:20:00Z",
  "type": "alpha",
  "channel": "alpha",
  "licensee": { "name": "Harrow Port Authority", "customer_id": "harrow-port-authority" },
  "scope": {
    "deployment": { "installation_id": "4b7d2e90-1c5a-4f8e-a3d6-7e0b9c2f5a18" },
    "tenants": []
  },
  "edition": "enterprise",
  "grants": [
    { "feature_group": "enterprise-base", "scope": "deployment" },
    { "feature_group": "map-and-geoai", "scope": "deployment" }
  ],
  "add_ons": ["mail"],
  "domain_packs": ["logistics-and-maritime"],
  "metric": { "kind": "per-environment", "quantity": 1 },
  "term": { "starts_on": "2027-01-01", "ends_on": "2027-12-31", "warn_days": 30, "grace_days": 30 },
  "matrix": { "version": 1, "sha256": "<64 lower-case hexadecimal characters>" },
  "signatures": {
    "ed25519": { "key_id": "licence-ed-2026a", "sig": "<86 characters>" },
    "p256": { "key_id": "licence-p256-2026a", "sig": "<86 characters>" }
  }
}

Kiekvienas laukas yra privalomas, o kiekvienas dokumento objektas yra uždaras. Formatui nepriklausantis elementas atmetamas, todėl niekas negali būti pridėta už parašo ribų.

Laukas Kas jame saugoma
format Tiksliai nexus-licence/v1. Bet kokia kita reikšmė, įskaitant vėlesnę versiją, yra atmetama.
licence_id Mažųjų raidžių UUID (universalusis unikalusis identifikatorius). Diegimas kiekvieną licencijos ID importuoja vieną kartą.
issued_at Akimirka, kai Adverant ją išdavė, kaip YYYY-MM-DDThh:mm:ssZ.
type alpha, evaluation arba commercial.
channel Leidimo kanalas, kuriam ji buvo išduota, pavyzdžiui, alpha. Pasirašytas ir perduodamas; tikrinimas nuo jo nepriklauso.
licensee.name Nuo 1 iki 200 simbolių, pasirašyta tiksliai taip, kaip parašyta. Brennan ir Brennán yra du skirtingi pavadinimai su dviem skirtingais parašais.
licensee.customer_id Jūsų kliento ID Adverant sistemoje: mažosios raidės, skaitmenys, ., _ ir -.
scope.deployment.installation_id Diegimo tapatybė, sukurta jo raktų tarnybos pirmojo diegimo metu.
scope.tenants Organizacijų ID, iki 1000. Tuščia, nebent kuri nors teisė taikoma nuomininko lygmeniu.
edition enterprise arba team. Enterprise licencija visada suteikia enterprise-base.
grants Nuo 1 iki 500 {feature_group, scope} porų, kiekviena grupė nurodoma vieną kartą.
add_ons Priedų ID iš leidimų matricos, iki 100. Gali būti tuščia.
domain_packs Srities paketų ID iš leidimų matricos, iki 100. Gali būti tuščia.
metric kind yra per-environment, per-core arba named-seat; quantity yra sveikasis skaičius nuo 1.
term starts_on ir ends_on yra datos; warn_days ir grace_days yra sveikieji skaičiai nuo 0 iki 365.
matrix Leidimų matricos versija, pagal kurią parašytos grupės, ir to matricos failo SHA-256 maiša, saugoma auditui.
signatures Du parašai: ed25519 ir p256. Vienintelis laukas, kuris nėra pasirašomas.

Datos yra kalendorinės datos UTC laiku, ir ta diena turi egzistuoti: 2028-02-29 tinka, o 2027-02-29 atmetama.

Du parašai, abu privalomi

Adverant pasirašo kiekvieną licenciją dviem nepriklausomais raktais. Vienas parašas yra Ed25519. Kitas yra ECDSA (elipsinių kreivių skaitmeninio parašo algoritmas) P-256 kreivėje iš NIST (JAV nacionalinio standartų ir technologijų instituto), kurio prašo pirkėjai, kuriems reikalingi JAV federaliniai algoritmai. Abu sukuriami iš tų pačių baitų ir abu turi būti patvirtinti. Dokumentas, kuriame trūksta vienos pusės arba bet kuri pusė yra neteisinga, laikomas visiškai negaliojančia licencija.

Pasirašyti baitai yra RFC 8785 kanoninė dokumento forma su pašalintu signatures, todėl tarpai ir elementų tvarka jūsų faile neturi reikšmės. Vienas pakeistas simbolis licencijos turėtojo pavadinime, datose ar suteiktoje teisėje reiškia kitą dokumentą, ir patikra nepavyksta.

Viešieji raktai, kuriuos naudoja patikra, yra patikimų šakninių sertifikatų faile, integruotame į kiekvieną atvaizdą leidimo kūrimo metu. Joks aplinkos kintamasis, vėliavėlė ar prijungimas nenurodo kito failo. Kai Adverant pakeičia pasirašymo raktą, senasis raktas pasirašo naująjį, o kitas pasirašytas leidimas jau turi naująjį raktą. Naujuoju raktu pasirašyta licencija patvirtinama leidime, kuriame šis raktas yra, todėl pakeitus raktą prieš importuojant gali tekti atnaujinti sistemą (žr. 2.17 skyrių „Trikčių šalinimas“).

Tipai, leidimai ir kaip skaičiuojama licencija

Laukas type nurodo, kokio pobūdžio sutartimi remiantis išduota licencija:

  • alpha: licencija alfa leidimo kanalui – būtent tokią turi Harrow.
  • evaluation: savarankiškai talpinama bandomoji Enterprise versija. Ji veikia ne ilgiau kaip 30 dienų, skirta ne daugiau kaip 5 vardiniams asmenims (metrika named-seat), o grace_days nustatytas į 0. Formatas atmeta bandomąją versiją su bet kokiu lengvatiniu laikotarpiu.
  • commercial: sutartinė licencija.

Laukas metric fiksuoja, kaip skaičiuojama licencija: per-environment (Harrow gamybinis klasteris yra viena aplinka), per-core arba named-seat. Adverant nurodo kainą; licencijoje pateikiamas tik matavimo vienetas ir kiekis.

Licencijos edition yra enterprise kiekvienam Enterprise diegimui. Formatas taip pat priima team, kur licencija suteikia team grupę ir niekada nesuteikia enterprise-base.

Funkcijų grupės, priedai ir sričių paketai

Tai, ką licencija leidžia žmonėms naudoti, yra išvardyta pagal funkcijų grupes, naudojant leidimų matricos ID. Harrow licencija suteikia enterprise-base (tinkintus vaidmenis, keturių akių patvirtinimus, ilgą audito įrašų saugojimą, įmonės prisijungimą su priverstiniu taikymu ir katalogų sinchronizavimu, verslo padalinius, operatoriaus puslapius ir likusią Enterprise bazę) ir map-and-geoai. Joje yra mail priedas ir logistics-and-maritime srities paketas.

Matricoje yra taisyklės, kas su kuo dera, ir Adverant išdavimo sistema jas patikrina prieš pasirašydama licenciją. Kiekvienam priedui ir kiekvienam paketui reikia enterprise-base. Kai kuriems paketams reikia priedų: Logistikos ir jūrų paketui reikia Žemėlapio ir GeoAI, Draudimo paketui bei Kapitalo rinkų ir turto valdymo paketui reikia Sprendimų kambarių ir užantspauduotų įrašų, o Teisės ir profesinių paslaugų paketui reikia Sprendimų kambarių ir Pašto. Kiekvieno paketo telefono ekranams taip pat reikia Mobiliųjų programų priedo.

Kiekviena suteikta teisė turi apimtį:

  • deployment: grupė taikoma visam diegimui, kiekvienai jame esančiai organizacijai.
  • tenant: grupė taikoma tik organizacijoms, išvardytoms scope.tenants. Licencijoje su nuomininko apimties teise turi būti nurodyta bent viena organizacija, o organizacijų sąrašas be nuomininko apimties teisės yra atmetamas.

Tarkime, kad Harrow locmanų komanda veiktų kaip antra organizacija tame pačiame diegime ir tik ta organizacija turėtų naudoti Ideas. Suteikta teisė būtų { "feature_group": "ideas", "scope": "tenant" }, o locmanų organizacijos ID būtų įrašytas į scope.tenants. Jei licencija būtų importuota dar prieš sukuriant tą organizaciją, importavimo atsakymas ją įskaičiuotų į tenants_without_organisation, o teisė jai būtų pritaikyta, kai tik organizacija būtų sukurta.

Administratorius gali susiaurinti grupės pasiekiamumą. Pridėti grupę gali tik Adverant išduota licencija.

Licencija ir ką ji atrakina
Licencija ir ką ji atrakina
Licencijos puslapyje išvardytos visos funkcijų grupės, nurodant, kaip jos apsaugotos ir ką apima. Grupės, kurių licencija nesuteikia, lieka sąraše papilkintos, kad žmonės matytų, kas egzistuoja.

Terminas: įspėjimas ir lengvatinis laikotarpis

Laukas term nustato keturias kalendoriaus datas. Nuo starts_on iki ends_on licencija galioja. warn_days nustato, prieš kiek laiko pradedamas rodyti įspėjimas, o grace_days – kiek laiko viskas toliau veikia pasibaigus galiojimui. Adverant išduodamose licencijose abiem atvejais numatyta po 30 dienų, nebent sutartyje nurodyta kitaip. Bandomosios versijos grace_days visada yra 0.

Aukščiau pateiktai Harrow licencijai kalendorius išsidėsto taip:

Datos Būsena
2027 m. sausio 1 d. – 2027 m. gruodžio 1 d. VALID
2027 m. gruodžio 2 d. – 2027 m. gruodžio 31 d. WARN
2028 m. sausio 1 d. – 2028 m. sausio 30 d. GRACE
Nuo 2028 m. sausio 31 d. RESTRICT

Paskutinė termino diena, ends_on, vis dar yra WARN diena. Diena po jos yra GRACE arba RESTRICT, kai lengvatinio laikotarpio nėra.

Šešios būsenos

Kiekvieną kartą nuskaitant licenciją, diegimas iš naujo apskaičiuoja jos būseną pagal dokumentą ir dabartinę datą. Niekas nėra podėliuojama ilgiau nei iki dienos pabaigos, todėl galiojimas baigiasi laiku be suplanuotos užduoties.

Būsena Kada Ką žmonės gali daryti
ABSENT Licencija neimportuota arba dokumentas buvo atmestas Community lygmuo. Enterprise sritys rodomos kaip anonsai, nurodant, kas gali jas įjungti.
VALID Nuo starts_on iki ends_on atėmus warn_days Suteikta teisė į kiekvieną priskirtą grupę.
WARN Paskutinės warn_days termino dienos Teisė suteikta, o administratoriai produkte mato juostą su pabaigos data.
GRACE Po ends_on, grace_days d. Teisė suteikta, su pranešimu LICENCE_IN_GRACE puslapyje „Today“ ir licencijos puslapyje.
RESTRICT Pasibaigus lengvatiniam laikotarpiui Negalima pradėti jokio naujo darbo licencijuotoje grupėje. Vykdomi darbai užbaigiami, skaitymas ir eksportavimas veikia toliau, o saugos pataisos toliau gaunamos.
TERMINATE Adverant atšaukė licenciją Enterprise artefaktai nebesiūlomi. Lieka Community lygmuo ir duomenų eksportavimas.

Bet kurioje būsenoje vykdomi darbai tęsiami, saugos pataisos gaunamos toliau, eksportuoti duomenys lieka įskaitomi ir niekas neištrinama. RESTRICT būsenoje asmuo, bandantis pradėti naują Enterprise darbą, mato atmetimo lentelę su kodu LICENCE_LOCKED ir asmens, galinčio atnaujinti licenciją, vardu.

Horizontali laiko juosta su penkiomis atkarpomis iš kairės į dešinę: VALID (nuo starts_on), WARN (paskutinės termino warn_days dienos), GRACE (grace_days dienos po ends_on), RESTRICT (po lengvatinio laikotarpio). Po atkarpomis yra trys pažymėti žymekliai: starts_on, ends_on ir ends_on + grace_days. Atskirame langelyje po laiko juosta, sujungtame punktyrine rodykle iš bet kurios atkarpos, yra užrašas TERMINATE (pasirašytame atšaukimo sąraše nurodyta licencija). Antrame langelyje kairiajame krašte, už laiko juostos ribų, yra užrašas ABSENT (nėra licencijos arba ji atmesta: Community lygmuo).
Licencijos būsenos pagal kalendorių.

Kaip apskaičiuojama dabartinė data

Laikrodis gali rodyti netiksliai arba būti tyčia atsuktas atgal. Todėl diegimas niekada nesiremia vien tik laikrodžiu. Dabartinė data yra vėlesnė iš dviejų laiko akimirkų: sistemos laikrodžio ir išsaugotos žemiausios ribos, kuri yra vėliausia diegimo matyta akimirka. Ši riba pasislenka į priekį kiekvieno importavimo ir kiekvieno būsenos nuskaitymo metu ir niekada savaime negrįžta atgal. Laikrodžio atsukimas mėnesiu atgal negrąžina pasibaigusio galiojimo licencijos į VALID būseną; RESTRICT licencija lieka RESTRICT.

Kai laikrodis rodo ankstesnį laiką nei išsaugota riba, būsena turi pranešimą LICENCE_CLOCK_BEHIND_FLOOR ir yra nuskaitoma pagal ribos dieną. Jei laikrodis iš tikrųjų buvopaskubėjęs (mazgas buvo paleistas su neteisinga data ir riba pasislinko į priekį), paprašykite Adverant laiko atstatymo prieigos rakto. Tai nedidelis pasirašytas dokumentas, susietas su jūsų diegimo ID ir vienkartiniu skaičiumi (nonce), turintis floor_to laiko akimirką. Jį importuojate per API su šia užklausa:

curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence/time-reset \
  -H "Authorization: Bearer <access-token>" \
  -H "Content-Type: application/json" \
  --data-binary @harrow-time-reset.json

<access-token> yra diegimo administratoriaus prieigos raktas. Raktas pritaikomas, kai patvirtinami abu parašai, jo diegimo ID sutampa su jūsų ir jo vienkartinis skaičius (nonce) dar nebuvo panaudotas. Atmestas raktas nieko nekeičia, todėl jo niekada negalima panaudoti tinkamai licencijai atmesti. Raktas, kurio vienkartinis skaičius jau buvo panaudotas, atmetamas su kodu LICENCE_CLOCK_BEHIND_FLOOR.

Licencijos užsakymas

Licencijų prašoma ir jos atsisiunčiamos iš jūsų Adverant paskyros adresu https://account.adverant.ai. Tai, kas jūsų organizacijoje gali priskirti diegimus ir atsisiųsti licencijas, nustatoma paskyros puslapyje „Organisation and team roles“.

Adverant turi žinoti, kuriam diegimui skirta licencija, ir yra trys būdai tai nurodyti.

Vienkartinis kodas diegimui su ekranu. Diegimas rodo vienkartinį kodą ir savo kontrolinį kodą. Puslapyje „Claim a deployment“ įklijuojate kodą, tada grupė po grupės palyginate kontrolinį kodą su tuo, ką rodo diegimas. Kai visos grupės sutampa, priskiriate jį savo organizacijai ir licencija atsiranda paskyroje.

Priskyrimo raktas įrenginiui arba paribio (edge) įrenginiui. Jie neturi ekrano kodui parodyti. Serijos numeris ir priskyrimo raktas yra išspausdinti ant dėžės ir įrangos gamintojo užsakyme. Įveskite juos po vieną puslapyje „Enter a claim key“ arba įkelkite gamintojo užsakymo failą, kad priskirtumėte daug įrenginių vienu metu. Kiekvienas raktas patikrinamas pagal Adverant įrašus apie tai, kas jums buvo išsiųsta, o raktas iš kito asmens užsakymo yra atmetamas.

Pasirašyta licencijos užklausa diegimui be išorinio ryšio. Tai yra Harrow būdas. Diegime administratorius sukuria užklausos failą skiltyje „This installation, Licence“. Tai licence-request pobūdžio pareiškimas, nurodantis diegimo ID ir pasirašytas paties diegimo Ed25519 raktu. Tomás išneša jį patvirtintoje laikmenoje, įkelia į puslapį „Offline exchange“ ir atsisiunčia grąžintą licencijos failą. Licencija veikia tik tame diegime, kuris sukūrė užklausą.

Keitimasis neprisijungus
Keitimasis neprisijungus
Apsikeitimas neprisijungus diegimui be išorinio ryšio. Kiekvienas oro tarpą kertantis failas yra pasirašytas, todėl pakeliui pakeistas failas atmetamas, o kiekvienas apsikeitimas registruojamas nurodant, kas jį atliko.
Du stulpeliai: kairysis pažymėtas „Harrow diegimas (be interneto)“, o dešinysis – „Adverant paskyra“. Kairėje viršuje: langelis „Licencijos užklausos failas, pasirašytas diegimo raktu“. Rodyklė, pažymėta „perkeliama laikmenoje“, pereina į dešiniojo stulpelio langelį „Neprisijungusio keitimosi puslapis“. Po juo – langelis „Licencijos failas, pasirašytas dviem Adverant raktais“. Rodyklė, pažymėta „perkeliama atgal laikmenoje“, grįžta į kairiojo stulpelio langelį „Importavimas: pultas, nexusctl arba API“, o iš ten žemyn į langelį „Patikrinama diegime pagal įdiegtus patikimumo šakninius sertifikatus“.
Kaip licencija pasiekia diegimą be išorinio ryšio.

Licencijos importavimas

Yra trys įkėlimo būdai, ir jie visi pasiekia tą patį galinį tašką „nexus-auth“ tarnyboje. Importuoti gali tik diegimo administratorius: visos organizacijos, kuriai priklauso diegimas, savininkas arba administratorius, prisijungęs prie jo, arba pilnateisis platformos administratorius. Bet kas kitas atmetamas dar prieš nuskaitant failą.

Pulte

Naujame diegime „Import the licence“ yra viena iš šešių patikrų puslapyje „Six things before anyone signs in“. Kai įkeliate failą į puslapį, pultas patikrina jį pačiame diegime, neprisijungus prie interneto, ir išvardija jo funkcijų grupes, nurodydamas, kaip kiekviena yra apsaugota, bei galiojimo terminą.

Vėlesni importavimai atliekami per „This installation, Licence“: naudokite „Import a new licence“ arba „Import a renewed licence“, kai dabartinė licencija baigiasi. Community diegimas, pereinantis į Enterprise, naudoja „From Community to Enterprise“. Tas puslapis pirmiausia nuskaito licenciją ir parodo, kas bus atsiųsta ir kas pasikeis, dar prieš bet kokiems veiksmams įvykstant. Niekas neatsiunčiama, kol kas nors nepasirenka „Fetch and switch on“. Tada Enterprise dalys atsiunčiamos iš registry.adverant.ai naudojant diegimo atsiuntimo raktą, kiekviena patikrinama pagal Adverant leidimo raktą, ir grupės įjungiamos po vieną. Po to tai lieka tas pats diegimas su tais pačiais žmonėmis, failais, darbo eigomis ir kanalais.

Licencijos importavimas
Licencijos importavimas
Licencijos importavimas sąrankos metu. Tikrasis failas išvardija savo funkcijų grupes; kopija su dviem pakeistomis eilutėmis rodoma kaip nesanti su kodu LICENCE_SIGNATURE_INVALID, o jau galiojanti licencija lieka nepaliesta.
Iš Community į Enterprise
Iš Community į Enterprise
Community diegimo perkėlimas į Enterprise. Licencija buvo nuskaityta ir pripažinta tikra, o puslapyje išvardijamos atsiųstinos dalys ir pakeitimai dar prieš kam nors paspaudžiant „Fetch and switch on“.

Naudojant nexusctl

nexusctl licence import harrow-2027.licence.json

Komanda importuoja nepakeistą failą ir išspausdina dabartinę licencijos būseną. Pridėkite --explain, kad išspausdintumėte operacijas, kurias ji vykdytų, iš tikrųjų jų nevykdydami.

Per API

curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence \
  -H "Authorization: Bearer <access-token>" \
  -H "Content-Type: application/json" \
  --data-binary @harrow-2027.licence.json

Siųskite failą tiksliai tokį, kokį jį jums davė Adverant. Neperformuokite jo ir neįdėkite į kitą objektą: užklausos turinys ir yra pats dokumentas. Maršrutas nepriima jokios užklausos eilutės, o didesnis nei 1 MiB turinys yra atmetamas. Aukščiausio lygio elementas, nurodantis organizaciją arba asmenį, atmetamas su kodu TENANT_NOT_A_PARAMETER arba ACTOR_NOT_A_PARAMETER, nes diegimo licencija priklauso diegimui, kurį valdo prieigos rakto organizacija.

Sėkmingas importavimas grąžina 201. Turinyje pateikiamas licencijos vaizdas (jos ID, dabartinė būsena, licencijos turėtojas, leidimas, terminas, suteiktos teisės ir funkcijų grupės), informacija, kiek organizacijų dabar ją turi ir kiek išvardytų nuomininkų dar neturi organizacijos. Licencija, jos SHA-256 santrauka ir didžiosios knygos eilutės kiekvienai organizacijai įrašomos viena operacija, o importavimas užregistruojamas audito žurnale.

Kartu su juo veikia du skaitymo maršrutai:

  • GET /api/v1/installation/licence/state grąžina būseną, perskaičiuojamą kiekvieno nuskaitymo metu. Administratorius gauna pilną vaizdą. Bet kuris kitas diegime esančios organizacijos narys gauna tik pranešimą: būseną, pranešimo kodą (LICENCE_ENDS_SOON, LICENCE_IN_GRACE arba LICENCE_CLOCK_BEHIND_FLOOR) ir pranešime minimas datas. Narys niekada nemato licencijos turėtojo, termino ar grupių, nes ši informacija priklauso diegimo savininkui.
  • GET /api/v1/installation/licence/document administratoriams grąžina neapdorotą importuotą dokumentą. Kiekvienas Enterprise modulis jį pasiima ir dar kartą patikrina parašus naudodamas savo įkompiliuotą tikrintuvą, todėl pakeista tapatybės tarnyba negali įjungti grupės, kurios nesuteikia licencija.

Kiekvienas atmetimas

Atmestas importavimas nieko nekeičia, net laikrodžio žemiausios ribos, o atmetimas užregistruojamas audito žurnale.

Kodas HTTP Reikšmė Ką daryti
LICENCE_FORMAT_INVALID 422 Failas nėra licencija, kurią ši darinio versija galėtų nuskaityti: tai ne JSON, neatitinka schemos, datos sumaišytos vietomis arba grupė nurodyta du kartus. Siųskite failą tiksliai tokį, kokį jį jums davė Adverant.
LICENCE_SIGNATURE_INVALID 422 Trūksta vieno iš dviejų parašų arba failas buvo pakeistas po pasirašymo. dar kartą paprašykite Adverant failo ir neredaguokite jo.
LICENCE_ROOT_UNKNOWN 422 Jis pasirašytas raktu, kurio nėra šio leidimo patikimuose šakniniuose sertifikatuose. Paprašykite licencijos, pasirašytos šio leidimo šakniniams sertifikatams, arba atnaujinkite sistemą.
LICENCE_MATRIX_MISMATCH 422 Ji parašyta pagal leidimų matricą, kurios ši darinio versija neskaito, arba suteikia grupę, kurios nėra darinio kataloge. Atnaujinkite į leidimą, kuris ją skaito, arba paprašykite licencijos, parašytos šiam leidimui.
LICENCE_OTHER_INSTALLATION 409 Ji buvo išduota kitam diegimo ID. Paprašykite licencijos šio diegimo tapatybei.
LICENCE_REVOKED 403 Adverant atšaukė šią licenciją. Paprašykite Adverant naujos licencijos.
LICENCE_LOCKED 403 Licencija dar neįsigaliojo: dabartinė data yra ankstesnė nei starts_on. Importuokite ją dar kartą pirmąją jos galiojimo dieną arba vėliau.
TRANSITION_NOT_PERMITTED 409 Licencija su šiuo ID jau buvo importuota. Paprašykite Adverant naujos licencijos, jei sąlygos turi pasikeisti.
RECORD_NOT_FOUND 404 Diegimas dar nebuvo deklaruotas, todėl neturi tapatybės, su kuria būtų galima palyginti. Užbaikite pirmąjį administratoriaus veiksmą, tada importuokite.
VALIDATION_FAILED 400 Nepavyko nuskaityti turinio, jis viršija 1 MiB arba užklausoje buvo užklausos eilutė. Siųskite vieną patį failą kaip užklausos turinį, be jokios užklausos eilutės.

Diegimas tikrina nustatyta tvarka, o pirmoji klaida nurodo kodą. Apie trūkstamą pusę pranešama prieš nežinomą raktą, o dokumentas, kurio parašų patikra nepavyksta, toliau niekada neskaitomas, todėl suklastotas failas, kuriame taip pat nurodytas kitas diegimas, vis tiek grąžina LICENCE_SIGNATURE_INVALID.

Atnaujinimas

Atnaujinimas yra nauja licencija su nauju licence_id. Importuokite ją tokiu pačiu būdu kaip ir pirmąją. Ji įsigalioja iš karto, nepriklausomai nuo to, kokią būseną buvo pasiekusi senoji: iš WARN, GRACE arba RESTRICT diegimas iškart grįžta į licencijuotą būseną ir nieko nereikia diegti iš naujo. Adverant taip pat gali išduoti pakeistą licenciją termino viduryje, pavyzdžiui, norėdama pridėti Sprendimų kambarius, ir jūs ją importuojate tokiu pačiu būdu.

Tos pačios licencijos importavimas du kartus atmetamas su kodu TRANSITION_NOT_PERMITTED.

Atšaukimas

Adverant atšaukia licenciją pasirašydama atšaukimo sąrašą. Sąrašas turi sequence numerį ir nurodo kiekvienos atšauktos licencijos ID kartu su atšaukimo laiku ir priežastimi. Sąrašai yra kaupiamieji: kiekviename iš jų yra visi anksčiau atšaukti ID. Jį importuojate tokiu pačiu būdu kaip ir licenciją:

curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence/revocations \
  -H "Authorization: Bearer <access-token>" \
  -H "Content-Type: application/json" \
  --data-binary @revocations-12.json

Sąrašas, kurio eilės numeris nėra didesnis už paskutinį importuotą, atmetamas su kodu TRANSITION_NOT_PERMITTED, todėl seno sąrašo negalima grąžinti vietoj naujesnio. Sąrašas, kurio nepavyksta nuskaityti arba patvirtinti, atmetamas su tais pačiais kodais kaip ir licencija. Kai sąraše nurodoma jūsų licencija, jos būsena tampa TERMINATE.

Diegimas be išorinio ryšio apie atšaukimą sužino tik tada, kai kas nors importuoja sąrašą. Harrow atveju atšaukimas yra tiek pat sutarties, kiek ir programinės įrangos klausimas, ir Tomás importuoja kiekvieną Adverant atsiųstą sąrašą kito duomenų perkėlimo metu.

Licenciją viršijančios darbo vietos

Licencijos kiekis yra pažadas dėl naudojimo, ir Nexus jo viršijimą traktuoja kaip įspėjimą, o ne blokavimą. Kai Nexus naudoja daugiau žmonių, nei apima licencija, administratoriai puslapyje „People“ mato lentelę SEATS_OVER_LICENCE. Visi toliau dirba. Lentelėje nurodoma, iki kada reikia tai ištaisyti (30 dienų), parodoma, iš kur atsirado papildomi žmonės, ir pasiūlomi du sprendimai: pašalinti žmones, kuriems nereikia Nexus, arba paprašyti Adverant daugiau darbo vietų. Darbo vietų pridėjimas yra jautrus pakeitimas, kuriam reikia antro asmens patvirtinimo, o papildomos vietos įskaičiuojamos į metinę naudojimo ataskaitą.

Darbo vietų skaičius viršija licenciją
Licenciją viršijančios darbo vietos
Daugiau žmonių nei darbo vietų. Katalogų sinchronizavimas pridėjo 143 rangovus, o lentelė suteikia 30 dienų žmonėms pašalinti arba vietoms pridėti, nieko neblokuojant.

Naudojimo ataskaitoje yra tik skaitikliai, ir jūs galite perskaityti kiekvieną eilutę prieš ją išsiunčiant. Harrow išsaugo ją kaip failą ir išneša per apsikeitimą neprisijungus.

Išbandymai

Bandomoji versija yra evaluation tipo licencija, pradedama paskyros puslapyje „Trials“ priskirtam diegimui. Ji trunka ne ilgiau kaip 30 dienų, apima ne daugiau kaip 5 vardinius asmenis ir neturi lengvatinio laikotarpio. Kitą dieną po ends_on ji iškart pereina į RESTRICT būseną: Enterprise sritys vėl tampa anonsais ir niekas, kas buvo sukurta bandymo metu, neištrinama. Idėjų vykdymas, parengtos politikos ir pašto taisyklės išsaugomos tiksliai tokios, kokios buvo, ir vėl atsidaro importavus licenciją.

Organizacija vienu metu gali naudoti vieną savarankiškai talpinamą bandomąją versiją.