PieteiktiesPieteikt konsultāciju

2.13. nodaļa

Licences

Ko satur Nexus licences fails, kā instalācija to pārbauda bezsaistē, seši iespējamie tā stāvokļi un kā to pieprasīt, importēt, atjaunot un atsaukt.

Šo lapu no oriģināla angļu valodā ir tulkojis MI. Neskaidrību gadījumā par pamatu jāņem lapa angļu valodā. Lasīt šo lapu angļu valodā

19 minūšu lasīšana

Harrow Port Authority darbina Nexus Enterprise savā Kubernetes klasterī vietnē harrow.example bez maršruta no klastera uz internetu. Katru gadu IT vadītāja Aoife Brennan atjauno līgumu, un platformas inženieris Tomás Reilly pārnes nelielu JSON failu pāri izolētajai videi un to importē. Nekas netiek pārstartēts, un licences lapā tiek rādīts jauns beigu datums.

Šī nodaļa ir par šo failu. Īsumā: licence ir viens parakstīts JSON dokuments, kas piesaistīts vienai instalācijai. Instalācija pati to pārbauda ar attēlā iestrādātajām publiskajām atslēgām un šim nolūkam neveic nekādus tīkla izsaukumus. Licence nekad nav Helm vērtība un nekad nav piemontēts fails. Jūs to importējat caur konsoli, nexusctl vai lietojumprogrammu saskarni (API), un nekur citur.

Licences dokuments

Licence ir viens JSON objekts formātā nexus-licence/v1. Šeit ir Harrow licence ar divām saīsinātām paraksta vērtībām.

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

Katrs lauks ir obligāts, un katrs objekts dokumentā ir slēgts. Elements, kas formātā nav uzskaitīts, tiek noraidīts, tāpēc nekas nevar tikt pievienots ārpus paraksta.

Lauks Ko tas satur
format Tieši nexus-licence/v1. Jebkura cita vērtība, tostarp jaunāka versija, tiek noraidīts.
licence_id Mazo burtu UUID (universāli unikāls identifikators). Instalācija katru licences id importē vienu reizi.
issued_at Brīdis, kad Adverant to izsniedza, kā YYYY-MM-DDThh:mm:ssZ.
type alpha, evaluation vai commercial.
channel Izlaidumu kanāls, kuram tā tika izsniegta, piemēram, alpha. Parakstīts un iekļauts; pārbaude no tā nav atkarīga.
licensee.name No 1 līdz 200 rakstzīmēm, parakstīts tieši tā, kā uzrakstīts. Brennan un Brennán ir divi dažādi nosaukumi ar diviem dažādiem parakstiem.
licensee.customer_id Jūsu klienta id uzņēmumā Adverant: mazie burti, cipari, ., _ un -.
scope.deployment.installation_id Instalācijas identitāte, ko pirmās instalēšanas laikā izveido tās atslēgu serviss.
scope.tenants Organizāciju ID, līdz 1000. Tukšs, ja vien kāda piešķīruma tvērums nav ierobežots ar nomnieku.
edition enterprise vai team. Enterprise licence vienmēr piešķir enterprise-base.
grants No 1 līdz 500 {feature_group, scope} pāriem, katra grupa nosaukta vienu reizi.
add_ons Papildinājumu id no izdevumu matricas, līdz 100. Var būt tukšs.
domain_packs Domēnu pakešu id no izdevumu matricas, līdz 100. Var būt tukšs.
metric kind ir per-environment, per-core vai named-seat; quantity ir vesels skaitlis, sākot no 1.
term starts_on un ends_on ir datumi; warn_days un grace_days ir veseli skaitļi no 0 līdz 365.
matrix Izdevumu matricas versija, atbilstoši kurai grupas ir izveidotas, un šī matricas faila SHA-256, kas tiek glabāts revīzijas nolūkos.
signatures Divi paraksti, ed25519 un p256. Vienīgais lauks, kas nav parakstīts.

Datumi ir kalendārie datumi UTC laika joslā, un dienai ir jāpastāv: 2028-02-29 ir derīgs, bet 2027-02-29 tiek noraidīts.

Divi paraksti, abi obligāti

