IdħolIbbukkja laqgħa informattiva

Kapitlu 2.13

Liċenzji

X'fih fajl tal-liċenzja ta' Nexus, kif l-installazzjoni tiċċekkjah offline, is-sitt stati li jista' jkun fihom, u kif titlob, timporta, iġġedded u tirtira waħda.

Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

19 minuti qari

Harrow Port Authority tħaddem Nexus Enterprise fuq il-cluster ta' Kubernetes tagħha stess fuq harrow.example, mingħajr ebda rotta mill-cluster għall-internet. Kull sena Aoife Brennan, il-kap tal-IT, iġġedded il-kuntratt, u Tomás Reilly, l-inġinier tal-pjattaforma, iġorr fajl żgħir JSON min-naħa għall-oħra u jimportah. Xejn ma jerġa' jibda mill-ġdid, u l-paġna tal-liċenzja turi data tat-tmiem ġdida.

Dan il-kapitlu huwa dwar dak il-fajl. Fil-qosor, liċenzja hija dokument wieħed JSON iffirmat marbut ma' installazzjoni waħda. L-installazzjoni tiċċekkjah hi stess, bi ċwievet pubbliċi inkorporati fl-immaġni, u ma tagħmel ebda sejħa fin-netwerk biex tagħmel dan. Liċenzja qatt ma hija valur ta' Helm u qatt ma hija fajl immuntat. Timportaha permezz tal-console, nexusctl jew l-interfaċċja tal-ipprogrammar tal-applikazzjonijiet (API), u mkien ieħor.

Id-dokument tal-liċenzja

Liċenzja hija oġġett wieħed JSON fil-format nexus-licence/v1. Hawnhekk hawn dik ta' Harrow, biż-żewġ valuri tal-firma mqassra.

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

Kull qasam huwa meħtieġ, u kull oġġett fid-dokument huwa magħluq. Membru li l-format ma jelenkax jiġi rrifjutat, sabiex xejn ma jkun jista' jidħol barra mill-firma.

Qasam X'fih
format Eżattament nexus-licence/v1. Kwalunkwe valur ieħor, inkluża verżjoni aktar tard, jiġi rrifjutat.
licence_id UUID (identifikatur uniku universali) b'ittri żgħar. Installazzjoni timporta kull id tal-liċenzja darba biss.
issued_at Il-mument li fih Adverant ħariġha, bħala YYYY-MM-DDThh:mm:ssZ.
type alpha, evaluation jew commercial.
channel Il-kanal tar-rilaxx li għalih inħarġet, bħal alpha. Iffirmat u miżmum; il-kontroll ma jiddependix fuqu.
licensee.name Minn karattru 1 sa 200 karattru, iffirmati eżattament kif miktuba. Brennan u Brennán huma żewġ ismijiet differenti b'żewġ firem differenti.
licensee.customer_id L-id tal-klijent tiegħek għand Adverant: ittri żgħar, ċifri, ., _ u -.
scope.deployment.installation_id L-identità tal-installazzjoni, maħluqa mis-servizz taċ-ċwievet tagħha fl-ewwel installazzjoni.
scope.tenants Ids tal-organizzazzjoni, sa 1,000. Vojta sakemm xi konċessjoni ma tkunx fl-ambitu ta' kerrej (tenant-scoped).
edition enterprise jew team. Liċenzja Enterprise dejjem tagħti enterprise-base.
grants Minn par 1 sa 500 par {feature_group, scope}, b'kull grupp imsemmi darba.
add_ons Ids ta' add-ons mill-matriċi tal-edizzjoni, sa 100. Jista' jkun vojt.
domain_packs Ids ta' pakketti tad-dominju mill-matriċi tal-edizzjoni, sa 100. Jista' jkun vojt.
metric kind huwa per-environment, per-core jew named-seat; quantity huwa numru sħiħ minn 1 'il fuq.
term starts_on u ends_on huma dati; warn_days u grace_days huma numri sħaħ minn 0 sa 365.
matrix Il-verżjoni tal-matriċi tal-edizzjoni li l-gruppi huma miktuba kontriha, u s-SHA-256 ta' dak il-fajl tal-matriċi, miżmuma għall-awditjar.
signatures Żewġ firem, ed25519 u p256. L-uniku qasam li mhuwiex iffirmat.

