PrijavaRezervirajte predstavitev

Poglavje 2.13

Licence

Kaj vsebuje licenčna datoteka Nexus, kako jo namestitev preveri brez povezave, šest stanj, v katerih je lahko, ter kako jo zahtevate, uvozite, podaljšate in umaknete.

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

19 min branja

Harrow Port Authority izvaja Nexus Enterprise na lastni gruči Kubernetes na naslovu harrow.example, brez povezave iz gruče v internet. Vsako leto Aoife Brennan, vodja IT-ja, podaljša pogodbo, Tomás Reilly, inženir platforme, pa prenese majhno datoteko JSON čez vrzel in jo uvozi. Nič se ne zažene znova, stran z licenco pa prikaže nov končni datum.

To poglavje govori o tej datoteki. Na kratko, licenca je en podpisan dokument JSON, vezan na eno namestitev. Namestitev ga preveri sama z javnimi ključi, vgrajenimi v sliko, in pri tem ne opravi nobenega omrežnega klica. Licenca ni nikoli vrednost Helm in nikoli priklopljena datoteka. Uvozite jo prek konzole, nexusctl ali aplikacijskega programskega vmesnika (API) in nikjer drugje.

Licenčni dokument

Licenca je en objekt JSON v formatu nexus-licence/v1. Tukaj je licenca organizacije Harrow, s skrajšanima vrednostma obeh podpisov.

{
  "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>" }
  }
}

Vsako polje je obvezno in vsak objekt v dokumentu je zaprt. Član, ki ga format ne navaja, je zavrnjen, zato se nič ne more izmuzniti zunaj podpisa.

Polje Kaj vsebuje
format Natančno nexus-licence/v1. Vsaka druga vrednost, vključno s poznejšo različico, je zavrnjena.
licence_id UUID (univerzalni enolični identifikator) z malimi črkami. Namestitev uvozi vsak ID licence enkrat.
issued_at Trenutek, ko jo je Adverant izdal, kot YYYY-MM-DDThh:mm:ssZ.
type alpha, evaluation ali commercial.
channel Kanal izdaje, za katerega je bila izdana, kot je alpha. Podpisan in prenesen; preverjanje se glede na to ne veji.
licensee.name 1 do 200 znakov, podpisanih natanko tako, kot so zapisani. Brennan in Brennán sta dve različni imeni z dvema različnima podpisoma.
licensee.customer_id Vaš ID stranke pri družbi Adverant: male črke, števke, ., _ in -.
scope.deployment.installation_id Identiteta namestitve, ki jo ustvari njena storitev ključev ob prvi namestitvi.
scope.tenants ID-ji organizacij, do 1.000. Prazno, razen če je kakšna dodelitev omejena na najemnika.
edition enterprise ali team. Licenca Enterprise vedno dodeli enterprise-base.
grants 1 do 500 parov {feature_group, scope}, pri čemer je vsaka skupina imenovana enkrat.
add_ons ID-ji dodatkov iz matrike izdaj, do 100. Lahko je prazno.
domain_packs ID-ji domenskih paketov iz matrike izdaj, do 100. Lahko je prazno.
metric kind je per-environment, per-core ali named-seat; quantity je celo število od 1 naprej.
term starts_on in ends_on sta datuma; warn_days in grace_days sta celi števili od 0 do 365.
matrix Različica matrike izdaj, glede na katero so skupine zapisane, in zgoščena vrednost SHA-256 te datoteke matrike, shranjena za revizijo.
signatures Dva podpisa, ed25519 in p256. Edino polje, ki ni podpisano.

Datumi so koledarski datumi v UTC in dan mora obstajati: 2028-02-29 je v redu, 2027-02-29 pa je zavrnjen.

Dva podpisa, oba obvezna

