เข้าสู่ระบบนัดหมายรับฟังข้อมูลสรุป (or นัดหมายพูดคุยกับทีมงาน)

บทที่ 2.13

ใบอนุญาต

สิ่งที่อยู่ในไฟล์ใบอนุญาตของ Nexus วิธีที่ระบบตรวจสอบไฟล์แบบออฟไลน์ สถานะทั้งหกที่เป็นไปได้ และวิธีขอ นำเข้า ต่ออายุ และเพิกถอนใบอนุญาต

หน้านี้แปลโดย AI จากต้นฉบับภาษาอังกฤษ หากมีส่วนใดไม่ชัดเจน โปรดอ้างอิงจากหน้าภาษาอังกฤษ อ่านหน้านี้เป็นภาษาอังกฤษ

ใช้เวลาอ่าน 19 นาที

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 (ตั้งแต่ starts_on), WARN (ช่วง warn_days สุดท้ายของระยะเวลาสัญญา), GRACE (ช่วง grace_days หลังจาก ends_on), RESTRICT (หลังระยะเวลาผ่อนผัน) ใต้แถบมีเครื่องหมายกำกับสามจุด: starts_on, ends_on และ ends_on + grace_days กล่องแยกด้านล่างไทม์ไลน์ซึ่งเชื่อมด้วยลูกศรเส้นประจากแถบใดๆ มีป้ายกำกับว่า TERMINATE (รายการเพิกถอนที่ลงนามแล้วระบุชื่อใบอนุญาตนี้) กล่องที่สองทางซ้ายสุดนอกไทม์ไลน์มีป้ายกำกับว่า ABSENT (ไม่มีใบอนุญาต หรือใบอนุญาตถูกปฏิเสธ: ระดับพื้นฐานของ Community)
สถานะของใบอนุญาตตามลำดับปฏิทิน

วิธีคำนวณวันที่ปัจจุบัน

นาฬิกาอาจคลาดเคลื่อนได้ และนาฬิกาอาจถูกตั้งย้อนกลับโดยเจตนาได้ ดังนั้นการติดตั้งจึงไม่เคยอ่านค่าจากนาฬิกาเพียงอย่างเดียว วันที่ปัจจุบันคือเวลาที่อยู่หลังสุดระหว่างสองค่า: นาฬิกาจริงของระบบและค่าเวลาขั้นต่ำที่บันทึกไว้ ซึ่งเป็นเวลาล่าสุดที่การติดตั้งเคยพบ ค่าเวลาขั้นต่ำจะเดินหน้าต่อไปทุกครั้งที่มีการนำเข้าและทุกครั้งที่มีการอ่านสถานะ และจะไม่เคยย้อนกลับเอง การตั้งนาฬิกาย้อนกลับไปหนึ่งเดือนจะไม่ทำให้ใบอนุญาตที่หมดอายุแล้วกลับมาเป็น 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 และดาวน์โหลดไฟล์ใบอนุญาตที่ส่งกลับมา ใบอนุญาตนี้จะใช้ได้เฉพาะกับการติดตั้งที่สร้างคำขอเท่านั้น

การแลกเปลี่ยนแบบออฟไลน์
การแลกเปลี่ยนแบบออฟไลน์
การแลกเปลี่ยนแบบออฟไลน์สำหรับการติดตั้งที่ไม่มีการเชื่อมต่อภายนอก ทุกไฟล์ที่ส่งข้ามระบบที่แยกส่วนกันจะมีการลงนาม ดังนั้นไฟล์ที่ถูกแก้ไขระหว่างทางจะถูกปฏิเสธ และทุกการแลกเปลี่ยนจะแสดงรายการพร้อมระบุผู้ที่ดำเนินการ
สองคอลัมน์ ด้านซ้ายมีป้ายกำกับว่า "ระบบที่ติดตั้งของ Harrow (ไม่มีอินเทอร์เน็ต)" และด้านขวามีป้ายกำกับว่า "บัญชี Adverant" ด้านบนซ้าย: กล่อง "ไฟล์คำขอใบอนุญาต ลงนามด้วยคีย์การติดตั้ง" ลูกศรที่มีป้ายกำกับว่า "นำส่งผ่านสื่อบันทึกข้อมูล" ชี้ข้ามไปยังกล่องในคอลัมน์ขวา "หน้าแลกเปลี่ยนแบบออฟไลน์" ด้านล่างคือกล่อง "ไฟล์ใบอนุญาต ลงนามด้วยคีย์ของ Adverant สองคีย์" ลูกศรที่มีป้ายกำกับว่า "นำส่งกลับผ่านสื่อบันทึกข้อมูล" ชี้กลับไปยังกล่องในคอลัมน์ซ้าย "นำเข้า: คอนโซล, nexusctl หรือ API" และจากจุดนั้นชี้ลงไปยังกล่อง "ตรวจสอบในระบบที่ติดตั้งเทียบกับรูทความเชื่อถือที่ฝังไว้ในระบบ"
วิธีที่ใบอนุญาตส่งไปถึงการติดตั้งที่ไม่มีการเชื่อมต่อภายนอก

