Sínigh isteachCuir cruinniú eolais in áirithe

Caibidil 2.13

Ceadúnais

Cad atá i gcomhad ceadúnais Nexus, conas a sheiceálann an tsuiteáil é as líne, na sé staid ina bhféadfadh sé a bheith, agus conas a iarrann tú, a iompórtálann tú, a athnuachann tú agus a tharraingíonn tú siar ceann.

d'aistrigh AI an leathanach seo ón mbunleagan Béarla. Má tá aon rud doiléir, is é an leathanach Béarla an tagairt. Léigh an leathanach seo i mBéarla

19 nóiméad le léamh

Ritheann Harrow Port Authority Nexus Enterprise ar a bhraisle Kubernetes féin ag harrow.example, gan aon bhealach ón mbraisle chuig an idirlíon. Gach bliain, déanann Aoife Brennan, ceannaire TF, an conradh a athnuachan, agus iompraíonn Tomás Reilly, an t-innealtóir ardáin, comhad beag JSON trasna na bearna agus iompórtálann sé é. Ní atosóidh aon rud, agus taispeánann leathanach an cheadúnais dáta deiridh nua.

Baineann an chaibidil seo leis an gcomhad sin. I mbeagán focal, is doiciméad amháin sínithe JSON é ceadúnas atá ceangailte le suiteáil amháin. Seiceálann an tsuiteáil í féin é, le heochracha poiblí atá leabaithe san íomhá, agus ní dhéanann sí aon ghlaoch líonra chun é sin a dhéanamh. Ní luach Helm é ceadúnas riamh agus ní comhad feistithe é riamh. Iompórtálann tú é tríd an gconsól, nexusctl nó an comhéadan feidhmchláir ríomhchlárúcháin (API), agus ní in aon áit eile.

An doiciméad ceadúnais

Is oibiacht JSON amháin é ceadúnas san fhormáid nexus-licence/v1. Seo ceann Harrow, leis an dá luach sínithe giorraithe.

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

Tá gach réimse riachtanach, agus tá gach oibiacht sa doiciméad dúnta. Diúltaítear do bhall nach liostaíonn an fhormáid, ionas nach féidir le haon rud taisteal lasmuigh den síniú.

Réimse An méid atá ann
format Go díreach nexus-licence/v1. Diúltaítear d'aon luach eile, leagan níos déanaí san áireamh.
licence_id UUID (aitheantóir uathúil uilíoch) i gcás íochtair. Iompórtálann suiteáil gach id ceadúnais uair amháin.
issued_at An nóiméad a d'eisigh Adverant é, mar YYYY-MM-DDThh:mm:ssZ.
type alpha, evaluation nó commercial.
channel An cainéal eisiúna ar eisíodh dó é, amhail alpha. Sínithe agus iompartha; ní ghabhann an tseiceáil treo eile air.
licensee.name 1 go 200 carachtar, sínithe go díreach mar atá sé scríofa. Is dhá ainm dhifriúla iad Brennan agus Brennán le dhá shíniú dhifriúla.
licensee.customer_id D'aitheantas custaiméara ag Adverant: cás íochtair, digití, ., _ agus -.
scope.deployment.installation_id Aitheantas na suiteála, miontaithe ag a seirbhís eochrach ag an gcéad suiteáil.
scope.tenants Aitheantais eagraíochta, suas le 1,000. Folamh mura bhfuil deontas éigin scóipithe do thionóntaí.
edition enterprise nó team. Deonaíonn ceadúnas Enterprise enterprise-base i gcónaí.
grants 1 go 500 péire {feature_group, scope}, gach grúpa ainmnithe uair amháin.
add_ons Aitheantais bhreiseáin ón maitrís eagráin, suas le 100. Féadfaidh sé a bheith folamh.
domain_packs Aitheantais phacáiste fearainn ón maitrís eagráin, suas le 100. Féadfaidh sé a bheith folamh.
metric Is é kind per-environment, per-core nó named-seat; is slánuimhir ó 1 é quantity.
term Is dátaí iad starts_on agus ends_on; is slánuimhreacha ó 0 go 365 iad warn_days agus grace_days.
matrix Leagan na maitríse eagráin a bhfuil na grúpaí scríofa ina choinne, agus SHA-256 an chomhaid mhaitríse sin, coinnithe le haghaidh iniúchta.
signatures Dhá shíniú, ed25519 agus p256. An t-aon réimse amháin nach bhfuil sínithe.