Adverant podpiše vsako licenco z dvema neodvisnima ključema. En podpis je Ed25519. Drugi je ECDSA (algoritem za digitalni podpis z eliptičnimi krivuljami) na krivulji P-256 inštituta NIST (Nacionalni inštitut za standarde in tehnologijo ZDA), ki ga zahtevajo kupci, ki potrebujejo zvezne algoritme ZDA. Oba sta ustvarjena nad istimi bajti in oba se morata uspešno preveriti. Dokument, pri katerem ena polovica manjka ali je katera koli polovica napačna, šteje, kot da licence sploh ni.

Podpisani bajti so kanonična oblika dokumenta po standardu RFC 8785 z odstranjenim poljem signatures, tako da presledki in vrstni red članov v vaši datoteki ne vplivajo na nič. En sam spremenjen znak v imenu imetnika licence, datumih ali dodelitvi pomeni drugačen dokument in preverjanje ne uspe.

Javni ključi, ki jih uporablja preverjanje, so v datoteki korenov zaupanja, vgrajeni v vsako sliko ob gradnji izdaje. Nobena okoljska spremenljivka, zastavica ali priklop ne določa druge datoteke. Ko Adverant zamenja podpisni ključ, stari ključ podpiše novega in naslednja podpisana izdaja vsebuje novi ključ. Licenca, podpisana z novim ključem, se uspešno preveri v izdaji, ki ta ključ vsebuje, zato boste po menjavi ključa morda morali pred uvozom opraviti nadgradnjo (glejte poglavje 2.17, Odpravljanje težav).

Vrste, izdaje in način štetja licenc

Polje type pove, iz kakšne vrste dogovora izhaja licenca:

  • alpha: licenca za kanal izdaje alfa, kakršno ima Harrow.
  • evaluation: samostojno gostovano preizkusno obdobje izdaje Enterprise. Traja največ 30 dni, za največ 5 imenovanih oseb (metrika named-seat), pri čemer je grace_days nastavljen na 0. Format zavrne vsako preizkusno licenco s kakršnim koli odlogom.
  • commercial: pogodbena licenca.

Polje metric beleži, kako se licenca šteje: per-environment (produkcijska gruča organizacije Harrow je eno okolje), per-core ali named-seat. Adverant določi ceno; licenca vsebuje le mersko enoto in količino.

Polje licence edition je enterprise za vsako namestitev Enterprise. Format sprejme tudi team, kjer licenca dodeli skupino team in nikoli enterprise-base.

Skupine funkcionalnosti, dodatki in domenski paketi

Kaj licenca ljudem dovoljuje uporabljati, je navedeno po skupinah funkcij z uporabo ID-jev iz matrike izdaj. Licenca organizacije Harrow dodeljuje enterprise-base (vloge po meri, odobritve po načelu štirih oči, dolgo hrambo revizijskih sledi, prijavo v podjetju z uveljavljanjem in sinhronizacijo imenika, poslovne enote, operaterske strani in preostanek osnove Enterprise) in map-and-geoai. Vsebuje dodatek mail in domenski paket logistics-and-maritime.

Matrika vsebuje pravila o tem, kaj sodi skupaj, in sistem izdajanja družbe Adverant jih preveri, preden se licenca podpiše. Vsak dodatek in vsak paket potrebuje enterprise-base. Nekateri paketi potrebujejo dodatke: paket Logistika in pomorstvo potrebuje Zemljevid in GeoAI, paket Zavarovalništvo ter paket Kapitalski trgi in upravljanje premoženja potrebujeta Odločitvene sobe in zapečatene zapise, paket Pravne in strokovne storitve pa potrebuje Odločitvene sobe in Pošto.Zasloni za telefone v vsakem paketu prav tako potrebujejo dodatek Mobilne aplikacije.

Vsaka dodelitev ima obseg:

  • deployment: skupina velja za celotno namestitev, za vsako organizacijo v njej.
  • tenant: skupina velja samo za organizacije, navedene v scope.tenants. Licenca z dodelitvijo, omejeno na najemnika, mora navajati vsaj eno organizacijo, seznam organizacij brez dodelitve, omejene na najemnika, pa je zavrnjen.

