Oturum açınToplantı planlayın

Bölüm 2.13

Lisanslar

Bir Nexus lisans dosyasının neler içerdiği, kurulumun bunu çevrimdışı olarak nasıl kontrol ettiği, içinde bulunabileceği altı durum ve bir lisansı nasıl talep edeceğiniz, içe aktaracağınız, yenileyeceğiniz ve geri çekeceğiniz.

Bu sayfa, İngilizce aslından YZ tarafından çevrilmiştir. Anlaşılmayan bir yer olursa İngilizce sayfa esas alınır. Bu sayfayı İngilizce okuyun

19 dakikalık okuma

Harrow Port Authority, Nexus Enterprise'ı harrow.example adresindeki kendi Kubernetes kümesinde, kümeden internete hiçbir yönlendirme olmaksızın çalıştırır. BT başkanı Aoife Brennan her yıl sözleşmeyi yeniler ve platform mühendisi Tomás Reilly küçük bir JSON dosyasını hava boşluğundan geçirerek içe aktarır. Hiçbir şey yeniden başlatılmaz ve lisans sayfasında yeni bir bitiş tarihi görünür.

Bu bölüm o dosya hakkındadır. Kısacası lisans, tek bir kuruluma bağlı, imzalı tek bir JSON belgesidir. Kurulum, imaja gömülü açık anahtarlarla bu belgeyi kendisi kontrol eder ve bunun için hiçbir ağ çağrısı yapmaz. Lisans asla bir Helm değeri ve asla bağlanmış (mounted) bir dosya değildir. Yalnızca konsol, nexusctl veya uygulama programlama arayüzü (API) aracılığıyla içe aktarılır; başka hiçbir yerden aktarılmaz.

Lisans belgesi

Lisans, nexus-licence/v1 biçiminde tek bir JSON nesnesidir. İşte iki imza değeri kısaltılmış olarak Harrow'un lisansı.

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

Her alan zorunludur ve belgedeki her nesne kapalıdır. Biçimin listelemediği bir üye reddedilir, böylece imzanın dışında hiçbir şey belgeye eklenemez.

Alan Ne barındırır
format Tam olarak nexus-licence/v1. Daha sonraki bir sürüm de dahil olmak üzere başka herhangi bir değer reddedilir.
licence_id Küçük harfli bir UUID (evrensel benzersiz tanımlayıcı). Bir kurulum, her lisans kimliğini bir kez içe aktarır.
issued_at Adverant'ın lisansı verdiği an, YYYY-MM-DDThh:mm:ssZ biçiminde.
type alpha, evaluation veya commercial.
channel alpha gibi, lisansın verildiği sürüm kanalı. İmzalanır ve taşınır; kontrol işlemi buna göre dallanmaz.
licensee.name 1 ila 200 karakter, tam yazıldığı şekliyle imzalanır. Brennan ve Brennán, iki farklı imzaya sahip iki farklı addır.
licensee.customer_id Adverant'taki müşteri kimliğiniz: küçük harfler, rakamlar, ., _ ve -.
scope.deployment.installation_id İlk kurulumda kendi anahtar hizmeti tarafından üretilen kurulum kimliği.
scope.tenants En fazla 1.000 adet kuruluş kimliği. Herhangi bir yetki kiracı kapsamlı (tenant-scoped) olmadığı sürece boştur.
edition enterprise veya team. Bir Enterprise lisansı her zaman enterprise-base yetkisi verir.
grants Her grup bir kez adlandırılmak üzere, 1 ila 500 adet {feature_group, scope} çifti.
add_ons Sürüm matrisinden en fazla 100 adet eklenti kimliği. Boş olabilir.
domain_packs Sürüm matrisinden en fazla 100 adet alan paketi kimliği. Boş olabilir.
metric kind; per-environment, per-core veya named-seat değerini alır; quantity, 1'den başlayan bir tam sayıdır.
term starts_on ve ends_on tarihtir; warn_days ve grace_days, 0 ile 365 arasında tam sayılardır.
matrix Grupların kendisine göre yazıldığı sürüm matrisi versiyonu ve bu matris dosyasının denetim için saklanan SHA-256 özeti.
signatures İki imza: ed25519 ve p256. İmzalanmayan tek alandır.