Id-dati huma dati kalendarji fil-UTC, u l-jum irid ikun jeżisti: 2028-02-29 hija tajba u 2027-02-29 tiġi rrifjutata.

Żewġ firem, it-tnejn meħtieġa

Adverant tiffirma kull liċenzja b'żewġ ċwievet indipendenti. Firma waħda hija Ed25519. L-oħra hija ECDSA (Elliptic Curve Digital Signature Algorithm) fuq il-kurva P-256 min-NIST (l-Istitut Nazzjonali tal-Istandards u t-Teknoloġija tal-Istati Uniti), li jitolbu x-xerrejja li jeħtieġu algoritmi federali tal-Istati Uniti. It-tnejn huma magħmula fuq l-istess bytes, u t-tnejn iridu jiġu vverifikati. Dokument b'nofs wieħed nieqes, jew b'xi wieħed min-nofsijiet ħażin, jitqies bħallikieku m'hemm ebda liċenzja.

Il-bytes iffirmati huma l-forma kanonika RFC 8785 tad-dokument bi signatures imneħħi, għalhekk l-ispazji vojta u l-ordni tal-membri fil-fajl tiegħek ma jagħmlu ebda differenza. Karattru wieħed mibdul fl-isem tad-detentur tal-liċenzja, fid-dati jew f'konċessjoni jagħmel id-dokument wieħed differenti, u jfalli.

Iċ-ċwievet pubbliċi li juża l-kontroll jinsabu f'fajl trust-roots inkorporat f'kull immaġni fil-mument tal-bini tar-rilaxx. Ebda varjabbli tal-ambjent, flag jew mount ma jsemmi fajl ieħor. Meta Adverant tissostitwixxi ċavetta tal-iffirmar, iċ-ċavetta l-qadima tiffirma l-ġdida u r-rilaxx iffirmat li jmiss iġorr iċ-ċavetta l-ġdida. Liċenzja ffirmata b'ċavetta ġdida tiġi vverifikata fuq rilaxx li jġorrha, għalhekk wara bidla fiċ-ċavetta jista' jkollok bżonn taġġorna qabel ma timporta (ara l-kapitlu 2.17, Issolvi l-problemi).

Tipi, edizzjonijiet u kif tgħodd liċenzja

Il-type jgħid minn liema tip ta' ftehim ġejja l-liċenzja:

  • alpha: liċenzja għall-kanal tar-rilaxx alpha, li hija t-tip li għandha Harrow.
  • evaluation: prova ospitata minnek innifsek (self-hosted) ta' Enterprise. Taħdem għal massimu ta' 30 jum, għal massimu ta' 5 persuni msemmija (metrika named-seat), bi grace_days issettjat għal 0. Il-format jirrifjuta evalwazzjoni bi kwalunkwe perjodu ta' grazzja.
  • commercial: liċenzja b'kuntratt.

