InnskráningBóka kynningu

Kafli 2.13

Leyfi

Hvað Nexus-leyfisskrá inniheldur, hvernig uppsetningin sannreynir hana án nettengingar, stöðurnar sex sem hún getur verið í, og hvernig þú biður um, flytur inn, endurnýjar og afturkallar leyfi.

Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

19 mínútna lestur

Harrow Port Authority keyrir Nexus Enterprise á sínum eigin Kubernetes-klasa á harrow.example, án nokkurrar tengingar frá klasanum út á internetið. Á hverju ári endurnýjar Aoife Brennan, yfirmaður upplýsingatæknideildar, samninginn og Tomás Reilly, kerfisverkfræðingur, ferjar lítið JSON-skjal yfir bilið og flytur það inn. Ekkert endurræsist og leyfissíðan sýnir nýja lokadagsetningu.

Þessi kafli fjallar um þá skrá. Í stuttu máli er leyfi eitt undirritað JSON-skjal sem er bundið við eina uppsetningu. Uppsetningin sannreynir það sjálf með dreifilyklum sem eru innbyggðir í myndina (image) og framkvæmir engin netköll til þess. Leyfi er aldrei Helm-gildi og aldrei tengd (mounted) skrá. Þú flytur það inn í gegnum stjórnborðið, nexusctl eða forritaskilin (API), og hvergi annars staðar.

Leyfisskjalið

Leyfi er einn JSON-hlutur á sniðinu nexus-licence/v1. Hér er leyfi Harrow, þar sem undirskriftargildin tvö hafa verið stytt.

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

Hvert einasta svæði er áskilið og hver hlutur í skjalinu er lokaður. Staki sem sniðið tilgreinir ekki er hafnað, þannig að ekkert getur flotið með utan undirskriftarinnar.

Reitur Hvað það geymir
format Nákvæmlega nexus-licence/v1. Öllum öðrum gildum, þar á meðal nýrri útgáfum, er hafnað.
licence_id UUID (universally unique identifier) í lágstöfum. Uppsetning flytur hvert leyfisauðkenni inn einu sinni.
issued_at Augnablikið þegar Adverant gaf það út, sem YYYY-MM-DDThh:mm:ssZ.
type alpha, evaluation eða commercial.
channel Útgáfurásin sem það var gefið út fyrir, svo sem alpha. Undirritað og flutt með; athugunin greinist ekki eftir því.
licensee.name 1 til 200 stafir, undirritað nákvæmlega eins og það er skrifað. Brennan og Brennán eru tvö ólík nöfn með tvær ólíkar undirskriftir.
licensee.customer_id Viðskiptavinaauðkenni þitt hjá Adverant: lágstafir, tölustafir, ., _ og -.
scope.deployment.installation_id Auðkenni uppsetningarinnar, búið til af lyklaþjónustu hennar við fyrstu uppsetningu.
scope.tenants Auðkenni stofnana, allt að 1.000. Tómt nema einhver heimild sé bundin við leigjanda (tenant-scoped).
edition enterprise eða team. Enterprise-leyfi veitir alltaf enterprise-base.
grants 1 til 500 {feature_group, scope} pör, hver hópur nefndur einu sinni.
add_ons Auðkenni viðbóta úr útgáfufylkinu, allt að 100. Má vera tómt.
domain_packs Auðkenni fagsviðspakka úr útgáfufylkinu, allt að 100. Má vera tómt.
metric kind er per-environment, per-core eða named-seat; quantity er heiltala frá 1.
term starts_on og ends_on eru dagsetningar; warn_days og grace_days eru heiltölur frá 0 til 365.
matrix Útgáfa útgáfufylkisins sem hóparnir eru skrifaðir gegn, og SHA-256 summa þeirrar fylkisskrár, varðveitt fyrir endurskoðun.
signatures Tvær undirskriftir, ed25519 og p256. Eina svæðið sem er ekki undirritað.

Dagsetningar eru almanaksdagar í UTC og dagurinn verður að vera til: 2028-02-29 er í lagi en 2027-02-29 er hafnað.

Tvær undirskriftir, báðar áskildar

