BejelentkezésBemutató kérése

2.10. fejezet

Hálózattól elzárt (air-gapped) telepítés

Vigyen be egy aláírt offline csomagot egy internetkapcsolat nélküli telephelyre, ellenőrizze egy külön bevitt kulccsal, töltse be a saját tárolójába (registry), és telepítse. A licencek, frissítések és visszavonási listák szintén manuálisan kerülnek át a zárt rendszerbe.

Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

19 perc olvasási idő

A Harrow Port Authority üzemeltetési hálózatának törvényi előírás és a tervezés alapján sincs kapcsolata az internettel. A hajóforgalom, a kikötőhelyi tervek és a vámzárak mind ezen futnak, és semmi sem kezdeményezhet róla kimenő hívást. Amikor Tomás Reilly telepítette ott a Nexust, minden egyes bájt egy futár által a portára hozott lemezen érkezett, és minden egyes bájtot ellenőriztek a telephelyen belül, mielőtt bármi felhasználta volna.

Ez a fejezet ezt a telepítést mutatja be. Beszerez egy aláírt offline csomagot, ellenőrzi egy másik útvonalon érkezett kulccsal, átmásolja a képfájlokat a saját regisztrációs adatbázisába (registry), ott újra ellenőrzi őket, majd telepíti a chartot úgy, hogy az értékek (values) között a saját regisztrációs adatbázisának neve szerepel. Ezután következnek azok a lépések, amelyeket egy izolált (air-gapped) telephelyen kézzel kell elvégezni, míg egy hálózatra kapcsolt helyszínen automatikusan megtörténnek: a k3s és a cert-manager telepítése letöltés nélkül, a frissítések adathordozón, a licencek offline cserén keresztül, valamint a visszavonási listák saját kezű importálása.

Bal oldalon a „hálózatra kapcsolt oldal” (connected side) doboz tartalmazza a „downloads.adverant.ai” címet és „az Ön Adverant-fiókját” (your Adverant account). Két külön nyíl keresztez egy vastag függőleges vonalat, amelynek felirata „a szakadék” (the gap). A felső nyíl, „egyszer, külön útvonalon; ujjlenyomat sávon kívül ellenőrizve” (once, by a separate route; fingerprint checked out of band) felirattal, a „release.pub” fájlt viszi. Az alsó nyíl, „minden kiadás, lemezen” (every release, on a disk) felirattal, a „nexus-alpha-1.0.0-alpha.1-enterprise.tar” fájlt viszi. Jobb oldalon, a „Harrow üzemeltetési hálózatán” (Harrow operations network) belül mindkettő a „verify-bundle.sh: VERIFY-BUNDLE PASS” dobozba érkezik, amely a „registry.harrow.example (cosign load, cosign verify)” elemhez, majd onnan „a fürthöz (helm install)” (the cluster (helm install)) vezet.
Hogyan íveli át a szakadékot egy kiadás és annak hitelessége két külön útvonalon.

Mit tartalmaz az offline csomag

Egy csomag egyetlen kiadás egyetlen változatát tartalmazza tömörítetlen tar fájlként, mellette egy ellenőrzőösszeg-fájllal: nexus-alpha-1.0.0-alpha.1-enterprise.tar és nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256. A Community csomagok nyilvánosan elérhetők a downloads.adverant.ai címen. Az Enterprise csomagok az Ön Adverant-fiókjából, a https://account.adverant.ai címről tölthetők le a licence mellől, és soha nem névtelenül.

Kicsomagolva így néz ki:

nexus-alpha-1.0.0-alpha.1-enterprise/
  release/facts.json               the release facts: version, edition, architectures, key fingerprint
  release/facts-gaps.json          the release facts the build couldn't record, each with its reason
  release/images.lock.json         every image by digest: index, per platform, its SBOMs
  release/source-offer.json        the sources of every copyleft data-tier image
  release/source-offer.sha256      a checksum for each of those source files
  images/<svc>/                    one cosign save layout per image
  charts/nexus-1.0.0-alpha.1.tgz   the Helm chart
  sbom/<edition>/<svc>-<arch>.spdx.json
  source-offer/                    the source files themselves
  docs/INSTALL-AIRGAP.md
  docs/example-values.yaml
  docs/RELEASE-NOTES.md
  SHA256SUMS                       a checksum for every file above
  SHA256SUMS.sigstore.json         the signature over SHA256SUMS, made with the release key

