Versioni 1.0.0-alpha.1më i fundit
Kapitulli 2.13
Licencat
Çfarë përmban një skedar licence i Nexus, si e kontrollon instalimi atë jashtë linje, gjashtë gjendjet në të cilat mund të ndodhet dhe si mund të kërkoni, importoni, rinovoni dhe tërhiqni një të tillë.
Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

Harrow Port Authority ekzekuton Nexus Enterprise në klasterin e vet Kubernetes në harrow.example, pa asnjë rrugë komunikimi nga klasteri drejt internetit. Çdo vit Aoife Brennan, drejtuese e IT-së, rinovon kontratën dhe Tomás Reilly, inxhinieri i platformës, e kalon një skedar të vogël JSON përtej kësaj ndarjeje dhe e importon atë. Asgjë nuk rindizet dhe faqja e licencës shfaq një datë të re përfundimi.
Ky kapitull flet për atë skedar. Shkurt, një licencë është një dokument JSON i nënshkruar, i lidhur me një instalim të vetëm. Instalimi e kontrollon vetë atë, me çelësa publikë të integruar në imazh, dhe nuk kryen asnjë thirrje në rrjet për ta bërë këtë. Një licencë nuk është kurrë një vlerë e Helm dhe asnjëherë një skedar i montuar. Ju e importoni atë përmes konsolës, nexusctl ose ndërfaqes së programimit të aplikacioneve (API), dhe askund tjetër.
Dokumenti i licencës
Një licencë është një objekt JSON në formatin nexus-licence/v1. Ja si duket ajo e Harrow, me dy vlerat e nënshkrimit të shkurtuara.
{
"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>" }
}
}Çdo fushë është e detyrueshme dhe çdo objekt në dokument është i mbyllur. Një element që formati nuk e rendit refuzohet, kështu që asgjë nuk mund të bashkëngjitet jashtë nënshkrimit.
| Fusha | Çfarë mban |
|---|---|
format |
Saktësisht nexus-licence/v1. Çdo vlerë tjetër, përfshirë një version të mëvonshëm, refuzohet. |
licence_id |
Një UUID (identifikues universalisht unik) me shkronja të vogla. Një instalim e importon çdo id licence vetëm një herë. |
issued_at |
Momenti kur Adverant e lëshoi atë, si YYYY-MM-DDThh:mm:ssZ. |
type |
alpha, evaluation ose commercial. |
channel |
Kanali i lëshimit për të cilin është lëshuar, si p.sh. alpha. I nënshkruar dhe i mbartur; kontrolli nuk degëzohet në bazë të tij. |
licensee.name |
1 deri në 200 karaktere, të nënshkruara saktësisht siç janë shkruar. Brennan dhe Brennán janë dy emra të ndryshëm me dy nënshkrime të ndryshme. |
licensee.customer_id |
Id-ja juaj e klientit në Adverant: shkronja të vogla, shifra, ., _ dhe -. |
scope.deployment.installation_id |
Identiteti i instalimit, i krijuar nga shërbimi i tij i çelësave gjatë instalimit të parë. |
scope.tenants |
Id-të e organizatave, deri në 1,000. E zbrazët, përveç rasteve kur ndonjë e drejtë e dhënë është e kufizuar në nivel tenanti. |
edition |
enterprise ose team. Një licencë Enterprise jep gjithmonë enterprise-base. |
grants |
1 deri në 500 çifte {feature_group, scope}, ku çdo grup përmendet një herë. |
add_ons |
Id-të e shtesave (add-on) nga matrica e edicioneve, deri në 100. Mund të jetë e zbrazët. |
domain_packs |
Id-të e paketave të domenit nga matrica e edicioneve, deri në 100. Mund të jetë e zbrazët. |
metric |
kind është per-environment, per-core ose named-seat; quantity është një numër i plotë duke filluar nga 1. |
term |
starts_on dhe ends_on janë data; warn_days dhe grace_days janë numra të plotë nga 0 deri në 365. |
matrix |
Versioni i matricës së edicioneve mbi të cilin janë shkruar grupet, dhe SHA-256 i atij skedari matrice, të ruajtura për auditim. |
signatures |
Dy nënshkrime, ed25519 dhe p256. E vetmja fushë që nuk nënshkruhet. |
Datat janë data kalendarike në UTC, dhe dita duhet të ekzistojë: 2028-02-29 pranohet dhe 2027-02-29 refuzohet.
Dy nënshkrime, të dyja të detyrueshme
Adverant e nënshkruan çdo licencë me dy çelësa të pavarur. Njëri nënshkrim është Ed25519. Tjetri është ECDSA (Elliptic Curve Digital Signature Algorithm) në kurbën P-256 nga NIST (Instituti Kombëtar i Standardeve dhe Teknologjisë i SHBA-së), të cilin e kërkojnë blerësit që kanë nevojë për algoritme federale amerikane. Të dy krijohen mbi të njëjtat bajte dhe të dy duhet të verifikohen. Një dokument të cilit i mungon njëra gjysmë, ose që e ka njërën gjysmë të gabuar, llogaritet si mungesë e plotë licence.
Bajtet e nënshkruara janë forma kanonike RFC 8785 e dokumentit pa signatures, kështu që hapësirat e bardha dhe renditja e elementeve në skedarin tuaj nuk bëjnë asnjë ndryshim. Një karakter i vetëm i ndryshuar në emrin e mbajtësit të licencës, në datat ose në një të drejtë të dhënë përbën një dokument tjetër, dhe verifikimi dështon.
Çelësat publikë që përdor kontrolli ndodhen në një skedar trust-roots të integruar në çdo imazh gjatë ndërtimit të versionit. Asnjë variabël mjedisi, flamur (flag) apo montim nuk mund të caktojë një skedar tjetër. Kur Adverant zëvendëson një çelës nënshkrimi, çelësi i vjetër nënshkruan të riun dhe versioni tjetër i nënshkruar mbart çelësin e ri. Një licencë e nënshkruar me një çelës të ri verifikohet në një version që e mbart atë, kështu që pas një ndryshimi çelësi mund t'ju duhet të përditësoni sistemin përpara se të importoni (shihni kapitullin 2.17, Zgjidhja e problemeve).
Llojet, edicionet dhe si numërohet një licencë
Fusha type tregon se nga çfarë lloj marrëveshjeje vjen licenca:
alpha: një licencë për kanalin e lëshimit alpha, që është lloji që zotëron Harrow.evaluation: një provë e vetë-hostuar e Enterprise. Ajo funksionon për të shumtën 30 ditë, për të shumtën 5 persona të emërtuar (metrikanamed-seat), megrace_daystë vendosur në 0. Formati refuzon çdo vlerësim që ka periudhë mospagimi (grace).commercial: një licencë e kontraktuar.
Fusha metric regjistron mënyrën se si llogaritet licenca: per-environment (klasteri i prodhimit i Harrow është një mjedis), per-core ose named-seat. Adverant cakton çmimin; licenca mbart vetëm njësinë matëse dhe sasinë.
Fusha edition e licencës është enterprise për çdo instalim Enterprise. Formati pranon gjithashtu team, ku licenca jep grupin team dhe kurrë enterprise-base.
Grupet e veçorive, shtesat dhe paketat e fushës
Ajo që një licencë u lejon njerëzve të përdorin renditet sipas grupit të veçorive, duke përdorur id-të e matricës së edicioneve. Licenca e Harrow jep enterprise-base (role të personalizuara, miratime me katër sy, ruajtje afatgjatë të auditimit, identifikim të kompanisë me detyrim dhe sinkronizim direktorie, njësi biznesi, faqet e operatorit dhe pjesën tjetër të bazës Enterprise) dhe map-and-geoai. Ajo mbart shtesën mail dhe paketën e domenit logistics-and-maritime.
Matrica ka rregulla se çfarë shkon bashkë, dhe procesi i lëshimit të Adverant i kontrollon ato përpara se të nënshkruhet një licencë. Çdo shtesë dhe çdo paketë ka nevojë për enterprise-base. Disa paketa kanë nevojë për shtesa: paketa e Logjistikës dhe detarisë ka nevojë për Hartën dhe GeoAI, paketa e Sigurimeve dhe paketa e Tregjeve të kapitalit dhe menaxhimit të aseteve kanë nevojë për Dhomat e vendimeve dhe regjistrimet e vulosura, ndërsa paketa e Shërbimeve ligjore dhe profesionale ka nevojë për Dhomat e vendimeve dhe Postën. Ekranet e telefonit të çdo pakete kanë nevojë gjithashtu për shtesën e Aplikacioneve celulare.
Çdo e drejtë e dhënë ka një fushëveprim:
deployment: grupi zbatohet për të gjithë instalimin, për çdo organizatë në të.tenant: grupi zbatohet vetëm për organizatat e renditura nëscope.tenants. Një licencë me një të drejtë të kufizuar në nivel tenanti duhet të rendisë të paktën një organizatë, dhe një listë organizatash pa asnjë të drejtë të kufizuar në nivel tenanti refuzohet.
Supozojmë se ekipi i pilotimit të Harrow do të funksiononte si një organizatë e dytë në të njëjtin instalim, dhe vetëm ajo organizatë do të zotëronte Ideas. E drejta e dhënë do të lexonte { "feature_group": "ideas", "scope": "tenant" }, me id-në e organizatës së pilotimit në scope.tenants. Nëse licenca do të importohej përpara se ajo organizatë të ekzistonte, përgjigjja e importimit do ta numëronte atë nën tenants_without_organisation, dhe e drejta do të shtrihej tek ajo sapo të krijohej organizata.
Një administrator mund ta ngushtojë atë që arrin një grup. Vetëm një licencë nga Adverant mund të shtojë një grup.
Afati: paralajmërimi dhe periudha e mirëkuptimit
Fusha term vendos katër data në kalendar. Nga starts_on deri në ends_on licenca është në fuqi. warn_days përcakton se sa herët fillon paralajmërimi, dhe grace_days se sa gjatë vazhdon të funksionojë gjithçka pas përfundimit. Licencat që lëshon Adverant mbartin 30 ditë për secilën, përveç rasteve kur kontrata parashikon ndryshe. Një vlerësim ka gjithmonë grace_days 0.
Për licencën e Harrow më lart, kalendari funksionon kështu:
| Datat | Gjendja |
|---|---|
| 1 janar 2027 deri më 1 dhjetor 2027 | VALID |
| 2 dhjetor 2027 deri më 31 dhjetor 2027 | WARN |
| 1 janar 2028 deri më 30 janar 2028 | GRACE |
| Nga 31 janari 2028 | RESTRICT |
Dita e fundit e afatit, ends_on, është ende një ditë WARN. Dita pas saj është GRACE, ose RESTRICT kur nuk ka periudhë shtesë (grace).
Gjashtë gjendjet
Sa herë që lexohet licenca, instalimi rillogarit gjendjen e saj nga dokumenti dhe data aktuale. Asgjë nuk ruhet në cache përtej kufirit të një dite, kështu që skadimi ndodh në kohë pa pasur nevojë për një proces të planifikuar.
| Gjendja | Kur | Çfarë mund të bëjnë njerëzit |
|---|---|---|
| ABSENT | Nuk është importuar asnjë licencë, ose dokumenti u refuzua | Niveli bazë Community. Zonat Enterprise shfaqen si pamje paraprake (teasers) me informacionin se kush mund t'i aktivizojë ato. |
| VALID | starts_on deri në ends_on minus warn_days |
Çdo grup i dhënë është i autorizuar. |
| WARN | Ditët e fundit warn_days të afatit |
I autorizuar, dhe administratorët shohin një baner brenda produktit me datën e përfundimit. |
| GRACE | Pas ends_on, për grace_days ditë |
I autorizuar, me njoftimin LICENCE_IN_GRACE te Today dhe në faqen e licencës. |
| RESTRICT | Pas periudhës shtesë (grace) | Asnjë punë e re nuk mund të nisë nën një grup të licencuar. Puna në vazhdim përfundon, leximet dhe eksportet vazhdojnë të funksionojnë, dhe rregullimet e sigurisë vazhdojnë të mbërrijnë. |
| TERMINATE | Adverant e revokoi licencën | Artefaktet Enterprise ndalojnë së ofruari. Niveli bazë Community dhe eksporti i të dhënave mbeten. |
Në çdo gjendje, puna në vazhdim vijon të ekzekutohet, rregullimet e sigurisë vazhdojnë të mbërrijnë, eksportet mbeten të lexueshme dhe asgjë nuk fshihet. Në RESTRICT, një person që përpiqet të nisë një punë të re Enterprise sheh një pllakë refuzimi me kodin LICENCE_LOCKED dhe emrin e atij që mund ta rinovojë.
Si llogaritet data aktuale
Një orë mund të jetë e gabuar, dhe një orë mund të kthehet pas qëllimisht. Prandaj instalimi nuk e lexon kurrë vetëm orën. Data aktuale është momenti më i vonshëm mes dy çasteve: orës së sistemit dhe një kufiri të poshtëm të ruajtur (floor), i cili është momenti më i fundit që instalimi ka parë. Ky kufi i poshtëm ecën përpara në çdo importim dhe në çdo lexim të gjendjes, dhe nuk kthehet kurrë pas vetë. Kthimi i orës pas me një muaj nuk e kthen një licencë të skaduar përsëri në VALID; një licencë RESTRICT mbetet RESTRICT.
Kur ora tregon më herët se kufiri i poshtëm, gjendja mbart njoftimin LICENCE_CLOCK_BEHIND_FLOOR dhe lexohet në ditën e kufirit të poshtëm. Nëse ora ka ecur vërtet përpara (një nyje u ndez me datën e gabuar dhe kufiri i poshtëm u shty përpara), kërkojini Adverant një token për rivendosjen e kohës. Është një dokument i vogël i nënshkruar i lidhur me id-në e instalimit tuaj dhe një nonce njëpërdorimëshe, me një moment floor_to. Ju e importoni atë përmes API-t me këtë kërkesë:
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> është token-i i aksesit i një administratori të instalimit. Një token zbatohet kur të dyja nënshkrimet verifikohen, id-ja e instalimit të tij është e juaja dhe nonce-ja e tij nuk është përdorur. Një token i refuzuar nuk ndryshon asgjë, kështu që nuk mund të përdoret kurrë për të refuzuar një licencë të vlefshme. Një token, nonce-ja e të cilit është përdorur tashmë, refuzohet me LICENCE_CLOCK_BEHIND_FLOOR.
Kërkimi i një licence
Licencat kërkohen dhe shkarkohen nga llogaria juaj Adverant në https://account.adverant.ai. Se kush në organizatën tuaj mund të marrë në pronësi vendosjet (deployments) dhe të shkarkojë licencat, caktohet në faqen Organizata dhe rolet e ekipit të llogarisë.
Adverant duhet të dijë se për cilin instalim është licenca, dhe ka tri mënyra për t'ia treguar këtë.
Një kod njëpërdorimësh, për një instalim me ekran. Instalimi shfaq një kod njëpërdorimësh dhe gjurmën e tij digjitale (fingerprint). Në faqen Merr në pronësi një vendosje (Claim a deployment) ju ngjisni kodin, pastaj krahasoni gjurmën digjitale grup pas grupi me atë që shfaq instalimi. Kur çdo grup përputhet, ju e merrni atë në pronësi për organizatën tuaj dhe licenca mbërrin në llogari.
Një çelës pronësie (claim key), për një pajisje të dedikuar (appliance) ose një pajisje në skaj (edge device). Këto nuk kanë ekran për të shfaqur një kod. Numri i serisë dhe një çelës pronësie janë të printuara në kuti dhe në porosinë e prodhuesit të pajisjes. Futini ato në faqen Fut një çelës pronësie një nga një, ose hidhni skedarin e porosisë së prodhuesit për të marrë në pronësi shumë njëherësh. Çdo çelës kontrollohet kundrejt regjistrit të Adverant për atë që ju është dërguar, dhe një çelës nga porosia e dikujt tjetër refuzohet.
Një kërkesë licence e nënshkruar, për një instalim pa lidhje të jashtme. Kjo është rruga e Harrow. Në instalim, një administrator krijon një skedar kërkese nën Ky instalim, Licenca. Është një deklaratë e llojit licence-request që përmend id-në e instalimit, e nënshkruar me çelësin Ed25519 të vetë instalimit. Tomás e nxjerr atë jashtë në një media të miratuar, e hedh në faqen Shkëmbimi jashtë linje (Offline exchange), dhe shkarkon skedarin e licencës që kthehet. Licenca funksionon vetëm në instalimin që bëri kërkesën.
Importimi i një licence
Ka tri mënyra hyrjeje dhe të gjitha arrijnë në të njëjtën pikë fundore (endpoint) në nexus-auth. Vetëm një administrator instalimi mund të importojë: një pronar ose administrator i të gjithë organizatës që zotëron instalimin, i identifikuar në të, ose një administrator i plotë i platformës. Kushdo tjetër refuzohet përpara se të lexohet skedari.
Në konsolë
Në një instalim të ri, Importo licencën është një nga gjashtë kontrollet te Gjashtë gjëra përpara se dikush të identifikohet. Kur e hidhni skedarin në faqe, konsola e kontrollon atë në instalim, jashtë linje, dhe rendit grupet e tij të veçorive bashkë me mënyrën se si mbrohet secili dhe afatin.
Importimet e mëvonshme kalojnë përmes Ky instalim, Licenca: përdorni Importo një licencë të re, ose Importo një licencë të rinovuar kur ajo aktuale ka skaduar. Një instalim Community që kalon në Enterprise përdor Nga Community në Enterprise. Ajo faqe lexon fillimisht licencën dhe tregon se çfarë do të shkarkohet dhe çfarë ndryshon, përpara se të ndodhë ndonjë gjë. Asgjë nuk shkarkohet derisa dikush të zgjedhë Shkarko dhe aktivizo (Fetch and switch on). Pjesët Enterprise vijnë më pas nga registry.adverant.ai me token-in e tërheqjes (pull token) të instalimit, ku secila kontrollohet kundrejt çelësit të lëshimit të Adverant, dhe grupet aktivizohen një nga një. Pas kësaj, mbetet i njëjti instalim, me të njëjtët njerëz, skedarë, rrjedha pune dhe kanale.
Me nexusctl
nexusctl licence import harrow-2027.licence.jsonKomanda e importon skedarin të pandryshuar dhe printon gjendjen aktuale të licencës. Shtoni --explain për të printuar veprimet që do të ekzekutonte pa i ekzekutuar ato.
Përmes API-t
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.jsonDërgojeni skedarin saktësisht siç jua ka dhënë Adverant. Mos e riformatoni dhe mos e mbështillni brenda një objekti tjetër: trupi i kërkesës (body) është vetë dokumenti. Rruga nuk pranon varg pyetësor (query string) dhe një trup më i madh se 1 MiB refuzohet. Një element i nivelit të lartë që përmend një organizatë ose një person refuzohet me TENANT_NOT_A_PARAMETER ose ACTOR_NOT_A_PARAMETER, sepse licenca e instalimit i përket instalimit që zotëron organizata e token-it.
Një importim i suksesshëm përgjigjet me 201. Trupi mban pamjen e licencës (id-në e saj, gjendjen aktuale, mbajtësin e licencës, edicionin, afatin, të drejtat e dhëna dhe grupet e veçorive), sa organizata e zotërojnë atë tani dhe sa tenantë të renditur nuk kanë ende një organizatë. Licenca, përmbledhja (digest) e saj SHA-256 dhe rreshtat e regjistrit kryesor (ledger) për çdo organizatë shkruhen në një transaksion të vetëm, dhe importimi regjistrohet në ditarin e auditimit.
Dy rrugë leximi e shoqërojnë atë:
GET /api/v1/installation/licence/statekthen si përgjigje gjendjen, të rillogaritur në çdo lexim. Një administrator merr pamjen e plotë. Çdo anëtar tjetër i një organizate në instalim merr vetëm njoftimin: gjendjen, kodin e njoftimit (LICENCE_ENDS_SOON,LICENCE_IN_GRACEoseLICENCE_CLOCK_BEHIND_FLOOR) dhe datat që përmend njoftimi. Një anëtar nuk e sheh kurrë mbajtësin e licencës, afatin apo grupet, sepse ato i përkasin pronarit të instalimit.GET /api/v1/installation/licence/documentkthen si përgjigje dokumentin e importuar, të papërpunuar, për administratorët. Çdo modul Enterprise e tërheq atë dhe kontrollon përsëri nënshkrimet me verifikuesin e vet të kompiluar brenda tij, kështu që një shërbim identiteti i modifikuar nuk mund të aktivizojë një grup që licenca nuk e jep.
Çdo refuzim
Një importim i refuzuar nuk ndryshon asgjë, as kufirin e poshtëm të orës, dhe refuzimi regjistrohet në ditarin e auditimit.
| Kodi | HTTP | Kuptimi | Çfarë duhet të bëni |
|---|---|---|---|
LICENCE_FORMAT_INVALID |
422 | Skedari nuk është një licencë që ky ndërtim (build) mund ta lexojë: nuk është JSON, nuk i përmbahet skemës, datat nuk janë në rendin e duhur ose një grup është përmendur dy herë. | Dërgojeni skedarin saktësisht siç jua ka dhënë Adverant. |
LICENCE_SIGNATURE_INVALID |
422 | Një nga dy nënshkrimet mungon, ose skedari ka ndryshuar pas nënshkrimit. | Kërkojini Adverant skedarin përsëri dhe mos e modifikoni atë. |
LICENCE_ROOT_UNKNOWN |
422 | Është nënshkruar me një çelës që rrënjët e besimit (trust roots) të këtij versioni nuk e mbajnë. | Kërkoni një licencë të nënshkruar për rrënjët e këtij versioni, ose përditësoni sistemin. |
LICENCE_MATRIX_MISMATCH |
422 | Është shkruar kundrejt një matrice edicionesh që ky ndërtim nuk e lexon, ose jep një grup që katalogu i ndërtimit nuk e njeh. | Përditësoni në një version që e lexon atë, ose kërkoni një licencë të shkruar kundrejt këtij versioni. |
LICENCE_OTHER_INSTALLATION |
409 | Është lëshuar për një id tjetër instalimi. | Kërkoni një licencë për identitetin e këtij instalimi. |
LICENCE_REVOKED |
403 | Adverant e ka tërhequr këtë licencë. | Kërkojini Adverant një licencë të re. |
LICENCE_LOCKED |
403 | Licenca nuk ka filluar: data aktuale është përpara starts_on. |
Importojeni përsëri në ose pas ditës së saj të parë. |
TRANSITION_NOT_PERMITTED |
409 | Një licencë me këtë id është importuar tashmë. | Kërkojini Adverant një licencë të re nëse kushtet duhet të ndryshojnë. |
RECORD_NOT_FOUND |
404 | Instalimi nuk është deklaruar ende, kështu që nuk ka identitet kundrejt të cilit të kryhet kontrolli. | Përfundoni hapin e parë të administratorit, pastaj importoni. |
VALIDATION_FAILED |
400 | Trupi nuk mund të lexohej, është mbi 1 MiB, ose kërkesa kishte një varg pyetësor (query string). | Dërgoni vetëm skedarin si trup të kërkesës, pa varg pyetësor. |
Instalimi kontrollon sipas një rendi fiks, dhe dështimi i parë përcakton kodin. Mungesa e njërës gjysmë raportohet përpara një çelësi të panjohur, dhe një dokument nënshkrimet e të cilit dështojnë nuk lexohet kurrë më tej, kështu që një skedar i manipuluar që përmend gjithashtu një instalim tjetër përsëri përgjigjet me LICENCE_SIGNATURE_INVALID.
Rinovimi
Një rinovim është një licencë e re me një licence_id të ri. Importojeni atë në të njëjtën mënyrë si të parën. Ajo hyn në fuqi menjëherë, pavarësisht gjendjes që kishte arritur e vjetra: nga WARN, GRACE ose RESTRICT instalimi kthehet drejtpërdrejt në gjendjen e licencuar, dhe asgjë nuk ka nevojë të riinstalohet. Adverant mund të lëshojë gjithashtu një licencë të ndryshuar në mes të afatit, për shembull për të shtuar Dhomat e vendimeve, dhe ju e importoni atë në të njëjtën mënyrë.
Importimi i së njëjtës licencë dy herë refuzohet me TRANSITION_NOT_PERMITTED.
Revokimi
Adverant e tërheq një licencë duke nënshkruar një listë revokimi. Lista ka një numër sequence dhe përmend çdo id licence të tërhequr bashkë me kohën dhe arsyen. Listat janë kumulative: secila mbart çdo id të revokuar përpara saj. Ju e importoni atë në të njëjtën mënyrë si një licencë:
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.jsonNjë listë sekuenca e së cilës nuk është më e lartë se e fundit e importuar refuzohet me TRANSITION_NOT_PERMITTED, kështu që një listë e vjetër nuk mund të vendoset përsëri në vend të një më të reje. Një listë që nuk lexohet ose nuk verifikohet refuzohet me të njëjtat kode si një licencë. Sapo një listë përmend licencën tuaj, gjendja e saj bëhet TERMINATE.
Një instalim pa lidhje të jashtme mëson për një revokim vetëm kur dikush e importon listën. Për Harrow, revokimi është një çështje kontrate po aq sa edhe softueri, dhe Tomás importon çdo listë që Adverant dërgon gjatë kalimit të radhës.
Vendet mbi licencën
Sasia e licencës është një premtim mbi përdorimin, dhe Nexus e trajton tejkalimin e saj si një paralajmërim, kurrë si një bllokim aksesi. Kur më shumë njerëz përdorin Nexus sesa mbulon licenca, administratorët shohin pllakën SEATS_OVER_LICENCE në faqen Njerëzit. Të gjithë vazhdojnë të punojnë. Pllaka tregon se deri kur duhet rregulluar (30 ditë), tregon se nga erdhën njerëzit shtesë dhe ofron dy zgjidhjet: hiqni njerëzit që nuk kanë nevojë për Nexus, ose kërkojini Adverant më shumë vende (seats). Shtimi i vendeve është një ndryshim delikat që kërkon një person të dytë, dhe vendet shtesë numërohen në pasqyrën vjetore të përdorimit.
Pasqyra e përdorimit mban vetëm numërues, dhe ju mund të lexoni çdo rresht përpara se të dërgohet. Harrow e ruan atë si skedar dhe e nxjerr jashtë përmes shkëmbimit jashtë linje.
Vlerësimet
Një vlerësim është një licencë e llojit evaluation, e nisur nga faqja Provat (Trials) e llogarisë për një vendosje të marrë në pronësi. Ajo zgjat të shumtën 30 ditë, mbulon të shumtën 5 persona të emërtuar dhe nuk ka periudhë shtesë (grace). Ditën pas ends_on ajo kalon drejtpërdrejt në RESTRICT: zonat Enterprise kthehen në pamje paraprake (teasers) dhe asgjë e krijuar gjatë vlerësimit nuk fshihet. Ekzekutimet e Ideas, politikat e hartuara dhe rregullat e postës ruhen saktësisht siç ishin, dhe ato hapen përsëri sapo të importohet një licencë.
Një organizatë ekzekuton një vlerësim të vetë-hostuar në të njëjtën kohë.