Tarihler UTC cinsinden takvim tarihleridir ve gün gerçekten var olmalıdır: 2028-02-29 geçerlidir, 2027-02-29 ise reddedilir.

İki imza, ikisi de zorunlu

Adverant her lisansı iki bağımsız anahtarla imzalar. İmzalardan biri Ed25519'dur. Diğeri ise ABD federal algoritmalarına ihtiyaç duyan alıcıların talep ettiği, NIST'in (ABD Ulusal Standartlar ve Teknoloji Enstitüsü) P-256 eğrisi üzerindeki ECDSA'dır (Eliptik Eğri Dijital İmza Algoritması). Her ikisi de aynı baytlar üzerinden oluşturulur ve her ikisinin de doğrulanması gerekir. Bir yarısı eksik veya herhangi bir yarısı hatalı olan bir belge, hiç lisans yokmuş gibi sayılır.

İmzalanan baytlar, signatures alanı çıkarılmış belgenin RFC 8785 kurallı (canonical) biçimidir; bu nedenle dosyanızdaki boşluklar ve üyelerin sırası hiçbir fark yaratmaz. Lisans sahibinin adında, tarihlerde veya bir yetkide değiştirilen tek bir karakter belgeyi farklı bir belge yapar ve doğrulama başarısız olur.

Kontrol işleminin kullandığı açık anahtarlar, sürüm derlemesi sırasında her imaja gömülen bir güven kökleri (trust-roots) dosyasında bulunur. Hiçbir ortam değişkeni, bayrak veya bağlama noktası (mount) başka bir dosyayı işaret edemez. Adverant bir imzalama anahtarını değiştirdiğinde, eski anahtar yenisini imzalar ve bir sonraki imzalı sürüm yeni anahtarı taşır. Yeni bir anahtarla imzalanmış bir lisans, o anahtarı taşıyan bir sürümde doğrulanır; bu nedenle bir anahtar değişikliğinden sonra içe aktarma işleminden önce sistemi yükseltmeniz gerekebilir (bkz. bölüm 2.17, Sorun Giderme).

Türler, sürümler ve bir lisansın nasıl sayıldığı

type, lisansın ne tür bir sözleşmeden geldiğini belirtir:

  • alpha: Harrow'un sahip olduğu tür olan alfa sürüm kanalı için bir lisans.
  • evaluation: kendi sunucunuzda barındırılan (self-hosted) bir Enterprise deneme sürümü. En fazla 30 gün boyunca, en fazla 5 adlandırılmış kişi için (metrik named-seat), grace_days değeri 0'a ayarlanmış olarak çalışır. Biçim, herhangi bir ek süre (grace) içeren deneme sürümlerini reddeder.
  • commercial: sözleşmeli bir lisans.