Recimo, da bi ekipa za pilotažo v organizaciji Harrow delovala kot druga organizacija na isti namestitvi in bi imela Ideje samo ta organizacija. Dodelitev bi se glasila { "feature_group": "ideas", "scope": "tenant" }, z ID-jem organizacije za pilotažo v scope.tenants. Če bi bila licenca uvožena, preden bi ta organizacija obstajala, bi jo odgovor ob uvozu štel pod tenants_without_organisation, dodelitev pa bi jo dosegla, ko bi bila organizacija ustvarjena.

Skrbnik lahko zoži obseg, ki ga skupina doseže. Skupino lahko doda samo licenca družbe Adverant.

Licenca in kaj odklene
Licenca in kaj odklene
Stran z licenco navaja vsako skupino funkcij skupaj s tem, kako je zaščitena in kaj pokriva. Skupine, ki jih licenca ne vključuje, ostanejo na seznamu zatemnjene, tako da lahko ljudje vidijo, kaj obstaja.

Obdobje veljavnosti: opozorilo in odlog

Polje term določa štiri datume na koledarju. Od starts_on do ends_on je licenca v veljavi. warn_days določa, kako zgodaj se začne opozorilo, in grace_days, kako dolgo vse še naprej deluje po izteku. Licence, ki jih izda Adverant, vključujejo 30 dni za vsakega, razen če pogodba določa drugače. Preizkusna licenca ima grace_days vedno nastavljen na 0.

Za zgornjo licenco organizacije Harrow se koledar izide takole:

Datumi Stanje
1. januar 2027 do 1. december 2027 VALID
2. december 2027 do 31. december 2027 WARN
1. januar 2028 do 30. januar 2028 GRACE
Od 31. januarja 2028 RESTRICT

Zadnji dan obdobja veljavnosti, ends_on, je še vedno dan v stanju WARN. Dan po njem je v stanju GRACE ali RESTRICT, če ni obdobja odloga.

Šest stanj

Vsakič, ko se licenca prebere, namestitev ponovno izračuna njeno stanje iz dokumenta in trenutnega datuma. Nič se ne predpomni prek meje dneva, zato do poteka pride pravočasno brez načrtovanega opravila.

Stanje Kdaj Kaj lahko ljudje počnejo
ABSENT Nobena licenca ni uvožena ali pa je bil dokument zavrnjen Osnovna raven Community. Področja Enterprise so prikazana kot predstavitveni dražilniki s podatkom, kdo jih lahko vklopi.
VALID starts_on do ends_on minus warn_days Vsaka dodeljena skupina ima veljavno pravico do uporabe.
WARN Zadnjih warn_days dni obdobja veljavnosti Pravica do uporabe velja, skrbniki pa v izdelku vidijo pasico s končnim datumom.
GRACE Po ends_on, za grace_days dni Pravica do uporabe velja, z obvestilom LICENCE_IN_GRACE na strani Danes in na strani z licenco.
RESTRICT Po obdobju odloga Pod licencirano skupino ni mogoče začeti nobenega novega dela. Delo v teku se dokonča, branje in izvozi še naprej delujejo, varnostni popravki pa še naprej prihajajo.
TERMINATE Adverant je preklical licenco Artefakti Enterprise niso več na voljo. Osnovna raven Community in izvoz podatkov ostaneta.

V vsakem stanju se delo v teku še naprej izvaja, varnostni popravki še naprej prihajajo, izvozi ostanejo berljivi in nič se ne izbriše. V stanju RESTRICT oseba, ki poskuša začeti novo delo Enterprise, vidi ploščico o zavrnitvi s kodo LICENCE_LOCKED in imenom osebe, ki lahko licenco podaljša.

Vodoravna časovnica s petimi pasovi od leve proti desni: VALID (od starts_on), WARN (zadnjih warn_days obdobja veljavnosti), GRACE (grace_days po ends_on), RESTRICT (po obdobju odloga). Pod pasovi so tri označene oznake: starts_on, ends_on in ends_on + grace_days. Ločeno polje pod časovnico, povezano s črtkano puščico iz katerega koli pasu, ima oznako TERMINATE (podpisan seznam preklicanih licenc navaja licenco). Drugo polje skrajno levo, zunaj časovnice, ima oznako ABSENT (ni licence ali pa je bila zavrnjena: osnovna raven Community).
Stanja licence skozi koledar.