Minden egyes images/<svc>/ könyvtár a cosign save által írt tartalom. Magában foglalja a képfájl-indexet és mindkét platform képfájlját (linux/amd64 és linux/arm64), a cosign-aláírással, egy SPDX SBOM (szoftverösszetevő-lista) tanúsítvánnyal mindkét platformhoz, valamint egy származási tanúsítvánnyal, amelyek mind az Adverant kiadási kulcsával készültek. Ugyanezek az SBOM-ok egyszerű fájlként megtalálhatók az sbom/ könyvtárban is, így a biztonsági csapat cosign nélkül is elolvashatja őket.

Az adatréteg copyleft szoftvereket is tartalmaz: többek között a PostgreSQL-t PostGIS-szel, valamint a Neo4j Community Editiont. A csomag tartalmazza minden általa szállított adatréteg-képfájl forráskódját, és az release/source-offer.json ezt minden képfájl esetében rögzíti is. Olyan csomag, amely copyleft binárist a forráskódja nélkül szállítana, nem készül.

A release/facts.json megnevezi a kiadást, a változatot, az architektúrákat, valamint annak a kiadási kulcsnak az ujjlenyomatát, amellyel a csomagot aláírták, sha256:<hex> formában.

A nyilvános kulcs külön úton érkezik

A csomag soha nem tartalmazza az ellenőrzéséhez szükséges kulcsot. Egy olyan csomagot, amely a saját kulcsát is tartalmazza, bárki kicserélhetne a kulccsal együtt, és minden ellenőrzés sikeres maradna. Az ellenőrző szkript elutasítja a csomag könyvtárán belül található kulcsot.

Szerezze be egyszer a nyilvános kiadási kulcsot egy hálózatra kapcsolt gépen a https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ címről. Mentse el release.pub néven. Az ujjlenyomata a fájl SHA-256 értéke:

sha256sum release.pub

Hasonlítsa ezt össze az Adverant által közzétett ujjlenyomattal, valamint a külön csatornán kapott kiadási megjegyzésekben szereplővel. A részleteket a 2.4. fejezet (Kiadás beszerzése és ellenőrzése) tartalmazza. Ezután vigye be a release.pub fájlt a telephelyre – ha lehetséges, a csomagtól eltérő útvonalon –, és őrizze meg ott. Tomás csapata az üzemeltetési hálózat fájlmegosztóján tartja, a bekerülés dátumát tartalmazó feljegyzéssel együtt. Minden későbbi kiadást ezzel a telepített kulccsal ellenőriznek, soha nem azzal, amit egy lemez magával hoz.

A csomag ellenőrzése

A verify-bundle.sh a csomagot ellenőrző szkript, amelyet minden kiadással együtt közzétesznek. A telepítő lemezkép ugyanezt a szkriptet futtatja az első indításkor. Szüksége van a cosign v3, a helm v4, valamint az sha256sum vagy a shasum meglétére. Semmilyen hálózatról nem olvas adatot, és nincs szüksége Pythonra, így csupasz telepítő csomóponton éppúgy fut, mint egy munkaállomáson.

  1. Ellenőrizze a tar fájlt az ellenőrzőösszege alapján, majd csomagolja ki:
sha256sum -c nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256
tar -xf nexus-alpha-1.0.0-alpha.1-enterprise.tar
  1. Futtassa az ellenőrzést a behozott kulccsal:
./verify-bundle.sh nexus-alpha-1.0.0-alpha.1-enterprise release.pub

Egy harmadik argumentum egy értékfájlt (values) nevez meg a chart ellenőrzéseihez. Ennek hiányában a szkript a csomag docs/example-values.yaml fájlját használja.

  1. Olvassa el az utolsó sort, amelynek VERIFY-BUNDLE PASS kell, hogy legyen, mielőtt továbbhaladna.
  1 SHA256SUMS OK files=<n>
  2 SHA256SUMS signature OK
  3 images signed + SBOM-attested: <n>
  4 helm lint --strict OK nexus-1.0.0-alpha.1.tgz
  5 coverage OK rendered=<n> lock=<n>
  6 source offer OK images=5 files=<n>
VERIFY-BUNDLE PASS files=<n> images=<n>

A szkript megáll az első sikertelen ellenőrzésnél. Az egyes lépések a következőket teszik.