Il-metric jirreġistra kif tiġi magħduda l-liċenzja: per-environment (il-cluster tal-produzzjoni ta' Harrow huwa ambjent wieħed), per-core jew named-seat. Adverant tikkwota l-prezz; il-liċenzja ġġorr biss il-kejl u l-kwantità.

Il-edition tal-liċenzja huwa enterprise għal kull installazzjoni Enterprise. Il-format jaċċetta wkoll team, fejn il-liċenzja tagħti l-grupp team u qatt enterprise-base.

Gruppi ta' karatteristiċi, add-ons u pakketti ta' dominju

Dak li liċenzja tħalli lin-nies jużaw huwa elenkat skont il-grupp ta' karatteristiċi, bl-użu tal-ids tal-matriċi tal-edizzjoni. Il-liċenzja ta' Harrow tagħti enterprise-base (rwoli personalizzati, approvazzjonijiet ta' erba' għajnejn, żamma twila tal-awditjar, dħul tal-kumpanija b'infurzar u sinkronizzazzjoni tad-direttorju, unitajiet tan-negozju, il-paġni tal-operatur u l-bqija tal-bażi ta' Enterprise) u map-and-geoai. Hija ġġorr l-add-on mail u l-pakkett tad-dominju logistics-and-maritime.

Il-matriċi għandha regoli dwar x'imur flimkien, u l-ħruġ ta' Adverant jiċċekkjahom qabel ma tiġi ffirmata liċenzja. Kull add-on u kull pakkett jeħtieġ enterprise-base. Xi pakketti jeħtieġu add-ons: il-pakkett tal-Loġistika u marittimu jeħtieġ Map u GeoAI, il-pakkett tal-Assigurazzjoni u l-pakkett tas-Swieq kapitali u l-ġestjoni tal-assi jeħtieġu Kmamar tad-deċiżjonijiet u rekords issiġillati, u l-pakkett tas-Servizzi legali u professjonali jeħtieġ Kmamar tad-deċiżjonijiet u Posta. L-iskrins tat-telefon ta' kull pakkett jeħtieġu wkoll l-add-on tal-Apps mobbli.

Kull konċessjoni għandha ambitu:

  • deployment: il-grupp japplika għall-installazzjoni kollha, għal kull organizzazzjoni fuqha.
  • tenant: il-grupp japplika biss għall-organizzazzjonijiet elenkati f'scope.tenants. Liċenzja b'konċessjoni fl-ambitu ta' kerrej trid telenka mill-inqas organizzazzjoni waħda, u lista ta' organizzazzjonijiet mingħajr ebda konċessjoni fl-ambitu ta' kerrej tiġi rrifjutata.

Ejja ngħidu li t-tim tal-pilotaġġ ta' Harrow kien qed jaħdem bħala t-tieni organizzazzjoni fuq l-istess installazzjoni, u dik l-organizzazzjoni biss kellha jkollha Ideas. Il-konċessjoni tkun taqra { "feature_group": "ideas", "scope": "tenant" }, bl-id tal-organizzazzjoni tal-pilotaġġ f'scope.tenants. Kieku l-liċenzja ġiet importata qabel ma kienet teżisti dik l-organizzazzjoni, it-tweġiba tal-importazzjoni kienet tgħoddha taħt tenants_without_organisation, u l-konċessjoni kienet tasal għandha ladarba l-organizzazzjoni tinħoloq.

Amministratur jista' jirrestrinġi dak li jilħaq grupp. Liċenzja mingħand Adverant biss iżżid grupp.

Il-liċenzja u x'tiftaħ
Il-liċenzja u x'tiftaħ
Il-paġna tal-liċenzja telenka kull grupp ta' karatteristiċi b'kif inhu protett u x'ikopri. Gruppi li l-liċenzja ma jkollhiex jibqgħu fil-lista, bil-griż, sabiex in-nies ikunu jistgħu jaraw x'jeżisti.

It-terminu: twissija u grazzja

Il-term jissettja erba' dati fuq il-kalendarju. Minn starts_on sa ends_on il-liċenzja tkun fis-seħħ. warn_days jissettja kemm tibda kmieni t-twissija, u grace_days kemm idum jaħdem kollox wara t-tmiem. Liċenzji li toħroġ Adverant iġorru 30 jum minn kull wieħed sakemm il-kuntratt ma jgħidx mod ieħor. Evalwazzjoni dejjem ikollha grace_days 0.

Għal-liċenzja ta' Harrow hawn fuq, il-kalendarju jaħdem hekk:

Dati Stat
1 ta' Jannar 2027 sa 1 ta' Diċembru 2027 VALID
2 ta' Diċembru 2027 sa 31 ta' Diċembru 2027 WARN
1 ta' Jannar 2028 sa 30 ta' Jannar 2028 GRACE
Mill-31 ta' Jannar 2028 RESTRICT

L-aħħar jum tat-terminu, ends_on, xorta huwa jum WARN. Il-jum ta' warajh huwa GRACE, jew RESTRICT meta ma jkunx hemm perjodu ta' grazzja.

Is-sitt stati

Kull darba li tinqara l-liċenzja, l-installazzjoni terġa' tikkalkula l-istat tagħha mid-dokument u mid-data kurrenti. Xejn ma jinżamm fil-cache wara l-konfini ta' jum, għalhekk skadenza sseħħ fil-ħin mingħajr xogħol skedat.

Stat Meta X'jistgħu jagħmlu n-nies
ABSENT Ebda liċenzja importata, jew id-dokument ġie rrifjutat Il-livell bażiku ta' Community. L-oqsma ta' Enterprise jidhru bħala previżjonijiet (teasers) b'min jista' jixgħelhom.
VALID starts_on sa ends_on nieqes warn_days Kull grupp mogħti huwa intitolat.
WARN L-aħħar warn_days ijiem tat-terminu Intitolat, u l-amministraturi jaraw strixxun fil-prodott bid-data tat-tmiem.
GRACE Wara ends_on, għal grace_days ijiem Intitolat, bl-avviż LICENCE_IN_GRACE fuq Today u fuq il-paġna tal-liċenzja.
RESTRICT Wara l-perjodu ta' grazzja Ebda xogħol ġdid ma jista' jibda taħt grupp liċenzjat. Ix-xogħol li jkun għaddej jintemm, il-qari u l-esportazzjonijiet jibqgħu jaħdmu, u t-tiswijiet tas-sigurtà jibqgħu jaslu.
TERMINATE Adverant irrevokat il-liċenzja L-artefatti ta' Enterprise jieqfu milli jiġu offruti. Il-livell bażiku ta' Community u l-esportazzjoni tad-data jibqgħu.

F'kull stat, ix-xogħol li jkun għaddej jibqa' għaddej, it-tiswijiet tas-sigurtà jibqgħu jaslu, l-esportazzjonijiet jibqgħu jinqraw u xejn ma jitħassar. F'RESTRICT, persuna li tipprova tibda xogħol ġdid ta' Enterprise tara pjanċa ta' rifjut bil-kodiċi LICENCE_LOCKED u l-isem ta' min jista' jġedded.

Kronoloġija orizzontali b'ħames faxex mix-xellug għal-lemin: VALID (minn starts_on), WARN (l-aħħar warn_days tat-terminu), GRACE (grace_days wara ends_on), RESTRICT (wara l-perjodu ta' grazzja). Taħt il-faxex, tliet markaturi ttikkettjati: starts_on, ends_on u ends_on + grace_days. Kaxxa separata taħt il-kronoloġija, magħquda bi vleġġa b'linji maqtugħa minn kwalunkwe faxxa, hija ttikkettjata TERMINATE (lista ta' revoka ffirmata ssemmi l-liċenzja). It-tieni kaxxa fit-tarf nett tax-xellug, barra l-kronoloġija, hija ttikkettjata ABSENT (ebda liċenzja, jew waħda rrifjutata: il-livell bażiku ta' Community).
L-istati tal-liċenzja tul il-kalendarju.

Kif tiġi kkalkulata d-data kurrenti

Arloġġ jista' jkun ħażin, u arloġġ jista' jitreġġa' lura apposta. Għalhekk l-installazzjoni qatt ma taqra l-arloġġ waħdu. Id-data kurrenti hija l-aktar waħda tard minn żewġ mumenti: l-arloġġ tal-ħajt u limitu minimu maħżun (stored floor), li huwa l-aħħar mument li rat l-installazzjoni. Il-limitu minimu jimxi 'l quddiem fuq kull importazzjoni u kull qari tal-istat, u qatt ma jimxi lura waħdu. Li treġġa' l-arloġġ lura b'xahar ma jġibx liċenzja skaduta lura għal VALID; liċenzja RESTRICT tibqa' RESTRICT.

Meta l-arloġġ jaqra qabel il-limitu minimu, l-istat iġorr l-avviż LICENCE_CLOCK_BEHIND_FLOOR u jinqara fil-jum tal-limitu minimu. Jekk l-arloġġ tassew mexa 'l quddiem (node mixgħul bid-data żbaljata u l-limitu minimu nġarr 'il quddiem), itlob lil Adverant għal token ta' risettjar tal-ħin. Huwa dokument żgħir iffirmat marbut mal-id tal-installazzjoni tiegħek u nonce ta' darba, b'mument floor_to. Timportah permezz tal-API b'din it-talba:

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> huwa t-token tal-aċċess ta' amministratur tal-installazzjoni. Token jiġi applikat meta ż-żewġ firem jiġu vverifikati, l-id tal-installazzjoni tiegħu tkun tiegħek u n-nonce tiegħu ma jkunx intuża. Token irrifjutat ma jibdel xejn, għalhekk qatt ma jista' jintuża biex jirrifjuta liċenzja tajba. Token li n-nonce tiegħu jkun diġà ntuża jiġi rrifjutat bi LICENCE_CLOCK_BEHIND_FLOOR.