Kako se izračuna trenutni datum

Ura je lahko napačna in uro je mogoče nalašč premakniti nazaj. Zato namestitev nikoli ne bere samo ure. Trenutni datum je poznejši od dveh trenutkov: sistemske ure in shranjene spodnje meje, ki je najpoznejši trenutek, ki ga je namestitev zaznala. Spodnja meja se pomakne naprej ob vsakem uvozu in vsakem branju stanja ter se nikoli sama od sebe ne pomakne nazaj. Premik ure za en mesec nazaj potekle licence ne vrne v stanje VALID; licenca v stanju RESTRICT ostane v stanju RESTRICT.

Ko ura kaže čas pred spodnjo mejo, stanje nosi obvestilo LICENCE_CLOCK_BEHIND_FLOOR in se bere na dan spodnje meje. Če je ura resnično prehitevala (vozlišče se je zagnalo z napačnim datumom in spodnja meja se je prenesla naprej), prosite Adverant za žeton za ponastavitev časa. To je majhen podpisan dokument, vezan na vaš ID namestitve in enkratno naključno vrednost (nonce), s trenutkom floor_to. Uvozite ga prek vmesnika API s to zahtevo:

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> je dostopni žeton skrbnika namestitve. Žeton se uveljavi, ko se oba podpisa uspešno preverita, je njegov ID namestitve vaš in njegova enkratna naključna vrednost (nonce) še ni bila uporabljena. Zavrnjen žeton ne spremeni ničesar, zato ga ni mogoče nikoli uporabiti za zavrnitev veljavne licence. Žeton, katerega enkratna naključna vrednost je že bila uporabljena, se zavrne s kodo LICENCE_CLOCK_BEHIND_FLOOR.

Zahtevek za licenco

Licence zahtevate in prenesete iz svojega računa Adverant na naslovu https://account.adverant.ai. Kdo v vaši organizaciji lahko prevzema namestitve in prenaša licence, je določeno na strani Vloge organizacije in ekipe v računu.

Adverant mora vedeti, za katero namestitev je licenca namenjena, in to mu lahko sporočite na tri načine.

Enkratna koda za namestitev z zaslonom. Namestitev prikaže enkratno kodo in svoj prstni odtis. Na strani Prevzem namestitve prilepite kodo, nato pa skupino za skupino primerjate prstni odtis s tistim, kar prikazuje namestitev. Ko se vse skupine ujemajo, jo prevzamete za svojo organizacijo in licenca prispe v račun.

Ključ za prevzem za namensko napravo ali robno napravo. Te naprave nimajo zaslona za prikaz kode. Serijska številka in ključ za prevzem sta natisnjena na škatli in v naročilu proizvajalca opreme. Vnesite ju na strani Vnos ključa za prevzem enega za drugim ali pa odložite datoteko z naročilom proizvajalca, da jih prevzamete več hkrati. Vsak ključ se preveri v evidenci družbe Adverant o tem, kaj vam je bilo poslano, in ključ iz naročila nekoga drugega je zavrnjen.

Podpisana zahteva za licenco za namestitev brez zunanje povezave. To je pot, ki jo uporablja Harrow. Na namestitvi skrbnik ustvari datoteko zahteve pod Ta namestitev, Licenca. Gre za izjavo vrste licence-request, ki navaja ID namestitve in je podpisana z lastnim ključem Ed25519 namestitve. Tomás jo odnese na odobrenem nosilcu podatkov, jo odloži na strani Izmenjava brez povezave in prenese datoteko licence, ki jo dobi v odgovor. Licenca deluje samo na namestitvi, ki je ustvarila zahtevo.

