ΣύνδεσηΚλείστε μια ενημέρωση

Κεφάλαιο 2.13

Άδειες χρήσης

Τι περιέχει ένα αρχείο άδειας χρήσης του Nexus, πώς το ελέγχει η εγκατάσταση εκτός σύνδεσης, οι έξι καταστάσεις στις οποίες μπορεί να βρίσκεται και πώς μπορείτε να ζητήσετε, να εισαγάγετε, να ανανεώσετε και να αποσύρετε μια άδεια.

Αυτή η σελίδα μεταφράστηκε με AI από το αγγλικό πρωτότυπο. Εάν οτιδήποτε είναι ασαφές, η αγγλική σελίδα αποτελεί το σημείο αναφοράς. Διαβάστε αυτή τη σελίδα στα αγγλικά

19 λεπτά ανάγνωσης

Η Harrow Port Authority εκτελεί το Nexus Enterprise στο δικό της σύμπλεγμα Kubernetes στη διεύθυνση harrow.example, χωρίς δρομολόγηση από το σύμπλεγμα προς το διαδίκτυο. Κάθε χρόνο η Aoife Brennan, επικεφαλής IT, ανανεώνει τη σύμβαση, και ο Tomás Reilly, ο μηχανικός πλατφόρμας, μεταφέρει ένα μικρό αρχείο JSON πέρα από το κενό δικτύου και το εισάγει. Τίποτα δεν επανεκκινείται και η σελίδα της άδειας χρήσης εμφανίζει νέα ημερομηνία λήξης.

Αυτό το κεφάλαιο αφορά εκείνο το αρχείο. Εν συντομία, μια άδεια χρήσης είναι ένα υπογεγραμμένο έγγραφο JSON συνδεδεμένο με μία εγκατάσταση. Η εγκατάσταση το ελέγχει η ίδια, με δημόσια κλειδιά ενσωματωμένα στην εικόνα (image), και δεν πραγματοποιεί καμία κλήση δικτύου για να το κάνει. Μια άδεια χρήσης δεν είναι ποτέ τιμή του 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. Κενό, εκτός εάν κάποια παραχώρηση έχει εμβέλεια μισθωτή (tenant-scoped).
edition enterprise ή team. Μια άδεια χρήσης Enterprise παραχωρεί πάντα το enterprise-base.
grants 1 έως 500 ζεύγη {feature_group, scope}, όπου κάθε ομάδα αναφέρεται μία φορά.
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 (Αλγόριθμος Ψηφιακής Υπογραφής Ελλειπτικής Καμπύλης) στην καμπύλη P-256 του NIST (Εθνικό Ινστιτούτο Προτύπων και Τεχνολογίας των ΗΠΑ), την οποία ζητούν οι αγοραστές που χρειάζονται ομοσπονδιακούς αλγορίθμους των ΗΠΑ. Και οι δύο δημιουργούνται επί των ίδιων byte, και πρέπει να επαληθευτούν και οι δύο. Ένα έγγραφο από το οποίο λείπει το ένα ήμισυ, ή στο οποίο οποιοδήποτε ήμισυ είναι εσφαλμένο, λογίζεται ως ανύπαρκτη άδεια χρήσης.

Τα υπογεγραμμένα byte είναι η κανονική μορφή RFC 8785 του εγγράφου με εξαίρεση το signatures, επομένως τα κενά διαστήματα και η σειρά των μελών στο αρχείο σας δεν κάνουν καμία διαφορά. Ένας και μόνο αλλαγμένος χαρακτήρας στο όνομα του κατόχου της άδειας, στις ημερομηνίες ή σε μια παραχώρηση συνιστά διαφορετικό έγγραφο και αποτυγχάνει.

Τα δημόσια κλειδιά που χρησιμοποιεί ο έλεγχος βρίσκονται σε ένα αρχείο ριζών εμπιστοσύνης (trust-roots) ενσωματωμένο σε κάθε εικόνα κατά τη δημιουργία της έκδοσης. Καμία μεταβλητή περιβάλλοντος, σημαία ή προσάρτηση δεν ορίζει άλλο αρχείο. Όταν η Adverant αντικαθιστά ένα κλειδί υπογραφής, το παλιό κλειδί υπογράφει το νέο και η επόμενη υπογεγραμμένη έκδοση φέρει το νέο κλειδί. Μια άδεια χρήσης υπογεγραμμένη με νέο κλειδί επαληθεύεται σε μια έκδοση που το φέρει, επομένως μετά από μια αλλαγή κλειδιού ενδέχεται να χρειαστεί να κάνετε αναβάθμιση πριν από την εισαγωγή (δείτε το κεφάλαιο 2.17, Αντιμετώπιση προβλημάτων).

