Verżjoni 1.0.0-alpha.1l-aħħar
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ż

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 (metrikanamed-seat), bigrace_daysissettjat 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.
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.
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.
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.
B'nexusctl
nexusctl licence import harrow-2027.licence.jsonIl-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.jsonIbgħ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/stateiwieġ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_GRACEjewLICENCE_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/documentiwieġ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.jsonLista 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.
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.