Adverant undirritar hvert leyfi með tveimur óháðum lyklum. Önnur undirskriftin er Ed25519. Hin er ECDSA (Elliptic Curve Digital Signature Algorithm) á P-256 ferlinum frá NIST (US National Institute of Standards and Technology), sem kaupendur sem þurfa alríkisreiknirit Bandaríkjanna óska eftir. Báðar eru gerðar yfir sömu bætin og báðar verða að sannreynast. Skjal þar sem annan helminginn vantar, eða annar hvor helmingurinn er rangur, telst alls ekkert leyfi.

Undirrituðu bætin eru RFC 8785 staðalform (canonical form) skjalsins þar sem signatures hefur verið fjarlægt, þannig að bil og röð staka í skránni þinni skipta engu máli. Einn breyttur stafur í nafni leyfishafa, dagsetningum eða heimild þýðir að um annað skjal er að ræða og það fellur á prófinu.

Dreifilyklarnir sem athugunin notar eru í skrá með traustrótum (trust-roots) sem er innbyggð í hverja mynd við útgáfusmíði. Engin umhverfisbreyta, flagg eða tengipunktur (mount) vísar í aðra skrá. Þegar Adverant skiptir út undirritunarlykli, undirritar gamli lykillinn þann nýja og næsta undirritaða útgáfa inniheldur nýja lykilinn. Leyfi sem er undirritað með nýjum lykli sannreynist á útgáfu sem inniheldur hann, þannig að eftir lyklaskipti gætir þú þurft að uppfæra áður en þú flytur inn (sjá kafla 2.17, Vandamálaleit).

Tegundir, útgáfur og hvernig leyfi er talið

Svæðið type segir til um hvers konar samning leyfið kemur úr:

  • alpha: leyfi fyrir alfa-útgáfurásina, sem er sú tegund sem Harrow er með.
  • evaluation: sjálfhýst prufuleyfi fyrir Enterprise. Það gildir í mesta lagi í 30 daga, fyrir að hámarki 5 nafngreinda einstaklinga (mælikvarði named-seat), þar sem grace_days er stillt á 0. Sniðið hafnar prufuleyfi sem hefur einhvern greiðslufrest (grace period).
  • commercial: samningsbundið leyfi.

Svæðið metric skráir hvernig leyfið er talið: per-environment (rekstrarklasi Harrow er eitt umhverfi), per-core eða named-seat. Adverant gefur upp verðið; leyfið ber aðeins með sér mælieininguna og magnið.

Svæðið edition í leyfinu er enterprise fyrir hverja Enterprise-uppsetningu. Sniðið tekur einnig við team, þar sem leyfið veitir hópinn team og aldrei enterprise-base.

Eiginleikahópar, viðbætur og sviðspakkar

Það sem leyfi gerir fólki kleift að nota er listað eftir eiginleikahópum með auðkennum úr útgáfufylkinu. Leyfi Harrow veitir enterprise-base (sérsniðin hlutverk, fjögurra augna samþykktir, langtímavarðveisla endurskoðunarskráa, fyrirtækisinskráning með framfylgd og möppusamstillingu, rekstrareiningar, rekstrarsíður og afganginn af Enterprise-grunninum) og map-and-geoai. Það inniheldur viðbótina mail og fagsviðspakkann logistics-and-maritime.

Fylkið hefur reglur um hvað fer saman og útgáfukerfi Adverant athugar þær áður en leyfi er undirritað. Hver viðbót og hver pakki krefst enterprise-base. Sumir pakkar þurfa viðbætur: Flutninga- og siglingapakkinn (Logistics and maritime) þarf Kort og GeoAI (Map and GeoAI), Tryggingapakkinn (Insurance) og Fjármagnsmarkaðs- og eignastýringarpakkinn (Capital markets and asset management) þurfa Ákvörðunarherbergi og innsiglaðar skrár (Decision rooms and sealed records), og Lögfræði- og sérfræðiþjónustupakkinn (Legal and professional services) þarf Ákvörðunarherbergi og Póst (Mail). Símskjáir hvers pakka þurfa einnig Farsímaforrita-viðbótina (Mobile apps add-on).

Hver heimild hefur gildissvið:

  • deployment: hópurinn gildir fyrir alla uppsetninguna, fyrir hverja stofnun á henni.
  • tenant: hópurinn gildir aðeins fyrir þær stofnanir sem taldar eru upp í scope.tenants. Leyfi með heimild sem bundin er við leigjanda verður að tilgreina að minnsta kosti eina stofnun, og lista yfir stofnanir án heimildar sem bundin er við leigjanda er hafnað.