Talba għal liċenzja

Il-liċenzji jintalbu u jitniżżlu mill-kont Adverant tiegħek fuq https://account.adverant.ai. Min fl-organizzazzjoni tiegħek jista' jikklejmja deployments u jniżżel il-liċenzji huwa ssettjat fuq il-paġna Organizzazzjoni u rwoli tat-tim tal-kont.

Adverant teħtieġ tkun taf għal liema installazzjoni hija l-liċenzja, u hemm tliet modi kif tgħidilha.

Kodiċi ta' darba, għal installazzjoni bi skrin. L-installazzjoni turi kodiċi ta' darba u l-marka tas-swaba' (fingerprint) tagħha. Fuq il-paġna Ikklejmja deployment tippejstja l-kodiċi, imbagħad tqabbel il-marka tas-swaba' grupp b'grupp ma' dak li turi l-installazzjoni. Meta kull grupp jaqbel, tikklejmjah għall-organizzazzjoni tiegħek, u l-liċenzja tasal fuq il-kont.

Ċavetta ta' klejm, għal appliance jew apparat edge. Dawn m'għandhomx skrin biex juru kodiċi. In-numru tas-serje u ċavetta ta' klejm huma stampati fuq il-kaxxa u fl-ordni tal-manifattur tat-tagħmir. Daħħalhom fuq il-paġna Daħħal ċavetta ta' klejm waħda waħda, jew itfa' l-fajl tal-ordni tal-manifattur biex tikklejmja ħafna f'daqqa. Kull ċavetta tiġi ċċekkjata mar-rekord ta' Adverant ta' dak li ntbagħatlek, u ċavetta mill-ordni ta' xi ħadd ieħor tiġi rrifjutata.