Is dátaí féilire in UTC iad na dátaí, agus ní mór don lá a bheith ann: tá 2028-02-29 go breá agus diúltaítear do 2027-02-29.

Dhá shíniú, an dá cheann ag teastáil

Síníonn Adverant gach ceadúnas le dhá eochair neamhspleácha. Is Ed25519 é síniú amháin. Is ECDSA (Elliptic Curve Digital Signature Algorithm) é an ceann eile ar an gcuar P-256 ó NIST (US National Institute of Standards and Technology), rud a iarrann ceannaitheoirí a dteastaíonn algartaim fheidearálacha SAM uathu. Déantar an dá cheann thar na bearta céanna, agus ní mór an dá cheann a fhíorú. Maidir le doiciméad a bhfuil leath amháin in easnamh air, nó a bhfuil ceachtar leath mícheart, ní áirítear é ina cheadúnas ar chor ar bith.

Is iad na bearta sínithe an fhoirm chanónach RFC 8785 den doiciméad agus signatures bainte amach as, mar sin ní dhéanann spás bán ná ord na mball i do chomhad aon difríocht. Is doiciméad difriúil é aon charachtar amháin a athraítear in ainm an cheadúnaí, sna dátaí nó i ndeontas, agus teipeann air.

Tá na heochracha poiblí a úsáideann an tseiceáil i gcomhad fréamhacha iontaoibhe atá leabaithe i ngach íomhá ag am tógála an eisiúna. Ní ainmníonn aon athróg thimpeallachta, bratach ná feistiú comhad eile. Nuair a chuireann Adverant eochair shínithe nua in ionad ceann eile, síníonn an tseaneochair an ceann nua agus iompraíonn an chéad eisiúint shínithe eile an eochair nua. Fíoraíonn ceadúnas atá sínithe le heochair nua ar eisiúint a iompraíonn í, mar sin tar éis athrú eochrach b'fhéidir go mbeadh ort uasghrádú sula ndéanann tú iompórtáil (féach caibidil 2.17, Fabhtcheartú).

Cineálacha, eagráin agus conas a chomhairtear ceadúnas

Deir an type cén cineál comhaontaithe as a dtagann an ceadúnas:

  • alpha: ceadúnas don chainéal eisiúna alfa, arb é an cineál atá ag Harrow.
  • evaluation: triail féin-óstáilte d'Enterprise. Ritheann sé ar feadh 30 lá ar a mhéad, do 5 dhuine ainmnithe ar a mhéad (méadrach named-seat), le grace_days socraithe go 0. Diúltaíonn an fhormáid do mheastóireacht a bhfuil aon tréimhse chairde ar bith aici.
  • commercial: ceadúnas ar chonradh.

Taifeadann an metric conas a chomhairtear an ceadúnas: per-environment (is timpeallacht amháin é braisle táirgthe Harrow), per-core nó named-seat. Luaigh Adverant an praghas; ní iompraíonn an ceadúnas ach an tomhas agus an chainníocht.

Is é enterprise edition an cheadúnais do gach suiteáil Enterprise. Glacann an fhormáid le team freisin, áit a ndeonaíonn an ceadúnas an grúpa team agus nach ndeonaíonn sé enterprise-base riamh.

Grúpaí gnéithe, breiseáin agus pacáistí fearainn

Liostaítear an méid a ligeann ceadúnas do dhaoine a úsáid de réir grúpa gnéithe, ag úsáid aitheantais na maitríse eagráin. Deonaíonn ceadúnas Harrow enterprise-base (róil saincheaptha, ceaduithe ceithre shúil, coinneáil fhada iniúchta, síniú isteach cuideachta le forfheidhmiú agus sioncrónú eolaire, aonaid ghnó, leathanaigh an oibreora agus an chuid eile de bhonn Enterprise) agus map-and-geoai. Iompraíonn sé an breiseán mail agus an pacáiste fearainn logistics-and-maritime.