Lépés Mit ellenőriz
1 Az SHA256SUMS fájlban felsorolt minden fájl megfelel az ellenőrzőösszegének, és nincs jelen olyan fájl, amely kimaradt a listából. Egy becsempészett plusz fájl ugyanolyan biztosan hibát okoz, mint egy módosított.
2 Az SHA256SUMS.sigstore.json egy érvényes aláírás az SHA256SUMS felett az Ön által megadott kulccsal. Az 1. és 2. lépéssel együtt biztosított, hogy a csomag minden egyes bájtja az a bájt, amelyet az Adverant aláírt.
3 Minden képfájl-könyvtár esetében: a képfájl index-kivonata (digest) szerepel a release/images.lock.json fájlban; létezik egy cosign-aláírás, amelynek tárgya pontosan ez a kivonat, és az érvényesíthető az Ön kulcsával; a cosign verify és a cosign verify-attestation --type spdxjson egyaránt sikeresen lefut a mentett elrendezésen.
4 A helm lint --strict sikeresen lefut a charton a példaértékekkel vagy az Ön saját értékeivel.
5 A zárolási fájlban (lock) szereplő minden képfájl el van mentve az images/ könyvtárban, és a chart által előállított minden képfájl egy kivonat a zárolási fájlban. Semmi, amit a chart telepít, nem származik máshonnan.
6 Amikor a zárolási fájl adatréteg-képfájlokat tartalmaz, az release/source-offer.json teljes, megnevezi mindegyiket, és az általa felsorolt minden forrásfájl jelen van a megfelelő ellenőrzőösszeggel.

A 3. lépés kivonat alapján ellenőrzi magát az aláírást, amellett, hogy futtatja a cosign verify parancsot. Ennek oka a cosign saját működése: a mentett elrendezésen futtatott cosign verify akkor is 0 kóddal lép ki, ha az elrendezés csak egy kulccsal készült tanúsítványt tartalmaz, aláírást viszont nem. A szkript ezt nem fogadja el.

Ha ez sikertelen

A hiba VERIFY-BUNDLE FAIL step=<k> <why> üzenettel végződik.

Utolsó sor Mit jelent Teendők
step=0 the public key must come from outside the bundle Az Ön által megnevezett kulcs a csomag könyvtárán belül található. Használja a külön behozott kulcsot.
step=1 checksum mismatch Egy fájl megváltozott a lista elkészítése után, vagy megsérült a szállítás során. Másolja át újra a csomagot az eredeti adathordozóról, és ellenőrizze ismét.
step=1 files not covered by SHA256SUMS Egy fájlt hozzáadtak a csomaghoz. Kezelje az adathordozót megbízhatatlanként. Ne telepítsen róla.
step=2 SHA256SUMS signature does not verify Az ellenőrzőösszeg-listát nem az Ön birtokában lévő kiadási kulccsal írták alá. Álljon meg. Jelentse a biztonsági csapatnak, és kérjen az Adveranttól új adathordozót.
step=3 image <svc>: ... Egy képfájl aláírása vagy SBOM-tanúsítványa hiányzik, vagy az ellenőrzése sikertelen. Álljon meg, akárcsak a 2. lépésnél.
step=4, step=5 A chart vagy annak képfájl-listája nem konzisztens. Kérjen az Adveranttól új csomagot.
step=6 ... A forráskód-ajánlat hiányos. Kérjen az Adveranttól új csomagot.

A 2. és 3. lépés sikertelensége az az eset, amelynek kivédésére az egész rendszert tervezték. Ez azt jelenti, hogy a fájlok nem azok, amelyeket az Adverant aláírt. Őrizze meg az adathordozót a biztonsági csapat számára.

A képfájlok betöltése a saját tárolóba

A csomópontok a telephelyen belüli regisztrációs adatbázisból (registry) töltik le a képfájlokat. A Harrow-é a registry.harrow.example. Minden Nexus-képfájl az nexus/ útvonal alá kerül ebben a regisztrációs adatbázisban, mivel a chart minden képfájlra <global.imageRegistry>/nexus/<svc>@<digest> formában hivatkozik.

  1. Jelentkezzen be a regisztrációs adatbázisba a szokásos eszközével, hogy a cosign feltölthessen (push) oda.
  2. A csomag könyvtárán belülről töltse be az összes képfájlt, és ellenőrizze őket újra az új helyükön:
REG=registry.harrow.example
jq -r '.images[] | "\(.svc) \(.index)"' release/images.lock.json | while read -r svc digest; do
  cosign load --dir "images/$svc" "$REG/nexus/$svc"
  cosign verify --key release.pub --insecure-ignore-tlog=true "$REG/nexus/$svc@$digest" > /dev/null \
    && cosign verify-attestation --key release.pub --insecure-ignore-tlog=true --type spdxjson "$REG/nexus/$svc@$digest" > /dev/null \
    && echo "verified $svc"
done

A cosign load a képfájllal együtt viszi az aláírást és minden tanúsítványt, így a regisztrációs adatbázisban lévő másolat ugyanazzal a kulccsal ellenőrizhető. A fürt (cluster) szempontjából az itteni ellenőrzés számít: ez bizonyítja, hogy amit a csomópontok le fognak tölteni, az megegyezik azzal, amit az Adverant aláírt.

verified nexus-alpha
verified nexus-auth
verified nexus-postgres
...

A zárolási fájlban lévő minden képfájlnak egy verified sort kell kiírnia. A hiányzó sor azt jelenti, hogy az adott képfájl betöltése vagy ellenőrzése sikertelen volt, és a hibaüzenet közvetlenül felette olvasható.

A Nexus-kiadásokhoz nincs átláthatósági napló (transparency log), ezért minden ellenőrzésnél szükség van a --insecure-ignore-tlog=true kapcsolóra. A kiadási kulcs jelenti a teljes bizalmi gyökeret (trust root). A kapcsoló nélkül a cosign not enough verified log entries from transparency log: 0 < 1 üzenettel elutasítja a műveletet.

Telepítés a saját tárolóból

Az izolált (air-gapped) telepítés értékfájlja (values) egyetlen sorban tér el a hálózatra kapcsolt változattól: az global.imageRegistry a saját regisztrációs adatbázisát nevezi meg.

# harrow-prod-values.yaml (Helm values)
global:
  imageRegistry: registry.harrow.example
  domain: harrow.example
hosts:
  console: console.harrow.example
  api: api.harrow.example
  auth: auth.harrow.example
edition: enterprise
enterprise:
  enabled: true
tls:
  mode: existing
  existingSecret: harrow-public-tls
storage:
  className: harrow-ssd
keys:
  installationName: harrow-port
  custody:
    recipients:
      - "<custodian-one-age-recipient>"
      - "<custodian-two-age-recipient>"

Az <custodian-...-age-recipient> bejegyzések azoknak a személyeknek a nyilvános age1... sorai, akik a kulcstároló helyreállítási kulcsait birtokolják. A 2.8. fejezet (Egygépes telepítések) elmagyarázza, hogyan készíthetnek ilyet. A harrow-ssd a Harrow saját tárolási osztálya (storage class): adja meg a sajátját, vagy hagyja ki a storage.className beállítást a fürt alapértelmezett értékének használatához.

  1. Futtassa az előzetes ellenőrzést (preflight) a fürtön ezzel a fájllal, ahogyan azt a 2.5. fejezet (Előzetes ellenőrzés a nexusctl segítségével) leírja.
  2. Telepítsen a csomag chartjából, és hagyja el a --wait kapcsolót.
helm install nexus charts/nexus-1.0.0-alpha.1.tgz -n nexus --create-namespace \
  -f harrow-prod-values.yaml --timeout 45m
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s

A helm install --wait holtpontot (deadlock) okoz ennél a chartnál: egy telepítés utáni (post-install) hook adja meg minden szolgáltatásnak az adatbázis-jelszavát, a --wait pedig visszatartja a hookokat, amíg a szolgáltatások el nem indulnak. A 2.8. fejezet (Egygépes telepítések) tartalmazza azt a ciklust, amely a StatefulSetekre is vár.

A nexusctl használatával ugyanez a telepítés: nexusctl install --context <kube-context> --values harrow-prod-values.yaml.

A chartban semmi sem nyúl ki a névtéren (namespace) kívülre, kivéve a DNS-t (Domain Name System), a Kubernetes API-t (alkalmazásprogramozási felület) a tokenek ellenőrzéséhez, valamint bármely olyan címet, amelyet felsorol az alapértelmezés szerint üres networkPolicy.externalEgressCIDRs listában. Semmilyen telemetria nem hagyja el a telepítést, és a telemetry.enabled nem állítható másra, csak false értékre. Az internetkapcsolat nélküli telephelyeken használt AI (mesterséges intelligencia) esetében a szervezet a saját, telephelyen belüli, OpenAI-kompatibilis modellszerverét csatlakoztatja, amelyet az ai.localProvider.baseUrl nevez meg; erről a 2.14. fejezet (AI-szolgáltatók és -modellek) szól.