Segjum sem svo að hafnsöguteymi Harrow væri rekið sem önnur stofnun á sömu uppsetningu og aðeins sú stofnun ætti að hafa Hugmyndir (Ideas). Heimildin myndi þá vera { "feature_group": "ideas", "scope": "tenant" }, með auðkenni hafnsögustofnunarinnar í scope.tenants. Ef leyfið væri flutt inn áður en sú stofnun yrði til, myndi svarið við innflutningnum telja hana undir tenants_without_organisation, og heimildin myndi ná til hennar um leið og stofnunin væri búin til.

Kerfisstjóri getur þrengt það sem hópur nær til. Aðeins leyfi frá Adverant bætir við hópi.

Leyfi og hvað það opnar
Leyfi og hvað það opnar
Leyfissíðan listar hvern eiginleikahóp ásamt því hvernig hann er varinn og hvað hann nær yfir. Hópar sem leyfið inniheldur ekki haldast á listanum, óvirkir (gráir), svo fólk geti séð hvað er til.

Gildistíminn: viðvörun og greiðslufrestur

Svæðið term setur fjórar dagsetningar á dagatalið. Frá starts_on til ends_on er leyfið í gildi. warn_days segir til um hversu snemma viðvörunin hefst og grace_days hversu lengi allt heldur áfram að virka eftir lokadag. Leyfi sem Adverant gefur út innihalda 30 daga af hvoru um sig nema samningurinn kveði á um annað. Prufuleyfi hefur alltaf grace_days sem 0.

Fyrir leyfi Harrow hér að ofan lítur dagatalið svona út:

Dagsetningar Staða
1. janúar 2027 til 1. desember 2027 VALID
2. desember 2027 til 31. desember 2027 WARN
1. janúar 2028 til 30. janúar 2028 GRACE
Frá 31. janúar 2028 RESTRICT

Síðasti dagur gildistímans, ends_on, er enn WARN-dagur. Dagurinn þar á eftir er GRACE, eða RESTRICT þegar enginn frestur er til staðar.

Stöðurnar sex

Í hvert skipti sem leyfið er lesið endurreiknar uppsetningin stöðu sína út frá skjalinu og núverandi dagsetningu. Ekkert er geymt í skyndiminni fram yfir dagamörk, þannig að leyfi rennur út á réttum tíma án þess að þörf sé á tímasettu verki.

Staða Hvenær Hvað fólk getur gert
ABSENT Ekkert leyfi flutt inn, eða skjalinu var hafnað Community-grunnurinn. Enterprise-svæði birtast sem kynningar (teasers) með upplýsingum um hver getur kveikt á þeim.
VALID starts_on til ends_on mínus warn_days Hver veittur hópur er virkur.
WARN Síðustu warn_days dagar gildistímans Virkt, og kerfisstjórar sjá borða í kerfinu með lokadagsetningunni.
GRACE Eftir ends_on, í grace_days daga Virkt, með tilkynningunni LICENCE_IN_GRACE á Í dag (Today) og á leyfissíðunni.
RESTRICT Eftir frestinn Engin ný vinna getur hafist undir leyfisskyldum hópi. Vinna sem er í gangi klárast, lestur og útflutningur gagna virka áfram og öryggisuppfærslur halda áfram að berast.
TERMINATE Adverant afturkallaði leyfið Hætt er að bjóða upp á Enterprise-einingar. Community-grunnurinn og gagnaútflutningur haldast.

Í öllum stöðum heldur vinna sem er í gangi áfram að keyra, öryggisuppfærslur halda áfram að berast, útflutt gögn eru áfram læsileg og engu er eytt. Í RESTRICT sér sá sem reynir að hefja nýja Enterprise-vinnu höfnunarspjald með kóðanum LICENCE_LOCKED og nafni þess sem getur endurnýjað.

Lárétt tímalína með fimm svæðum frá vinstri til hægri: VALID (frá starts_on), WARN (síðustu warn_days gildistímans), GRACE (grace_days eftir ends_on), RESTRICT (eftir frestinn). Undir svæðunum eru þrjú merkt tákn: starts_on, ends_on og ends_on + grace_days. Aðskilinn kassi fyrir neðan tímalínuna, tengdur með brotinni ör frá hvaða svæði sem er, er merktur TERMINATE (undirritaður afturköllunarlisti nefnir leyfið). Annar kassi lengst til vinstri, utan tímalínunnar, er merktur ABSENT (ekkert leyfi, eða leyfi sem var hafnað: Community-grunnurinn).
Stöður leyfisins eftir dagatalinu.