Tá rialacha ag an maitrís faoi cad a théann le chéile, agus seiceálann eisiúint Adverant iad sula sínítear ceadúnas. Teastaíonn enterprise-base ó gach breiseán agus ó gach pacáiste. Teastaíonn breiseáin ó phacáistí áirithe: teastaíonn Map agus GeoAI ón bpacáiste Lóistíochta agus muirí, teastaíonn Seomraí cinnteoireachta agus taifid shéalaithe ón bpacáiste Árachais agus ón bpacáiste Margaí caipitil agus bainistíochta sócmhainní, agus teastaíonn Seomraí cinnteoireachta agus Ríomhphost ón bpacáiste Seirbhísí dlí agus gairmiúla. Teastaíonn an breiseán Aipeanna móibíleacha ó scáileáin ghutháin gach pacáiste freisin.

Tá scóip ag gach deontas:

  • deployment: baineann an grúpa leis an tsuiteáil iomlán, do gach eagraíocht atá uirthi.
  • tenant: baineann an grúpa leis na heagraíochtaí atá liostaithe in scope.tenants amháin. Ní mór do cheadúnas a bhfuil deontas scóipithe do thionóntaí aige eagraíocht amháin ar a laghad a liostú, agus diúltaítear do liosta eagraíochtaí nach bhfuil aon deontas scóipithe do thionóntaí aige.

Cuir i gcás go raibh foireann phíolótaíochta Harrow ag rith mar an dara heagraíocht ar an tsuiteáil chéanna, agus nach mbeadh Ideas ach ag an eagraíocht sin amháin. Bheadh { "feature_group": "ideas", "scope": "tenant" } sa deontas, le haitheantas na heagraíochta píolótaíochta in scope.tenants. Dá ndéanfaí an ceadúnas a iompórtáil sula raibh an eagraíocht sin ann, dhéanfadh freagra na hiompórtála é a chomhaireamh faoi tenants_without_organisation, agus shroichfeadh an deontas í nuair a dhéanfaí an eagraíocht.

Is féidir le riarthóir an méid a shroicheann grúpa a chúngú. Ní chuireann ach ceadúnas ó Adverant grúpa leis.

Ceadúnas agus an méid a dhíghlasálann sé
Ceadúnas agus an méid a dhíghlasálann sé
Liostaíonn leathanach an cheadúnais gach grúpa gnéithe mar aon leis an gcaoi a bhfuil sé cosanta agus an méid a chlúdaíonn sé. Fanann grúpaí nach bhfuil ag an gceadúnas sa liosta, iad liath, ionas gur féidir le daoine a fheiceáil cad atá ann.

An téarma: rabhadh agus cairde

Socraíonn an term ceithre dháta ar an bhféilire. Ó starts_on go ends_on tá an ceadúnas i bhfeidhm. Socraíonn warn_days cé chomh luath agus a thosaíonn an rabhadh, agus grace_days cé chomh fada agus a choinníonn gach rud ag obair tar éis an deiridh. Iompraíonn ceadúnais a eisíonn Adverant 30 lá de gach ceann mura ndeir an conradh a mhalairt. Bíonn grace_days 0 ag meastóireacht i gcónaí.

Maidir le ceadúnas Harrow thuas, oibríonn an féilire amach mar seo:

Dátaí Stát
1 Eanáir 2027 go 1 Nollaig 2027 VALID
2 Nollaig 2027 go 31 Nollaig 2027 WARN
1 Eanáir 2028 go 30 Eanáir 2028 GRACE
Ó 31 Eanáir 2028 RESTRICT

Is lá WARN fós é an lá deireanach den téarma, ends_on. Is é GRACE an lá dar gcionn, nó RESTRICT nuair nach bhfuil aon tréimhse chairde ann.

Na sé staid

Gach uair a léitear an ceadúnas, athríomhann an tsuiteáil a staid ón doiciméad agus ón dáta reatha. Ní chuirtear aon rud i dtaisce thar theorainn lae, mar sin tarlaíonn dul in éag in am gan jab sceidealaithe.