Adverant paraksta katru licenci ar divām neatkarīgām atslēgām. Viens paraksts ir Ed25519. Otrs ir ECDSA (eliptisko līkņu digitālā paraksta algoritms) uz P-256 līknes no NIST (ASV Nacionālā standartu un tehnoloģiju institūta), ko pieprasa pircēji, kuriem nepieciešami ASV federālie algoritmi. Abi tiek izveidoti virs tiem pašiem baitiem, un abiem ir jāiziet pārbaude. Dokuments, kuram trūkst vienas puses vai kura jebkura puse ir nepareiza, tiek uzskatīts par pilnīgi nederīgu licenci.

Parakstītie baiti ir dokumenta RFC 8785 kanoniskā forma ar izņemtu signatures, tāpēc atstarpēm un elementu secībai jūsu failā nav nozīmes. Viena izmainīta rakstzīme licenciāta nosaukumā, datumos vai piešķīrumā padara to par citu dokumentu, un pārbaude neizdodas.

Publiskās atslēgas, ko izmanto pārbaudei, atrodas uzticamības sakņu failā, kas iestrādāts katrā attēlā izlaiduma būvēšanas laikā. Neviens vides mainīgais, karodziņš vai montējums nenorāda uz citu failu. Kad Adverant nomaina parakstīšanas atslēgu, vecā atslēga paraksta jauno, un nākamais parakstītais izlaidums satur jauno atslēgu. Ar jauno atslēgu parakstīta licence ir derīga izlaidumā, kurā šī atslēga ir iekļauta, tāpēc pēc atslēgas maiņas jums, iespējams, būs jāveic jaunināšana pirms importēšanas (skatiet 2.17. nodaļu, Problēmu novēršana).

Veidi, izdevumi un licenču uzskaite

Lauks type norāda, no kāda veida līguma izriet licence:

  • alpha: licence alfa izlaidumu kanālam; tieši šāda licence ir Harrow.
  • evaluation: pašmitināts Enterprise izmēģinājums. Tas darbojas ne ilgāk kā 30 dienas, ne vairāk kā 5 konkrētiem lietotājiem (metrika named-seat), ar grace_days iestatītu uz 0. Formāts noraida jebkuru izmēģinājuma versiju, kurai ir kaut mazākais labvēlības periods.
  • commercial: līgumiska licence.

Lauks metric reģistrē, kā licence tiek uzskaitīta: per-environment (Harrow produkcijas klasteris ir viena vide), per-core vai named-seat. Adverant nosaka cenu; licence satur tikai mērvienību un daudzumu.

Licences edition ir enterprise katrai Enterprise instalācijai. Formāts pieņem arī team, kur licence piešķir grupu team un nekad enterprise-base.

Līdzekļu grupas, papildinājumi un nozaru pakotnes

Tas, ko licence ļauj cilvēkiem izmantot, ir uzskaitīts pa funkciju grupām, izmantojot izdevumu matricas id. Harrow licence piešķir enterprise-base (pielāgotas lomas, četru acu principa apstiprinājumus, ilgu revīzijas datu glabāšanu, uzņēmuma pierakstīšanos ar piespiedu izpildi un direktoriju sinhronizāciju, struktūrvienības, operatora lapas un pārējo Enterprise bāzi) un map-and-geoai. Tajā ir iekļauts papildinājums mail un domēna pakete logistics-and-maritime.

Matricā ir noteikumi par to, kas ir savstarpēji saderīgs, un Adverant izsniegšanas sistēma tos pārbauda pirms licences parakstīšanas. Katram papildinājumam un katrai paketei ir nepieciešams enterprise-base. Dažām paketēm ir nepieciešami papildinājumi: Loģistikas un jūrniecības paketei ir nepieciešams Map un GeoAI, Apdrošināšanas paketei un Kapitāla tirgu un aktīvu pārvaldības paketei ir nepieciešams Decision rooms un aizzīmogotie ieraksti, savukārt Juridisko un profesionālo pakalpojumu paketei ir nepieciešams Decision rooms un Mail. Katras paketes tālruņa ekrāniem ir nepieciešams arī papildinājums Mobile apps.

Katram piešķīrumam ir tvērums:

  • deployment: grupa attiecas uz visu instalāciju, uz katru tajā esošo organizāciju.
  • tenant: grupa attiecas tikai uz organizācijām, kas uzskaitītas scope.tenants. Licencē ar nomnieka tvēruma piešķīrumu ir jābūt uzskaitītai vismaz vienai organizācijai, un organizāciju saraksts bez neviena nomnieka tvēruma piešķīruma tiek noraidīts.