A licenc nem egy chart-érték. A telepítés után kell importálnia, az alábbiakban leírtak szerint.

k3s és cert-manager letöltés nélkül

Ha a Nexus egy Ön által épített k3s-fürtre kerül, a k3s-t is hálózat nélkül kell telepíteni. A telepítő lemezkép ezt elvégzi Ön helyett (2.9. fejezet, A telepítő lemezkép). Kézzel, minden egyes csomóponton:

  1. Hozza át az architektúrájának megfelelő k3s v1.33.6+k3s1 kiadási fájlokat: a k3s binárist (arm64 esetén k3s-arm64), a install.sh, k3s-airgap-images-<arch>.tar.zst és sha256sum-<arch>.txt fájlokat. A k3s ellenőrzőösszegeket tesz közzé ezekhez a fájlokhoz, aláírást nem. Ellenőrizzen minden fájlt a sha256sum-<arch>.txt alapján, és tisztázza a biztonsági csapattal, hogy ez egy azonos forrásból származó ellenőrzőösszeg, nem pedig aláírás.
  2. Helyezze a binárist és a rendszer-képfájlokat oda, ahol a k3s keresi őket, majd telepítse kikapcsolt letöltésekkel:
sudo install -m 0755 k3s /usr/local/bin/k3s
sudo mkdir -p /var/lib/rancher/k3s/agent/images
sudo cp k3s-airgap-images-amd64.tar.zst /var/lib/rancher/k3s/agent/images/
sudo INSTALL_K3S_SKIP_DOWNLOAD=true INSTALL_K3S_EXEC="--write-kubeconfig-mode=0600" sh install.sh
sudo k3s kubectl wait --for=condition=Ready node --all --timeout=600s

A cert-manager v1.21.3 előfeltétel: a chart saját CA-ja (hitelesítésszolgáltatója) egy cert-manager kibocsátó (issuer). Hozza át a cert-manager chartját, a cert-manager-v1.21.3.tgz fájlt és a képfájljait. A hálózatra kapcsolt oldalon ellenőrizze a képfájlokat a cert-manager projekt saját kulcsával, mielőtt átvinné őket:

cosign verify --signature-digest-algorithm sha512 --insecure-ignore-tlog=true \
  --key cert-manager-pubkey-2021-09-20.pem quay.io/jetstack/<image>@<digest>

A telephelyen belül importálja a képfájlokat minden csomópont konténertárolójába a cert-manager chart által kért quay.io/jetstack/cert-manager-<name>:v1.21.3 nevek alatt, majd ellenőrizze őket és végezze el a telepítést:

sudo k3s ctr -n k8s.io images import --all-platforms cert-manager-images.tar
sudo k3s ctr -n k8s.io images ls -q | grep cert-manager
helm install cert-manager cert-manager-v1.21.3.tgz -n cert-manager \
  --create-namespace --set crds.enabled=true --wait --timeout 10m

A --wait megfelelő a cert-managerhez. Csak a Nexus esetében tilos használni.

A frissítések és az új elemek aláírt adathordozón érkeznek

Egy izolált telephely a frissítést is lemezről végzi. A konzolon az Ez a telepítés (This installation) oldalakon található Importálás adathordozóról (Import from media) funkció betölti a telephelyre behozott lemezen lévő kiadást. Ellenőrzi minden fájl ellenőrzőösszegét, majd az aláírást a telephelyen már telepített kiadási kulccsal (soha nem a lemezen lévő kulccsal), végül pedig azt, hogy a kiadás újabb-e a jelenleg futónál. Az importálás csak másol és ellenőriz. A felhasználók tovább dolgozhatnak a futó kiadáson, és semmi sem változik, amíg Ön úgy nem dönt, hogy frissít.

Importálás adathordozóról (internet nélkül)
Importálás adathordozóról (internet nélkül)
Lemezről importált kiadás a Harrow-nál. Az aláírást a telephelyen telepített kulccsal ellenőrzik, és a futó verzió érintetlen marad, amíg valaki el nem indítja a frissítést.

Parancssorból ugyanez a kiadás a nexusctl paranccsal vihető be:

nexusctl upgrade plan --bundle nexus-alpha-1.0.0-alpha.2-enterprise.tar
nexusctl upgrade apply --bundle nexus-alpha-1.0.0-alpha.2-enterprise.tar

A plan megmutatja, mi fog változni, de nem módosít semmit. A apply először biztonsági mentést készít, majd frissít. A 2.15. fejezet (Második nap: a Nexus üzemeltetése) részletesen tárgyalja a frissítéseket.

Ha egy lemez aláírása nem egyezik, az importálást a rendszer MEDIA_SIGNATURE_INVALID üzenettel elutasítja. Semmi sem töltődik be vagy másolódik át, és a futó kiadás zavartalanul fut tovább. Az oldal megmutatja, mely ellenőrzések voltak sikeresek, hol állt meg a folyamat, és milyen kulcsot várt a talált kulcs mellett. Őrizze meg a lemezt a biztonsági csapat számára, és kérjen az Adveranttól egy újat.

Az adathordozóról történő importálás sikertelen
Az adathordozóról történő importálás sikertelen
Elutasított importálás. Minden ellenőrzőösszeg egyezett, de az aláírás ismeretlen kulccsal készült, így semmi sem töltődött be, és a futó kiadás érintetlen maradt.

A licenc által aktivált Enterprise összetevők ugyanígy érkeznek egy izolált telephelyre: a kiadási lemezen, az Importálás adathordozóról funkción keresztül, még mielőtt bekapcsolná őket. Minden összetevőt ellenőriz a rendszer az Adverant kiadási kulcsával a bekapcsolás előtt, így soha nem kell kézzel binárist másolnia a fürtbe.

Licencek internet nélkül

A hálózatra kapcsolt telepítés önállóan megkapja a licencét. Az izolált telepítés kézzel cserél fájlokat az Adveranttal az offline cserén keresztül.

  1. A konzol licencoldalai készítenek egy kis licenckérelmi fájlt. A telepítés aláírja azt a saját kulcsával, így az Adverant tudja, melyik telepítés nyújtotta be a kérelmet.
  2. Valaki kiviszi a fájlt egy pendrive-on egy internetkapcsolattal rendelkező számítógépre, bejelentkezik az Adverant-fiókba a https://account.adverant.ai címen, és feltölti az Offline csere (Offline exchange) oldalon.
  3. A licencfájlt ugyanígy hozzák vissza.
  4. Importálja a fájlt. A konzolon nyissa meg a Licenc és amit felold (Licence and what it unlocks) oldalt, és nyomja meg az Új licenc importálása (Import a new licence) gombot. Parancssorból:
nexusctl licence import harrow-port-licence.json

A licenc ellenőrzése offline, a telephelyen belül történik az Adverant kulcsai alapján. Az Adverant minden licencet két független kulccsal ír alá, és mindkét aláírásnak érvényesnek kell lennie.

Offline csere
Offline csere
Az Offline csere oldal az Adverant-fiókban, ahová az aláírt kérelmi fájlt feltöltik, és ahonnan a licencfájlt visszakapják.

Ugyanezen a cserén keresztül viszik ki az éves használati kimutatást is. Ez kizárólag számlálókat tartalmaz (felhasználói helyek, eszközök, funkciócsoportok), és a rendszergazda sorról sorra elolvashatja a Használati kimutatás az Adverant számára (Usage statement for Adverant) oldalon, mielőtt kivinnék.

Kód Állapot Mit jelent
LICENCE_SIGNATURE_INVALID 422 A fájl nem egy Adverant által aláírt licenc, vagy egy bájt megváltozott az aláírás után. Semmi sem változik.
LICENCE_OTHER_INSTALLATION 409 A licenc eredeti, de egy másik telepítéshez állították ki. Kérjen egy olyat, amelyet ennek a telepítésnek az azonosítójához (id) állítottak ki.
LICENCE_CLOCK_BEHIND_FLOOR 409 Az óra korábbi időpontot mutat, mint a telepítés által látott legutóbbi időpont. Az óra visszaállítása nem éleszti újra a lejárt licencet.
LICENCE_REVOKED 403 Az Adverant egy aláírt visszavonással visszavonta a licencet. Az Enterprise összetevők többé nem érhetők el; a Community és az exportálás megmarad.

A 2.13. fejezet (Licencek) tárgyalja az állapotokat, a türelmi időt és a megújítást.