Stát Cathain An méid is féidir le daoine a dhéanamh
ABSENT Níor iompórtáladh aon cheadúnas, nó diúltaíodh don doiciméad Urlár Community. Taispeántar limistéir Enterprise mar bhlaiseadh mar aon le cé atá in ann iad a chasadh air.
VALID starts_on go ends_on lúide warn_days Tá gach grúpa deonaithe i dteideal.
WARN Na warn_days lá deireanacha den téarma I dteideal, agus feiceann riarthóirí meirge sa táirge leis an dáta deiridh.
GRACE Tar éis ends_on, ar feadh grace_days lá I dteideal, leis an bhfógra LICENCE_IN_GRACE ar Today agus ar leathanach an cheadúnais.
RESTRICT Tar éis na tréimhse cairde Ní féidir le haon obair nua tosú faoi ghrúpa ceadúnaithe. Críochnaíonn obair atá ag rith, coinníonn léamha agus easpórtálacha ag obair, agus coinníonn ceartúcháin slándála ag teacht.
TERMINATE aisghair Adverant an ceadúnas Stopann déantáin Enterprise de bheith á dtairiscint. Fanann urlár Community agus easpórtáil sonraí.

I ngach staid, coinníonn obair atá ag rith ag rith, coinníonn ceartúcháin slándála ag teacht, fanann easpórtálacha inléite agus ní scriostar aon rud. In RESTRICT, feiceann duine a dhéanann iarracht obair nua Enterprise a thosú pláta diúltaithe leis an gcód LICENCE_LOCKED agus ainm cibé duine atá in ann athnuachan a dhéanamh.

Amlíne chothrománach le cúig bhanda ó chlé go deas: VALID (ó starts_on), WARN (na warn_days deireanacha den téarma), GRACE (grace_days tar éis ends_on), RESTRICT (tar éis na tréimhse cairde). Faoi na bandaí, trí mharcóir lipéadaithe: starts_on, ends_on agus ends_on + grace_days. Tá bosca ar leith faoi bhun na hamlíne, ceangailte le saighead bhriste ó aon bhanda, lipéadaithe TERMINATE (ainmníonn liosta aisghairme sínithe an ceadúnas). Tá an dara bosca ar thaobh na láimhe clé ar fad, lasmuigh den amlíne, lipéadaithe ABSENT (gan ceadúnas, nó ceann diúltaithe: urlár Community).
Staideanna an cheadúnais feadh an fhéilire.

Conas a oibrítear amach an dáta reatha

Is féidir le clog a bheith mícheart, agus is féidir clog a chur siar d'aon ghnó. Mar sin ní léann an tsuiteáil an clog leis féin riamh. Is é an dáta reatha an ceann is déanaí de dhá nóiméad: an clog balla agus urlár stóráilte, arb é an nóiméad is déanaí a chonaic an tsuiteáil. Bogann an t-urlár ar aghaidh ar gach iompórtáil agus ar gach léamh staide, agus ní bhogann sé siar leis féin riamh. Ní thugann cur siar an chloig mí amháin ceadúnas atá imithe in éag ar ais go VALID; fanann ceadúnas RESTRICT mar RESTRICT.

Nuair a léann an clog níos luaithe ná an t-urlár, iompraíonn an staid an fógra LICENCE_CLOCK_BEHIND_FLOOR agus léitear í ag lá an urláir. Má chuaigh an clog chun cinn i ndáiríre (thosaigh nód leis an dáta mícheart agus tugadh an t-urlár ar aghaidh), iarr comhartha athshocraithe ama ar Adverant. Is doiciméad beag sínithe é atá ceangailte le d'aitheantas suiteála agus nonce aonuaire, le nóiméad floor_to. Iompórtálann tú é tríd an API leis an iarratas seo:

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

Is é <access-token> comhartha rochtana riarthóra suiteála. Cuirtear comhartha i bhfeidhm nuair a fhíoraíonn an dá shíniú, nuair is leatsa a aitheantas suiteála agus nuair nach bhfuil a nonce úsáidte. Ní athraíonn comhartha diúltaithe aon rud, mar sin ní féidir é a úsáid riamh chun ceadúnas maith a dhiúltú. Diúltaítear do chomhartha ar úsáideadh a nonce cheana féin le LICENCE_CLOCK_BEHIND_FLOOR.