Pieņemsim, ka Harrow loču komanda darbotos kā otra organizācija tajā pašā instalācijā un tikai šai organizācijai būtu pieejams Ideas. Piešķīrums būtu { "feature_group": "ideas", "scope": "tenant" } ar loču organizācijas id laukā scope.tenants. Ja licence tiktu importēta pirms šīs organizācijas izveides, importēšanas atbildē tā tiktu pieskaitīta pie tenants_without_organisation, un piešķīrums to sasniegtu, tiklīdz organizācija tiktu izveidota.

Administrators var sašaurināt grupas tvērumu. Grupu var pievienot tikai licence no Adverant.

Licence un tas, ko tā atbloķē
Licence un tas, ko tā atbloķē
Licences lapā ir uzskaitīta katra funkciju grupa, norādot, kā tā ir aizsargāta un ko tā ietver. Grupas, kuras licence neietver, paliek sarakstā pelēkotas, lai cilvēki varētu redzēt, kas vispār pastāv.

Termiņš: brīdinājuma un labvēlības periods

Lauks term kalendārā nosaka četrus datumus. No starts_on līdz ends_on licence ir spēkā. warn_days nosaka, cik agri sākas brīdinājums, un grace_days nosaka, cik ilgi viss turpina darboties pēc termiņa beigām. Adverant izsniegtajās licencēs katram no šiem periodiem ir atvēlētas 30 dienas, ja vien līgumā nav noteikts citādi. Izmēģinājuma versijai grace_days vienmēr ir 0.

Iepriekš minētajai Harrow licencei kalendārs izskatās šādi:

Datumi Stāvoklis
No 2027. gada 1. janvāra līdz 2027. gada 1. decembrim VALID
No 2027. gada 2. decembra līdz 2027. gada 31. decembrim WARN
No 2028. gada 1. janvāra līdz 2028. gada 30. janvārim GRACE
No 2028. gada 31. janvāra RESTRICT

Termiņa pēdējā diena, ends_on, joprojām ir WARN diena. Nākamā diena pēc tās ir GRACE vai RESTRICT, ja labvēlības perioda nav.

Seši stāvokļi

Katru reizi, kad licence tiek nolasīta, instalācija pārrēķina tās statusu no dokumenta un pašreizējā datuma. Nekas netiek saglabāts kešatmiņā ilgāk par dienas robežu, tāpēc derīguma termiņa beigas iestājas laikā bez ieplānota uzdevuma.

Stāvoklis Kad Ko lietotāji var darīt
ABSENT Licence nav importēta vai dokuments tika noraidīts Community bāzes līmenis. Enterprise sadaļas tiek rādītas kā priekšskatījumi ar informāciju par to, kurš var tās ieslēgt.
VALID No starts_on līdz ends_on mīnus warn_days Katra piešķirtā grupa ir pieejama.
WARN Termiņa pēdējās warn_days dienas Pieejama, un administratori produktā redz reklāmkarogu ar beigu datumu.
GRACE Pēc ends_on, grace_days dienas Pieejama, ar paziņojumu LICENCE_IN_GRACE sadaļā Today un licences lapā.
RESTRICT Pēc labvēlības perioda Licencētas grupas ietvaros nevar sākt jaunu darbu.iesāktie darbi tiek pabeigti, lasīšana un eksportēšana turpina darboties, un drošības labojumi turpina pienākt.
TERMINATE Adverant atsauca licenci Enterprise artefakti vairs netiek piedāvāti. Paliek Community bāzes līmenis un datu eksportēšana.

Jebkurā statusā iesāktie darbi turpina darboties, drošības labojumi turpina pienākt, eksportētie dati paliek lasāmi un nekas netiek dzēsts. Statusā RESTRICT lietotājs, kurš mēģina sākt jaunu Enterprise darbu, redz noraidījuma paziņojumu ar kodu LICENCE_LOCKED un tās personas vārdu, kura var atjaunot licenci.

Horizontāla laika skala ar piecām joslām no kreisās uz labo pusi: VALID (no starts_on), WARN (termiņa pēdējās warn_days), GRACE (grace_days pēc ends_on), RESTRICT (pēc labvēlības perioda). Zem joslām ir trīs marķieri ar uzrakstiem: starts_on, ends_on un ends_on + grace_days. Atsevišķam lodziņam zem laika skalas, kas ar pārtrauktu bultiņu savienots ar jebkuru joslu, ir uzraksts TERMINATE (parakstītā atsaukumu sarakstā ir norādīta licence). Otram lodziņam kreisajā malā, ārpus laika skalas, ir uzraksts ABSENT (nav licences vai tā ir noraidīta: Community bāzes līmenis).
Licences statusi kalendāra griezumā.

