Verzió 1.0.0-alpha.1legújabb
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

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.
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.pubHasonlí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.
- 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- Futtassa az ellenőrzést a behozott kulccsal:
./verify-bundle.sh nexus-alpha-1.0.0-alpha.1-enterprise release.pubEgy 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.
- Olvassa el az utolsó sort, amelynek
VERIFY-BUNDLE PASSkell, 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.
- Jelentkezzen be a regisztrációs adatbázisba a szokásos eszközével, hogy a
cosignfeltölthessen (push) oda. - 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"
doneA 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.
- 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.
- Telepítsen a csomag chartjából, és hagyja el a
--waitkapcsoló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=900sA 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:
- Hozza át az architektúrájának megfelelő k3s v1.33.6+k3s1 kiadási fájlokat: a
k3sbinárist (arm64 eseténk3s-arm64), ainstall.sh,k3s-airgap-images-<arch>.tar.zstéssha256sum-<arch>.txtfájlokat. A k3s ellenőrzőösszegeket tesz közzé ezekhez a fájlokhoz, aláírást nem. Ellenőrizzen minden fájlt asha256sum-<arch>.txtalapjá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. - 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=600sA 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 10mA --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.
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.tarA 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.
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.
- 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.
- 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.aicímen, és feltölti az Offline csere (Offline exchange) oldalon. - A licencfájlt ugyanígy hozzák vissza.
- 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.jsonA 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.
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.jsonA --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.