Ceadúnas a iarraidh

Iarrtar agus íoslódáiltear ceadúnais ó do chuntas Adverant ag https://account.adverant.ai. Socraítear cé i d'eagraíocht a fhéadfaidh imlonnaíochtaí a éileamh agus ceadúnais a íoslódáil ar leathanach Eagraíochta agus ról foirne an chuntais.

Ní mór do Adverant a fháil amach cén tsuiteáil a bhfuil an ceadúnas di, agus tá trí bhealach ann chun é sin a insint dó.

Cód aonuaire, do shuiteáil a bhfuil scáileán aici. Taispeánann an tsuiteáil cód aonuaire agus a méarlorg. Ar an leathanach Éiligh imlonnú greamaíonn tú an cód, ansin cuireann tú an méarlorg i gcomparáid grúpa ar ghrúpa leis an méid a thaispeánann an tsuiteáil. Nuair a mheaitseálann gach grúpa, éilíonn tú é do d'eagraíocht, agus tagann an ceadúnas ar an gcuntas.

Eochair éilimh, d'fhearas nó do ghléas imeallach. Níl aon scáileán acu seo chun cód a thaispeáint. Tá an tsraithuimhir agus eochair éilimh priontáilte ar an mbosca agus in ordú dhéantóir an trealaimh. Cuir isteach iad ar an leathanach Cuir isteach eochair éilimh ceann ar cheann, nó scaoil comhad ordaithe an déantóra chun go leor a éileamh ag an am céanna. Seiceáiltear gach eochair i gcoinne thaifead Adverant ar an méid a seoladh chugat, agus diúltaítear d'eochair ó ordú duine éigin eile.

Iarratas ceadúnais sínithe, do shuiteáil nach bhfuil aon nasc seachtrach aici. Seo bealach Harrow. Ar an tsuiteáil, déanann riarthóir comhad iarratais faoi An tsuiteáil seo, Ceadúnas. Is ráiteas den chineál licence-request é a ainmníonn aitheantas na suiteála, sínithe le heochair Ed25519 na suiteála féin. Iompraíonn Tomás amach é ar mheáin cheadaithe, scaoileann sé é ar an leathanach Malartú as líne, agus íoslódálann sé an comhad ceadúnais a thagann ar ais. Ní oibríonn an ceadúnas ach ar an tsuiteáil a rinne an t-iarratas.

Malartú as líne
Malartú as líne
An malartú as líne do shuiteáil nach bhfuil aon nasc seachtrach aici. Sínítear gach comhad a thrasnaíonn an bhearna, mar sin diúltaítear do chomhad a athraítear ar an mbealach, agus liostaítear gach malartú mar aon le cé a rinne é.
Dhá cholún, lipéad "Suiteáil Harrow (gan idirlíon)" ar an gceann ar chlé agus lipéad "Cuntas Adverant" ar an gceann ar dheis. Barr ar chlé: bosca "Comhad iarratais ceadúnais, sínithe ag eochair na suiteála". Trasnaíonn saighead leis an lipéad "iompartha ar mheán" go dtí an bosca sa cholún ar dheis "Leathanach malartaithe as líne". Faoi sin, bosca "Comhad ceadúnais, sínithe le dhá eochair Adverant". Filleann saighead leis an lipéad "iompartha ar ais ar mheán" ar an mbosca sa cholún ar chlé "Iompórtáil: consól, nexusctl nó API", agus as sin síos go bosca "Seiceáilte ar an tsuiteáil in aghaidh na bhfréamhacha iontaoibhe ionsuite".
Conas a shroicheann ceadúnas suiteáil nach bhfuil aon nasc seachtrach aici.

Ceadúnas a iompórtáil

Tá trí bhealach isteach ann, agus sroicheann siad go léir an críochphointe céanna ar nexus-auth. Ní féidir ach le riarthóir suiteála iompórtáil: úinéir nó riarthóir na heagraíochta iomláine ar léi an tsuiteáil, sínithe isteach inti, nó riarthóir ardáin iomlán. Diúltaítear d'aon duine eile sula léitear an comhad.