Kā tiek noteikts pašreizējais datums

Pulkstenis var būt nepareizs, un pulksteni var pagriezt atpakaļ ar nolūku. Tāpēc instalācija nekad nenolasa tikai pulksteni. Pašreizējais datums ir vēlākais no diviem laika brīžiem: sistēmas pulksteņa un saglabātās apakšējās robežas, kas ir pēdējais laika brīdis, ko instalācija ir redzējusi. Apakšējā robeža virzās uz priekšu katrā importēšanas un katrā statusa nolasīšanas reizē, un tā nekad pati no sevis nevirzās atpakaļ. Pulksteņa pagriešana par mēnesi atpakaļ neatgriež licenci ar beigušos termiņu statusā VALID; RESTRICT licence paliek RESTRICT.

Kad pulkstenis rāda agrāku laiku nekā apakšējā robeža, statuss satur paziņojumu LICENCE_CLOCK_BEHIND_FLOOR un tiek nolasīts atbilstoši apakšējās robežas dienai. Ja pulkstenis patiešām ir aizskrējis uz priekšu (mezgls tika palaists ar nepareizu datumu un apakšējā robeža tika pārcelta uz priekšu), palūdziet Adverant laika atiestatīšanas marķieri. Tas ir neliels parakstīts dokuments, kas piesaistīts jūsu instalācijas id un vienreizējam nonce kodam, ar floor_to laika brīdi. Jūs to importējat caur API ar šādu pieprasījumu:

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> ir instalācijas administratora piekļuves marķieris. Marķieris tiek lietots, kad abi paraksti ir verificēti, tā instalācijas id atbilst jūsējam un tā nonce kods vēl nav izmantots. Noraidīts marķieris neko nemaina, tāpēc to nekad nevar izmantot, lai noraidītu derīgu licenci. Marķieris, kura nonce kods jau ir izmantots, tiek noraidīts ar LICENCE_CLOCK_BEHIND_FLOOR.

Licences pieprasīšana

Licences tiek pieprasītas un lejupielādētas no jūsu Adverant konta vietnē https://account.adverant.ai. Tas, kurš jūsu organizācijā drīkst pieprasīt izvietojumus un lejupielādēt licences, tiek iestatīts konta lapā Organisation and team roles.

Adverant ir jāzina, kurai instalācijai licence ir paredzēta, un ir trīs veidi, kā to paziņot.

Vienreizējs kods instalācijai ar ekrānu. Instalācija parāda vienreizēju kodu un tās kontrolsummu (fingerprint). Lapā Claim a deployment jūs ielīmējat kodu un pēc tam salīdzināt kontrolsummu grupu pa grupai ar to, ko rāda instalācija. Kad katra grupa sakrīt, jūs to pieprasāt savai organizācijai, un licence nonāk kontā.

Pieprasīšanas atslēga iekārtai vai perifērijas ierīcei. Šīm ierīcēm nav ekrāna, kurā parādīt kodu. Sērijas numurs un pieprasīšanas atslēga ir uzdrukāti uz kastes un aprīkojuma ražotāja pasūtījumā. Ievadiet tos lapā Enter a claim key pa vienam vai ievelciet ražotāja pasūtījuma failu, lai pieprasītu daudzas ierīces vienlaikus. Katra atslēga tiek salīdzināta ar Adverant ierakstu par to, kas jums tika nosūtīts, un atslēga no cita pasūtījuma tiek noraidīta.

Parakstīts licences pieprasījums instalācijai bez ārējā savienojuma. Šis ir Harrow ceļš. Instalācijā administrators izveido pieprasījuma failu sadaļā This installation, Licence. Tas ir paziņojums ar tipu licence-request, kurā norādīts instalācijas id un kurš parakstīts ar pašas instalācijas Ed25519 atslēgu. Tomás to iznes apstiprinātā datu nesējā, ievelk lapā Offline exchange un lejupielādē saņemto licences failu. Licence darbojas tikai tajā instalācijā, kura izveidoja pieprasījumu.