Talba għal liċenzja ffirmata, għal installazzjoni mingħajr ebda konnessjoni ma' barra. Din hija r-rotta ta' Harrow. Fuq l-installazzjoni, amministratur jagħmel fajl ta' talba taħt Din l-installazzjoni, Liċenzja. Hija dikjarazzjoni tat-tip licence-request li ssemmi l-id tal-installazzjoni, iffirmata biċ-ċavetta Ed25519 tal-installazzjoni stess. Tomás joħroġha fuq midja approvata, jitfagħha fuq il-paġna Skambju offline, u jniżżel il-fajl tal-liċenzja li jiġi lura. Il-liċenzja taħdem biss fuq l-installazzjoni li għamlet it-talba.

Skambju offline
Skambju offline
L-iskambju offline għal installazzjoni mingħajr ebda konnessjoni ma' barra. Kull fajl li jaqsam min-naħa għall-oħra huwa ffirmat, għalhekk fajl mibdul fit-triq jiġi rrifjutat, u kull skambju huwa elenkat b'min għamlu.
Żewġ kolonni, dik tax-xellug bit-tikketta "Installazzjoni ta' Harrow (bla internet)" u dik tal-lemin bit-tikketta "Kont ta' Adverant". Fuq nett tax-xellug: kaxxa "Fajl ta' talba għal-liċenzja, iffirmat biċ-ċavetta tal-installazzjoni". Vleġġa bit-tikketta "miġbura fuq midja" taqsam għall-kaxxa tal-kolonna tal-lemin "Paġna ta' skambju offline". Taħtha, kaxxa "Fajl tal-liċenzja, iffirmat b'żewġ ċwievet ta' Adverant". Vleġġa bit-tikketta "miġbura lura fuq midja" tirritorna lejn il-kaxxa tal-kolonna tax-xellug "Importazzjoni: console, nexusctl jew API", u minn hemm 'l isfel lejn kaxxa "Iċċekkjat fuq l-installazzjoni mal-għeruq ta' fiduċja inkorporati".
Kif liċenzja tasal għand installazzjoni mingħajr ebda konnessjoni ma' barra.

Importazzjoni ta' liċenzja