Τύποι, εκδόσεις και πώς καταμετράται μια άδεια χρήσης

Το type δηλώνει από τι είδους συμφωνία προέρχεται η άδεια χρήσης:

  • alpha: άδεια χρήσης για το κανάλι κυκλοφορίας 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.

Ομάδες δυνατοτήτων, πρόσθετα και πακέτα τομέα (domain packs)

Το τι επιτρέπει μια άδεια χρήσης να χρησιμοποιούν οι άνθρωποι παρατίθεται ανά ομάδα λειτουργιών, χρησιμοποιώντας τα αναγνωριστικά του πίνακα εκδόσεων. Η άδεια χρήσης της 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 και τα σφραγισμένα αρχεία (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 εμφανίζονται ως προεπισκοπήσεις (teasers) με πληροφορίες για το ποιος μπορεί να τις ενεργοποιήσει.
VALID starts_on έως ends_on μείον warn_days Κάθε παραχωρημένη ομάδα είναι ενεργοποιημένη.
WARN Οι τελευταίες warn_days ημέρες της περιόδου ισχύος Ενεργοποιημένη, και οι διαχειριστές βλέπουν μια ειδοποίηση εντός του προϊόντος με την ημερομηνία λήξης.
GRACE Μετά την ends_on, για grace_days ημέρες Ενεργοποιημένη, με την ειδοποίηση LICENCE_IN_GRACE στη σελίδα Today και στη σελίδα της άδειας χρήσης.
RESTRICT Μετά την περίοδο χάριτος Καμία νέα εργασία δεν μπορεί να ξεκινήσει υπό μια αδειοδοτημένη ομάδα. Οι εργασίες που εκτελούνται ολοκληρώνονται, οι αναγνώσεις και οι εξαγωγές συνεχίζουν να λειτουργούν και οι ενημερώσεις ασφαλείας συνεχίζουν να καταφθάνουν.
TERMINATE Η Adverant ανακάλεσε την άδεια χρήσης Τα τεχνουργήματα (artefacts) του 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).
Οι καταστάσεις της άδειας χρήσης κατά μήκος του ημερολογίου.

Πώς υπολογίζεται η τρέχουσα ημερομηνία

Ένα ρολόι μπορεί να είναι λάθος, και ένα ρολόι μπορεί να γυρίσει πίσω σκόπιμα. Επομένως, η εγκατάσταση δεν διαβάζει ποτέ μόνο το ρολόι. Η τρέχουσα ημερομηνία είναι η μεταγενέστερη από δύο χρονικές στιγμές: το ρολόι συστήματος και ένα αποθηκευμένο κατώτατο όριο (floor), το οποίο είναι η πιο πρόσφατη χρονική στιγμή που έχει δει η εγκατάσταση. Το κατώτατο όριο προχωρά μπροστά σε κάθε εισαγωγή και σε κάθε ανάγνωση κατάστασης, και δεν γυρίζει ποτέ πίσω από μόνο του. Το γύρισμα του ρολογιού έναν μήνα πίσω δεν επαναφέρει μια ληγμένη άδεια χρήσης σε VALID· μια άδεια RESTRICT παραμένει RESTRICT.

Όταν το ρολόι δείχνει νωρίτερα από το κατώτατο όριο, η κατάσταση φέρει την ειδοποίηση LICENCE_CLOCK_BEHIND_FLOOR και διαβάζεται στην ημέρα του κατώτατου ορίου. Εάν το ρολόι όντως έτρεξε μπροστά (ένας κόμβος εκκινήθηκε με λάθος ημερομηνία και το κατώτατο όριο μεταφέρθηκε μπροστά), ζητήστε από την Adverant ένα διακριτικό επαναφοράς χρόνου (time-reset token). Πρόκειται για ένα μικρό υπογεγραμμένο έγγραφο συνδεδεμένο με το αναγνωριστικό της εγκατάστασής σας και ένα 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. Το ποιος στον οργανισμό σας μπορεί να διεκδικήσει αναπτύξεις (deployments) και να λάβει άδειες χρήσης ορίζεται στη σελίδα Organisation and team roles του λογαριασμού.

Η Adverant πρέπει να γνωρίζει για ποια εγκατάσταση προορίζεται η άδεια χρήσης, και υπάρχουν τρεις τρόποι για να το δηλώσετε.