Hvernig núverandi dagsetning er fundin út

Klukka getur verið röng og hægt er að færa klukku aftur á bak viljandi. Þess vegna les uppsetningin aldrei á klukkuna eina og sér. Núverandi dagsetning er sú síðari af tveimur tímasetningum: veggklukkunni og geymdu lágmarki (floor), sem er síðasta tímasetning sem uppsetningin hefur séð. Lágmarkið færist fram við hvern innflutning og hvern stöðulestur, og það færist aldrei aftur á bak af sjálfu sér. Að færa klukkuna aftur um mánuð kemur útrunnu leyfi ekki aftur í VALID; RESTRICT-leyfi helst RESTRICT.

Þegar klukkan sýnir tíma sem er á undan lágmarkinu ber staðan tilkynninguna LICENCE_CLOCK_BEHIND_FLOOR og er lesin miðað við dagsetningu lágmarksins. Ef klukkan hljóp raunverulega á undan sér (hnútur ræstist með rangri dagsetningu og lágmarkið færðist fram), skaltu biðja Adverant um tímaendurstillingartákn (time-reset token). Það er lítið undirritað skjal sem er bundið við auðkenni uppsetningarinnar þinnar og einnota slembitölu (nonce), með floor_to tímasetningu. Þú flytur það inn í gegnum API með þessari beiðni:

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> er aðgangstákn kerfisstjóra uppsetningarinnar. Tákni er beitt þegar báðar undirskriftir sannreynast, auðkenni uppsetningarinnar er þitt og einnota slembitala þess hefur ekki verið notuð. Tákn sem er hafnað breytir engu, þannig að það er aldrei hægt að nota það til að hafna gildu leyfi. Tákni þar sem einnota slembitalan hefur þegar verið notuð er hafnað með LICENCE_CLOCK_BEHIND_FLOOR.

Beðið um leyfi

Beðið er um leyfi og þeim hlaðið niður af Adverant-reikningnum þínum á https://account.adverant.ai. Á síðunni Stofnana- og teymishlutverk (Organisation and team roles) á reikningnum er stillt hverjir í stofnuninni þinni mega skrá uppsetningar á sig og hlaða niður leyfum.

Adverant þarf að vita fyrir hvaða uppsetningu leyfið er, og það eru þrjár leiðir til að segja til um það.

Einnota kóði, fyrir uppsetningu með skjá. Uppsetningin sýnir einnota kóða og fingrafar sitt. Á síðunni Skrá uppsetningu (Claim a deployment) límir þú kóðann inn og berð síðan fingrafarið saman, hóp fyrir hóp, við það sem uppsetningin sýnir. Þegar allir hópar stemma skráir þú hana á stofnunina þína og leyfið berst inn á reikninginn.

Skráningarlykill, fyrir sérhæfðan búnað (appliance) eða jaðartæki. Þessi tæki hafa engan skjá til að sýna kóða. Raðnúmerið og skráningarlykill (claim key) eru prentuð á kassann og í pöntun búnaðarframleiðandans. Sláðu þau inn á síðunni Slá inn skráningarlykil (Enter a claim key) eitt í einu, eða slepptu pöntunarskrá framleiðandans þangað til að skrá mörg í einu. Hver lykill er borinn saman við skrá Adverant yfir það sem var sent til þín og lykli úr pöntun einhvers annars er hafnað.

Undirrituð leyfisbeiðni, fyrir uppsetningu án utanaðkomandi tengingar. Þetta er leiðin sem Harrow fer. Á uppsetningunni býr kerfisstjóri til beiðniskrá undir Þessi uppsetning, Leyfi (This installation, Licence). Það er yfirlýsing af gerðinni licence-request sem nefnir auðkenni uppsetningarinnar, undirrituð með eigin Ed25519-lykli uppsetningarinnar. Tomás ferjar hana út á samþykktum miðli, sleppir henni á síðuna Ónettengd skipti (Offline exchange) og hleður niður leyfisskránni sem kemur til baka. Leyfið virkar aðeins á uppsetningunni sem bjó til beiðnina.