Izmenjava brez povezave
Izmenjava brez povezave
Izmenjava brez povezave za namestitev brez zunanje povezave. Vsaka datoteka, ki prečka vrzel, je podpisana, zato je datoteka, spremenjena na poti, zavrnjena, vsaka izmenjava pa je navedena skupaj s podatkom, kdo jo je opravil.
Dva stolpca, levi z oznako »Namestitev Harrow (brez interneta)« in desni z oznako »Račun Adverant«. Levo zgoraj: polje »Datoteka z zahtevo za licenco, podpisana s ključem namestitve«. Puščica z oznako »preneseno na mediju« vodi v polje v desnem stolpcu »Stran za izmenjavo brez povezave«. Pod njim je polje »Licenčna datoteka, podpisana z dvema ključema Adverant«. Puščica z oznako »preneseno nazaj na mediju« se vrača v polje v levem stolpcu »Uvoz: konzola, nexusctl ali API« in od tam navzdol v polje »Preverjeno na namestitvi glede na vgrajena korenska potrdila zaupanja«.
Kako licenca doseže namestitev brez zunanje povezave.

Uvoz licence

Obstajajo tri vstopne poti in vse dosežejo isto končno točko na storitvi nexus-auth. Uvozi lahko samo skrbnik namestitve: lastnik ali skrbnik celotne organizacije, ki ima v lasti namestitev in je vanjo prijavljen, ali polni skrbnik platforme. Vsakdo drug je zavrnjen, še preden se datoteka prebere.

V konzoli

Pri novi namestitvi je Uvoz licence eno od šestih preverjanj na strani Šest stvari, preden se kdor koli prijavi. Ko datoteko odložite na stran, jo konzola preveri na namestitvi, brez povezave, ter navede njene skupine funkcij skupaj s tem, kako je posamezna zaščitena, in obdobjem veljavnosti.

Poznejši uvozi potekajo prek Ta namestitev, Licenca: uporabite Uvozi novo licenco ali Uvozi podaljšano licenco, ko je trenutna potekla. Namestitev Community, ki prehaja na Enterprise, uporabi Iz Community v Enterprise. Ta stran najprej prebere licenco ter prikaže, kaj bo pridobljeno in kaj se bo spremenilo, preden se kar koli zgodi. Nič se ne pridobi, dokler nekdo ne izbere Pridobi in vklopi. Deli Enterprise nato pridejo z naslova registry.adverant.ai z žetonom za vlečenje namestitve, pri čemer se vsak preveri glede na ključ izdaje družbe Adverant, skupine pa se vklapljajo ena za drugo. Po tem je to ista namestitev z istimi ljudmi, datotekami, delovnimi tokovi in kanali.

Uvoz licence
Uvoz licence
Uvažanje licence med nastavitvijo. Pristna datoteka navede svoje skupine funkcij; kopija z dvema spremenjenima vrsticama je prikazana kot odsotna s kodo LICENCE_SIGNATURE_INVALID, licenca, ki je že v veljavi, pa ostane nedotaknjena.
Iz izdaje Community v Enterprise
Iz izdaje Community v Enterprise
Prehod namestitve Community na Enterprise. Licenca je bila prebrana in spoznana za pristno, stran pa navaja dele, ki jih je treba pridobiti, in spremembe, preden kdor koli pritisne Pridobi in vklopi.

Z orodjem nexusctl

nexusctl licence import harrow-2027.licence.json

Ukaz uvozi datoteko nespremenjeno in izpiše trenutno stanje licence. Dodajte --explain, da izpišete operacije, ki bi se izvedle, ne da bi jih dejansko zagnali.

Prek vmesnika 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

Pošljite datoteko natanko tako, kot vam jo je dal Adverant. Ne preoblikujte je in je ne ovijajte v drug objekt: telo zahteve je sam dokument. Pot ne sprejema poizvedbenega niza, telo, večje od 1 MiB, pa je zavrnjeno. Član na najvišji ravni, ki imenuje organizacijo ali osebo, je zavrnjen s kodo TENANT_NOT_A_PARAMETER ali ACTOR_NOT_A_PARAMETER, ker licenca namestitve pripada namestitvi, ki je v lasti organizacije žetona.