Sa chonsól

Ar shuiteáil nua, is é Iompórtáil an ceadúnas ceann de na sé sheiceáil ar Sé rud sula síníonn aon duine isteach. Nuair a scaoileann tú an comhad ar an leathanach, seiceálann an consól é ar an tsuiteáil, as líne, agus liostaíonn sé a ghrúpaí gnéithe mar aon leis an gcaoi a bhfuil gach ceann cosanta agus an téarma.

Téann iompórtálacha níos déanaí trí An tsuiteáil seo, Ceadúnas: úsáid Iompórtáil ceadúnas nua, nó Iompórtáil ceadúnas athnuaite nuair atá an ceann reatha imithe in éag. Úsáideann suiteáil Community atá ag bogadh go Enterprise Ó Community go Enterprise. Léann an leathanach sin an ceadúnas ar dtús agus taispeánann sé cad a gheofar agus cad a athraíonn, sula dtarlaíonn aon rud. Ní fhaightear aon rud go dtí go roghnaíonn duine éigin Faigh agus cas air. Tagann na codanna Enterprise ansin ó registry.adverant.ai le comhartha tarraingthe na suiteála, gach ceann acu seiceáilte i gcoinne eochair eisiúna Adverant, agus casann na grúpaí air ceann ar cheann. Is í an tsuiteáil chéanna í ina dhiaidh sin, leis na daoine, na comhaid, na sreafaí oibre agus na cainéil chéanna.

Iompórtáil an ceadúnas
Iompórtáil an ceadúnas
An ceadúnas á iompórtáil le linn an tsocraithe. Liostaíonn an comhad fíor a ghrúpaí gnéithe; taispeántar cóip a bhfuil dhá líne athraithe inti mar cheann atá as láthair leis an gcód LICENCE_SIGNATURE_INVALID, agus fágtar an ceadúnas atá i bhfeidhm cheana féin mar atá sé.
Ó Community go Enterprise
Ó Community go Enterprise
Suiteáil Community á bogadh go Enterprise. Léadh an ceadúnas agus fuarthas go bhfuil sé fíor, agus liostaíonn an leathanach na codanna le fáil agus cad a athraíonn sula mbrúnn aon duine Faigh agus cas air.

Le nexusctl

nexusctl licence import harrow-2027.licence.json

Iompórtálann an t-ordú an comhad gan athrú agus priontálann sé staid reatha an cheadúnais. Cuir --explain leis chun na hoibríochtaí a rithfeadh sé a phriontáil gan iad a rith.

Tríd an 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

Seol an comhad go díreach mar a thug Adverant duit é. Ná déan é a athfhormáidiú, agus ná cuir i mbosca oibiachta eile é: is é an corp an doiciméad. Ní ghlacann an bealach le haon teaghrán fiosrúcháin, agus diúltaítear do chorp is mó ná 1 MiB. Diúltaítear do bhall barrleibhéil a ainmníonn eagraíocht nó duine le TENANT_NOT_A_PARAMETER nó ACTOR_NOT_A_PARAMETER, toisc go mbaineann ceadúnas na suiteála leis an tsuiteáil ar le heagraíocht an chomhartha í.

Freagraíonn iompórtáil mhaith le 201. Coinníonn an corp amharc an cheadúnais (a id, a staid reatha, an ceadúnaí, an t-eagrán, an téarma, na deontais agus na grúpaí gnéithe), cé mhéad eagraíocht a bhfuil sé acu anois, agus cé mhéad tionónta liostaithe nach bhfuil aon eagraíocht acu fós. Scríobhtar an ceadúnas, aachoimre SHA-256 agus na sraitheanna mórleabhair do gach eagraíocht in aon idirbheart amháin, agus taifeadtar an iompórtáil sa loga iniúchta.