metric, lisansın nasıl sayıldığını kaydeder: per-environment (Harrow'un üretim kümesi tek bir ortamdır), per-core veya named-seat. Fiyatı Adverant teklif eder; lisans yalnızca ölçüyü ve miktarı taşır.

Her Enterprise kurulumu için lisans edition değeri enterprise şeklindedir. Biçim ayrıca, lisansın team grubuna yetki verdiği ve asla enterprise-base grubuna yetki vermediği team değerini de kabul eder.

Özellik grupları, eklentiler ve alan paketleri

Bir lisansın insanların neyi kullanmasına izin verdiği, sürüm matrisinin kimlikleri kullanılarak özellik grubuna göre listelenir. Harrow'un lisansı enterprise-base (özel roller, dört göz onayları, uzun süreli denetim kaydı saklama, zorunlu kılma ve dizin eşitlemeli şirket girişi, iş birimleri, operatör sayfaları ve Enterprise tabanının geri kalanı) ve map-and-geoai yetkilerini verir. Ayrıca mail eklentisini ve logistics-and-maritime alan paketini taşır.

Matrisin nelerin bir arada kullanılabileceğine dair kuralları vardır ve Adverant'ın lisans verme sistemi, bir lisans imzalanmadan önce bunları kontrol eder. Her eklenti ve her paket enterprise-base gerektirir. Bazı paketler eklenti gerektirir: Lojistik ve denizcilik paketi Harita ve GeoAI gerektirir; Sigorta paketi ile Sermaye piyasaları ve varlık yönetimi paketi Karar odaları ve mühürlü kayıtlar gerektirir; Hukuk ve profesyonel hizmetler paketi ise Karar odaları ve Posta gerektirir. Her paketin telefon ekranları ayrıca Mobil uygulamalar eklentisini gerektirir.

Her yetkinin bir kapsamı vardır:

  • deployment: grup, kurulumdaki her kuruluş için tüm kuruluma uygulanır.
  • tenant: grup yalnızca scope.tenants içinde listelenen kuruluşlara uygulanır. Kiracı kapsamlı bir yetkiye sahip bir lisans en az bir kuruluşu listelemelidir; kiracı kapsamlı hiçbir yetki içermeyen bir kuruluş listesi reddedilir.

Harrow'un kılavuzluk ekibinin aynı kurulumda ikinci bir kuruluş olarak çalıştığını ve yalnızca bu kuruluşun Fikirler (Ideas) özelliğine sahip olacağını varsayalım. Yetki, scope.tenants içinde kılavuzluk kuruluşunun kimliğiyle birlikte { "feature_group": "ideas", "scope": "tenant" } olarak görünür. Lisans, o kuruluş henüz oluşturulmadan önce içe aktarılırsa, içe aktarma yanıtı bunu tenants_without_organisation altında sayar ve kuruluş oluşturulduğunda yetki ona ulaşır.

Bir yönetici, bir grubun eriştiği kapsamı daraltabilir. Yalnızca Adverant'tan alınan bir lisans yeni bir grup ekleyebilir.

Lisans ve kilidini açtığı özellikler
Lisans ve kilidini açtığı özellikler
Lisans sayfası, her özellik grubunu nasıl korunduğu ve neleri kapsadığıyla birlikte listeler. Lisansın içermediği gruplar, insanların nelerin mevcut olduğunu görebilmesi için listede grileştirilmiş olarak kalır.

Süre: uyarı ve ek süre

term, takvimde dört tarih belirler. starts_on tarihinden ends_on tarihine kadar lisans yürürlüktedir. warn_days uyarının ne kadar erken başlayacağını, grace_days ise bitiş tarihinden sonra her şeyin ne kadar süre çalışmaya devam edeceğini belirler. Adverant'ın verdiği lisanslar, sözleşmede aksi belirtilmedikçe her ikisi için de 30 gün içerir. Bir deneme sürümünün grace_days değeri her zaman 0'dır.

Yukarıdaki Harrow lisansı için takvim şu şekilde işler:

Tarihler Durum
1 Ocak 2027 - 1 Aralık 2027 VALID
2 Aralık 2027 - 31 Aralık 2027 WARN
1 Ocak 2028 - 30 Ocak 2028 GRACE
31 Ocak 2028'den itibaren RESTRICT

Sürenin son günü olan ends_on, hala bir WARN günüdür. Ondan sonraki gün GRACE veya ek süre yoksa RESTRICT olur.

Altı durum

Lisans her okunduğunda kurulum, durumunu belgeden ve geçerli tarihten yeniden hesaplar. Gün sınırının ötesinde hiçbir şey önbelleğe alınmaz, böylece zamanlanmış bir göreve gerek kalmadan süre dolumu tam zamanında gerçekleşir.

Durum Ne zaman İnsanlar ne yapabilir
ABSENT Hiçbir lisans içe aktarılmadı veya belge reddedildi Community tabanı. Enterprise alanları, bunları kimin etkinleştirebileceğini gösteren tanıtımlar (teaser) olarak görünür.
VALID starts_on ile ends_on eksi warn_days arası Yetki verilen her grup kullanıma açıktır.
WARN Sürenin son warn_days günü Kullanıma açıktır ve yöneticiler ürün içinde bitiş tarihini gösteren bir bilgi şeridi görür.
GRACE ends_on tarihinden sonra, grace_days gün boyunca Bugün (Today) ve lisans sayfasında LICENCE_IN_GRACE bildirimiyle birlikte kullanıma açıktır.
RESTRICT Ek süre (grace period) bittikten sonra Lisanslı bir grup altında yeni bir iş başlatılamaz. Çalışmakta olan işler tamamlanır, okuma ve dışa aktarma işlemleri çalışmaya devam eder ve güvenlik düzeltmeleri gelmeyi sürdürür.
TERMINATE Adverant lisansı iptal etti Enterprise yapıtlarının (artefacts) sunulması durdurulur. Community tabanı ve veri dışa aktarma işlevi kalır.

Her durumda, çalışmakta olan işler çalışmaya devam eder, güvenlik düzeltmeleri gelmeyi sürdürür, dışa aktarımlar okunabilir kalır ve hiçbir şey silinmez. RESTRICT durumunda, yeni bir Enterprise işi başlatmaya çalışan bir kişi, LICENCE_LOCKED kodunu ve lisansı kimin yenileyebileceğinin adını içeren bir ret levhası görür.

Soldan sağa beş bantlı yatay bir zaman çizelgesi: VALID (starts_on tarihinden itibaren), WARN (sürenin son warn_days günü), GRACE (ends_on tarihinden sonraki grace_days günü), RESTRICT (ek süreden sonra). Bantların altında üç etiketli işaretleyici: starts_on, ends_on ve ends_on + grace_days. Zaman çizelgesinin altında, herhangi bir banttan gelen kesikli bir okla bağlanan ayrı bir kutu TERMINATE olarak etiketlenmiştir (imzalı bir iptal listesi lisansı barındırır). En solda, zaman çizelgesinin dışındaki ikinci bir kutu ABSENT olarak etiketlenmiştir (lisans yok veya reddedilmiş bir lisans var: Community tabanı).
Takvim boyunca lisans durumları.

Geçerli tarihin hesaplanması

Bir saat yanlış olabilir ve bir saat kasıtlı olarak geri alınabilir. Bu nedenle kurulum asla yalnızca saati okumaz. Geçerli tarih, iki zaman noktasından daha geç olanıdır: duvar saati ve kurulumun gördüğü en son zaman noktası olan kayıtlı taban (floor). Taban, her içe aktarmada ve her durum okumasında ileri gider ve kendi kendine asla geri gitmez. Saati bir ay geri almak, süresi dolmuş bir lisansı VALID durumuna geri getirmez; RESTRICT durumundaki bir lisans RESTRICT olarak kalır.

Saat tabandan daha erken bir zamanı gösterdiğinde, durum LICENCE_CLOCK_BEHIND_FLOOR bildirimini taşır ve tabanın gününde okunur. Saat gerçekten ileri gitmişse (bir düğüm yanlış tarihle başlamış ve taban ileri taşınmışsa), Adverant'tan bir zaman sıfırlama belirteci (time-reset token) isteyin. Bu, kurulum kimliğinize ve tek kullanımlık bir sayıya (nonce) bağlı, floor_to zaman noktası içeren küçük imzalı bir belgedir. Bunu API aracılığıyla şu istekle içe aktarırsınız:

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>, bir kurulum yöneticisinin erişim belirtecidir. Bir belirteç, her iki imza doğrulandığında, kurulum kimliği sizinki olduğunda ve tek kullanımlık sayısı (nonce) daha önce kullanılmadığında uygulanır. Reddedilen bir belirteç hiçbir şeyi değiştirmez, bu nedenle geçerli bir lisansı reddetmek için asla kullanılamaz. Tek kullanımlık sayısı zaten kullanılmış olan bir belirteç LICENCE_CLOCK_BEHIND_FLOOR ile reddedilir.

Lisans talep etme

Lisanslar, https://account.adverant.ai adresindeki Adverant hesabınızdan talep edilir ve indirilir. Kuruluşunuzda kimlerin dağıtımları (deployments) sahiplenebileceği ve lisansları indirebileceği, hesabın Kuruluş ve ekip rolleri sayfasında ayarlanır.

Adverant'ın lisansın hangi kurulum için olduğunu bilmesi gerekir ve bunu bildirmenin üç yolu vardır.

Ekranı olan bir kurulum için tek kullanımlık kod. Kurulum, tek kullanımlık bir kod ve parmak izini gösterir. Bir dağıtımı sahiplen (Claim a deployment) sayfasına kodu yapıştırır, ardından parmak izini kurulumun gösterdiğiyle grup grup karşılaştırırsınız. Her grup eşleştiğinde, onu kuruluşunuz için sahiplenirsiniz ve lisans hesaba gelir.

Bir donanım aygıtı (appliance) veya uç cihaz (edge device) için sahiplenme anahtarı (claim key). Bunların bir kodu gösterecek ekranı yoktur. Seri numarası ve bir sahiplenme anahtarı kutunun üzerinde ve ekipman üreticisinin siparişinde basılıdır. Bunları Bir sahiplenme anahtarı girin (Enter a claim key) sayfasına teker teker girin veya aynı anda birden fazlasını sahiplenmek için üreticinin sipariş dosyasını bırakın. Her anahtar, Adverant'ın size gönderilenlerle ilgili kayıtlarıyla karşılaştırılır ve bir başkasının siparişine ait bir anahtar reddedilir.

Dış bağlantısı olmayan bir kurulum için imzalı lisans talebi. Bu, Harrow'un izlediği yoldur. Kurulumda bir yönetici, Bu kurulum, Lisans (This installation, Licence) altında bir talep dosyası oluşturur. Bu, kurulumun kendi Ed25519 anahtarıyla imzalanmış, kurulum kimliğini belirten licence-request türünde bir beyandır. Tomás bunu onaylı bir ortamda dışarı taşır, Çevrimdışı değişim (Offline exchange) sayfasına bırakır ve geri dönen lisans dosyasını indirir. Lisans yalnızca talebi oluşturan kurulumda çalışır.

Çevrimdışı değişim
Çevrimdışı değişim
Dış bağlantısı olmayan bir kurulum için çevrimdışı değişim. Hava boşluğundan geçen her dosya imzalıdır, bu nedenle yolda değiştirilen bir dosya reddedilir ve her değişim kimin yaptığıyla birlikte listelenir.
İki sütun; sol sütun "Harrow kurulumu (internet yok)" ve sağ sütun "Adverant hesabı" olarak etiketlenmiş. Sol üstte: "Kurulum anahtarıyla imzalanmış lisans talep dosyası" kutusu. "Medya üzerinde taşınır" etiketli bir ok, sağ sütundaki "Çevrimdışı değişim sayfası" kutusuna geçer. Bunun altında, "İki Adverant anahtarıyla imzalanmış lisans dosyası" kutusu bulunur. "Medya üzerinde geri taşınır" etiketli bir ok, sol sütundaki "İçe aktarma: konsol, nexusctl veya API" kutusuna döner ve oradan aşağıya, "Yerleşik güven köklerine karşı kurulumda kontrol edildi" kutusuna iner.
Dış bağlantısı olmayan bir kuruluma lisansın ulaşması.

Lisansı içe aktarma

İçeri aktarmanın üç yolu vardır ve bunların hepsi nexus-auth üzerinde aynı uç noktaya (endpoint) ulaşır. Yalnızca bir kurulum yöneticisi içe aktarma yapabilir: kuruluma sahip olan tüm kuruluşun oturum açmış bir sahibi veya yöneticisi ya da tam yetkili bir platform yöneticisi. Başka herhangi biri, daha dosya okunmadan reddedilir.

Konsolda

Yeni bir kurulumda, Lisansı içe aktar (Import the licence) adımı, Kimse oturum açmadan önce altı şey (Six things before anyone signs in) sayfasındaki altı kontrolden biridir. Dosyayı sayfaya bıraktığınızda, konsol bunu kurulum üzerinde çevrimdışı olarak kontrol eder ve özellik gruplarını her birinin nasıl korunduğu ve süresiyle birlikte listeler.

Daha sonraki içe aktarmalar Bu kurulum, Lisans (This installation, Licence) üzerinden yapılır: Yeni bir lisans içe aktar (Import a new licence) seçeneğini veya mevcut olanın süresi dolduğunda Yenilenmiş bir lisans içe aktar (Import a renewed licence) seçeneğini kullanın. Enterprise sürümüne geçen bir Community kurulumu, Community'den Enterprise'a (From Community to Enterprise) sayfasını kullanır. Bu sayfa önce lisansı okur ve herhangi bir şey olmadan önce nelerin getirileceğini ve nelerin değişeceğini gösterir. Birisi Getir ve etkinleştir (Fetch and switch on) seçeneğini seçene kadar hiçbir şey getirilmez. Ardından Enterprise parçaları, kurulumun çekme belirteciyle (pull token) registry.adverant.ai adresinden gelir, her biri Adverant sürüm anahtarına karşı kontrol edilir ve gruplar teker teker etkinleştirilir. Sonrasında aynı kişiler, dosyalar, iş akışları ve kanallarla aynı kurulum olarak devam eder.

Lisansı içe aktar
Lisansı içe aktar
Kurulum sırasında lisansın içe aktarılması. Orijinal dosya kendi özellik gruplarını listeler; iki satırı değiştirilmiş bir kopya LICENCE_SIGNATURE_INVALID koduyla yok (absent) olarak gösterilir ve halihazırda yürürlükte olan lisans olduğu gibi bırakılır.
Community'den Enterprise'a
Community'den Enterprise'a
Bir Community kurulumunu Enterprise'a taşıma. Lisans okunmuş ve orijinal bulunmuştur; sayfa, birisi Getir ve etkinleştir düğmesine basmadan önce getirilecek parçaları ve nelerin değişeceğini listeler.

nexusctl ile

nexusctl licence import harrow-2027.licence.json

Komut, dosyayı değiştirmeden içe aktarır ve lisansın geçerli durumunu yazdırır. Çalıştıracağı işlemleri çalıştırmadan yazdırmak için --explain ekleyin.

API aracılığıyla

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

Dosyayı tam olarak Adverant'ın size verdiği şekilde gönderin. Yeniden biçimlendirmeyin ve başka bir nesnenin içine sarmayın: gövde (body) belgenin kendisidir. Yönlendirme (route) hiçbir sorgu dizesi (query string) almaz ve 1 MiB'den büyük bir gövde reddedilir. Bir kuruluşu veya kişiyi adlandıran üst düzey bir üye TENANT_NOT_A_PARAMETER veya ACTOR_NOT_A_PARAMETER ile reddedilir, çünkü kurulumun lisansı, belirtecin kuruluşunun sahip olduğu kuruluma aittir.

Başarılı bir içe aktarma 201 yanıtını verir. Gövde; lisans görünümünü (kimliği, geçerli durumu, lisans sahibi, sürümü, süresi, yetkileri ve özellik grupları), şu anda kaç kuruluşun buna sahip olduğunu ve listelenen kiracılardan kaçının henüz bir kuruluşu olmadığını tutar. Lisans, SHA-256 özeti ve her kuruluş için ana defter (ledger) satırları tek bir işlemde (transaction) yazılır ve içe aktarma işlemi denetim günlüğüne kaydedilir.

Buna iki okuma yönlendirmesi (read route) eşlik eder:

  • GET /api/v1/installation/licence/state, her okumada yeniden hesaplanan durumu yanıtlar. Bir yönetici tam görünümü alır. Kurulumdaki bir kuruluşun diğer herhangi bir üyesi yalnızca bildirimi alır: durum, bildirim kodu (LICENCE_ENDS_SOON, LICENCE_IN_GRACE veya LICENCE_CLOCK_BEHIND_FLOOR) ve bildirimin belirttiği tarihler. Bir üye lisans sahibini, süreyi veya grupları asla görmez, çünkü bunlar kurulumun sahibine aittir.
  • GET /api/v1/installation/licence/document, yöneticiler için içe aktarılan belgeyi ham haliyle yanıtlar. Her Enterprise modülü bunu getirir ve kendi içine derlenmiş doğrulayıcısıyla imzaları tekrar kontrol eder; böylece değiştirilmiş bir kimlik hizmeti, lisansın yetki vermediği bir grubu etkinleştiremez.

Her ret durumu

Reddedilen bir içe aktarma, saat tabanı da dahil olmak üzere hiçbir şeyi değiştirmez ve ret işlemi denetim günlüğüne kaydedilir.

Kod HTTP Anlamı Ne yapılmalı
LICENCE_FORMAT_INVALID 422 Dosya bu derlemenin okuyabileceği bir lisans değil: JSON değil, şemaya uymuyor, tarihler sırasız veya bir grup iki kez adlandırılmış. Dosyayı tam olarak Adverant'ın size verdiği şekilde gönderin.
LICENCE_SIGNATURE_INVALID 422 İki imzadan biri eksik veya dosya imzalandıktan sonra değiştirilmiş. Dosyayı Adverant'tan tekrar isteyin ve düzenlemeyin.
LICENCE_ROOT_UNKNOWN 422 Bu sürümün güven köklerinin (trust roots) barındırmadığı bir anahtarla imzalanmış. Bu sürümün kökleri için imzalanmış bir lisans isteyin veya sistemi yükseltin.
LICENCE_MATRIX_MISMATCH 422 Bu derlemenin okumadığı bir sürüm matrisine göre yazılmış veya derlemenin kataloğunun bilmediği bir gruba yetki veriyor. Bunu okuyabilen bir sürüme yükseltin veya bu sürüme göre yazılmış bir lisans isteyin.
LICENCE_OTHER_INSTALLATION 409 Başka bir kurulum kimliği için verilmiş. Bu kurulumun kimliği için bir lisans isteyin.
LICENCE_REVOKED 403 Adverant bu lisansı geri çekmiş. Adverant'tan yeni bir lisans isteyin.
LICENCE_LOCKED 403 Lisans henüz başlamamış: geçerli tarih starts_on tarihinden önce. İlk gününde veya daha sonrasında tekrar içe aktarın.
TRANSITION_NOT_PERMITTED 409 Bu kimliğe sahip bir lisans zaten içe aktarılmış. Koşulların değişmesi gerekiyorsa Adverant'tan yeni bir lisans isteyin.
RECORD_NOT_FOUND 404 Kurulum henüz bildirilmemiş, bu nedenle karşılaştırılacak bir kimliği yok. İlk yönetici adımını tamamlayın, ardından içe aktarın.
VALIDATION_FAILED 400 Gövde okunamadı, 1 MiB'nin üzerinde veya istekte bir sorgu dizesi vardı. Sorgu olmadan, gövde olarak yalnızca dosyayı gönderin.

Kurulum sabit bir sırayla kontrol eder ve ilk hata kodu belirler. Eksik bir yarı, bilinmeyen bir anahtardan önce bildirilir ve imzaları başarısız olan bir belge asla daha fazla okunmaz; bu nedenle başka bir kurulumu da adlandıran kurcalanmış bir dosya yine LICENCE_SIGNATURE_INVALID yanıtını verir.

Yenileme

Yenileme, yeni bir licence_id değerine sahip yeni bir lisanstır. İlk lisansla aynı şekilde içe aktarın. Eski lisans hangi duruma ulaşmış olursa olsun derhal yürürlüğe girer: kurulum WARN, GRACE veya RESTRICT durumundan doğrudan lisanslı duruma geri döner ve hiçbir şeyin yeniden kurulmasına gerek kalmaz. Adverant ayrıca dönem ortasında, örneğin Karar odalarını eklemek için değiştirilmiş bir lisans verebilir ve bunu da aynı şekilde içe aktarırsınız.

Aynı lisansın iki kez içe aktarılması TRANSITION_NOT_PERMITTED ile reddedilir.

İptal etme

Adverant, bir iptal listesi imzalayarak bir lisansı geri çeker. Listenin bir sequence numarası vardır ve geri çekilen her lisans kimliğini ne zaman ve neden geri çekildiğiyle birlikte belirtir. Listeler birikimlidir (kümülatif): her biri kendisinden önce iptal edilen her kimliği taşır. Bunu bir lisansla aynı şekilde içe aktarırsınız:

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

Sırası (sequence) içe aktarılan son listeden daha yüksek olmayan bir liste TRANSITION_NOT_PERMITTED ile reddedilir, böylece eski bir liste daha yeni bir listenin yerine geri konulamaz. Okunamayan veya doğrulanamayan bir liste, bir lisansla aynı kodlarla reddedilir. Bir liste lisansınızı adlandırdığında, durumu TERMINATE olur.

Dış bağlantısı olmayan bir kurulum, bir iptali yalnızca birisi listeyi içe aktardığında öğrenir. Harrow için iptal işlemi yazılım kadar sözleşmeyle de ilgili bir konudur ve Tomás, Adverant'ın gönderdiği her listeyi bir sonraki geçişte içe aktarır.

Lisansı aşan kullanıcı sayıları

Lisansın miktarı kullanıma dair bir taahhüttür ve Nexus bunun aşılmasını asla bir kilitleme olarak değil, bir uyarı olarak ele alır. Nexus'u lisansın kapsadığından daha fazla kişi kullandığında, yöneticiler Kişiler (People) sayfasında SEATS_OVER_LICENCE levhasını görür. Herkes çalışmaya devam eder. Levha, durumun ne zamana kadar düzeltilmesi gerektiğini (30 gün) söyler, fazladan kişilerin nereden geldiğini gösterir ve iki çözüm sunar: Nexus'a ihtiyacı olmayan kişileri kaldırın veya Adverant'tan daha fazla koltuk (seat) isteyin. Koltuk eklemek ikinci bir kişinin onayını gerektiren hassas bir değişikliktir ve fazladan koltuklar yıllık kullanım beyanında sayılır.

Lisans sınırını aşan koltuklar
Lisans sınırını aşan koltuklar
Koltuk sayısından fazla kişi. Dizin eşitlemesi 143 yüklenici ekledi ve levha, kimse sistem dışına kilitlenmeden kişileri kaldırmak veya koltuk eklemek için 30 gün süre veriyor.

Kullanım beyanı yalnızca sayaçları tutar ve sistemden çıkmadan önce her satırı okuyabilirsiniz. Harrow bunu bir dosya olarak kaydeder ve çevrimdışı değişim yoluyla dışarı taşır.

Değerlendirmeler

Deneme sürümü, sahiplenilmiş bir dağıtım için hesabın Denemeler (Trials) sayfasından başlatılan evaluation türünde bir lisanstır. En fazla 30 gün sürer, en fazla 5 adlandırılmış kişiyi kapsar ve ek süresi (grace) yoktur. ends_on tarihinden sonraki gün doğrudan RESTRICT durumuna geçer: Enterprise alanları tanıtımlara (teaser) geri döner ve deneme sırasında yapılan hiçbir şey silinmez. Fikir çalıştırmaları (Idea runs), taslak politikalar ve posta kuralları tam olarak oldukları gibi saklanır ve bir lisans içe aktarıldığında tekrar açılırlar.

Bir kuruluş aynı anda kendi sunucusunda barındırılan (self-hosted) tek bir deneme sürümü çalıştırır.