Hemm tliet modi kif tidħol, u kollha jilħqu l-istess endpoint fuq nexus-auth. Amministratur tal-installazzjoni biss jista' jimporta: sid jew amministratur tal-organizzazzjoni kollha li tippossjedi l-installazzjoni, li jkun illoggjat fiha, jew amministratur sħiħ tal-pjattaforma. Kwalunkwe persuna oħra tiġi rrifjutata qabel ma jinqara l-fajl.

Fil-console

Fuq installazzjoni ġdida, Importa l-liċenzja huwa wieħed mis-sitt kontrolli fuq Sitt affarijiet qabel ma jidħol xi ħadd. Meta titfa' l-fajl fuq il-paġna, il-console tiċċekkjah fuq l-installazzjoni, offline, u telenka l-gruppi ta' karatteristiċi tiegħu b'kif kull wieħed huwa protett u t-terminu.

Importazzjonijiet aktar tard jgħaddu minn Din l-installazzjoni, Liċenzja: uża Importa liċenzja ġdida, jew Importa liċenzja mġedda meta dik kurrenti tkun skadiet. Installazzjoni Community li tkun qed tgħaddi għal Enterprise tuża Minn Community għal Enterprise. Dik il-paġna taqra l-liċenzja l-ewwel u turi x'se jinġieb u x'jinbidel, qabel ma jiġri xejn. Xejn ma jinġieb sakemm xi ħadd ma jagħżilx Ġib u ixgħel. Il-partijiet ta' Enterprise mbagħad jiġu minn registry.adverant.ai bit-token tal-ġbid (pull token) tal-installazzjoni, kull wieħed iċċekkjat maċ-ċavetta tar-rilaxx ta' Adverant, u l-gruppi jinxtegħlu wieħed wieħed. Tibqa' l-istess installazzjoni wara, bl-istess nies, fajls, flussi tax-xogħol u kanali.

Importa l-liċenzja
Importa l-liċenzja
L-importazzjoni tal-liċenzja waqt is-set-up. Il-fajl ġenwin jelenka l-gruppi ta' karatteristiċi tiegħu; kopja b'żewġ linji mibdula tintwera bħala assenti bil-kodiċi LICENCE_SIGNATURE_INVALID, u l-liċenzja li tkun diġà fis-seħħ titħalla kif inhi.
Minn Community għal Enterprise
Minn Community għal Enterprise
It-trasferiment ta' installazzjoni Community għal Enterprise. Il-liċenzja nqrat u nstabet ġenwina, u l-paġna telenka l-partijiet li għandhom jinġiebu u x'jinbidel qabel ma xi ħadd jagħfas Ġib u ixgħel.

B'nexusctl

nexusctl licence import harrow-2027.licence.json

Il-kmand jimporta l-fajl mhux mibdul u jistampa l-istat kurrenti tal-liċenzja. Żid --explain biex tistampa l-operazzjonijiet li kien iħaddem mingħajr ma tħaddimhom.

Permezz tal-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

Ibgħat il-fajl eżattament kif tahulek Adverant. Tifformattjahx mill-ġdid, u tgeżwrux f'oġġett ieħor: il-body huwa d-dokument. Ir-rotta ma tieħu ebda query string, u body ta' aktar minn 1 MiB jiġi rrifjutat. Membru tal-ogħla livell li jsemmi organizzazzjoni jew persuna jiġi rrifjutat bi TENANT_NOT_A_PARAMETER jew ACTOR_NOT_A_PARAMETER, minħabba li l-liċenzja tal-installazzjoni tappartjeni lill-installazzjoni li tippossjedi l-organizzazzjoni tat-token.