Uspešen uvoz odgovori s kodo 201. Telo vsebuje pogled licence (njen ID, njeno trenutno stanje, imetnika licence, izdajo, obdobje veljavnosti, dodelitve in skupine funkcij), koliko organizacij jo zdaj ima in koliko navedenih najemnikov še nima organizacije. Licenca, njena zgoščena vrednost SHA-256 in vrstice glavne knjige za vsako organizacijo se zapišejo v eni transakciji, uvoz pa se zabeleži v revizijski dnevnik.

S tem sta povezani dve poti za branje:

  • GET /api/v1/installation/licence/state vrne stanje, ponovno izračunano ob vsakem branju. Skrbnik dobi celoten pogled. Vsak drug član organizacije na namestitvi dobi samo obvestilo: stanje, kodo obvestila (LICENCE_ENDS_SOON, LICENCE_IN_GRACE ali LICENCE_CLOCK_BEHIND_FLOOR) in datume, ki jih obvestilo navaja. Član nikoli ne vidi imetnika licence, obdobja veljavnosti ali skupin, ker ti podatki pripadajo lastniku namestitve.
  • GET /api/v1/installation/licence/document vrne uvoženi dokument v surovi obliki za skrbnike. Vsak modul Enterprise ga pridobi in ponovno preveri podpise s svojim lastnim vgrajenim preverjevalnikom, tako da spremenjena storitev identitete ne more vklopiti skupine, ki je licenca ne dodeljuje.

Vsaka zavrnitev

Zavrnjen uvoz ne spremeni ničesar, niti spodnje meje ure, zavrnitev pa se zabeleži v revizijski dnevnik.

Koda HTTP Pomen Kaj storiti
LICENCE_FORMAT_INVALID 422 Datoteka ni licenca, ki bi jo ta gradnja lahko prebrala: ni JSON, ne ustreza shemi, datumi si ne sledijo v pravilnem vrstnem redu ali pa je skupina imenovana dvakrat. Pošljite datoteko natanko tako, kot vam jo je dal Adverant.
LICENCE_SIGNATURE_INVALID 422 Eden od dveh podpisov manjka ali pa je bila datoteka po podpisu spremenjena. Znova prosite Adverant za datoteko in je ne urejajte.
LICENCE_ROOT_UNKNOWN 422 Podpisana je s ključem, ki ga koreni zaupanja te izdaje ne vsebujejo. Prosite za licenco, podpisano za korene te izdaje, ali opravite nadgradnjo.
LICENCE_MATRIX_MISMATCH 422 Zapisana je glede na matriko izdaj, ki je ta gradnja ne bere, ali pa dodeljuje skupino, ki je katalog gradnje ne pozna. Nadgradite na izdajo, ki jo bere, ali prosite za licenco, zapisano za to izdajo.
LICENCE_OTHER_INSTALLATION 409 Izdana je bila za drug ID namestitve. Prosite za licenco za identiteto te namestitve.
LICENCE_REVOKED 403 Adverant je to licenco umaknil. Prosite Adverant za novo licenco.
LICENCE_LOCKED 403 Licenca še ni začela veljati: trenutni datum je pred starts_on. Uvozite jo znova na njen prvi dan ali po njem.
TRANSITION_NOT_PERMITTED 409 Licenca s tem ID-jem je že bila uvožena. Prosite Adverant za novo licenco, če se morajo pogoji spremeniti.
RECORD_NOT_FOUND 404 Namestitev še ni bila deklarirana, zato nima identitete, s katero bi se opravilo preverjanje. Dokončajte prvi skrbniški korak in nato opravite uvoz.
VALIDATION_FAILED 400 Telesa ni bilo mogoče prebrati, je večje od 1 MiB ali pa je imela zahteva poizvedbeni niz. Pošljite samo datoteko kot telo, brez poizvedbe.