Bezsaistes apmaiņa
Bezsaistes apmaiņa
Bezsaistes apmaiņa instalācijai bez ārējā savienojuma. Katrs fails, kas šķērso izolēto vidi, ir parakstīts, tāpēc pa ceļam izmainīts fails tiek noraidīts, un katra apmaiņa tiek reģistrēta kopā ar informāciju par to, kurš to veica.
Divas kolonnas, kreisā ar uzrakstu „Harrow instalācija (bez interneta)” un labā ar uzrakstu „Adverant konts”. Kreisajā pusē augšā: bloks „Licences pieprasījuma fails, parakstīts ar instalācijas atslēgu”. Bulta ar uzrakstu „pārnest datu nesējā” ved uz labās kolonnas bloku „Bezsaistes apmaiņas lapa”. Zem tā — bloks „Licences fails, parakstīts ar divām Adverant atslēgām”. Bulta ar uzrakstu „pārnest atpakaļ datu nesējā” ved atpakaļ uz kreisās kolonnas bloku „Importēšana: konsole, nexusctl vai API”, un no turienes uz leju uz bloku „Pārbaudīts instalācijā pret iebūvētajām uzticamības saknēm”.
Kā licence sasniedz instalāciju bez ārējā savienojuma.

Licences importēšana

Ir trīs ievades veidi, un tie visi sasniedz vienu un to pašu galapunktu servisā nexus-auth. Importēt var tikai instalācijas administrators: visas organizācijas, kurai pieder instalācija, īpašnieks vai administrators, kurš tajā ir pierakstījies, vai pilntiesīgs platformas administrators. Jebkurš cits tiek noraidīts pirms faila nolasīšanas.

Konsolē

Jaunā instalācijā Import the licence ir viena no sešām pārbaudēm lapā Six things before anyone signs in. Kad jūs ievelkat failu lapā, konsole to pārbauda instalācijā bezsaistē un uzskaita tās funkciju grupas, norādot, kā katra no tām ir aizsargāta, kā arī darbības termiņu.

Vēlāka importēšana notiek caur This installation, Licence: izmantojiet Import a new licence vai Import a renewed licence, kad pašreizējās licences termiņš ir beidzies. Community instalācija, kas pāriet uz Enterprise, izmanto From Community to Enterprise. Šī lapa vispirms nolasa licenci un parāda, kas tiks izgūts un kas mainīsies, pirms jebkas notiek. Nekas netiek izgūts, kamēr kāds neizvēlas Fetch and switch on. Pēc tam Enterprise daļas tiek iegūtas no registry.adverant.ai, izmantojot instalācijas izgūšanas marķieri, katra no tām tiek pārbaudīta pret Adverant izlaiduma atslēgu, un grupas tiek ieslēgtas pa vienai. Pēc tam tā ir tā pati instalācija ar tiem pašiem cilvēkiem, failiem, darbplūsmām un kanāliem.

Importēt licenci
Importēt licenci
Licences importēšana iestatīšanas laikā. Oriģinālais fails uzskaita savas funkciju grupas; kopija ar divām izmainītām rindiņām tiek rādīta kā neesoša ar kodu LICENCE_SIGNATURE_INVALID, un jau spēkā esošā licence netiek aiztikta.
No Community uz Enterprise
No Community uz Enterprise
Community instalācijas pārvietošana uz Enterprise. Licence ir nolasīta un atzīta par īstu, un lapā ir uzskaitītas daļas, kas jāizgūst, un tas, kas mainīsies, pirms kāds nospiež Fetch and switch on.

Ar nexusctl

nexusctl licence import harrow-2027.licence.json

Komanda importē failu nemainītu un izdrukā licences pašreizējo statusu. Pievienojiet --explain, lai izdrukātu darbības, kuras tā izpildītu, tās reāli neizpildot.

Caur 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

Nosūtiet failu tieši tādu, kādu Adverant jums to iedeva. Nepārformatējiet to un neietveriet to citā objektā: pamatteksts ir pats dokuments. Maršruts nepieņem vaicājuma virkni, un pamatteksts, kas pārsniedz 1 MiB, tiek noraidīts. Augšējā līmeņa elements, kas nosauc organizāciju vai personu, tiek noraidīts ar TENANT_NOT_A_PARAMETER vai ACTOR_NOT_A_PARAMETER, jo instalācijas licence pieder instalācijai, kuru pārvalda marķiera organizācija.