A visszavonási listákat kézzel kell importálni

Amikor az Adverant visszavon egy licencet, közzétesz egy aláírt visszavonási listát. A lista kumulatív: mindegyik tartalmazza az összes korábban visszavont licencet. Egy hálózatra kapcsolt telepítés értesül erről. Egy izolált telepítés csak akkor értesül róla, ha valaki importálja a listát, ezért minden kiadási lemezzel hozza be a legfrissebb listát, és importálja a telepítés visszavonás-importáló felületén a licencoldalakon, vagy a bejelentkezési kiszolgáló /api/v1/installation/licence/revocations címén.

Ez kétélű dolog. Az az izolált telepítés, amelybe soha nem importálnak listát, soha nem értesül arról, ha egy licencet visszavontak, beleértve az olyan kulccsal aláírt licenceket is, amelyekről később kiderült, hogy kompromittálódtak. A lista importálása az egyetlen módja annak, hogy ez a hír átívelje a szakadékot.

A szuverén, lezárt csomag: nexus-airgap

Egyes szuverén telephelyek egyetlen lezárt, aláírt fájlként kérik a kiadást, amelynek saját manifesztje tiltja a hálózati hozzáférést. Számukra létezik egy második formátum, a lezárt csomag (sealed bundle), és annak eszköze, a nexus-airgap, amely a @adverant/nexus-sovereign csomagból származik. Telepítse az eszközt az Adverant csomagregisztrációs adatbázisából, elkülönítve minden olyan csomagtól, amelyet ellenőrizni fog. Egy csomag nem kezeskedhet önmagáért.

A lezárt csomag egyetlen aláírt tarball. A manifesztje Ed25519 algoritmussal van aláírva, és minden fájlhoz felsorol egy SHA-256 értéket. Az eszköz négy műveletet (verb) ismer.

Művelet Mit csinál
nexus-airgap bundle Felépít egy lezárt csomagot egy előkészített könyvtárból, és aláírja a manifesztjét.
nexus-airgap verify --bundle <file> --trusted-key <pem> --profile <profile> Ellenőrzi az aláírást a megbízható kulcs alapján, újraszámítja minden fájl kivonatát (hash), elutasít minden olyan fájlt, amely nem szerepel a manifesztben, és elutasítja azt a csomagot, amelynek hálózati szabálya nem az üres engedélyezési lista kizárólag helyi ágensforgalommal. Nem módosít semmit.
nexus-airgap install Ellenőriz, majd sorrendben végrehajtja a telepítési tervet: betölti a képfájlokat, alkalmazza a manifeszteket, futtatja a migrációkat, feltölti a képességeket (skills), és kiosztja a kulcsokat.
nexus-airgap open Megnyitja a csomag opcionális titkosított exportját a telephely saját kulcsőrével, amely egy izolált telephelyen a gép TPM (Trusted Platform Module) chipje.

Mindenekelőtt végezze el az ellenőrzést:

nexus-airgap verify --bundle nexus-alpha-1.0.0-alpha.1.tar.gz \
  --trusted-key release.pub --profile airgap --keep-staging > verify.json
jq '{ok, bundleId, profile, artifactsVerified}' verify.json

A --keep-staging megtartja az ellenőrzött, kicsomagolt másolatot, és a kimenetben stagingDir néven nevezi meg, így Ön abból dolgozhat, amit már ellenőrzött.

Ha az ellenőrzés BUNDLE_INTEGRITY_VIOLATION hibával meghiúsul, a csomagban lévő egyik fájl megváltozott az aláírás után. Álljon meg ott. Az eszköz rendelkezik egy --no-strict kapcsolóval, amely kihagyja a listán nem szereplő fájlok ellenőrzését. Kiadáson ne használja.

Aznap, amikor megérkezik a következő lemez

Tomás egy rövid ellenőrzőlistát tart felragasztva a portai szekrény belsejében, amelyet érdemes lemásolni. Ellenőrizze a tar .sha256 értékét. Futtassa a verify-bundle.sh szkriptet a telepített kulccsal, és olvassa el az utolsó sort. Importálja a legújabb visszavonási listát. Ezután, és csakis ezután importálja a kiadást az adathordozóról, és tervezze meg a frissítést. Az a lemez, amelyik ezen lépések bármelyikén megbukik, felcímkézve visszakerül a borítékjába a biztonsági csapat számára, és a hálózaton semmi sem változott.