Téann dhá bhealach léite leis:

  • Freagraíonn GET /api/v1/installation/licence/state an staid, athríofa ar gach léamh. Faigheann riarthóir an t-amharc iomlán. Ní fhaigheann aon bhall eile d'eagraíocht ar an tsuiteáil ach an fógra: an staid, cód an fhógra (LICENCE_ENDS_SOON, LICENCE_IN_GRACE nó LICENCE_CLOCK_BEHIND_FLOOR) agus na dátaí a ainmníonn an fógra. Ní fheiceann ball an ceadúnaí, an téarma ná na grúpaí riamh, toisc go mbaineann siad sin le húinéir na suiteála.
  • Freagraíonn GET /api/v1/installation/licence/document an doiciméad iompórtáilte, amh, do riarthóirí. Faigheann gach modúl Enterprise é agus seiceálann sé na sínithe arís lena fhíoraitheoir tiomsaithe féin, ionas nach féidir le seirbhís aitheantais mhodhnaithe grúpa nach ndeonaíonn an ceadúnas a chasadh air.

Gach diúltú

Ní athraíonn iompórtáil dhiúltaithe aon rud, fiú urlár an chloig, agus taifeadtar an diúltú sa loga iniúchta.

Cód HTTP Brí Cad ba cheart a dhéanamh
LICENCE_FORMAT_INVALID 422 Ní ceadúnas é an comhad gur féidir leis an tógáil seo a léamh: ní JSON é, ní hé an scéimre é, tá na dátaí as ord nó tá grúpa ainmnithe faoi dhó. Seol an comhad go díreach mar a thug Adverant duit é.
LICENCE_SIGNATURE_INVALID 422 Tá ceann den dá shíniú in easnamh, nó d'athraigh an comhad tar éis a shínithe. Iarr an comhad ar Adverant arís, agus ná cuir in eagar é.
LICENCE_ROOT_UNKNOWN 422 Tá sé sínithe le heochair nach bhfuil ag fréamhacha iontaoibhe an eisiúna seo. Iarr ceadúnas atá sínithe do fhréamhacha an eisiúna seo, nó déan uasghrádú.
LICENCE_MATRIX_MISMATCH 422 Tá sé scríofa i gcoinne maitrís eagráin nach léann an tógáil seo, nó deonaíonn sé grúpa nach bhfuil eolas ag catalóg na tógála air. Déan uasghrádú go heisiúint a léann é, nó iarr ceadúnas atá scríofa i gcoinne an eisiúna seo.
LICENCE_OTHER_INSTALLATION 409 Eisíodh é le haghaidh aitheantas suiteála eile. Iarr ceadúnas le haghaidh aitheantas na suiteála seo.
LICENCE_REVOKED 403 Tharraing Adverant siar an ceadúnas seo. Iarr ceadúnas nua ar Adverant.
LICENCE_LOCKED 403 Níl tús curtha leis an gceadúnas: tá an dáta reatha roimh starts_on. Iompórtáil arís é ar a chéad lá nó ina dhiaidh.
TRANSITION_NOT_PERMITTED 409 Iompórtáladh ceadúnas leis an id seo cheana féin. Iarr ceadúnas nua ar Adverant más gá na téarmaí a athrú.
RECORD_NOT_FOUND 404 Níor fógraíodh an tsuiteáil fós, mar sin níl aon aitheantas aici le seiceáil ina choinne. Críochnaigh an chéad chéim riarthóra, ansin déan iompórtáil.
VALIDATION_FAILED 400 Níorbh fhéidir an corp a léamh, tá sé os cionn 1 MiB, nó bhí teaghrán fiosrúcháin ag an iarratas. Seol an comhad leis féin mar an corp, gan aon fhiosrúchán.

Seiceálann an tsuiteáil in ord seasta, agus ainmníonn an chéad teip an cód. Tuairiscítear leath atá in easnamh roimh eochair anaithnid, agus ní léitear doiciméad a dteipeann ar a shínithe níos faide riamh, mar sin freagraíonn comhad ar cuireadh isteach air a ainmníonn suiteáil eile freisin le LICENCE_SIGNATURE_INVALID fós.

Athnuachan