Veiksmīga importēšana atbild ar 201. Pamattekstā ir iekļauts licences skats (tās id, pašreizējais statuss, licenciāts, izdevums, termiņš, piešķīrumi un funkciju grupas), tas, cik organizācijām tā tagad ir pieejama, un cik uzskaitītajiem nomniekiem vēl nav organizācijas. Licence, tās SHA-256 kontrolsumma un virsgrāmatas rindas katrai organizācijai tiek ierakstītas vienā transakcijā, un importēšana tiek reģistrēta revīzijas žurnālā.

Tam ir pievienoti divi lasīšanas maršruti:

  • GET /api/v1/installation/licence/state atbild ar statusu, kas tiek pārrēķināts katrā lasīšanas reizē. Administrators saņem pilnu skatu. Jebkurš cits organizācijas dalībnieks instalācijā saņem tikai paziņojumu: statusu, paziņojuma kodu (LICENCE_ENDS_SOON, LICENCE_IN_GRACE vai LICENCE_CLOCK_BEHIND_FLOOR) un datumus, kas minēti paziņojumā. Dalībnieks nekad neredz licenciātu, termiņu vai grupas, jo šī informācija pieder instalācijas īpašniekam.
  • GET /api/v1/installation/licence/document atbild ar importēto dokumentu neapstrādātā veidā administratoriem. Katrs Enterprise modulis to izgūst un vēlreiz pārbauda parakstus ar savu iekompilēto verificētāju, tāpēc modificēts identitātes serviss nevar ieslēgt grupu, kuru licence nepiešķir.

Katrs noraidījums

Noraidīta importēšana neko nemaina, pat ne pulksteņa apakšējo robežu, un noraidījums tiek reģistrēts revīzijas žurnālā.

Kods HTTP Nozīme Kā rīkoties
LICENCE_FORMAT_INVALID 422 Fails nav licence, ko šis būvējums var nolasīt: tas nav JSON, neatbilst shēmai, datumi ir nepareizā secībā vai grupa ir nosaukta divreiz. Nosūtiet failu tieši tādu, kādu Adverant jums to iedeva.
LICENCE_SIGNATURE_INVALID 422 Trūkst viena no diviem parakstiem, vai arī fails pēc parakstīšanas ir mainīts. Pieprasiet failu no Adverant vēlreiz un nerediģējiet to.
LICENCE_ROOT_UNKNOWN 422 Tas ir parakstīts ar atslēgu, kuras nav šī izlaiduma uzticamības saknēs. Pieprasiet licenci, kas parakstīta šī izlaiduma saknēm, vai veiciet jaunināšanu.
LICENCE_MATRIX_MISMATCH 422 Tā ir izveidota atbilstoši izdevumu matricai, kuru šis būvējums nelasa, vai piešķir grupu, kuru būvējuma katalogs nepazīst. Jauniniet uz izlaidumu, kas to lasa, vai pieprasiet licenci, kas izveidota atbilstoši šim izlaidumam.
LICENCE_OTHER_INSTALLATION 409 Tā tika izsniegta citam instalācijas id. Pieprasiet licenci šīs instalācijas identitātei.
LICENCE_REVOKED 403 Adverant ir atsaucis šo licenci. Pieprasiet no Adverant jaunu licenci.
LICENCE_LOCKED 403 Licence vēl nav stājusies spēkā: pašreizējais datums ir pirms starts_on. Importējiet to vēlreiz tās pirmajā dienā vai pēc tās.
TRANSITION_NOT_PERMITTED 409 Licence ar šādu id jau ir importēta. Pieprasiet no Adverant jaunu licenci, ja nepieciešams mainīt nosacījumus.
RECORD_NOT_FOUND 404 Instalācija vēl nav deklarēta, tāpēc tai nav identitātes, pret kuru veikt pārbaudi. Pabeidziet pirmo administratora soli un pēc tam importējiet.
VALIDATION_FAILED 400 Pamattekstu nevarēja nolasīt, tas pārsniedz 1 MiB, vai arī pieprasījumā bija vaicājuma virkne. Nosūtiet tikai pašu failu kā pamattekstu, bez vaicājuma.

Instalācija veic pārbaudes noteiktā secībā, un pirmā kļūme nosaka kodu. Par trūkstošu pusi tiek ziņots pirms nezināmas atslēgas, un dokuments, kura parakstu pārbaude neizdodas, tālāk netiek lasīts, tāpēc viltots fails, kurā norādīta arī cita instalācija, joprojām atbild ar LICENCE_SIGNATURE_INVALID.