Ένας κωδικός μίας χρήσης, για μια εγκατάσταση με οθόνη. Η εγκατάσταση εμφανίζει έναν κωδικό μίας χρήσης και το αποτύπωμά της (fingerprint). Στη σελίδα Claim a deployment επικολλάτε τον κωδικό και, στη συνέχεια, συγκρίνετε το αποτύπωμα ομάδα προς ομάδα με αυτό που εμφανίζει η εγκατάσταση. Όταν κάθε ομάδα ταιριάζει, τη διεκδικείτε για τον οργανισμό σας και η άδεια χρήσης καταφθάνει στον λογαριασμό.

Ένα κλειδί διεκδίκησης (claim key), για μια συσκευή (appliance) ή μια συσκευή άκρων (edge device). Αυτές δεν διαθέτουν οθόνη για να εμφανίσουν κωδικό. Ο σειριακός αριθμός και ένα κλειδί διεκδίκησης είναι τυπωμένα στο κουτί και στην παραγγελία του κατασκευαστή του εξοπλισμού. Εισαγάγετέ τα στη σελίδα Enter a claim key ένα προς ένα, ή αποθέστε το αρχείο παραγγελίας του κατασκευαστή για να διεκδικήσετε πολλά ταυτόχρονα. Κάθε κλειδί ελέγχεται σε σχέση με το αρχείο της Adverant για το τι σας εστάλη, και ένα κλειδί από παραγγελία άλλου απορρίπτεται.

Ένα υπογεγραμμένο αίτημα άδειας χρήσης, για μια εγκατάσταση χωρίς εξωτερική σύνδεση. Αυτή είναι η οδός της Harrow. Στην εγκατάσταση, ένας διαχειριστής δημιουργεί ένα αρχείο αιτήματος στην ενότητα This installation, Licence. Πρόκειται για μια δήλωση είδους licence-request που κατονομάζει το αναγνωριστικό της εγκατάστασης, υπογεγραμμένη με το κλειδί Ed25519 της ίδιας της εγκατάστασης. Ο Tomás το μεταφέρει έξω σε εγκεκριμένο μέσο, το αποθέτει στη σελίδα Offline exchange και κατεβάζει το αρχείο άδειας χρήσης που επιστρέφεται. Η άδεια χρήσης λειτουργεί μόνο στην εγκατάσταση που υπέβαλε το αίτημα.

Ανταλλαγή εκτός σύνδεσης
Ανταλλαγή εκτός σύνδεσης
Η ανταλλαγή εκτός σύνδεσης (offline exchange) για μια εγκατάσταση χωρίς εξωτερική σύνδεση. Κάθε αρχείο που διασχίζει το κενό δικτύου είναι υπογεγραμμένο, επομένως ένα αρχείο που αλλοιώθηκε στη διαδρομή απορρίπτεται, και κάθε ανταλλαγή καταγράφεται μαζί με το ποιος την πραγματοποίησε.
Δύο στήλες, η αριστερή με την ένδειξη «Εγκατάσταση Harrow (χωρίς internet)» και η δεξιά με την ένδειξη «Λογαριασμός Adverant». Αριστερά πάνω: ένα πλαίσιο «Αρχείο αιτήματος άδειας χρήσης, υπογεγραμμένο από το κλειδί εγκατάστασης». Ένα βέλος με την ένδειξη «μεταφέρεται σε αποθηκευτικό μέσο» περνά στο πλαίσιο της δεξιάς στήλης «Σελίδα ανταλλαγής εκτός σύνδεσης». Από κάτω του, ένα πλαίσιο «Αρχείο άδειας χρήσης, υπογεγραμμένο με δύο κλειδιά Adverant». Ένα βέλος με την ένδειξη «επιστρέφεται σε αποθηκευτικό μέσο» γυρίζει στο πλαίσιο της αριστερής στήλης «Εισαγωγή: κονσόλα, nexusctl ή API», και από εκεί προς τα κάτω σε ένα πλαίσιο «Ελέγχεται στην εγκατάσταση έναντι των ενσωματωμένων ριζών εμπιστοσύνης».
Πώς φτάνει μια άδεια χρήσης σε μια εγκατάσταση χωρίς εξωτερική σύνδεση.

Εισαγωγή άδειας χρήσης

Υπάρχουν τρεις τρόποι εισόδου και όλοι καταλήγουν στο ίδιο τελικό σημείο (endpoint) στο 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 με το διακριτικό ανάκτησης (pull token) της εγκατάστασης, όπου το καθένα ελέγχεται με το κλειδί έκδοσης της Adverant, και οι ομάδες ενεργοποιούνται μία προς μία. Μετά από αυτό, παραμένει η ίδια εγκατάσταση, με τους ίδιους ανθρώπους, αρχεία, ροές εργασίας και κανάλια.