Ótengd skipti
Ótengd skipti
Ónettengd skipti fyrir uppsetningu án utanaðkomandi tengingar. Hver skrá sem fer yfir bilið er undirrituð, þannig að skrá sem breytist á leiðinni er hafnað, og öll skipti eru skráð ásamt því hver framkvæmdi þau.
Tveir dálkar, sá vinstri er merktur „Harrow uppsetning (ekkert internet)“ og sá hægri er merktur „Adverant reikningur“. Efst til vinstri: reitur „Leyfisbeiðniskrá, undirrituð með uppsetningarlyklinum“. Ör merkt „flutt á gagnamiðli“ liggur yfir í reitinn „Síða fyrir ónettengd skipti“ í hægri dálknum. Fyrir neðan hann er reiturinn „Leyfisskrá, undirrituð með tveimur Adverant lyklum“. Ör merkt „flutt til baka á gagnamiðli“ liggur aftur yfir í reitinn „Innflutningur: stjórnborð, nexusctl eða API“ í vinstri dálknum, og þaðan niður í reitinn „Sannreynt í uppsetningunni gegn innbyggðum traustrótum“.
Hvernig leyfi berst til uppsetningar án utanaðkomandi tengingar.

Leyfi flutt inn

Það eru þrjár leiðir inn og þær ná allar í sama endapunkt á nexus-auth. Aðeins kerfisstjóri uppsetningar getur flutt inn: eigandi eða kerfisstjóri allrar stofnunarinnar sem á uppsetninguna, innskráður í hana, eða fullgildur kerfisstjóri umhverfisins (platform administrator). Öllum öðrum er hafnað áður en skráin er lesin.

Í stjórnborðinu

Á nýrri uppsetningu er Flytja inn leyfið (Import the licence) eitt af sex atriðum á Sex atriði áður en nokkur skráir sig inn (Six things before anyone signs in). Þegar þú sleppir skránni á síðuna athugar stjórnborðið hana á uppsetningunni, án nettengingar, og listar eiginleikahópa hennar ásamt því hvernig hver og einn er varinn og gildistímann.

Síðari innflutningur fer í gegnum Þessi uppsetning, Leyfi (This installation, Licence): notaðu Flytja inn nýtt leyfi (Import a new licence), eða Flytja inn endurnýjað leyfi (Import a renewed licence) þegar það núverandi er útrunnið. Community-uppsetning sem færist yfir í Enterprise notar Frá Community yfir í Enterprise (From Community to Enterprise). Sú síða les leyfið fyrst og sýnir hvað verður sótt og hvað breytist, áður en nokkuð gerist. Ekkert er sótt fyrr en einhver velur Sækja og kveikja á (Fetch and switch on). Enterprise-hlutarnir koma þá frá registry.adverant.ai með niðurhalstákni (pull token) uppsetningarinnar, hver og einn er sannreyndur gegn útgáfulykli Adverant og það kviknar á hópunum einum í einu. Þetta er sama uppsetningin á eftir, með sama fólkinu, skránum, verkferlunum og rásunum.

Flytja inn leyfið
Flytja inn leyfið
Leyfið flutt inn við uppsetningu. Ósvikna skráin listar eiginleikahópa sína; afrit með tveimur breyttum línum er sýnt sem fjarverandi (absent) með kóðanum LICENCE_SIGNATURE_INVALID, og leyfið sem þegar er í gildi er látið í friði.
Frá Community yfir í Enterprise
Frá Community yfir í Enterprise
Community-uppsetning færð yfir í Enterprise. Leyfið hefur verið lesið og reynst ósvikið, og síðan listar hlutana sem á að sækja og hvað breytist áður en nokkur ýtir á Sækja og kveikja á (Fetch and switch on).

Með nexusctl

nexusctl licence import harrow-2027.licence.json

Skipunin flytur skrána inn óbreytta og prentar núverandi stöðu leyfisins. Bættu við --explain til að prenta aðgerðirnar sem hún myndi keyra án þess að keyra þær.

Í gegnum 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

Sendu skrána nákvæmlega eins og Adverant afhenti þér hana. Ekki endursníða hana og ekki pakka henni inn í annan hlut: meginmálið (body) er skjalið. Leiðin tekur engan fyrirspurnarstreng (query string) og meginmáli sem er stærra en 1 MiB er hafnað. Staki á efsta stigi sem nefnir stofnun eða einstakling er hafnað með TENANT_NOT_A_PARAMETER eða ACTOR_NOT_A_PARAMETER, vegna þess að leyfi uppsetningarinnar tilheyrir uppsetningunni sem stofnun táknsins á.