Importazzjoni tajba twieġeb 201. Il-body iżomm id-dehra tal-liċenzja (l-id tagħha, l-istat kurrenti tagħha, id-detentur tal-liċenzja, l-edizzjoni, it-terminu, il-konċessjonijiet u l-gruppi ta' karatteristiċi), kemm-il organizzazzjoni issa għandhomha, u kemm-il kerrej elenkat għad m'għandux organizzazzjoni. Il-liċenzja, id-digest SHA-256 tagħha u r-ringieli tal-leġer għal kull organizzazzjoni jinkitbu fi tranżazzjoni waħda, u l-importazzjoni tiġi rreġistrata fir-reġistru tal-awditjar.

Żewġ rotot tal-qari jmorru magħha:

  • GET /api/v1/installation/licence/state iwieġeb l-istat, ikkalkulat mill-ġdid fuq kull qari. Amministratur jikseb id-dehra sħiħa. Kwalunkwe membru ieħor ta' organizzazzjoni fuq l-installazzjoni jikseb biss l-avviż: l-istat, il-kodiċi tal-avviż (LICENCE_ENDS_SOON, LICENCE_IN_GRACE jew LICENCE_CLOCK_BEHIND_FLOOR) u d-dati li jsemmi l-avviż. Membru qatt ma jara lid-detentur tal-liċenzja, it-terminu jew il-gruppi, minħabba li dawk jappartjenu lis-sid tal-installazzjoni.
  • GET /api/v1/installation/licence/document iwieġeb id-dokument importat, mhux ipproċessat (raw), għall-amministraturi. Kull modulu Enterprise iġibu u jerġa' jiċċekkja l-firem bil-verifikatur ikkumpilat fih stess, sabiex servizz tal-identità mmodifikat ma jkunx jista' jixgħel grupp li l-liċenzja ma tagħtix.

Kull rifjut

Importazzjoni rrifjutata ma tibdel xejn, lanqas il-limitu minimu tal-arloġġ, u r-rifjut jiġi rreġistrat fir-reġistru tal-awditjar.

Kodiċi HTTP Tifsira X'għandek tagħmel
LICENCE_FORMAT_INVALID 422 Il-fajl mhuwiex liċenzja li dan il-build jista' jaqra: mhuwiex JSON, mhuwiex l-iskema, id-dati mhumiex fl-ordni jew grupp imsemmi darbtejn. Ibgħat il-fajl eżattament kif tahulek Adverant.
LICENCE_SIGNATURE_INVALID 422 Waħda miż-żewġ firem hija nieqsa, jew il-fajl inbidel wara l-iffirmar. Erġa' itlob lil Adverant għall-fajl, u teditjahx.
LICENCE_ROOT_UNKNOWN 422 Huwa ffirmat b'ċavetta li t-trust roots ta' dan ir-rilaxx m'għandhomx. Itlob għal liċenzja ffirmata għar-roots ta' dan ir-rilaxx, jew aġġorna.
LICENCE_MATRIX_MISMATCH 422 Huwa miktub kontra matriċi tal-edizzjoni li dan il-build ma jaqrax, jew jagħti grupp li l-katalgu tal-build ma jafx bih. Aġġorna għal rilaxx li jaqrah, jew itlob għal liċenzja miktuba kontra dan ir-rilaxx.
LICENCE_OTHER_INSTALLATION 409 Inħareġ għal id ta' installazzjoni oħra. Itlob għal liċenzja għall-identità ta' din l-installazzjoni.
LICENCE_REVOKED 403 Adverant irtirat din il-liċenzja. Itlob lil Adverant għal liċenzja ġdida.
LICENCE_LOCKED 403 Il-liċenzja għadha ma bdietx: id-data kurrenti hija qabel starts_on. Erġa' importaha fl-ewwel jum tagħha jew wara.
TRANSITION_NOT_PERMITTED 409 Liċenzja b'din l-id diġà ġiet importata. Itlob lil Adverant għal liċenzja ġdida jekk it-termini jridu jinbidlu.
RECORD_NOT_FOUND 404 L-installazzjoni għadha ma ġietx iddikjarata, għalhekk m'għandha ebda identità ma' xiex tiċċekkja. Lesti l-ewwel pass tal-amministratur, imbagħad importa.
VALIDATION_FAILED 400 Il-body ma setax jinqara, huwa aktar minn 1 MiB, jew it-talba kellha query string. Ibgħat il-fajl waħdu bħala l-body, mingħajr ebda query.

L-installazzjoni tiċċekkja f'ordni fissa, u l-ewwel falliment isemmi l-kodiċi. Nofs nieqes jiġi rrappurtat qabel ċavetta mhux magħrufa, u dokument li l-firem tiegħu jfallu qatt ma jinqara aktar, għalhekk fajl imbagħbas li jsemmi wkoll installazzjoni oħra xorta jwieġeb LICENCE_SIGNATURE_INVALID.

Tiġdid

Tiġdid huwa liċenzja ġdida bi licence_id ġdida. Importaha bl-istess mod bħall-ewwel waħda. Tidħol fis-seħħ minnufih, ikun xi jkun l-istat li kienet laħqet il-qadima: minn WARN, GRACE jew RESTRICT l-installazzjoni tmur dritt lura għal liċenzjata, u xejn ma jeħtieġ li jerġa' jiġi installat. Adverant tista' wkoll toħroġ liċenzja mibdula f'nofs it-terminu, pereżempju biex iżżid Kmamar tad-deċiżjonijiet, u inti timporta dik bl-istess mod.

L-importazzjoni tal-istess liċenzja darbtejn tiġi rrifjutata bi TRANSITION_NOT_PERMITTED.

Revoka

Adverant tirtira liċenzja billi tiffirma lista ta' revoka. Il-lista għandha numru sequence u ssemmi kull id ta' liċenzja rtirata b'meta u għaliex. Il-listi huma kumulattivi: kull waħda ġġorr kull id irrevokata qabilha. Timportaha bl-istess mod bħal liċenzja:

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 li s-sekwenza tagħha ma tkunx ogħla mill-aħħar waħda importata tiġi rrifjutata bi TRANSITION_NOT_PERMITTED, sabiex lista qadima ma tkunx tista' titqiegħed lura minflok waħda aktar ġdida. Lista li ma tinqarax jew ma tiġix ivverifikata tiġi rrifjutata bl-istess kodiċijiet bħal liċenzja. Ladarba lista ssemmi l-liċenzja tiegħek, l-istat tagħha jkun TERMINATE.

Installazzjoni mingħajr ebda konnessjoni ma' barra ssir taf biss b'revoka meta xi ħadd jimporta l-lista. Għal Harrow, ir-revoka hija kwistjoni ta' kuntratt daqskemm hija ta' software, u Tomás jimporta kull lista li tibgħat Adverant fil-qsim li jmiss.

Postijiet 'il fuq mil-liċenzja

Il-kwantità tal-liċenzja hija wegħda dwar l-użu, u Nexus jittratta l-qbiż tagħha bħala twissija, u qatt bħala imblukkar (lock-out). Meta aktar nies jużaw Nexus milli tkopri l-liċenzja, l-amministraturi jaraw il-pjanċa SEATS_OVER_LICENCE fuq il-paġna Nies. Kulħadd jibqa' jaħdem. Il-pjanċa tgħid sa meta għandha tiġi rranġata (30 jum), turi minn fejn ġew in-nies żejda, u toffri ż-żewġ soluzzjonijiet: neħħi n-nies li m'għandhomx bżonn Nexus, jew itlob lil Adverant għal aktar postijiet (seats). Iż-żieda ta' postijiet hija bidla sensittiva li teħtieġ it-tieni persuna, u l-postijiet żejda jingħaddu fid-dikjarazzjoni annwali tal-użu.

Postijiet aktar mil-liċenzja
Postijiet 'il fuq mil-liċenzja
Aktar nies milli postijiet. Is-sinkronizzazzjoni tad-direttorju żiedet 143 kuntrattur, u l-pjanċa tagħti 30 jum biex jitneħħew in-nies jew jiżdiedu l-postijiet filwaqt li ħadd ma jiġi mblukkat.

Id-dikjarazzjoni tal-użu żżomm kontaturi biss, u tista' taqra kull linja qabel ma toħroġ. Harrow issalvaha bħala fajl u toħroġha permezz tal-iskambju offline.

Evalwazzjonijiet

Evalwazzjoni hija liċenzja tat-tip evaluation, mibdija mill-paġna Provi tal-kont għal deployment ikklejmjat. Iddum l-aktar 30 jum, tkopri l-aktar 5 persuni msemmija, u m'għandha ebda perjodu ta' grazzja. Fil-jum ta' wara ends_on tmur dritt għal RESTRICT: l-oqsma ta' Enterprise jerġgħu lura għal previżjonijiet (teasers) u xejn magħmul waqt l-evalwazzjoni ma jitħassar. It-tħaddim ta' ideat, il-politiki abbozzati u r-regoli tal-posta jinżammu eżattament kif kienu, u jerġgħu jinfetħu ladarba tiġi importata liċenzja.

Organizzazzjoni tħaddem evalwazzjoni waħda ospitata minnha nnifisha (self-hosted) kull darba.