Εισαγωγή της άδειας χρήσης
Εισαγωγή της άδειας χρήσης
Εισαγωγή της άδειας χρήσης κατά τη ρύθμιση. Το γνήσιο αρχείο παραθέτει τις ομάδες λειτουργιών του· ένα αντίγραφο με δύο αλλαγμένες γραμμές εμφανίζεται ως απόν (absent) με τον κωδικό 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) είναι το έγγραφο. Η διαδρομή δεν δέχεται συμβολοσειρά ερωτήματος (query string) και ένα σώμα μεγαλύτερο από 1 MiB απορρίπτεται. Ένα μέλος ανώτατου επιπέδου που κατονομάζει έναν οργανισμό ή ένα άτομο απορρίπτεται με TENANT_NOT_A_PARAMETER ή ACTOR_NOT_A_PARAMETER, επειδή η άδεια χρήσης της εγκατάστασης ανήκει στην εγκατάσταση που κατέχει ο οργανισμός του διακριτικού.

Μια επιτυχής εισαγωγή απαντά με 201. Το σώμα περιέχει την προβολή της άδειας χρήσης (το αναγνωριστικό της, την τρέχουσα κατάστασή της, τον κάτοχο της άδειας, την έκδοση, την περίοδο ισχύος, τις παραχωρήσεις και τις ομάδες λειτουργιών), πόσοι οργανισμοί την κατέχουν πλέον και πόσοι αναφερόμενοι μισθωτές δεν έχουν ακόμη οργανισμό. Η άδεια χρήσης, η σύνοψη SHA-256 της και οι γραμμές του καθολικού (ledger) για κάθε οργανισμό εγγράφονται σε μία συναλλαγή, και η εισαγωγή καταγράφεται στο αρχείο καταγραφής ελέγχου (audit log).

Δύο διαδρομές ανάγνωσης τη συνοδεύουν:

  • Το GET /api/v1/installation/licence/state απαντά με την κατάσταση, η οποία επαναϋπολογίζεται σε κάθε ανάγνωση. Ένας διαχειριστής λαμβάνει την πλήρη προβολή. Οποιοδήποτε άλλο μέλος ενός οργανισμού στην εγκατάσταση λαμβάνει μόνο την ειδοποίηση: την κατάσταση, τον κωδικό ειδοποίησης (LICENCE_ENDS_SOON, LICENCE_IN_GRACE ή LICENCE_CLOCK_BEHIND_FLOOR) και τις ημερομηνίες που αναφέρει η ειδοποίηση. Ένα μέλος δεν βλέπει ποτέ τον κάτοχο της άδειας, την περίοδο ισχύος ή τις ομάδες, επειδή αυτά ανήκουν στον ιδιοκτήτη της εγκατάστασης.
  • Το GET /api/v1/installation/licence/document απαντά με το εισαχθέν έγγραφο, σε ανεπεξέργαστη μορφή (raw), για τους διαχειριστές. Κάθε λειτουργική μονάδα του Enterprise το ανακτά και ελέγχει ξανά τις υπογραφές με τον δικό της ενσωματωμένο επαληθευτή, ώστε μια τροποποιημένη υπηρεσία ταυτότητας να μην μπορεί να ενεργοποιήσει μια ομάδα που δεν παραχωρεί η άδεια χρήσης.

Κάθε απόρριψη

Μια εισαγωγή που απορρίπτεται δεν αλλάζει τίποτα, ούτε καν το κατώτατο όριο του ρολογιού, και η απόρριψη καταγράφεται στο αρχείο καταγραφής ελέγχου.

Κωδικός HTTP Σημασία Τι πρέπει να κάνετε
LICENCE_FORMAT_INVALID 422 Το αρχείο δεν είναι άδεια χρήσης που μπορεί να διαβάσει αυτή η δομή (build): δεν είναι JSON, δεν ακολουθεί το σχήμα, οι ημερομηνίες είναι εκτός σειράς ή μια ομάδα αναφέρεται δύο φορές. Στείλτε το αρχείο ακριβώς όπως σας το έδωσε η Adverant.
LICENCE_SIGNATURE_INVALID 422 Μία από τις δύο υπογραφές λείπει ή το αρχείο άλλαξε μετά την υπογραφή. Ζητήστε ξανά το αρχείο από την Adverant και μην το επεξεργαστείτε.
LICENCE_ROOT_UNKNOWN 422 Είναι υπογεγραμμένο με κλειδί που δεν περιέχουν οι ρίζες εμπιστοσύνης αυτής της έκδοσης. Ζητήστε μια άδεια χρήσης υπογεγραμμένη για τις ρίζες αυτής της έκδοσης ή κάντε αναβάθμιση.
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