การนำเข้าใบอนุญาต

มีสามช่องทางในการนำเข้า และทั้งหมดจะไปยังเอนด์พอยต์เดียวกันบน 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 และกลุ่มต่างๆ จะเปิดใช้งานทีละรายการ หลังจากนั้นระบบจะยังคงเป็นการติดตั้งเดิม โดยมีผู้คน ไฟล์ เวิร์กโฟลว์ และช่องทางเดิมทั้งหมด

การนำเข้าใบอนุญาตใช้งาน
การนำเข้าใบอนุญาตใช้งาน
การนำเข้าใบอนุญาตระหว่างการตั้งค่า ไฟล์ของแท้จะแสดงรายการกลุ่มฟีเจอร์ ส่วนไฟล์สำเนาที่มีการแก้ไขสองบรรทัดจะแสดงเป็นไม่มีใบอนุญาตพร้อมรหัส LICENCE_SIGNATURE_INVALID และใบอนุญาตที่มีผลบังคับใช้อยู่แล้วจะไม่ถูกแตะต้อง
จาก Community สู่ Enterprise
จาก Community สู่ Enterprise
การเปลี่ยนการติดตั้งแบบ Community ไปเป็น Enterprise ใบอนุญาตถูกอ่านและพบว่าเป็นของแท้ และหน้าเว็บจะแสดงรายการส่วนประกอบที่จะดึงข้อมูลมาและสิ่งที่จะเปลี่ยนแปลงก่อนที่จะมีผู้กด Fetch and switch on

ด้วย 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 การเพิ่มที่นั่งเป็นการเปลี่ยนแปลงที่ละเอียดอ่อนซึ่งต้องใช้บุคคลที่สองร่วมอนุมัติ และที่นั่งที่เกินมาจะถูกนับรวมในใบแจ้งยอดการใช้งานประจำปี

จำนวนที่นั่งเกินใบอนุญาต
จำนวนสิทธิ์การใช้งานเกินใบอนุญาต
จำนวนคนมากกว่าที่นั่ง การซิงค์ไดเรกทอรีได้เพิ่มผู้รับเหมาเข้ามา 143 คน และป้ายแจ้งเตือนให้เวลา 30 วันในการลบคนออกหรือเพิ่มที่นั่ง โดยที่ไม่มีใครถูกล็อกไม่ให้ใช้งาน

ใบแจ้งยอดการใช้งานจะเก็บเฉพาะตัวนับเท่านั้น และคุณสามารถอ่านทุกบรรทัดได้ก่อนที่จะส่งออกไป Harrow บันทึกข้อมูลนี้เป็นไฟล์และนำออกไปผ่านการแลกเปลี่ยนแบบออฟไลน์

การประเมินผล

การประเมินผลคือใบอนุญาตประเภท evaluation ซึ่งเริ่มต้นจากหน้า Trials ของบัญชีสำหรับการปรับใช้ที่อ้างสิทธิ์แล้ว มีอายุใช้งานสูงสุด 30 วัน ครอบคลุมผู้มีรายชื่อระบุสูงสุด 5 คน และไม่มีระยะเวลาผ่อนผัน ในวันถัดจาก ends_on สถานะจะเปลี่ยนเป็น RESTRICT ทันที: พื้นที่ของ Enterprise จะกลับไปเป็นตัวอย่างแนะนำ และไม่มีสิ่งใดที่สร้างขึ้นระหว่างการประเมินผลถูกลบ การรัน Idea นโยบายที่ร่างไว้ และกฎของเมลจะถูกเก็บไว้ตามเดิมทุกประการ และจะเปิดใช้งานได้อีกครั้งเมื่อมีการนำเข้าใบอนุญาต

หนึ่งองค์กรสามารถรันการประเมินผลแบบโฮสต์ด้วยตนเองได้ครั้งละหนึ่งรายการ