Gildur innflutningur svarar með 201. Meginmálið inniheldur leyfissýnina (auðkenni þess, núverandi stöðu, leyfishafa, útgáfu, gildistíma, heimildir og eiginleikahópa), hversu margar stofnanir hafa það núna, og hversu margir skráðir leigjendur eiga enga stofnun ennþá. Leyfið, SHA-256 summa þess og færslulínur (ledger rows) fyrir hverja stofnun eru skrifaðar í einni færslu (transaction) og innflutningurinn er skráður í endurskoðunarskrána.

Tvær lestrarleiðir fylgja með því:

  • GET /api/v1/installation/licence/state svarar með stöðunni, sem er endurreiknuð við hvern lestur. Kerfisstjóri fær alla sýnina. Allir aðrir meðlimir stofnunar á uppsetningunni fá aðeins tilkynninguna: stöðuna, tilkynningarkóðann (LICENCE_ENDS_SOON, LICENCE_IN_GRACE eða LICENCE_CLOCK_BEHIND_FLOOR) og dagsetningarnar sem tilkynningin nefnir. Meðlimur sér aldrei leyfishafann, gildistímann eða hópana, vegna þess að þær upplýsingar tilheyra eiganda uppsetningarinnar.
  • GET /api/v1/installation/licence/document svarar með innflutta skjalinu, hráu, fyrir kerfisstjóra. Hver Enterprise-eining sækir það og athugar undirskriftirnar aftur með sinni eigin innbyggðu sannreynslueiningu, þannig að breytt auðkenningarþjónusta getur ekki kveikt á hópi sem leyfið veitir ekki.

Hver höfnun

Innflutningur sem er hafnað breytir engu, ekki einu sinni lágmarki klukkunnar, og höfnunin er skráð í endurskoðunarskrána.

Kóði HTTP Merking Hvað skal gera
LICENCE_FORMAT_INVALID 422 Skráin er ekki leyfi sem þessi útgáfa getur lesið: ekki JSON, ekki skemað, dagsetningar í rangri röð eða hópur nefndur tvisvar. Sendu skrána nákvæmlega eins og Adverant afhenti þér hana.
LICENCE_SIGNATURE_INVALID 422 Aðra af undirskriftunum tveimur vantar, eða skránni var breytt eftir undirritun. Biddu Adverant um skrána aftur og ekki breyta henni.
LICENCE_ROOT_UNKNOWN 422 Það er undirritað með lykli sem traustrótaskrá þessarar útgáfu inniheldur ekki. Biddu um leyfi sem er undirritað fyrir rætur þessarar útgáfu, eða uppfærðu.
LICENCE_MATRIX_MISMATCH 422 Það er skrifað gegn útgáfufylki sem þessi útgáfa les ekki, eða veitir hóp sem vörulisti útgáfunnar þekkir ekki. Uppfærðu í útgáfu sem les það, eða biddu um leyfi sem er skrifað gegn þessari útgáfu.
LICENCE_OTHER_INSTALLATION 409 Það var gefið út fyrir annað uppsetningarauðkenni. Biddu um leyfi fyrir auðkenni þessarar uppsetningar.
LICENCE_REVOKED 403 Adverant hefur afturkallað þetta leyfi. Biddu Adverant um nýtt leyfi.
LICENCE_LOCKED 403 Leyfið hefur ekki tekið gildi: núverandi dagsetning er á undan starts_on. Flyttu það inn aftur á fyrsta gildisdegi þess eða síðar.
TRANSITION_NOT_PERMITTED 409 Leyfi með þessu auðkenni hefur þegar verið flutt inn. Biddu Adverant um nýtt leyfi ef skilmálarnir þurfa að breytast.
RECORD_NOT_FOUND 404 Uppsetningin hefur ekki verið skilgreind ennþá, þannig að hún hefur ekkert auðkenni til að bera saman við. Ljúktu við fyrsta skref kerfisstjóra og flyttu svo inn.
VALIDATION_FAILED 400 Ekki tókst að lesa meginmálið, það er yfir 1 MiB, eða beiðnin var með fyrirspurnarstreng. Sendu skrána eina og sér sem meginmál, án fyrirspurnar.