Μια λίστα της οποίας η ακολουθία (sequence) δεν είναι υψηλότερη από την τελευταία που εισήχθη απορρίπτεται με TRANSITION_NOT_PERMITTED, ώστε μια παλιά λίστα να μην μπορεί να επαναφερθεί στη θέση μιας νεότερης. Μια λίστα που δεν διαβάζεται ή δεν επαληθεύεται απορρίπτεται με τους ίδιους κωδικούς όπως μια άδεια χρήσης. Μόλις μια λίστα κατονομάσει την άδεια χρήσης σας, η κατάστασή της γίνεται TERMINATE.

Μια εγκατάσταση χωρίς εξωτερική σύνδεση μαθαίνει για μια ανάκληση μόνο όταν κάποιος εισαγάγει τη λίστα. Για τη Harrow, η ανάκληση είναι ζήτημα τόσο σύμβασης όσο και λογισμικού, και ο Tomás εισάγει κάθε λίστα που στέλνει η Adverant στην επόμενη μεταφορά.

Θέσεις καθ' υπέρβαση της άδειας χρήσης

Η ποσότητα της άδειας χρήσης είναι μια δέσμευση σχετικά με τη χρήση, και το Nexus αντιμετωπίζει την υπέρβασή της ως προειδοποίηση, ποτέ ως αποκλεισμό (lock-out). Όταν περισσότερα άτομα χρησιμοποιούν το Nexus από όσα καλύπτει η άδεια χρήσης, οι διαχειριστές βλέπουν την καρτέλα SEATS_OVER_LICENCE στη σελίδα People. Όλοι συνεχίζουν να εργάζονται. Η καρτέλα αναφέρει μέχρι πότε πρέπει να τακτοποιηθεί το θέμα (30 ημέρες), δείχνει από πού προήλθαν τα επιπλέον άτομα και προσφέρει τις δύο λύσεις: αφαιρέστε άτομα που δεν χρειάζονται το Nexus ή ζητήστε από την Adverant περισσότερες θέσεις (seats). Η προσθήκη θέσεων είναι μια ευαίσθητη αλλαγή που απαιτεί δεύτερο άτομο, και οι επιπλέον θέσεις καταμετρώνται στην ετήσια δήλωση χρήσης.

Θέσεις πέραν της άδειας χρήσης
Υπέρβαση θέσεων άδειας χρήσης
Περισσότερα άτομα από τις θέσεις. Ο συγχρονισμός καταλόγου πρόσθεσε 143 εξωτερικούς συνεργάτες και η καρτέλα δίνει 30 ημέρες για την αφαίρεση ατόμων ή την προσθήκη θέσεων, ενώ κανείς δεν αποκλείεται.

Η δήλωση χρήσης περιέχει μόνο μετρητές και μπορείτε να διαβάσετε κάθε γραμμή πριν αποσταλεί. Η Harrow την αποθηκεύει ως αρχείο και τη μεταφέρει έξω μέσω της ανταλλαγής εκτός σύνδεσης.

Αξιολογήσεις

Μια αξιολόγηση είναι μια άδεια χρήσης τύπου evaluation, η οποία ξεκινά από τη σελίδα Trials του λογαριασμού για μια διεκδικημένη ανάπτυξη. Διαρκεί το πολύ 30 ημέρες, καλύπτει το πολύ 5 κατονομαζόμενα άτομα και δεν έχει περίοδο χάριτος. Την επομένη της ends_on μεταβαίνει κατευθείαν σε RESTRICT: οι περιοχές του Enterprise επανέρχονται σε προεπισκοπήσεις (teasers) και τίποτα από όσα δημιουργήθηκαν κατά τη διάρκεια της αξιολόγησης δεν διαγράφεται. Οι εκτελέσεις του Ideas, τα προσχέδια πολιτικών και οι κανόνες αλληλογραφίας διατηρούνται ακριβώς όπως ήταν και ανοίγουν ξανά μόλις εισαχθεί μια άδεια χρήσης.

Ένας οργανισμός εκτελεί μία αυτοφιλοξενούμενη αξιολόγηση κάθε φορά.