Kirjaudu sisäänVaraa esittely

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

19 minuutin lukuaika

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 (mittari named-seat), ja grace_days on 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 kohdassa scope.tenants lueteltuja 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.

Lisenssi ja mitä se avaa
Lisenssi ja mitä se avaa
Lisenssisivulla on lueteltu jokainen ominaisuusryhmä sekä se, miten se on suojattu ja mitä se kattaa. Ryhmät, joita lisenssi ei sisällä, pysyvät luettelossa harmaina, jotta käyttäjät näkevät, mitä on olemassa.

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.

Vaakasuora aikajana, jossa on viisi kaistaa vasemmalta oikealle: VALID (alkaen kohdasta starts_on), WARN (kauden viimeiset warn_days), GRACE (grace_days kohdan ends_on jälkeen), RESTRICT (lisäajan jälkeen). Kaistojen alla on kolme nimettyä merkintää: starts_on, ends_on ja ends_on + grace_days. Aikajanan alapuolella oleva erillinen laatikko, johon johtaa katkoviivanuoli mistä tahansa kaistasta, on nimetty TERMINATE (allekirjoitettu sulkulista nimeää lisenssin). Toinen laatikko äärimmäisenä vasemmalla aikajanan ulkopuolella on nimetty ABSENT (ei lisenssiä tai hylätty lisenssi: Community-perustaso).
Lisenssin tilat kalenterissa.

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.

Offline-vaihto
Offline-vaihto
Offline-vaihto asennukselle, jolla ei ole ulkoista yhteyttä. Jokainen rajan ylittävä tiedosto on allekirjoitettu, joten matkalla muuttunut tiedosto hylätään, ja jokainen vaihto luetteloidaan tekijän tietojen kera.
Kaksi saraketta, joista vasen on nimetty "Harrow-asennus (ei internetiä)" ja oikea "Adverant-tili". Vasemmalla ylhäällä: laatikko "Lisenssipyyntötiedosto, allekirjoitettu asennusavaimella". Nuoli "siirretty tallennusvälineellä" johtaa oikean sarakkeen laatikkoon "Offline-vaihtosivu". Sen alapuolella on laatikko "Lisenssitiedosto, allekirjoitettu kahdella Adverant-avaimella". Nuoli "tuotu takaisin tallennusvälineellä" palaa vasemman sarakkeen laatikkoon "Tuonti: konsoli, nexusctl tai API" ja sieltä alas laatikkoon "Tarkistetaan asennuksessa sisäänrakennettuja luottamusjuuria vasten".
Miten lisenssi saavuttaa asennuksen, jolla ei ole ulkoista yhteyttä.

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.

Tuo lisenssi
Tuo lisenssi
Lisenssin tuominen käyttöönoton aikana. Aito tiedosto luettelee ominaisuusryhmänsä; kopio, jossa on kaksi muutettua riviä, näytetään puuttuvana koodilla LICENCE_SIGNATURE_INVALID, ja jo voimassa oleva lisenssi jätetään ennalleen.
Communitysta Enterpriseen
Communitysta Enterpriseen
Community-asennuksen siirtäminen Enterprise-versioon. Lisenssi on luettu ja todettu aidoksi, ja sivulla luetellaan noudettavat osat ja muutokset, ennen kuin kukaan painaa Nouda ja ota käyttöön.

nexusctl-työkalulla

nexusctl licence import harrow-2027.licence.json

Komento 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.json

Lä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/state vastaa 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_GRACE tai LICENCE_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/document vastaa 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.json

Lista, 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öpaikkoja yli lisenssin
Lisenssin ylittävät käyttöoikeuspaikat
Enemmän henkilöitä kuin käyttöpaikkoja. Hakemistosynkronointi lisäsi 143 alihankkijaa, ja ilmoitus antaa 30 päivää aikaa poistaa henkilöitä tai lisätä käyttöpaikkoja ilman, että ketään lukitaan ulos.

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.