Versio 1.0.0-alpha.1uusin
Luku 2.13
Lisenssit
Mitä Nexuksen lisenssitiedosto sisältää, kuinka asennus tarkistaa sen offline-tilassa, sen kuusi mahdollista tilaa ja kuinka pyydät, tuot, uusit ja peruutat lisenssin.
Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

Harrow Port Authority ajaa Nexus Enterprise -järjestelmää omalla Kubernetes-klusterillaan osoitteessa harrow.example, eikä klusterista ole reittiä internetiin. Joka vuosi tietohallintojohtaja Aoife Brennan uusii sopimuksen, ja alustainsinööri Tomás Reilly siirtää pienen JSON-tiedoston eristetyn verkon yli ja tuo sen järjestelmään. Mikään ei käynnisty uudelleen, ja lisenssisivulla näkyy uusi päättymispäivä.
Tämä luku käsittelee kyseistä tiedostoa. Lyhyesti sanottuna lisenssi on yksi allekirjoitettu JSON-dokumentti, joka on sidottu yhteen asennukseen. Asennus tarkistaa sen itse levykuvaan sisällytetyillä julkisilla avaimilla tekemättä verkkokutsuja. Lisenssi ei ole koskaan Helm-arvo eikä liitetty tiedosto. Tuotte sen konsolin, nexusctl-komennon tai ohjelmointirajapinnan (API) kautta, ettekä mistään muualta.
Lisenssiasiakirja
Lisenssi on yksi JSON-objekti muodossa nexus-licence/v1. Tässä on Harrow'n lisenssi, josta kaksi allekirjoitusarvoa on lyhennetty.
{
"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>" }
}
}Jokainen kenttä on pakollinen, ja jokainen dokumentin objekti on suljettu. Jäsen, jota muoto ei luettele, hylätään, joten mikään ei voi kulkea mukana allekirjoituksen ulkopuolella.
| Kenttä | Mitä se sisältää |
|---|---|
format |
Täsmälleen nexus-licence/v1. Mikä tahansa muu arvo, myöhempi versio mukaan lukien, hylätään. |
licence_id |
Pienillä kirjaimilla kirjoitettu UUID (yleisesti yksilöllinen tunniste). Asennus tuo kunkin lisenssitunnisteen vain kerran. |
issued_at |
Tarkka ajanhetki, jolloin Adverant myönsi sen, muodossa YYYY-MM-DDThh:mm:ssZ. |
type |
alpha, evaluation tai commercial. |
channel |
Julkaisukanava, jolle se on myönnetty, kuten alpha. Allekirjoitettu ja kulkee mukana; tarkistus ei haaroidu sen perusteella. |
licensee.name |
1–200 merkkiä, allekirjoitettu täsmälleen kirjoitetussa muodossa. Brennan ja Brennán ovat kaksi eri nimeä, joilla on kaksi eri allekirjoitusta. |
licensee.customer_id |
Asiakastunnisteenne Adverantilla: pienet kirjaimet, numerot, ., _ ja -. |
scope.deployment.installation_id |
Asennuksen identiteetti, jonka sen avainpalvelu luo ensimmäisen asennuksen yhteydessä. |
scope.tenants |
Organisaatiotunnisteet, enintään 1 000. Tyhjä, ellei jokin käyttöoikeus ole vuokraajakohtainen. |
edition |
enterprise tai team. Enterprise-lisenssi myöntää aina arvon enterprise-base. |
grants |
1–500 {feature_group, scope}-paria, jokainen ryhmä nimettynä kerran. |
add_ons |
Lisäosien tunnisteet versioiden ominaisuusmatriisista, enintään 100. Voi olla tyhjä. |
domain_packs |
Toimialapakettien tunnisteet versioiden ominaisuusmatriisista, enintään 100. Voi olla tyhjä. |
metric |
kind on per-environment, per-core tai named-seat; quantity on kokonaisluku alkaen luvusta 1. |
term |
starts_on ja ends_on ovat päivämääriä; warn_days ja grace_days ovat kokonaislukuja väliltä 0–365. |
matrix |
Ominaisuusmatriisin versio, jota vasten ryhmät on kirjoitettu, sekä kyseisen matriisitiedoston SHA-256-tiiviste, joka säilytetään auditointia varten. |
signatures |
Kaksi allekirjoitusta, ed25519 ja p256. Ainoa kenttä, jota ei allekirjoiteta. |
Päivämäärät ovat UTC-kalenteripäiviä, ja päivän on oltava olemassa: 2028-02-29 kelpaa ja 2027-02-29 hylätään.
Kaksi allekirjoitusta, molemmat vaaditaan
Adverant allekirjoittaa jokaisen lisenssin kahdella toisistaan riippumattomalla avaimella. Toinen allekirjoitus on Ed25519. Toinen on NISTin (Yhdysvaltain kansallinen standardi- ja teknologia-instituutti) P-256-käyrää käyttävä ECDSA (Elliptic Curve Digital Signature Algorithm), jota Yhdysvaltain liittovaltion algoritmeja tarvitsevat ostajat pyytävät. Molemmat muodostetaan samoista tavuista, ja molempien on mentävä läpi tarkistuksesta. Dokumentti, josta puuttuu toinen puolisko tai jossa jompikumpi puolisko on väärin, ei kelpaa lisenssiksi lainkaan.
Allekirjoitetut tavut ovat dokumentin RFC 8785 -standardin mukainen kanoninen muoto, josta signatures on poistettu, joten tiedoston tyhjillä merkeillä ja jäsenten järjestyksellä ei ole merkitystä. Yksikin muuttunut merkki lisenssinhaltijan nimessä, päivämäärissä tai käyttöoikeudessa tekee dokumentista eri dokumentin, jolloin tarkistus epäonnistuu.
Julkiset avaimet, joita tarkistus käyttää, sijaitsevat luottamusjuuritiedostossa, joka on sisällytetty jokaiseen levykuvaan julkaisun koontivaiheessa. Mikään ympäristömuuttuja, valitsin tai liitos ei nimeä toista tiedostoa. Kun Adverant vaihtaa allekirjoitusavaimen, vanha avain allekirjoittaa uuden ja seuraava allekirjoitettu julkaisu sisältää uuden avaimen. Uudella avaimella allekirjoitettu lisenssi menee läpi tarkistuksesta julkaisussa, joka sisältää kyseisen avaimen, joten avaimen vaihdon jälkeen järjestelmä on ehkä päivitettävä ennen lisenssin tuontia (katso luku 2.17, Vianmääritys).
Tyypit, versiot ja lisenssin laskentatapa
Kenttä type kertoo, millaisesta sopimuksesta lisenssi on peräisin:
alpha: lisenssi alfa-julkaisukanavalle; tämä on lisenssityyppi, joka Harrow'lla on.evaluation: omissa tiloissa ylläpidettävä Enterprise-kokeiluversio. Se on voimassa enintään 30 päivää, enintään 5 nimetylle henkilölle (mittarinamed-seat), jagrace_dayson asetettu arvoon 0. Muoto hylkää kokeiluversion, jossa on lainkaan lisäaikaa.commercial: sopimusperusteinen lisenssi.
Kenttä metric kirjaa, miten lisenssi lasketaan: per-environment (Harrow'n tuotantoklusteri on yksi ympäristö), per-core tai named-seat. Adverant antaa hintatarjouksen; lisenssi sisältää vain mittarin ja määrän.
Lisenssin edition on enterprise jokaisessa Enterprise-asennuksessa. Muoto hyväksyy myös arvon team, jolloin lisenssi myöntää ryhmän team eikä koskaan ryhmää enterprise-base.
Ominaisuusryhmät, lisäosat ja toimialapaketit
Se, mitä lisenssi antaa käyttäjien käyttää, on lueteltu ominaisuusryhmittäin käyttäen versioiden ominaisuusmatriisin tunnisteita. Harrow'n lisenssi myöntää ryhmät enterprise-base (mukautetut roolit, neljän silmän hyväksynnät, pitkä auditointilokien säilytys, yrityskirjautuminen pakotuksella ja hakemistosynkronoinnilla, liiketoimintayksiköt, operaattorisivut ja muu Enterprise-perusta) sekä map-and-geoai. Se sisältää mail-lisäosan ja logistics-and-maritime-toimialapaketin.
Matriisissa on säännöt siitä, mitkä osat kuuluvat yhteen, ja Adverantin myöntämisjärjestelmä tarkistaa ne ennen lisenssin allekirjoittamista. Jokainen lisäosa ja jokainen paketti vaatii ryhmän enterprise-base. Jotkin paketit vaativat lisäosia: Logistics and maritime -paketti vaatii Map and GeoAI -lisäosan, Insurance-paketti sekä Capital markets and asset management -paketti vaativat Decision rooms- ja sealed records -lisäosat, ja Legal and professional services -paketti vaatii Decision rooms- ja Mail-lisäosat. Jokaisen paketin puhelinnäkymät vaativat myös Mobile apps -lisäosan.
Jokaisella käyttöoikeudella on laajuus:
deployment: ryhmä koskee koko asennusta ja jokaista siinä olevaa organisaatiota.tenant: ryhmä koskee vain kohdassascope.tenantslueteltuja organisaatioita. Lisenssissä, jossa on vuokraajakohtainen käyttöoikeus, on lueteltava vähintään yksi organisaatio, ja organisaatioluettelo ilman vuokraajakohtaista käyttöoikeutta hylätään.
Oletetaan, että Harrow'n luotsaustiimi toimisi toisena organisaationa samassa asennuksessa ja vain tällä organisaatiolla olisi Ideas käytössään. Käyttöoikeus olisi muodossa { "feature_group": "ideas", "scope": "tenant" }, ja luotsausorganisaation tunniste olisi kohdassa scope.tenants. Jos lisenssi tuotaisiin ennen kuin kyseinen organisaatio on olemassa, tuontivastaus laskisi sen kohtaan tenants_without_organisation, ja käyttöoikeus tulisi sille voimaan heti, kun organisaatio on luotu.
Pääkäyttäjä voi kaventaa sitä, mihin ryhmä ulottuu. Vain Adverantin myöntämä lisenssi voi lisätä ryhmän.
Voimassaoloaika: varoitus- ja lisäaika
Kenttä term asettaa kalenteriin neljä päivämäärää. Päivästä starts_on päivään ends_on lisenssi on voimassa. warn_days määrittää, kuinka aikaisin varoitus alkaa, ja grace_days sen, kuinka kauan kaikki toimii edelleen päättymisen jälkeen. Adverantin myöntämissä lisensseissä kumpikin jakso on 30 päivää, ellei sopimuksessa toisin mainita. Kokeiluversiossa grace_days on aina 0.
Yllä olevan Harrow'n lisenssin kohdalla kalenteri muodostuu seuraavasti:
| Päivämäärät | Tila |
|---|---|
| 1. tammikuuta 2027 – 1. joulukuuta 2027 | VALID |
| 2. joulukuuta 2027 – 31. joulukuuta 2027 | WARN |
| 1. tammikuuta 2028 – 30. tammikuuta 2028 | GRACE |
| Alkaen 31. tammikuuta 2028 | RESTRICT |
Sopimuskauden viimeinen päivä, ends_on, on vielä WARN-päivä. Sitä seuraava päivä on GRACE, tai RESTRICT, jos lisäaikaa ei ole.
Kuusi tilaa
Joka kerta, kun lisenssi luetaan, asennus laskee sen tilan uudelleen dokumentin ja kuluvan päivämäärän perusteella. Mitään ei tallenneta välimuistiin vuorokauden rajan yli, joten vanheneminen tapahtuu ajallaan ilman ajastettua työtä.
| Tila | Tilanne | Mitä käyttäjät voivat tehdä |
|---|---|---|
| ABSENT | Lisenssiä ei ole tuotu, tai dokumentti hylättiin | Community-perustaso. Enterprise-alueet näkyvät esittelyinä, joissa kerrotaan, kuka voi ottaa ne käyttöön. |
| VALID | starts_on – ends_on miinus warn_days |
Jokainen myönnetty ryhmä on käyttöoikeutettu. |
| WARN | Sopimuskauden viimeiset warn_days päivää |
Käyttöoikeutettu, ja pääkäyttäjät näkevät tuotteen sisäisen ilmoituspalkin, jossa on päättymispäivä. |
| GRACE | Päivän ends_on jälkeen, grace_days päivän ajan |
Käyttöoikeutettu, ja Today-näkymässä sekä lisenssisivulla näkyy huomautus LICENCE_IN_GRACE. |
| RESTRICT | Lisäajan jälkeen | Lisensoidussa ryhmässä ei voida aloittaa uutta työtä. Käynnissä oleva työ valmistuu, luku ja vienti toimivat edelleen ja tietoturvakorjauksia saapuu jatkuvasti. |
| TERMINATE | Adverant peruutti lisenssin | Enterprise-artefakteja ei enää tarjota. Community-perustaso ja tietojen vienti säilyvät. |
Jokaisessa tilassa käynnissä oleva työ jatkuu, tietoturvakorjauksia saapuu jatkuvasti, viennit pysyvät luettavina eikä mitään poisteta. RESTRICT-tilassa henkilö, joka yrittää aloittaa uuden Enterprise-työn, näkee hylkäysilmoituksen, jossa on koodi LICENCE_LOCKED ja sen henkilön nimi, joka voi uusia lisenssin.
Miten nykyinen päivämäärä määritetään
Kello voi olla väärässä, ja kelloa voidaan siirtää taaksepäin tarkoituksella. Siksi asennus ei koskaan lue pelkkää kelloa. Nykyinen päivämäärä on myöhäisempi kahdesta ajanhetkestä: seinäkellosta ja tallennetusta alarajasta, joka on viimeisin asennuksen näkemä ajanhetki. Alaraja siirtyy eteenpäin jokaisen tuonnin ja jokaisen tilan luvun yhteydessä, eikä se koskaan siirry taaksepäin itsestään. Kellon siirtäminen kuukaudella taaksepäin ei palauta vanhentunutta lisenssiä VALID-tilaan; RESTRICT-tilassa oleva lisenssi pysyy RESTRICT-tilassa.
Kun kello näyttää alarajaa aiempaa aikaa, tilassa on ilmoitus LICENCE_CLOCK_BEHIND_FLOOR ja se luetaan alarajan päivän mukaan. Jos kello todella kävi edellä (solmu käynnistyi väärällä päivämäärällä ja alaraja siirtyi eteenpäin), pyydä Adverantilta ajan nollausvaltuus. Se on pieni allekirjoitettu asiakirja, joka on sidottu asennustunnukseesi ja kertakäyttöiseen nonce-arvoon ja jossa on floor_to-ajanhetki. Tuot sen API:n kautta tällä pyynnöllä:
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> on asennuksen pääkäyttäjän käyttövaltuus. Valtuus otetaan käyttöön, kun molemmat allekirjoitukset vahvistetaan, sen asennustunnus on sinun eikä sen nonce-arvoa ole käytetty. Hylätty valtuus ei muuta mitään, joten sitä ei voida koskaan käyttää kelvollisen lisenssin hylkäämiseen. Valtuus, jonka nonce-arvo on jo käytetty, hylätään koodilla LICENCE_CLOCK_BEHIND_FLOOR.
Lisenssin pyytäminen
Lisenssit pyydetään ja ladataan Adverant-tililtäsi osoitteessa https://account.adverant.ai. Se, kuka organisaatiossasi saa lunastaa käyttöönottoja ja ladata lisenssejä, määritetään tilin Organisaatio ja tiimiroolit -sivulla.
Adverantin on tiedettävä, mille asennukselle lisenssi on tarkoitettu, ja sen ilmoittamiseen on kolme tapaa.
Kertakäyttökoodi näytölliselle asennukselle. Asennus näyttää kertakäyttökoodin ja sormenjälkensä. Lunasta käyttöönotto -sivulla liität koodin ja vertaat sitten sormenjälkeä ryhmä kerrallaan siihen, mitä asennus näyttää. Kun jokainen ryhmä täsmää, lunastat sen organisaatiollesi, ja lisenssi saapuu tilille.
Lunastusavain laitteelle tai reunalaitteelle. Näissä ei ole näyttöä koodin esittämiseen. Sarjanumero ja lunastusavain on painettu laatikkoon ja laitevalmistajan tilaukseen. Syötä ne Syötä lunastusavain -sivulla yksi kerrallaan tai pudota valmistajan tilaustiedosto lunastaaksesi monta kerralla. Jokainen avain tarkistetaan Adverantin tietueesta sinulle toimitetuista laitteista, ja jonkun toisen tilauksesta peräisin oleva avain hylätään.
Allekirjoitettu lisenssipyyntö asennukselle, jolla ei ole ulkoista yhteyttä. Tämä on Harrow'n reitti. Asennuksessa pääkäyttäjä luo pyyntötiedoston kohdassa Tämä asennus, Lisenssi. Se on licence-request-tyyppinen lausunto, joka nimeää asennustunnuksen ja on allekirjoitettu asennuksen omalla Ed25519-avaimella. Tomás vie sen ulos hyväksytyllä tallennusvälineellä, pudottaa sen Offline-vaihto-sivulle ja lataa palautuvan lisenssitiedoston. Lisenssi toimii vain siinä asennuksessa, joka teki pyynnön.
Lisenssin tuominen
Sisääntulotapoja on kolme, ja ne kaikki päätyvät samaan päätepisteeseen nexus-auth-palvelussa. Vain asennuksen pääkäyttäjä voi tuoda lisenssin: asennuksen omistavan koko organisaation omistaja tai pääkäyttäjä, joka on kirjautuneena siihen, tai koko alustan pääkäyttäjä. Kaikki muut hylätään ennen tiedoston lukemista.
Konsolissa
Uudessa asennuksessa Tuo lisenssi on yksi kuudesta tarkistuksesta Kuusi asiaa ennen kuin kukaan kirjautuu sisään -sivulla. Kun pudotat tiedoston sivulle, konsoli tarkistaa sen asennuksessa offline-tilassa ja luettelee sen ominaisuusryhmät sekä kunkin suojausmenetelmän ja voimassaoloajan.
Myöhemmät tuonnit tehdään kohdassa Tämä asennus, Lisenssi: käytä Tuo uusi lisenssi -toimintoa tai Tuo uusittu lisenssi -toimintoa, kun nykyinen on vanhentunut. Community-asennus, joka siirtyy Enterprise-versioon, käyttää Siirry Communitysta Enterpriseen -toimintoa. Kyseinen sivu lukee ensin lisenssin ja näyttää, mitä noudetaan ja mikä muuttuu, ennen kuin mitään tapahtuu. Mitään ei noudeta, ennen kuin joku valitsee Nouda ja ota käyttöön. Enterprise-osat tulevat sen jälkeen osoitteesta registry.adverant.ai asennuksen noutovaltuudella, jokainen niistä tarkistetaan Adverantin julkaisuavainta vasten, ja ryhmät kytkeytyvät päälle yksi kerrallaan. Se on sen jälkeen sama asennus, jossa ovat samat henkilöt, tiedostot, työnkulut ja kanavat.
nexusctl-työkalulla
nexusctl licence import harrow-2027.licence.jsonKomento tuo tiedoston muuttumattomana ja tulostaa lisenssin nykyisen tilan. Lisää --explain tulostaaksesi toimenpiteet, jotka se suorittaisi, suorittamatta niitä.
API:n kautta
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.jsonLähetä tiedosto täsmälleen sellaisena kuin Adverant sen sinulle antoi. Älä muotoile sitä uudelleen äläkä kääri sitä toiseen objektiin: runko on itse asiakirja. Reitti ei ota kyselymerkkijonoa, ja yli 1 MiB:n runko hylätään. Ylimmän tason jäsen, joka nimeää organisaation tai henkilön, hylätään koodilla TENANT_NOT_A_PARAMETER tai ACTOR_NOT_A_PARAMETER, koska asennuksen lisenssi kuuluu sille asennukselle, jonka valtuuden organisaatio omistaa.
Onnistunut tuonti vastaa 201. Runko sisältää lisenssinäkymän (sen tunnuksen, nykyisen tilan, lisenssinhaltijan, version, voimassaoloajan, käyttöoikeudet ja ominaisuusryhmät), tiedon siitä, kuinka monella organisaatiolla se nyt on, ja kuinka monella luetellulla vuokraajalla ei ole vielä organisaatiota. Lisenssi, sen SHA-256-tiiviste ja kunkin organisaation tilikirjarivit kirjoitetaan yhdessä tapahtumassa, ja tuonti kirjataan tarkastuslokiin.
Siihen liittyy kaksi lukureittiä:
GET /api/v1/installation/licence/statevastaa tilan, joka lasketaan uudelleen jokaisella lukukerralla. Pääkäyttäjä saa täyden näkymän. Kuka tahansa muu asennuksessa olevan organisaation jäsen saa vain ilmoituksen: tilan, ilmoituskoodin (LICENCE_ENDS_SOON,LICENCE_IN_GRACEtaiLICENCE_CLOCK_BEHIND_FLOOR) ja ilmoituksen nimeämät päivämäärät. Jäsen ei koskaan näe lisenssinhaltijaa, voimassaoloaikaa tai ryhmiä, koska ne kuuluvat asennuksen omistajalle.GET /api/v1/installation/licence/documentvastaa tuodun asiakirjan raakamuodossa pääkäyttäjille. Jokainen Enterprise-moduuli noutaa sen ja tarkistaa allekirjoitukset uudelleen omalla sisäänrakennetulla tarkistimellaan, joten muokattu identiteettipalvelu ei voi kytkeä päälle ryhmää, jota lisenssi ei myönnä.
Jokainen hylkäys
Hylätty tuonti ei muuta mitään, ei edes kellon alarajaa, ja hylkäys kirjataan tarkastuslokiin.
| Koodi | HTTP | Merkitys | Mitä tehdä |
|---|---|---|---|
LICENCE_FORMAT_INVALID |
422 | Tiedosto ei ole lisenssi, jota tämä koontiversio pystyy lukemaan: se ei ole JSON-muotoa, ei vastaa skeemaa, päivämäärät ovat väärässä järjestyksessä tai ryhmä on nimetty kahdesti. | Lähetä tiedosto täsmälleen sellaisena kuin Adverant sen sinulle antoi. |
LICENCE_SIGNATURE_INVALID |
422 | Toinen kahdesta allekirjoituksesta puuttuu tai tiedosto on muuttunut allekirjoittamisen jälkeen. | Pyydä tiedostoa uudelleen Adverantilta äläkä muokkaa sitä. |
LICENCE_ROOT_UNKNOWN |
422 | Se on allekirjoitettu avaimella, jota tämän julkaisun luottamusjuuret eivät sisällä. | Pyydä tämän julkaisun juurille allekirjoitettua lisenssiä tai päivitä järjestelmä. |
LICENCE_MATRIX_MISMATCH |
422 | Se on kirjoitettu versiomatriisille, jota tämä koontiversio ei lue, tai se myöntää ryhmän, jota koontiversion luettelo ei tunne. | Päivitä julkaisuun, joka lukee sen, tai pyydä tälle julkaisulle kirjoitettua lisenssiä. |
LICENCE_OTHER_INSTALLATION |
409 | Se on myönnetty toiselle asennustunnukselle. | Pyydä lisenssiä tämän asennuksen identiteetille. |
LICENCE_REVOKED |
403 | Adverant on peruuttanut tämän lisenssin. | Pyydä Adverantilta uusi lisenssi. |
LICENCE_LOCKED |
403 | Lisenssi ei ole alkanut: nykyinen päivämäärä on ennen arvoa starts_on. |
Tuo se uudelleen sen ensimmäisenä voimassaolopäivänä tai sen jälkeen. |
TRANSITION_NOT_PERMITTED |
409 | Tällä tunnuksella varustettu lisenssi on jo tuotu. | Pyydä Adverantilta uusi lisenssi, jos ehtojen on muututtava. |
RECORD_NOT_FOUND |
404 | Asennusta ei ole vielä määritetty, joten sillä ei ole identiteettiä, jota vasten tarkistus voitaisiin tehdä. | Suorita ensimmäinen pääkäyttäjän vaihe loppuun ja tee tuonti sen jälkeen. |
VALIDATION_FAILED |
400 | Runkoa ei voitu lukea, se on yli 1 MiB tai pyynnössä oli kyselymerkkijono. | Lähetä pelkkä tiedosto runkona ilman kyselyä. |
Asennus tekee tarkistukset kiinteässä järjestyksessä, ja ensimmäinen virhe määrittää koodin. Puuttuva puolikas ilmoitetaan ennen tuntematonta avainta, eikä asiakirjaa, jonka allekirjoitukset epäonnistuvat, lueta koskaan pidemmälle, joten peukaloitu tiedosto, joka nimeää myös toisen asennuksen, vastaa silti LICENCE_SIGNATURE_INVALID.
Uusiminen
Uusiminen on uusi lisenssi, jolla on uusi licence_id. Tuo se samalla tavalla kuin ensimmäinen. Se tulee voimaan välittömästi riippumatta siitä, mihin tilaan vanha oli päätynyt: WARN-, GRACE- tai RESTRICT-tilasta asennus palaa suoraan lisensoituun tilaan, eikä mitään tarvitse asentaa uudelleen. Adverant voi myös myöntää muutetun lisenssin kesken kauden, esimerkiksi Päätöshuoneiden lisäämiseksi, ja tuot sen samalla tavalla.
Saman lisenssin tuominen kahdesti hylätään koodilla TRANSITION_NOT_PERMITTED.
Peruuttaminen
Adverant peruuttaa lisenssin allekirjoittamalla sulkulistan. Listalla on sequence-numero, ja siinä nimetään jokainen peruutettu lisenssitunnus sekä peruutuksen ajankohta ja syy. Listat ovat kumulatiivisia: jokainen sisältää kaikki sitä ennen peruutetut tunnukset. Tuot sen samalla tavalla kuin lisenssin:
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, jonka järjestysnumero ei ole suurempi kuin viimeksi tuodun, hylätään koodilla TRANSITION_NOT_PERMITTED, joten vanhaa listaa ei voida palauttaa uudemman tilalle. Lista, jota ei voida lukea tai vahvistaa, hylätään samoilla koodeilla kuin lisenssi. Kun lista nimeää lisenssisi, sen tilaksi tulee TERMINATE.
Asennus, jolla ei ole ulkoista yhteyttä, saa tiedon peruutuksesta vasta, kun joku tuo listan. Harrow'lle peruutus on yhtä lailla sopimus- kuin ohjelmistoasia, ja Tomás tuo jokaisen Adverantin lähettämän listan seuraavan siirron yhteydessä.
Lisenssin ylittävät käyttöoikeudet
Lisenssin määrä on lupaus käytöstä, ja Nexus käsittelee sen ylittämistä varoituksena, ei koskaan uloslukituksena. Kun useampi henkilö käyttää Nexusta kuin lisenssi kattaa, pääkäyttäjät näkevät Henkilöt-sivulla ilmoituksen SEATS_OVER_LICENCE. Kaikki voivat jatkaa työskentelyä. Ilmoituksessa kerrotaan, mihin mennessä asia on korjattava (30 päivää), näytetään, mistä ylimääräiset henkilöt ovat tulleet, ja tarjotaan kaksi korjaustapaa: poista henkilöt, jotka eivät tarvitse Nexusta, tai pyydä Adverantilta lisää käyttöpaikkoja. Käyttöpaikkojen lisääminen on arkaluonteinen muutos, joka vaatii toisen henkilön vahvistuksen, ja ylimääräiset käyttöpaikat lasketaan mukaan vuotuiseen käyttöilmoitukseen.
Käyttöilmoitus sisältää vain laskureita, ja voit lukea jokaisen rivin ennen sen lähettämistä. Harrow tallentaa sen tiedostona ja vie sen ulos offline-vaihdon kautta.
Arvioinnit
Arviointi on evaluation-tyyppinen lisenssi, joka käynnistetään tilin Kokeilut-sivulta lunastetulle käyttöönotolle. Se kestää enintään 30 päivää, kattaa enintään 5 nimettyä henkilöä eikä sisällä lisäaikaa. ends_on-päivän jälkeisenä päivänä se siirtyy suoraan RESTRICT-tilaan: Enterprise-alueet palaavat esittelytilaan, eikä mitään arvioinnin aikana tehtyä poisteta. Ideoinnit, luonnostellut käytännöt ja sähköpostisäännöt säilytetään täsmälleen sellaisina kuin ne olivat, ja ne avautuvat jälleen, kun lisenssi tuodaan.
Organisaatio suorittaa yhden itse ylläpidetyn arvioinnin kerrallaan.