Uppsetningin framkvæmir athuganir í fastri röð og fyrsta villan ákvarðar kóðann. Tilkynnt er um helming sem vantar áður en athugað er með óþekktan lykil, og skjal þar sem undirskriftir standast ekki er aldrei lesið lengra, þannig að átt hefur verið við skrá sem einnig nefnir aðra uppsetningu svarar samt með LICENCE_SIGNATURE_INVALID.

Endurnýjun

Endurnýjun er nýtt leyfi með nýju licence_id. Flyttu það inn á sama hátt og það fyrsta. Það tekur gildi samstundis, óháð því hvaða stöðu gamla leyfið var komið í: úr WARN, GRACE eða RESTRICT fer uppsetningin beint aftur í leyfisbundið ástand og ekkert þarf að setja upp aftur. Adverant getur einnig gefið út breytt leyfi á miðju tímabili, til dæmis til að bæta við Ákvörðunarherbergjum (Decision rooms), og þú flytur það inn á sama hátt.

Ef sama leyfið er flutt inn tvisvar er því hafnað með TRANSITION_NOT_PERMITTED.

Afturköllun

Adverant dregur leyfi til baka með því að undirrita afturköllunarlista. Listinn hefur sequence númer og tilgreinir hvert afturkallað leyfisauðkenni ásamt því hvenær og hvers vegna. Listar eru uppsafnaðir: hver og einn inniheldur öll auðkenni sem hafa verið afturkölluð á undan honum. Þú flytur hann inn á sama hátt og leyfi:

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

Lista þar sem raðnúmerið er ekki hærra en á þeim sem síðast var fluttur inn er hafnað með TRANSITION_NOT_PERMITTED, þannig að ekki er hægt að setja gamlan lista inn í stað nýrri. Lista sem ekki er hægt að lesa eða sannreyna er hafnað með sömu kóðum og leyfi. Um leið og listi nefnir leyfið þitt verður staða þess TERMINATE.

Uppsetning án utanaðkomandi tengingar fréttir aðeins af afturköllun þegar einhver flytur listann inn. Fyrir Harrow er afturköllun jafn mikið samningsatriði og hugbúnaðaratriði, og Tomás flytur inn hvern lista sem Adverant sendir við næstu ferð yfir bilið.

Sæti umfram leyfið

Magn leyfisins er loforð um notkun og Nexus lítur á það sem viðvörun ef farið er fram úr því, aldrei sem útilokun (lock-out). Þegar fleiri nota Nexus en leyfið nær yfir sjá kerfisstjórar spjaldið SEATS_OVER_LICENCE á síðunni Fólk (People). Allir halda áfram að vinna. Spjaldið segir til um hvenær eigi að kippa þessu í liðinn (30 dagar), sýnir hvaðan aukafólkið kom og býður upp á tvær lausnir: fjarlægja fólk sem þarf ekki Nexus, eða biðja Adverant um fleiri sæti. Að bæta við sætum er viðkvæm breyting sem krefst annars aðila, og aukasætin eru talin með í árlegu notkunaryfirlitinu.

Sæti umfram leyfi
Sæti umfram leyfi
Fleira fólk en sæti. Möppusamstilling bætti við 143 verktökum og spjaldið gefur 30 daga til að fjarlægja fólk eða bæta við sætum án þess að nokkur sé útilokaður.

Notkunaryfirlitið inniheldur aðeins teljara og þú getur lesið hverja línu áður en það fer út. Harrow vistar það sem skrá og ferjar það út í gegnum ónettengdu skiptin.

Prófanir

Prufuleyfi er leyfi af gerðinni evaluation, sem ræst er af síðunni Prufuáskriftir (Trials) á reikningnum fyrir skráða uppsetningu. Það varir í mesta lagi í 30 daga, nær til að hámarki 5 nafngreindra einstaklinga og hefur engan frest. Daginn eftir ends_on fer það beint í RESTRICT: Enterprise-svæði breytast aftur í kynningar (teasers) og engu sem búið var til á prufutímanum er eytt. Hugmyndakeyrslur, drög að stefnum og póstreglur eru varðveittar nákvæmlega eins og þær voru, og þær opnast aftur um leið og leyfi er flutt inn.

Stofnun keyrir eitt sjálfhýst prufuleyfi í einu.