Namestitev preverja v določenem vrstnem redu in prva napaka določi kodo. Manjkajoča polovica se javi pred neznanim ključem, dokument, pri katerem podpisa ne uspeta, pa se nikoli ne bere naprej, tako da prirejena datoteka, ki navaja tudi drugo namestitev, še vedno odgovori s kodo LICENCE_SIGNATURE_INVALID.

Podaljšanje

Podaljšanje je nova licenca z novim licence_id. Uvozite jo na enak način kot prvo. Učinkovati začne takoj, ne glede na to, katero stanje je dosegla stara: iz stanja WARN, GRACE ali RESTRICT se namestitev vrne naravnost v licencirano stanje in ničesar ni treba znova nameščati. Adverant lahko izda spremenjeno licenco tudi sredi obdobja veljavnosti, na primer za dodajanje Odločitvenih sob, in tudi to uvozite na enak način.

Dvakratni uvoz iste licence je zavrnjen s kodo TRANSITION_NOT_PERMITTED.

Preklic

Adverant umakne licenco s podpisom seznama preklicanih licenc. Seznam ima zaporedno številko sequence ter navaja vsak ID umaknjene licence skupaj s časom in razlogom. Seznami so kumulativni: vsak vsebuje vse ID-je, preklicane pred njim. Uvozite ga na enak način kot licenco:

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

Seznam, katerega zaporedna številka ni višja od zadnjega uvoženega, je zavrnjen s kodo TRANSITION_NOT_PERMITTED, tako da starega seznama ni mogoče vrniti namesto novejšega. Seznam, ki se ne more prebrati ali se ne preveri uspešno, je zavrnjen z istimi kodami kot licenca. Ko seznam navede vašo licenco, je njeno stanje TERMINATE.

Namestitev brez zunanje povezave izve za preklic šele, ko nekdo uvozi seznam. Za Harrow je preklic stvar pogodbe prav toliko kot programske opreme, in Tomás uvozi vsak seznam, ki ga Adverant pošlje, ob naslednjem prenosu.

Presežek uporabniških mest nad licenco

Količina v licenci je obljuba glede uporabe in Nexus prekoračitev obravnava kot opozorilo, nikoli kot zaklepanje. Ko Nexus uporablja več ljudi, kot jih pokriva licenca, skrbniki na strani Ljudje vidijo ploščico SEATS_OVER_LICENCE. Vsi še naprej delajo. Ploščica navaja, do kdaj je treba to urediti (30 dni), prikazuje, od kod so prišli dodatni ljudje, in ponuja dve rešitvi: odstranite ljudi, ki sistema Nexus ne potrebujejo, ali prosite Adverant za več mest. Dodajanje mest je občutljiva sprememba, ki zahteva drugo osebo, dodatna mesta pa se štejejo v letnem izkazu uporabe.

Presežena mesta v licenci
Preseženo število licenčnih mest
Več ljudi kot mest. Sinhronizacija imenika je dodala 143 pogodbenikov in ploščica daje 30 dni časa za odstranitev ljudi ali dodajanje mest, pri čemer nihče ni zaklenjen iz sistema.

Izkaz uporabe vsebuje samo števce in pred pošiljanjem lahko preberete vsako vrstico. Harrow ga shrani kot datoteko in ga prenese prek izmenjave brez povezave.

Preizkusne različice

Preizkusna licenca je licenca vrste evaluation, ki se zažene s strani Preizkusi v računu za prevzeto namestitev. Traja največ 30 dni, pokriva največ 5 imenovanih oseb in nima obdobja odloga. Dan po ends_on preide naravnost v stanje RESTRICT: področja Enterprise se vrnejo v predstavitvene dražilnike in nič, kar je bilo ustvarjeno med preizkusom, se ne izbriše. Zagoni idej, osnutki pravilnikov in poštna pravila se ohranijo natanko takšni, kot so bili, in se ponovno odprejo, ko se uvozi licenca.

Organizacija izvaja eno samostojno gostovano preizkusno licenco naenkrat.