Atjaunošana

Atjaunošana ir jauna licence ar jaunu licence_id. Importējiet to tāpat kā pirmo. Tā stājas spēkā nekavējoties neatkarīgi no tā, kādu statusu bija sasniegusi vecā licence: no WARN, GRACE vai RESTRICT instalācija uzreiz atgriežas licencētā stāvoklī, un nekas nav jāpārinstalē. Adverant var izsniegt izmainītu licenci arī termiņa vidū, piemēram, lai pievienotu Decision rooms, un jūs to importējat tādā pašā veidā.

Vienas un tās pašas licences importēšana divreiz tiek noraidīta ar TRANSITION_NOT_PERMITTED.

Atsaukšana

Adverant atsauc licenci, parakstot atsaukumu sarakstu. Sarakstam ir sequence numurs, un tajā ir nosaukts katrs atsauktās licences id, kā arī atsaukšanas laiks un iemesls. Saraksti ir kumulatīvi: katrā no tiem ir iekļauti visi iepriekšējie atsauktie id. Jūs to importējat tādā pašā veidā kā licenci:

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

Saraksts, kura kārtas numurs nav lielāks par pēdējo importēto, tiek noraidīts ar TRANSITION_NOT_PERMITTED, tāpēc vecu sarakstu nevar ievietot atpakaļ jaunāka saraksta vietā. Saraksts, ko nevar nolasīt vai verificēt, tiek noraidīts ar tiem pašiem kodiem kā licence. Tiklīdz sarakstā ir iekļauta jūsu licence, tās statuss ir TERMINATE.

Instalācija bez ārējā savienojuma par atsaukumu uzzina tikai tad, kad kāds importē sarakstu. Uzņēmumam Harrow atsaukums ir tikpat lielā mērā līguma, cik programmatūras jautājums, un Tomás importē katru Adverant atsūtīto sarakstu nākamajā datu pārnešanas reizē.

Licencēto vietu skaita pārsniegšana

Licences apjoms ir solījums par izmantošanu, un Nexus tā pārsniegšanu uztver kā brīdinājumu, nevis bloķēšanu. Kad Nexus izmanto vairāk cilvēku, nekā sedz licence, administratori lapā People redz paziņojumu SEATS_OVER_LICENCE. Visi turpina strādāt. Paziņojumā ir norādīts, līdz kuram laikam situācija jāatrisina (30 dienas), parādīts, no kurienes radušies papildu lietotāji, un piedāvāti divi risinājumi: noņemt lietotājus, kuriem Nexus nav nepieciešams, vai pieprasīt no Adverant vairāk vietu. Vietu pievienošana ir sensitīva izmaiņa, kurai nepieciešams otrs apstiprinātājs, un papildu vietas tiek uzskaitītas ikgadējā lietojuma pārskatā.

Vietu skaits pārsniedz licenci
Licenci pārsniedzošās lietotāju vietas
Vairāk cilvēku nekā vietu. Direktoriju sinhronizācija pievienoja 143 līgumdarbiniekus, un paziņojums dod 30 dienas, lai noņemtu lietotājus vai pievienotu vietas, kamēr neviens netiek bloķēts.

Lietojuma pārskatā ir tikai skaitītāji, un jūs varat izlasīt katru rindiņu pirms tā nosūtīšanas. Harrow saglabā to kā failu un iznes caur bezsaistes apmaiņu.

Novērtēšanas versijas

Izmēģinājuma versija ir evaluation tipa licence, kas tiek sākta konta lapā Trials pieprasītam izvietojumam. Tā darbojas ne ilgāk kā 30 dienas, aptver ne vairāk kā 5 konkrētus lietotājus, un tai nav labvēlības perioda. Nākamajā dienā pēc ends_on tā uzreiz pāriet statusā RESTRICT: Enterprise sadaļas atgriežas priekšskatījuma režīmā, un nekas, kas izveidots izmēģinājuma laikā, netiek dzēsts. Ideju izpildes, izstrādātās politikas un pasta kārtulas tiek saglabātas tieši tādas, kādas tās bija, un tās atkal tiek atvērtas, tiklīdz tiek importēta licence.

Organizācija vienlaikus var darbināt vienu pašmitinātu izmēģinājuma versiju.