Is ceadúnas nua é athnuachan a bhfuil licence_id nua aige. Iompórtáil é ar an mbealach céanna leis an gcéad cheann. Tagann sé i bhfeidhm láithreach, is cuma cén staid a bhí bainte amach ag an seancheann: ó WARN, GRACE nó RESTRICT téann an tsuiteáil díreach ar ais go ceadúnaithe, agus ní gá aon rud a athshuiteáil. Is féidir le Adverant ceadúnas athraithe a eisiúint i lár an téarma freisin, mar shampla chun Seomraí cinnteoireachta a chur leis, agus iompórtálann tú é sin ar an mbealach céanna.

Diúltaítear d'iompórtáil an cheadúnais chéanna faoi dhó le TRANSITION_NOT_PERMITTED.

Cúlghairm

Tarraingíonn Adverant ceadúnas siar trí liosta aisghairme a shíniú. Tá uimhir sequence ag an liosta agus ainmníonn sé gach id ceadúnais a tarraingíodh siar mar aon le cathain agus cén fáth. Tá liostaí carnach: iompraíonn gach ceann acu gach id a aisghaireadh roimhe. Iompórtálann tú é ar an mbealach céanna le ceadúnas:

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

Diúltaítear do liosta nach bhfuil a sheicheamh níos airde ná an ceann deireanach a iompórtáladh le TRANSITION_NOT_PERMITTED, ionas nach féidir seanliosta a chur ar ais in áit ceann níos nuaí. Diúltaítear do liosta nach léitear nó nach bhfíoraítear leis na cóid chéanna le ceadúnas. Nuair a ainmníonn liosta do cheadúnas, is é TERMINATE a staid.

Ní fhaigheann suiteáil nach bhfuil aon nasc seachtrach aici amach faoi aisghairm ach nuair a iompórtálann duine éigin an liosta. Maidir le Harrow, is ceist chonartha chomh maith le ceist bhogearraí í an aisghairm, agus iompórtálann Tomás gach liosta a sheolann Adverant ag an gcéad trasnú eile.

Suíocháin os cionn an cheadúnais

Is gealltanas faoi úsáid í cainníocht an cheadúnais, agus caitheann Nexus le dul thairis mar rabhadh, agus ní mar fhrithdhúnadh riamh. Nuair a úsáideann níos mó daoine Nexus ná mar a chlúdaíonn an ceadúnas, feiceann riarthóirí an pláta SEATS_OVER_LICENCE ar an leathanach Daoine. Coinníonn gach duine ag obair. Deir an pláta cathain is ceart é a chur ina cheart (30 lá), taispeánann sé cá as a dtáinig na daoine breise, agus tairgeann sé an dá réiteach: bain daoine nach dteastaíonn Nexus uathu, nó iarr níos mó suíochán ar Adverant. Is athrú íogair é suíocháin a chur leis a dteastaíonn an dara duine uaidh, agus comhairtear na suíocháin bhreise sa ráiteas úsáide bliantúil.

Suíocháin os cionn an cheadúnais
Suíocháin thar an gceadúnas
Níos mó daoine ná suíocháin. Chuir sioncrónú eolaire 143 conraitheoir leis, agus tugann an pláta 30 lá chun daoine a bhaint nó suíocháin a chur leis gan aon duine a bheith frithdhúnta.

Ní choinníonn an ráiteas úsáide ach áiritheoirí amháin, agus is féidir leat gach líne a léamh sula bhfágann sé. Sábhálann Harrow mar chomhad é agus iompraíonn sé amach é tríd an malartú as líne.

Meastóireachtaí

Is ceadúnas den chineál evaluation í meastóireacht, a thosaítear ó leathanach Trialacha an chuntais le haghaidh imlonnú éilithe. Maireann sé 30 lá ar a mhéad, clúdaíonn sé 5 dhuine ainmnithe ar a mhéad, agus níl aon tréimhse chairde aige. Ar an lá tar éis ends_on téann sé díreach go RESTRICT: filleann limistéir Enterprise ar bhlaisíní agus ní scriostar aon rud a rinneadh le linn na meastóireachta. Coinnítear riteacha smaoineamh, dréachtpholasaithe agus rialacha ríomhphoist go díreach mar a bhí siad, agus osclaíonn siad arís nuair a iompórtáiltear ceadúnas.

Ritheann eagraíocht meastóireacht féin-óstáilte amháin ag an am.