รุ่น 1.0.0-alpha.1ล่าสุด
บทที่ 2.13
ใบอนุญาต
สิ่งที่อยู่ในไฟล์ใบอนุญาตของ Nexus วิธีที่ระบบตรวจสอบไฟล์แบบออฟไลน์ สถานะทั้งหกที่เป็นไปได้ และวิธีขอ นำเข้า ต่ออายุ และเพิกถอนใบอนุญาต
หน้านี้แปลโดย AI จากต้นฉบับภาษาอังกฤษ หากมีส่วนใดไม่ชัดเจน โปรดอ้างอิงจากหน้าภาษาอังกฤษ อ่านหน้านี้เป็นภาษาอังกฤษ

Harrow Port Authority รัน Nexus Enterprise บนคลัสเตอร์ Kubernetes ของตนเองที่ harrow.example โดยไม่มีเส้นทางเชื่อมต่อจากคลัสเตอร์ออกสู่อินเทอร์เน็ต ในแต่ละปี Aoife Brennan หัวหน้าฝ่ายไอที จะต่ออายุสัญญา และ Tomás Reilly วิศวกรแพลตฟอร์ม จะนำไฟล์ JSON ขนาดเล็กข้ามระบบที่แยกส่วนกันนี้เข้ามาและนำเข้าสู่ระบบ ไม่มีสิ่งใดต้องรีสตาร์ท และหน้าใบอนุญาตจะแสดงวันสิ้นสุดใหม่
บทนี้ว่าด้วยเรื่องของไฟล์ดังกล่าว กล่าวโดยย่อ ใบอนุญาตคือเอกสาร JSON ที่ลงนามแล้วหนึ่งฉบับซึ่งผูกไว้กับการติดตั้งหนึ่งรายการ การติดตั้งจะตรวจสอบใบอนุญาตด้วยตัวเองโดยใช้คีย์สาธารณะที่ฝังไว้ในอิมเมจ และไม่ทำการเรียกใช้ผ่านเครือข่ายใดๆ ในการดำเนินการดังกล่าว ใบอนุญาตไม่เป็นค่า Helm และไม่เป็นไฟล์ที่ถูกเมานต์ คุณสามารถนำเข้าผ่านคอนโซล, nexusctl หรือส่วนต่อประสานโปรแกรมประยุกต์ (API) เท่านั้น ไม่สามารถทำจากที่อื่นได้
เอกสารใบอนุญาต
ใบอนุญาตคืออ็อบเจกต์ JSON หนึ่งรายการในรูปแบบ nexus-licence/v1 นี่คือใบอนุญาตของ Harrow โดยย่อค่าลายเซ็นทั้งสองให้สั้นลง
{
"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>" }
}
}ทุกฟิลด์เป็นข้อมูลที่จำเป็น และทุกอ็อบเจกต์ในเอกสารจะถูกปิดไว้ สมาชิกที่ไม่อยู่ในรายการของรูปแบบจะถูกปฏิเสธ ดังนั้นจึงไม่มีสิ่งใดแฝงเข้ามาอยู่นอกเหนือลายเซ็นได้
| ฟิลด์ | ข้อมูลที่เก็บ |
|---|---|
format |
ต้องเป็น nexus-licence/v1 เท่านั้น ค่าอื่นใด รวมถึงเวอร์ชันที่ใหม่กว่า จะถูกปฏิเสธ |
licence_id |
UUID (ตัวระบุที่เป็นเอกลักษณ์สากล) ตัวพิมพ์เล็ก การติดตั้งหนึ่งๆ จะนำเข้าแต่ละรหัสใบอนุญาตเพียงครั้งเดียว |
issued_at |
เวลาที่ Adverant ออกให้ ในรูปแบบ YYYY-MM-DDThh:mm:ssZ |
type |
alpha, evaluation หรือ commercial |
channel |
ช่องทางการปล่อยรุ่นที่ออกใบอนุญาตให้ เช่น alpha มีการลงนามและแนบมาด้วย แต่การตรวจสอบจะไม่แยกเงื่อนไขตามค่านี้ |
licensee.name |
1 ถึง 200 อักขระ ลงนามตามที่เขียนไว้ทุกประการ Brennan และ Brennán ถือเป็นสองชื่อที่ต่างกันและมีสองลายเซ็นที่ต่างกัน |
licensee.customer_id |
รหัสลูกค้าของคุณที่ Adverant: ตัวพิมพ์เล็ก ตัวเลข ., _ และ - |
scope.deployment.installation_id |
ข้อมูลประจำตัวของการติดตั้ง ซึ่งสร้างขึ้นโดยบริการคีย์ของการติดตั้งเมื่อทำการติดตั้งครั้งแรก |
scope.tenants |
รหัสองค์กร สูงสุด 1,000 รายการ จะว่างเปล่าเว้นแต่ว่าการให้สิทธิ์บางรายการจะจำกัดขอบเขตตามผู้เช่า |
edition |
enterprise หรือ team ใบอนุญาต Enterprise จะให้สิทธิ์ enterprise-base เสมอ |
grants |
คู่ {feature_group, scope} จำนวน 1 ถึง 500 คู่ โดยระบุชื่อแต่ละกลุ่มเพียงครั้งเดียว |
add_ons |
รหัสส่วนเสริมจากเมทริกซ์รุ่น สูงสุด 100 รายการ อาจว่างเปล่าได้ |
domain_packs |
รหัสแพ็กเกจโดเมนจากเมทริกซ์รุ่น สูงสุด 100 รายการ อาจว่างเปล่าได้ |
metric |
kind คือ per-environment, per-core หรือ named-seat; quantity คือจำนวนเต็มตั้งแต่ 1 ขึ้นไป |
term |
starts_on และ ends_on คือวันที่; warn_days และ grace_days คือจำนวนเต็มตั้งแต่ 0 ถึง 365 |
matrix |
เวอร์ชันเมทริกซ์รุ่นที่ใช้เขียนอ้างอิงสำหรับกลุ่มต่างๆ และค่า SHA-256 ของไฟล์เมทริกซ์นั้น ซึ่งเก็บไว้สำหรับการตรวจสอบ |
signatures |
สองลายเซ็น ได้แก่ ed25519 และ p256 เป็นฟิลด์เดียวที่ไม่ได้ถูกนำไปลงนาม |
วันที่คือวันที่ตามปฏิทินในเวลา UTC และวันนั้นต้องมีอยู่จริง: 2028-02-29 ใช้ได้ และ 2027-02-29 จะถูกปฏิเสธ
สองลายเซ็นที่จำเป็นต้องมีทั้งคู่
Adverant ลงนามในใบอนุญาตทุกฉบับด้วยคีย์อิสระสองรายการ ลายเซ็นหนึ่งคือ Ed25519 อีกลายเซ็นหนึ่งคือ ECDSA (Elliptic Curve Digital Signature Algorithm) บนเส้นโค้ง P-256 จาก NIST (สถาบันมาตรฐานและเทคโนโลยีแห่งชาติของสหรัฐอเมริกา) ซึ่งเป็นสิ่งที่ผู้ซื้อที่ต้องการอัลกอริทึมตามมาตรฐานรัฐบาลกลางสหรัฐฯ ร้องขอ ทั้งสองลายเซ็นสร้างขึ้นบนชุดไบต์เดียวกัน และทั้งสองรายการต้องผ่านการตรวจสอบ เอกสารที่ขาดส่วนใดส่วนหนึ่งไป หรือส่วนใดส่วนหนึ่งไม่ถูกต้อง จะถือว่าไม่มีใบอนุญาตเลย
ไบต์ที่ถูกลงนามคือรูปแบบมาตรฐาน RFC 8785 ของเอกสารที่นำ signatures ออกไปแล้ว ดังนั้นช่องว่างและลำดับของสมาชิกในไฟล์ของคุณจึงไม่มีผลใดๆ อักขระที่เปลี่ยนไปเพียงตัวเดียวในชื่อผู้ได้รับอนุญาต วันที่ หรือการให้สิทธิ์ จะถือเป็นคนละเอกสารกัน และจะไม่ผ่านการตรวจสอบ
คีย์สาธารณะที่การตรวจสอบใช้งานจะอยู่ในไฟล์ trust-roots ที่ฝังไว้ในแต่ละอิมเมจเมื่อทำการบิลด์รุ่น ไม่มีตัวแปรสภาพแวดล้อม แฟล็ก หรือการเมานต์ใดๆ ที่จะระบุไฟล์อื่นได้ เมื่อ Adverant เปลี่ยนคีย์สำหรับลงนาม คีย์เก่าจะลงนามรับรองคีย์ใหม่ และรุ่นที่ลงนามถัดไปจะมาพร้อมกับคีย์ใหม่ ใบอนุญาตที่ลงนามด้วยคีย์ใหม่จะผ่านการตรวจสอบบนรุ่นที่มีคีย์นั้นอยู่ ดังนั้นหลังจากการเปลี่ยนคีย์ คุณอาจต้องอัปเกรดก่อนทำการนำเข้า (ดูบทที่ 2.17 การแก้ไขปัญหา)
ประเภท รุ่น และวิธีนับใบอนุญาต
type ระบุว่าใบอนุญาตนั้นมาจากข้อตกลงประเภทใด:
alpha: ใบอนุญาตสำหรับช่องทางการปล่อยรุ่นอัลฟ่า ซึ่งเป็นประเภทที่ Harrow ถืออยู่evaluation: การทดลองใช้ Enterprise แบบโฮสต์ด้วยตนเอง ใช้งานได้สูงสุด 30 วัน สำหรับผู้มีรายชื่อระบุสูงสุด 5 คน (เมทริกnamed-seat) โดยตั้งค่าgrace_daysเป็น 0 รูปแบบดังกล่าวจะปฏิเสธใบอนุญาตประเมินผลที่มีระยะเวลาผ่อนผันใดๆ ทั้งสิ้นcommercial: ใบอนุญาตตามสัญญา
metric บันทึกวิธีการนับใบอนุญาต: per-environment (คลัสเตอร์ใช้งานจริงของ Harrow นับเป็นหนึ่งสภาพแวดล้อม), per-core หรือ named-seat Adverant เป็นผู้เสนอราคา ส่วนใบอนุญาตจะระบุเพียงหน่วยวัดและปริมาณเท่านั้น
edition ของใบอนุญาตคือ enterprise สำหรับทุกการติดตั้งแบบ Enterprise รูปแบบนี้ยังยอมรับ team ซึ่งใบอนุญาตจะให้สิทธิ์กลุ่ม team และไม่เคยให้สิทธิ์ enterprise-base เลย
กลุ่มฟีเจอร์ ส่วนเสริม และแพ็กโดเมน
สิ่งที่ใบอนุญาตให้ผู้คนใช้งานได้จะแสดงรายการตามกลุ่มฟีเจอร์ โดยใช้รหัสของเมทริกซ์รุ่น ใบอนุญาตของ Harrow ให้สิทธิ์ enterprise-base (บทบาทที่กำหนดเอง, การอนุมัติแบบสี่ตา, การเก็บรักษาบันทึกการตรวจสอบระยะยาว, การลงชื่อเข้าใช้ของบริษัทพร้อมการบังคับใช้และการซิงค์ไดเรกทอรี, หน่วยธุรกิจ, หน้าสำหรับผู้ปฏิบัติงาน และส่วนที่เหลือของฐาน Enterprise) และ map-and-geoai โดยมาพร้อมกับส่วนเสริม mail และแพ็กเกจโดเมน logistics-and-maritime
เมทริกซ์มีกฎเกณฑ์เกี่ยวกับสิ่งที่ต้องใช้งานร่วมกัน และระบบการออกใบอนุญาตของ Adverant จะตรวจสอบกฎเหล่านี้ก่อนที่จะลงนามในใบอนุญาต ทุกส่วนเสริมและทุกแพ็กเกจต้องใช้ enterprise-base บางแพ็กเกจต้องใช้ส่วนเสริม: แพ็กเกจ Logistics and maritime ต้องใช้ Map and GeoAI, แพ็กเกจ Insurance และแพ็กเกจ Capital markets and asset management ต้องใช้ Decision rooms and sealed records และแพ็กเกจ Legal and professional services ต้องใช้ Decision rooms และ Mail นอกจากนี้ หน้าจอโทรศัพท์ของทุกแพ็กเกจยังต้องใช้ส่วนเสริม Mobile apps ด้วย
การให้สิทธิ์แต่ละรายการมีขอบเขตดังนี้:
deployment: กลุ่มนี้มีผลกับการติดตั้งทั้งหมด สำหรับทุกองค์กรที่อยู่ในการติดตั้งนั้นtenant: กลุ่มนี้มีผลเฉพาะกับองค์กรที่ระบุไว้ในscope.tenantsเท่านั้น ใบอนุญาตที่มีการให้สิทธิ์แบบจำกัดขอบเขตตามผู้เช่าจะต้องระบุอย่างน้อยหนึ่งองค์กร และรายชื่อองค์กรที่ไม่มีการให้สิทธิ์แบบจำกัดขอบเขตตามผู้เช่าจะถูกปฏิเสธ
สมมติว่าทีมนำร่องของ Harrow ทำงานเป็นองค์กรที่สองในการติดตั้งเดียวกัน และมีเพียงองค์กรนั้นองค์กรเดียวที่จะถือครอง Ideas การให้สิทธิ์จะระบุเป็น { "feature_group": "ideas", "scope": "tenant" } โดยมีรหัสขององค์กรนำร่องอยู่ใน scope.tenants หากมีการนำเข้าใบอนุญาตก่อนที่องค์กรนั้นจะถูกสร้างขึ้น คำตอบจากการนำเข้าจะนับรวมไว้ภายใต้ tenants_without_organisation และการให้สิทธิ์จะมีผลกับองค์กรนั้นทันทีที่สร้างองค์กรเสร็จ
ผู้ดูแลระบบสามารถจำกัดขอบเขตที่กลุ่มเข้าถึงให้แคบลงได้ มีเพียงใบอนุญาตจาก Adverant เท่านั้นที่จะเพิ่มกลุ่มได้
ระยะเวลา: การแจ้งเตือนและช่วงผ่อนผัน
term กำหนดวันที่สี่วันบนปฏิทิน ตั้งแต่ starts_on ถึง ends_on ใบอนุญาตจะมีผลบังคับใช้ warn_days กำหนดว่าการแจ้งเตือนจะเริ่มล่วงหน้าเร็วเพียงใด และ grace_days กำหนดว่าทุกอย่างจะยังคงทำงานต่อไปได้นานเท่าใดหลังจากวันสิ้นสุด ใบอนุญาตที่ Adverant ออกให้จะมีระยะเวลาอย่างละ 30 วัน เว้นแต่สัญญาจะระบุไว้เป็นอย่างอื่น การประเมินผลจะมี grace_days เป็น 0 เสมอ
สำหรับใบอนุญาตของ Harrow ข้างต้น ปฏิทินจะคำนวณออกมาได้ดังนี้:
| วันที่ | สถานะ |
|---|---|
| 1 มกราคม 2027 ถึง 1 ธันวาคม 2027 | VALID |
| 2 ธันวาคม 2027 ถึง 31 ธันวาคม 2027 | WARN |
| 1 มกราคม 2028 ถึง 30 มกราคม 2028 | GRACE |
| ตั้งแต่ 31 มกราคม 2028 | RESTRICT |
วันสุดท้ายของระยะเวลาสัญญา ends_on ยังคงเป็นวัน WARN วันถัดจากนั้นคือ GRACE หรือ RESTRICT เมื่อไม่มีระยะเวลาผ่อนผัน
สถานะทั้งหก
ทุกครั้งที่มีการอ่านใบอนุญาต การติดตั้งจะคำนวณสถานะใหม่จากเอกสารและวันที่ปัจจุบัน ไม่มีสิ่งใดถูกแคชไว้ข้ามวัน ดังนั้นการหมดอายุจะเกิดขึ้นตรงเวลาโดยไม่ต้องมีงานที่ตั้งเวลาไว้
| สถานะ | เมื่อใด | สิ่งที่ผู้คนทำได้ |
|---|---|---|
| ABSENT | ไม่มีการนำเข้าใบอนุญาต หรือเอกสารถูกปฏิเสธ | ระดับพื้นฐานของ Community พื้นที่ของ Enterprise จะแสดงเป็นตัวอย่างแนะนำพร้อมระบุผู้ที่สามารถเปิดใช้งานได้ |
| VALID | starts_on ถึง ends_on ลบด้วย warn_days |
ได้รับสิทธิ์ใช้งานทุกกลุ่มที่ได้รับอนุญาต |
| WARN | warn_days วันสุดท้ายของระยะเวลาสัญญา |
ได้รับสิทธิ์ใช้งาน และผู้ดูแลระบบจะเห็นแบนเนอร์ภายในผลิตภัณฑ์พร้อมวันสิ้นสุด |
| GRACE | หลังจาก ends_on เป็นเวลา grace_days วัน |
ได้รับสิทธิ์ใช้งาน พร้อมประกาศแจ้งเตือน LICENCE_IN_GRACE บนหน้า Today และบนหน้าใบอนุญาต |
| RESTRICT | หลังจากระยะเวลาผ่อนผัน | ไม่สามารถเริ่มงานใหม่ภายใต้กลุ่มที่ต้องใช้ใบอนุญาตได้ งานที่กำลังรันอยู่จะทำงานจนเสร็จ การอ่านและการส่งออกข้อมูลยังคงทำงานต่อไป และการแก้ไขด้านความปลอดภัยยังคงส่งมาอย่างต่อเนื่อง |
| TERMINATE | Adverant เพิกถอนใบอนุญาตแล้ว | หยุดการนำเสนออาร์ติแฟกต์ของ Enterprise ระดับพื้นฐานของ Community และการส่งออกข้อมูลยังคงอยู่ |
ในทุกสถานะ งานที่กำลังรันอยู่จะยังคงรันต่อไป การแก้ไขด้านความปลอดภัยยังคงส่งมาอย่างต่อเนื่อง การส่งออกข้อมูลยังคงอ่านได้ และไม่มีสิ่งใดถูกลบ ในสถานะ RESTRICT ผู้ที่พยายามเริ่มงานใหม่ของ Enterprise จะเห็นป้ายปฏิเสธพร้อมรหัส LICENCE_LOCKED และชื่อของผู้ที่สามารถต่ออายุได้
วิธีคำนวณวันที่ปัจจุบัน
นาฬิกาอาจคลาดเคลื่อนได้ และนาฬิกาอาจถูกตั้งย้อนกลับโดยเจตนาได้ ดังนั้นการติดตั้งจึงไม่เคยอ่านค่าจากนาฬิกาเพียงอย่างเดียว วันที่ปัจจุบันคือเวลาที่อยู่หลังสุดระหว่างสองค่า: นาฬิกาจริงของระบบและค่าเวลาขั้นต่ำที่บันทึกไว้ ซึ่งเป็นเวลาล่าสุดที่การติดตั้งเคยพบ ค่าเวลาขั้นต่ำจะเดินหน้าต่อไปทุกครั้งที่มีการนำเข้าและทุกครั้งที่มีการอ่านสถานะ และจะไม่เคยย้อนกลับเอง การตั้งนาฬิกาย้อนกลับไปหนึ่งเดือนจะไม่ทำให้ใบอนุญาตที่หมดอายุแล้วกลับมาเป็น VALID ได้ ใบอนุญาตที่เป็น RESTRICT จะยังคงเป็น RESTRICT ต่อไป
เมื่อนาฬิกาอ่านค่าได้ก่อนหน้าค่าเวลาขั้นต่ำ สถานะจะแสดงประกาศแจ้งเตือน LICENCE_CLOCK_BEHIND_FLOOR และจะถูกอ่านค่าตามวันของค่าเวลาขั้นต่ำ หากนาฬิกาเดินล่วงหน้าไปจริงๆ (เช่น โหนดบูตขึ้นมาด้วยวันที่ที่ไม่ถูกต้องและค่าเวลาขั้นต่ำถูกขยับตามไปข้างหน้า) ให้ขอโทเค็นรีเซ็ตเวลาจาก Adverant ซึ่งจะเป็นเอกสารลงนามขนาดเล็กที่ผูกไว้กับรหัสการติดตั้งของคุณและค่า nonce แบบใช้ครั้งเดียว พร้อมด้วยเวลา floor_to คุณสามารถนำเข้าผ่าน API ด้วยคำขอนี้:
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> คือโทเค็นการเข้าถึงของผู้ดูแลการติดตั้ง โทเค็นจะถูกนำไปใช้เมื่อลายเซ็นทั้งสองผ่านการตรวจสอบ รหัสการติดตั้งตรงกับของคุณ และค่า nonce ยังไม่เคยถูกใช้งาน โทเค็นที่ถูกปฏิเสธจะไม่เปลี่ยนแปลงสิ่งใดเลย ดังนั้นจึงไม่สามารถใช้เพื่อปฏิเสธใบอนุญาตที่ถูกต้องได้ โทเค็นที่ค่า nonce ถูกใช้ไปแล้วจะถูกปฏิเสธด้วยรหัส LICENCE_CLOCK_BEHIND_FLOOR
การขอใบอนุญาต
สามารถขอและดาวน์โหลดใบอนุญาตได้จากบัญชี Adverant ของคุณที่ https://account.adverant.ai ผู้ใดในองค์กรของคุณที่สามารถอ้างสิทธิ์การปรับใช้และดาวน์โหลดใบอนุญาตได้นั้น จะถูกตั้งค่าไว้ในหน้า Organisation and team roles ของบัญชี
Adverant จำเป็นต้องทราบว่าใบอนุญาตนั้นใช้สำหรับการติดตั้งใด และมีสามวิธีในการแจ้งให้ทราบ
รหัสใช้ครั้งเดียว สำหรับการติดตั้งที่มีหน้าจอ การติดตั้งจะแสดงรหัสใช้ครั้งเดียวและลายนิ้วมือของรหัสนั้น ในหน้า Claim a deployment ให้คุณวางรหัสลงไป จากนั้นเปรียบเทียบลายนิ้วมือทีละกลุ่มกับสิ่งที่การติดตั้งแสดง เมื่อทุกกลุ่มตรงกัน คุณจึงอ้างสิทธิ์ให้กับองค์กรของคุณ และใบอนุญาตจะถูกส่งเข้ามาในบัญชี
คีย์อ้างสิทธิ์ สำหรับอุปกรณ์เฉพาะทางหรืออุปกรณ์เอดจ์ อุปกรณ์เหล่านี้ไม่มีหน้าจอสำหรับแสดงรหัส หมายเลขซีเรียลและคีย์อ้างสิทธิ์จะพิมพ์อยู่บนกล่องและในใบสั่งซื้อของผู้ผลิตอุปกรณ์ ป้อนข้อมูลดังกล่าวในหน้า Enter a claim key ทีละรายการ หรือวางไฟล์ใบสั่งซื้อของผู้ผลิตเพื่ออ้างสิทธิ์หลายรายการพร้อมกัน คีย์แต่ละรายการจะถูกตรวจสอบกับบันทึกของ Adverant เกี่ยวกับสิ่งที่จัดส่งให้คุณ และคีย์จากใบสั่งซื้อของผู้อื่นจะถูกปฏิเสธ
คำขอใบอนุญาตที่ลงนามแล้ว สำหรับการติดตั้งที่ไม่มีการเชื่อมต่อภายนอก นี่คือวิธีที่ Harrow ใช้ ในการติดตั้ง ผู้ดูแลระบบจะสร้างไฟล์คำขอภายใต้เมนู This installation, Licence ซึ่งเป็นข้อมูลประเภท licence-request ที่ระบุรหัสการติดตั้ง และลงนามด้วยคีย์ Ed25519 ของการติดตั้งนั้นเอง Tomás จะนำไฟล์นี้ออกมาผ่านสื่อบันทึกข้อมูลที่ได้รับอนุมัติ วางลงในหน้า Offline exchange และดาวน์โหลดไฟล์ใบอนุญาตที่ส่งกลับมา ใบอนุญาตนี้จะใช้ได้เฉพาะกับการติดตั้งที่สร้างคำขอเท่านั้น
การนำเข้าใบอนุญาต
มีสามช่องทางในการนำเข้า และทั้งหมดจะไปยังเอนด์พอยต์เดียวกันบน nexus-auth เฉพาะผู้ดูแลการติดตั้งเท่านั้นที่สามารถนำเข้าได้: เจ้าของหรือผู้ดูแลระบบขององค์กรทั้งหมดที่เป็นเจ้าของระบบการติดตั้งนั้นซึ่งได้ลงชื่อเข้าใช้แล้ว หรือผู้ดูแลแพลตฟอร์มที่มีสิทธิ์เต็มรูปแบบ บุคคลอื่นนอกเหนือจากนี้จะถูกปฏิเสธก่อนที่จะมีการอ่านไฟล์
ในคอนโซล
ในการติดตั้งใหม่ การนำเข้าใบอนุญาต (Import the licence) เป็นหนึ่งในหกรายการตรวจสอบในหน้า Six things before anyone signs in เมื่อคุณวางไฟล์ลงในหน้าดังกล่าว คอนโซลจะตรวจสอบไฟล์บนการติดตั้งแบบออฟไลน์ และแสดงรายการกลุ่มฟีเจอร์พร้อมวิธีปกป้องของแต่ละกลุ่มรวมถึงระยะเวลาสัญญา
การนำเข้าในภายหลังจะทำผ่านเมนู This installation, Licence: ใช้ Import a new licence หรือ Import a renewed licence เมื่อใบอนุญาตปัจจุบันหมดอายุลง การติดตั้งแบบ Community ที่ต้องการเปลี่ยนไปเป็น Enterprise จะใช้ From Community to Enterprise หน้านั้นจะอ่านใบอนุญาตก่อนและแสดงสิ่งที่จะถูกดึงข้อมูลมาและสิ่งที่จะเปลี่ยนแปลงก่อนที่จะมีอะไรเกิดขึ้น จะไม่มีการดึงข้อมูลใดๆ จนกว่าจะมีผู้เลือก Fetch and switch on จากนั้นส่วนประกอบของ Enterprise จะถูกดึงมาจาก registry.adverant.ai ด้วยโทเค็นสำหรับดึงข้อมูลของการติดตั้ง โดยแต่ละส่วนจะถูกตรวจสอบกับคีย์ปล่อยรุ่นของ Adverant และกลุ่มต่างๆ จะเปิดใช้งานทีละรายการ หลังจากนั้นระบบจะยังคงเป็นการติดตั้งเดิม โดยมีผู้คน ไฟล์ เวิร์กโฟลว์ และช่องทางเดิมทั้งหมด
ด้วย nexusctl
nexusctl licence import harrow-2027.licence.jsonคำสั่งนี้จะนำเข้าไฟล์โดยไม่มีการเปลี่ยนแปลงและพิมพ์สถานะปัจจุบันของใบอนุญาตออกมา เพิ่ม --explain เพื่อพิมพ์การดำเนินการที่จะรันโดยไม่ต้องรันจริง
ผ่าน 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ส่งไฟล์ตามที่ Adverant มอบให้คุณทุกประการ อย่าจัดรูปแบบใหม่ และอย่าห่อหุ้มไว้ในอ็อบเจกต์อื่น: เนื้อหาของคำขอ (body) คือตัวเอกสาร เส้นทางนี้ไม่รับสตริงคิวรี และเนื้อหาที่มีขนาดเกิน 1 MiB จะถูกปฏิเสธ สมาชิกระดับบนสุดที่ระบุชื่อองค์กรหรือบุคคลจะถูกปฏิเสธด้วยรหัส TENANT_NOT_A_PARAMETER หรือ ACTOR_NOT_A_PARAMETER เนื่องจากใบอนุญาตของการติดตั้งเป็นของระบบการติดตั้งที่องค์กรเจ้าของโทเค็นนั้นเป็นเจ้าของ
การนำเข้าที่สำเร็จจะตอบกลับเป็น 201 เนื้อหาจะเก็บมุมมองของใบอนุญาต (รหัส, สถานะปัจจุบัน, ผู้ได้รับอนุญาต, รุ่น, ระยะเวลาสัญญา, การให้สิทธิ์ และกลุ่มฟีเจอร์) จำนวนองค์กรที่ถือครองใบอนุญาตนี้ในปัจจุบัน และจำนวนผู้เช่าที่ระบุไว้แต่ยังไม่มีองค์กร ใบอนุญาต ค่าไดเจสต์ SHA-256 และแถวบัญชีแยกประเภทสำหรับแต่ละองค์กรจะถูกเขียนลงในหนึ่งทรานแซกชัน และการนำเข้าจะถูกบันทึกไว้ในบันทึกการตรวจสอบ
มีเส้นทางการอ่านข้อมูลสองเส้นทางที่ใช้ควบคู่กัน:
GET /api/v1/installation/licence/stateตอบกลับเป็นสถานะ ซึ่งจะคำนวณใหม่ทุกครั้งที่มีการอ่าน ผู้ดูแลระบบจะได้รับมุมมองแบบเต็ม สมาชิกคนอื่นๆ ขององค์กรในการติดตั้งจะได้รับเฉพาะประกาศแจ้งเตือน: สถานะ, รหัสประกาศแจ้งเตือน (LICENCE_ENDS_SOON,LICENCE_IN_GRACEหรือLICENCE_CLOCK_BEHIND_FLOOR) และวันที่ที่ประกาศแจ้งเตือนระบุ สมาชิกจะไม่เคยเห็นผู้ได้รับอนุญาต ระยะเวลาสัญญา หรือกลุ่มต่างๆ เนื่องจากข้อมูลเหล่านั้นเป็นของเจ้าของระบบการติดตั้งGET /api/v1/installation/licence/documentตอบกลับเป็นเอกสารที่นำเข้าในรูปแบบข้อมูลดิบสำหรับผู้ดูแลระบบ แต่ละโมดูลของ Enterprise จะดึงข้อมูลนี้และตรวจสอบลายเซ็นอีกครั้งด้วยตัวตรวจสอบที่คอมไพล์ฝังไว้ในตัวเอง ดังนั้นบริการข้อมูลประจำตัวที่ถูกดัดแปลงจะไม่สามารถเปิดใช้งานกลุ่มที่ใบอนุญาตไม่ได้ให้สิทธิ์ได้
การปฏิเสธทุกรูปแบบ
การนำเข้าที่ถูกปฏิเสธจะไม่เปลี่ยนแปลงสิ่งใดเลย แม้แต่ค่าเวลาขั้นต่ำของนาฬิกา และการปฏิเสธจะถูกบันทึกไว้ในบันทึกการตรวจสอบ
| รหัส | HTTP | ความหมาย | สิ่งที่ต้องทำ |
|---|---|---|---|
LICENCE_FORMAT_INVALID |
422 | ไฟล์นี้ไม่ใช่ใบอนุญาตที่บิลด์นี้สามารถอ่านได้: ไม่ใช่ JSON, ไม่ตรงตามสคีมา, วันที่ไม่เรียงตามลำดับ หรือมีการระบุชื่อกลุ่มซ้ำสองครั้ง | ส่งไฟล์ตามที่ Adverant มอบให้คุณทุกประการ |
LICENCE_SIGNATURE_INVALID |
422 | ลายเซ็นหนึ่งในสองรายการหายไป หรือไฟล์ถูกเปลี่ยนแปลงหลังจากการลงนาม | ขอไฟล์จาก Adverant อีกครั้ง และอย่าแก้ไขไฟล์ |
LICENCE_ROOT_UNKNOWN |
422 | ลงนามด้วยคีย์ที่ trust roots ของรุ่นนี้ไม่มีอยู่ | ขอใบอนุญาตที่ลงนามสำหรับ roots ของรุ่นนี้ หรือทำการอัปเกรด |
LICENCE_MATRIX_MISMATCH |
422 | เขียนขึ้นโดยอ้างอิงกับเมทริกซ์รุ่นที่บิลด์นี้ไม่อ่าน หรือให้สิทธิ์กลุ่มที่แคตตาล็อกของบิลด์ไม่รู้จัก | อัปเกรดเป็นรุ่นที่สามารถอ่านได้ หรือขอใบอนุญาตที่เขียนขึ้นโดยอ้างอิงกับรุ่นนี้ |
LICENCE_OTHER_INSTALLATION |
409 | ออกให้กับรหัสการติดตั้งอื่น | ขอใบอนุญาตสำหรับข้อมูลประจำตัวของการติดตั้งนี้ |
LICENCE_REVOKED |
403 | Adverant ได้เพิกถอนใบอนุญาตนี้แล้ว | ขอใบอนุญาตใหม่จาก Adverant |
LICENCE_LOCKED |
403 | ใบอนุญาตยังไม่เริ่มต้น: วันที่ปัจจุบันอยู่ก่อนหน้า starts_on |
นำเข้าอีกครั้งในหรือหลังวันแรกของใบอนุญาต |
TRANSITION_NOT_PERMITTED |
409 | ใบอนุญาตที่มีรหัสนี้ถูกนำเข้าไปแล้ว | ขอใบอนุญาตใหม่จาก Adverant หากต้องเปลี่ยนแปลงเงื่อนไข |
RECORD_NOT_FOUND |
404 | การติดตั้งยังไม่ได้รับการประกาศ ดังนั้นจึงไม่มีข้อมูลประจำตัวให้ใช้ตรวจสอบเทียบ | ดำเนินการขั้นตอนแรกของผู้ดูแลระบบให้เสร็จสิ้น จากนั้นจึงนำเข้า |
VALIDATION_FAILED |
400 | ไม่สามารถอ่านเนื้อหาได้ มีขนาดเกิน 1 MiB หรือคำขอมีสตริงคิวรี | ส่งเฉพาะไฟล์เป็นเนื้อหาเพียงอย่างเดียว โดยไม่มีคิวรี |
การติดตั้งจะตรวจสอบตามลำดับที่กำหนดไว้ตายตัว และความล้มเหลวแรกที่พบจะเป็นตัวระบุรหัส ส่วนที่ขาดหายไปครึ่งหนึ่งจะถูกรายงานก่อนคีย์ที่ไม่รู้จัก และเอกสารที่ลายเซ็นไม่ผ่านการตรวจสอบจะไม่ถูกอ่านต่ออีกเลย ดังนั้นไฟล์ที่ถูกดัดแปลงแก้ไขซึ่งระบุชื่อการติดตั้งอื่นด้วยจะยังคงตอบกลับเป็น LICENCE_SIGNATURE_INVALID
การต่ออายุ
การต่ออายุคือใบอนุญาตฉบับใหม่ที่มี licence_id ใหม่ ให้นำเข้าด้วยวิธีเดียวกับฉบับแรก โดยจะมีผลทันทีไม่ว่าใบอนุญาตเก่าจะไปถึงสถานะใดแล้วก็ตาม: จาก WARN, GRACE หรือ RESTRICT การติดตั้งจะกลับไปเป็นสถานะมีใบอนุญาตทันที และไม่จำเป็นต้องติดตั้งสิ่งใดใหม่ นอกจากนี้ Adverant ยังสามารถออกใบอนุญาตที่เปลี่ยนแปลงระหว่างระยะเวลาสัญญาได้ เช่น เพื่อเพิ่ม Decision rooms และคุณก็นำเข้าด้วยวิธีเดียวกัน
การนำเข้าใบอนุญาตเดิมซ้ำสองครั้งจะถูกปฏิเสธด้วยรหัส TRANSITION_NOT_PERMITTED
การเพิกถอน
Adverant เพิกถอนใบอนุญาตโดยการลงนามในรายการเพิกถอน รายการดังกล่าวมีหมายเลข sequence และระบุรหัสใบอนุญาตแต่ละรายการที่ถูกเพิกถอนพร้อมเวลาและเหตุผล รายการเพิกถอนจะเป็นแบบสะสม: แต่ละรายการจะเก็บรหัสทั้งหมดที่ถูกเพิกถอนไปก่อนหน้าด้วย คุณสามารถนำเข้ารายการนี้ด้วยวิธีเดียวกับใบอนุญาต:
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รายการที่มีลำดับไม่สูงกว่ารายการล่าสุดที่นำเข้าจะถูกปฏิเสธด้วยรหัส TRANSITION_NOT_PERMITTED ดังนั้นจึงไม่สามารถนำรายการเก่ากลับมาใส่แทนที่รายการที่ใหม่กว่าได้ รายการที่อ่านไม่ได้หรือไม่ผ่านการตรวจสอบจะถูกปฏิเสธด้วยรหัสเดียวกับใบอนุญาต ทันทีที่รายการระบุชื่อใบอนุญาตของคุณ สถานะของใบอนุญาตจะเป็น TERMINATE
การติดตั้งที่ไม่มีการเชื่อมต่อภายนอกจะรับทราบถึงการเพิกถอนก็ต่อเมื่อมีผู้นำเข้ารายการดังกล่าวเท่านั้น สำหรับ Harrow การเพิกถอนเป็นเรื่องของสัญญาพอๆ กับเรื่องของซอฟต์แวร์ และ Tomás จะนำเข้าทุกรายการที่ Adverant ส่งมาในการข้ามระบบครั้งถัดไป
จำนวนที่นั่งที่เกินใบอนุญาต
ปริมาณในใบอนุญาตคือคำมั่นสัญญาเกี่ยวกับการใช้งาน และ Nexus จะถือว่าการใช้งานเกินปริมาณเป็นเพียงการแจ้งเตือน ไม่ใช่การล็อกไม่ให้ใช้งาน เมื่อมีผู้ใช้งาน Nexus มากกว่าที่ใบอนุญาตครอบคลุม ผู้ดูแลระบบจะเห็นป้าย SEATS_OVER_LICENCE บนหน้า People ทุกคนยังคงทำงานต่อไปได้ ป้ายดังกล่าวจะระบุว่าต้องแก้ไขให้ถูกต้องภายในเมื่อใด (30 วัน) แสดงว่าผู้คนที่เกินมานั้นมาจากที่ใด และเสนอสองวิธีแก้ไข: ลบผู้ที่ไม่จำเป็นต้องใช้ Nexus ออก หรือขอที่นั่งเพิ่มเติมจาก Adverant การเพิ่มที่นั่งเป็นการเปลี่ยนแปลงที่ละเอียดอ่อนซึ่งต้องใช้บุคคลที่สองร่วมอนุมัติ และที่นั่งที่เกินมาจะถูกนับรวมในใบแจ้งยอดการใช้งานประจำปี
ใบแจ้งยอดการใช้งานจะเก็บเฉพาะตัวนับเท่านั้น และคุณสามารถอ่านทุกบรรทัดได้ก่อนที่จะส่งออกไป Harrow บันทึกข้อมูลนี้เป็นไฟล์และนำออกไปผ่านการแลกเปลี่ยนแบบออฟไลน์
การประเมินผล
การประเมินผลคือใบอนุญาตประเภท evaluation ซึ่งเริ่มต้นจากหน้า Trials ของบัญชีสำหรับการปรับใช้ที่อ้างสิทธิ์แล้ว มีอายุใช้งานสูงสุด 30 วัน ครอบคลุมผู้มีรายชื่อระบุสูงสุด 5 คน และไม่มีระยะเวลาผ่อนผัน ในวันถัดจาก ends_on สถานะจะเปลี่ยนเป็น RESTRICT ทันที: พื้นที่ของ Enterprise จะกลับไปเป็นตัวอย่างแนะนำ และไม่มีสิ่งใดที่สร้างขึ้นระหว่างการประเมินผลถูกลบ การรัน Idea นโยบายที่ร่างไว้ และกฎของเมลจะถูกเก็บไว้ตามเดิมทุกประการ และจะเปิดใช้งานได้อีกครั้งเมื่อมีการนำเข้าใบอนุญาต
หนึ่งองค์กรสามารถรันการประเมินผลแบบโฮสต์ด้วยตนเองได้ครั้งละหนึ่งรายการ




