InnskráningBóka kynningu

Kafli 2.10

Uppsetning án nettengingar

Komdu með undirritaðan ótengdan pakka á stað án internets, sannreyndu hann gegn lykli sem þú komst með í sitthvoru lagi, hladdu honum inn í þína eigin skráningarmiðstöð og settu hann upp. Leyfi, uppfærslur og afturköllunarlistar fara einnig handvirkt yfir bilið.

Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

19 mínútna lestur

Rekstrarnet Harrow Port Authority hefur enga leið út á internetið, bæði samkvæmt lögum og hönnun. Skipaumferð, leguplön og tollstöðvanir eru öll á því, og ekkert á því má kalla út. Þegar Tomás Reilly setti Nexus upp þar barst hvert einasta bæti á diski sem sendiboði kom með í hliðhúsið, og hvert bæti var sannreynt innan svæðisins áður en nokkuð notaði það.

Þessi kafli fjallar um þá uppsetningu. Þú færð undirritaðan ótengdan pakka, sannreynir hann með lykli sem barst þér eftir annarri leið, afritar myndirnar úr honum í þína eigin myndaskrá, sannreynir þær aftur þar og setur upp kortið með nafni myndaskrárinnar þinnar í gildunum. Síðan koma þau atriði sem lofteinangrað svæði gerir í höndunum en tengt svæði fær ókeypis: k3s og cert-manager án niðurhals, uppfærslur á miðlum, leyfi í gegnum ótengd skipti og afturköllunarlista sem þú flytur inn sjálf(ur).

Vinstra megin geymir reiturinn „tengda hliðin“ „downloads.adverant.ai“ og „Adverant-reikninginn þinn“. Tvær aðskildar örvar fara yfir þykka lóðrétta línu sem merkt er „bilið“. Efri örin, merkt „einu sinni, eftir aðskilinni leið; fingrafar athugað utan rásar“, flytur „release.pub“. Neðri örin, merkt „hver útgáfa, á diski“, flytur „nexus-alpha-1.0.0-alpha.1-enterprise.tar“. Hægra megin, inni í „rekstrarneti Harrow“, koma báðar í reitinn „verify-bundle.sh: VERIFY-BUNDLE PASS“, sem liggur í „registry.harrow.example (cosign load, cosign verify)“ og síðan í „klasann (helm install)“.
Hvernig útgáfa og traust hennar fara yfir bilið eftir tveimur aðskildum leiðum.

Hvað ótengdi pakkinn geymir

Pakki er ein gerð af einni útgáfu, sem óþjappað tar-safn með prófsummuskrá við hliðina á sér: nexus-alpha-1.0.0-alpha.1-enterprise.tar og nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256. Community-pakkar eru opinberir á downloads.adverant.ai. Enterprise-pakkar koma af Adverant-reikningnum þínum á https://account.adverant.ai, við hlið leyfisins þíns, og aldrei nafnlaust.

Afþjappaður lítur hann svona út:

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

Hver images/<svc>/-mappa er það sem cosign save skrifar. Hún geymir myndavísinn og báðar pallamyndirnar, linux/amd64 og linux/arm64, ásamt cosign-undirrituninni, SPDX SBOM-staðfestingu (software bill of materials) fyrir hvorn pall og upprunastaðfestingu, allt gert með útgáfulykli Adverant. Sömu SBOM-skrárnar liggja í sbom/ sem venjulegar skrár, svo öryggisteymi geti lesið þær án cosign.

Gagnalagið inniheldur copyleft-hugbúnað: PostgreSQL með PostGIS og Neo4j Community Edition meðal annarra. Pakkinn inniheldur frumkóða hverrar myndar í gagnalaginu sem hann sendir, og release/source-offer.json tekur það fram fyrir hverja mynd. Pakki sem myndi senda copyleft-keyrsluskrá án frumkóða síns er ekki smíðaður.

release/facts.json nefnir útgáfuna, gerðina, arkitektúrana og fingrafar útgáfulykilsins sem pakkinn var undirritaður með, sem sha256:<hex>.

Dreifilykillinn ferðast sérstaklega

Pakkinn inniheldur aldrei lykilinn sem sannreynir hann. Pakki sem bæri sinn eigin lykil gæti verið skipt út, með lykli og öllu, af hverjum sem er, og hver einasta athugun myndi samt standast. Sannprófunarforskriftin hafnar lykli sem situr inni í pakkamöppunni.

Sæktu opinbera útgáfulykilinn einu sinni, á tengdri vél, frá https://downloads.adverant.ai/nexus/1.0.0-alpha.1/. Vistaðu hann sem release.pub. Fingrafar hans er SHA-256 gildi skrárinnar:

sha256sum release.pub

Berðu það saman við fingrafarið sem Adverant birtir, og við það sem er í útgáfulýsingunni sem þú fékkst eftir annarri rás. Kafli 2.4, Að sækja og sannreyna útgáfu, inniheldur nánari upplýsingar. Farðu síðan með release.pub inn á svæðið, eftir annarri leið en pakkinn ef þú getur, og geymdu hann þar. Teymi Tomásar geymir hann á skráasvæði rekstrarnetsins með athugasemd um dagsetninguna þegar hann kom inn. Hver síðari útgáfa er sannreynd gegn þessum uppsetta lykli, aldrei gegn neinu sem diskur kemur með sér.

Sannreyndu pakkann

verify-bundle.sh er forskriftin sem sannreynir pakka, gefin út með hverri útgáfu. Diskmynd uppsetningarforritsins keyrir sömu forskrift við fyrstu ræsingu. Hún þarf cosign v3, helm v4, og sha256sum eða shasum. Hún les ekkert af neinu neti og þarf ekkert Python, svo hún keyrir jafnt á berum uppsetningarhnút sem og á vinnustöð.

  1. Athugaðu tar-skrána gegn prófsummu hennar og afþjappaðu hana síðan:
sha256sum -c nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256
tar -xf nexus-alpha-1.0.0-alpha.1-enterprise.tar
  1. Keyrðu sannprófunina með lyklinum sem þú komst með inn:
./verify-bundle.sh nexus-alpha-1.0.0-alpha.1-enterprise release.pub

Þriðja viðfangið nefnir gildaskrá fyrir kortathuganirnar. Án þess notar forskriftin docs/example-values.yaml pakkans.

  1. Lestu síðustu línuna, sem verður að vera VERIFY-BUNDLE PASS áður en þú ferð lengra.
  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>

Forskriftin stöðvast við fyrstu athugun sem mistekst. Hér er það sem hver og ein gerir.

Skref Hvað það athugar
1 Hver skrá sem talin er upp í SHA256SUMS passar við prófsummu sína, og engin skrá er til staðar sem listinn sleppir. Innsettri aukaskrá er hafnað jafn örugglega og breyttri skrá.
2 SHA256SUMS.sigstore.json er gild undirritun yfir SHA256SUMS með lyklinum sem þú gafst upp. Með skrefum 1 og 2 saman er hvert bæti í pakkanum það bæti sem Adverant undirritaði.
3 Fyrir hverja myndamöppu: vísis-digest myndarinnar er í release/images.lock.json; það er cosign-undirritun þar sem viðfangsefnið er nákvæmlega það digest, og hún sannreynist gegn lyklinum þínum; cosign verify og cosign verify-attestation --type spdxjson standast bæði á vistuðu uppsetningunni.
4 helm lint --strict stenst á kortinu með sýnisgildunum, eða með þínum gildum.
5 Hver mynd í lásnum er vistuð í images/, og hver mynd sem kortið teiknar upp er digest í lásnum. Ekkert sem kortið setur upp kemur annars staðar frá.
6 Þegar lásinn geymir myndir í gagnalagi er release/source-offer.json tæmandi, nefnir hverja einustu þeirra, og hver frumkóðaskrá sem hún telur upp er til staðar með réttri prófsummu.

Skref 3 athugar undirritunina sjálfa, eftir digest, auk þess að keyra cosign verify. Ástæðan er hegðun cosign sjálfs: cosign verify á vistaðri uppsetningu hættir líka með 0 þegar uppsetningin geymir aðeins staðfestingu með lyklinum en enga undirritun. Forskriftin samþykkir það ekki.

Ef þetta mistekst

Bilun endar á VERIFY-BUNDLE FAIL step=<k> <why>.

Síðasta lína Hvað það þýðir Hvað skal gera
step=0 the public key must come from outside the bundle Lykillinn sem þú nefndir er inni í pakkamöppunni. Notaðu lykilinn sem þú komst með inn í sitthvoru lagi.
step=1 checksum mismatch Skrá breyttist eftir að listinn var gerður, eða skemmdist í flutningi. Afritaðu pakkann aftur af upprunalega miðlinum og athugaðu aftur.
step=1 files not covered by SHA256SUMS Skrá var bætt við pakkann. Meðhöndlaðu miðilinn sem ótraustan. Ekki setja upp af honum.
step=2 SHA256SUMS signature does not verify Prófsummulistinn er ekki undirritaður með útgáfulyklinum sem þú ert með. Stöðvaðu. Tilkynntu það til öryggisteymisins þíns og biddu Adverant um nýjan miðil.
step=3 image <svc>: ... Undirritun myndar eða SBOM-staðfesting vantar eða sannreynist ekki. Stöðvaðu, eins og fyrir skref 2.
step=4, step=5 Kortið eða myndalisti þess heldur ekki saman. Biddu Adverant um nýjan pakka.
step=6 ... Frumkóðatilboðið er ófullkomið. Biddu Adverant um nýjan pakka.

Að skref 2 og 3 mistakist er tilvikið sem öll hönnunin er til fyrir. Það þýðir að skrárnar eru ekki þær sem Adverant undirritaði. Geymdu miðilinn fyrir öryggisteymið þitt.

Hladdu myndunum inn í þína eigin skráningarmiðstöð

Hnútar þínir sækja myndir úr myndaskrá innan svæðisins. Myndaskrá Harrow er registry.harrow.example. Hver Nexus-mynd fer undir slóðina nexus/ í þeirri myndaskrá, vegna þess að kortið vísar í hverja mynd sem <global.imageRegistry>/nexus/<svc>@<digest>.

  1. Skráðu þig inn í myndaskrána þína með tólinu sem þú notar venjulega, svo cosign geti ýtt í hana.
  2. Innan úr pakkamöppunni skaltu hlaða inn hverri mynd og sannreyna hana aftur á nýja staðnum:
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

cosign load flytur undirritunina og hverja staðfestingu ásamt myndinni, svo eintakið í myndaskránni sannreynist gegn sama lykli. Sannprófunin hér er sú sem gildir fyrir klasann þinn: hún sannar að það sem hnútar þínir munu sækja er það sem Adverant undirritaði.

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

Hver mynd í lásnum ætti að prenta eina verified-línu. Lína sem vantar þýðir að hleðsla eða athugun þeirrar myndar mistókst, og villan hennar er prentuð rétt fyrir ofan.

Það er engin gagnsæisskrá (transparency log) fyrir Nexus-útgáfur, svo --insecure-ignore-tlog=true er nauðsynlegt við hverja athugun. Útgáfulykillinn er öll traustrótin. Án flaggsins hafnar cosign með not enough verified log entries from transparency log: 0 < 1.

Settu upp úr skráningarmiðstöðinni þinni

Gildaskráin fyrir lofteinangraða uppsetningu er ólík tengdri uppsetningu í einni línu: global.imageRegistry nefnir myndaskrána þína.

# 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>"

Færslurnar í <custodian-...-age-recipient> eru opinberu age1...-línurnar hjá fólkinu sem geymir endurheimtarlykla lyklageymslunnar. Kafli 2.8, Uppsetningar á einni vél, útskýrir hvernig hver og einn býr slíkan til. harrow-ssd er eigin geymsluflokkur Harrow: settu þinn eigin, eða slepptu storage.className til að nota sjálfgefið gildi klasans.

  1. Keyrðu forathugun (preflight) gegn klasanum með þessari skrá, eins og kafli 2.5, Forathugun með nexusctl, lýsir.
  2. Settu upp úr korti pakkans og slepptu --wait.
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

helm install --wait lendir í sjálfheldu (deadlock) með þessu korti: krókur eftir uppsetningu (post-install hook) gefur hverri þjónustu lykilorð sitt að gagnagrunninum, og --wait heldur krókunum aftur þar til þjónusturnar eru komnar upp. Kafli 2.8, Uppsetningar á einni vél, er með lykkjuna sem bíður líka eftir StatefulSets.

Með nexusctl er sama uppsetning nexusctl install --context <kube-context> --values harrow-prod-values.yaml.

Ekkert í kortinu nær út fyrir nafnrýmið nema DNS (Domain Name System), Kubernetes API (application programming interface) fyrir tókasannprófanir (token reviews), og hvaða vistfang sem þú telur upp í networkPolicy.externalEgressCIDRs, sem er tómt sjálfgefið. Engin fjarmæling (telemetry) fer út úr uppsetningunni, og telemetry.enabled er ekki hægt að stilla á neitt annað en false. Fyrir gervigreind (artificial intelligence) á svæði án internets tengir stofnunin sinn eigin OpenAI-samhæfða líkanaþjón innan svæðisins, sem nefndur er í ai.localProvider.baseUrl; kafli 2.14, Gervigreindarveitur og líkön, fjallar um það.

Leyfið er ekki kortagildi. Þú flytur það inn eftir uppsetninguna, eins og lýst er hér að neðan.

k3s og cert-manager án niðurhals

Ef Nexus á að fara á k3s-klasa sem þú byggir sjálf(ur) þarf k3s líka að setjast upp án nets. Diskmynd uppsetningarforritsins gerir þetta fyrir þig (kafli 2.9, Diskmynd uppsetningarforritsins). Í höndunum, á hverjum hnút:

  1. Flyttu yfir k3s v1.33.6+k3s1 útgáfuskrárnar fyrir þinn arkitektúr: k3s keyrsluskrána (k3s-arm64 á arm64), install.sh, k3s-airgap-images-<arch>.tar.zst og sha256sum-<arch>.txt. k3s birtir prófsummur fyrir þessar skrár en enga undirritun. Athugaðu hverja skrá gegn sha256sum-<arch>.txt, og hafðu það á hreinu við öryggisteymið þitt að þetta er prófsumma frá sama uppruna, ekki undirritun.
  2. Settu keyrsluskrána og kerfismyndirnar þar sem k3s leitar að þeim, og settu upp með slökkt á niðurhali:
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

cert-manager v1.21.3 er forsenda: eigin CA (certificate authority) kortsins er cert-manager útgefandi. Flyttu yfir kort cert-manager, cert-manager-v1.21.3.tgz, og myndir þess. Á tengdu hliðinni skaltu athuga myndirnar með eigin lykli cert-manager verkefnisins áður en þær fara yfir:

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

Innan svæðisins skaltu flytja myndirnar inn í gámageymslu hvers hnúts undir nöfnunum sem cert-manager kortið biður um, quay.io/jetstack/cert-manager-<name>:v1.21.3, athuga þær síðan og setja upp:

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

--wait er rétt fyrir cert-manager. Það er aðeins Nexus sem má ekki hafa það.

Uppfærslur og nýir hlutar berast á undirrituðum miðlum

Lofteinangrað svæði uppfærir líka af diski. Í stjórnborðinu hleður Flytja inn af miðli á síðunum Þessi uppsetning inn útgáfu af diski sem borinn er inn á svæðið. Það athugar prófsummu hverrar skrár, síðan undirritunina gegn útgáfulyklinum sem þegar er uppsettur á svæðinu, aldrei lykli sem diskurinn kemur með, og síðan að útgáfan sé nýrri en sú sem er í gangi. Innflutningur afritar og athugar aðeins. Fólk heldur áfram að vinna á útgáfunni sem er í gangi, og ekkert breytist fyrr en þú velur að uppfæra.

Innflutningur af gagnamiðli (engin nettenging)
Innflutningur af gagnamiðli (engin nettenging)
Útgáfa á diski flutt inn hjá Harrow. Undirritunin er athuguð gegn lyklinum sem er uppsettur á svæðinu, og útgáfan sem er í gangi helst ósnert þar til einhver uppfærir.

Af skipanalínunni fer sama útgáfa inn með nexusctl:

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

plan sýnir hvað mun breytast og breytir engu. apply tekur fyrst öryggisafrit og uppfærir síðan. Kafli 2.15, Dagur tvö: rekstur Nexus, fjallar ítarlega um uppfærslur.

Þegar undirritun disks passar ekki er innflutningnum hafnað með MEDIA_SIGNATURE_INVALID. Ekkert er hlaðið eða afritað inn, og útgáfan sem er í gangi heldur áfram að keyra. Síðan segir hvaða athuganir stóðust, hvar hún stöðvaðist, og lykilinn sem hún bjóst við við hlið lykilsins sem hún fann. Geymdu diskinn fyrir öryggisteymið þitt og biddu Adverant um nýjan.

Innflutningur af miðli mistókst
Innflutningur af miðli mistókst
Hafnaður innflutningur. Hver prófsumma passaði, en undirritunin var gerð með óþekktum lykli, svo ekkert var hlaðið inn og útgáfan sem var í gangi var látin í friði.

Enterprise-hlutarnir sem leyfi kveikir á koma á sama hátt á lofteinangruðu svæði: á útgáfudiskinum, í gegnum Flytja inn af miðli, áður en þú kveikir á þeim. Hver hluti er athugaður gegn útgáfulykli Adverant áður en kveikt er á honum, svo þú afritar aldrei keyrsluskrá inn í klasann í höndunum.

Leyfi án internets

Tengd uppsetning fær leyfið sitt sjálfkrafa. Lofteinangruð uppsetning skiptist á skrám við Adverant í höndunum, í gegnum ótengdu skiptin.

  1. Leyfissíður stjórnborðsins búa til litla leyfisbeiðniskrá. Uppsetningin undirritar hana með sínum eigin lykli, svo Adverant geti séð hvaða uppsetning bað um hana.
  2. Einhver fer með skrána út á USB-lykli í tölvu sem er á netinu, skráir sig inn á Adverant-reikninginn á https://account.adverant.ai, og hleður henni upp á síðunni Ótengd skipti.
  3. Hann kemur með leyfisskrána til baka á sama hátt.
  4. Flyttu hana inn. Í stjórnborðinu skaltu opna Leyfi og hvað það opnar og ýta á Flytja inn nýtt leyfi. Af skipanalínunni:
nexusctl licence import harrow-port-licence.json

Leyfið er athugað án nettengingar, innan svæðisins, gegn lyklum Adverant. Adverant undirritar hvert leyfi með tveimur óháðum lyklum, og báðar undirritanirnar verða að sannreynast.

Ótengd skipti
Ótengd skipti
Síðan Ótengd skipti á Adverant-reikningnum, þar sem undirrituð beiðniskrá fer upp og leyfisskrá kemur til baka.

Sömu skipti flytja árlega notkunaryfirlitið út. Það geymir aðeins teljara (sæti, tæki, eiginleikahópa), og kerfisstjórinn les það línu fyrir línu á Notkunaryfirlit fyrir Adverant áður en það fer út.

Kóði Staða Hvað það þýðir
LICENCE_SIGNATURE_INVALID 422 Skráin er ekki leyfi sem Adverant undirritaði, eða bæti breyttist eftir undirritun. Ekkert breytist.
LICENCE_OTHER_INSTALLATION 409 Leyfið er ósvikið en var gefið út fyrir aðra uppsetningu. Biddu um leyfi sem er gefið út fyrir auðkenni þessarar uppsetningar.
LICENCE_CLOCK_BEHIND_FLOOR 409 Klukkan sýnir tíma sem er fyrr en nýjasti tími sem þessi uppsetning hefur séð. Að færa klukkuna aftur í tímann endurlífgar ekki útrunnið leyfi.
LICENCE_REVOKED 403 Adverant dró leyfið til baka með undirritaðri afturköllun. Hætt er að bjóða upp á Enterprise-hluta; Community og útflutningur haldast.

Kafli 2.13, Leyfi, fjallar um stöður, frest og endurnýjun.

Afturköllunarlistar eru fluttir inn í höndunum

Þegar Adverant dregur leyfi til baka birtir það undirritaðan afturköllunarlista. Listinn er uppsafnaður: hver listi inniheldur öll leyfi sem dregin hafa verið til baka á undan honum. Tengd uppsetning fréttir af honum. Lofteinangruð uppsetning fréttir aðeins af honum þegar einhver flytur listann inn, svo komdu með nýjasta listann inn með hverjum útgáfudiski og flyttu hann inn í gegnum innflutning afturkallana í uppsetningunni á leyfissíðunum, eða /api/v1/installation/licence/revocations vistfangið á innskráningarþjóninum.

Þetta virkar í báðar áttir. Lofteinangruð uppsetning sem flytur aldrei inn lista fréttir aldrei að leyfi hafi verið afturkallað, þar á meðal leyfi sem undirritað var með lykli sem síðar kom í ljós að hafði komist í hendur óviðkomandi. Innflutningur listans er eina leiðin til að þær fréttir fari yfir bilið.

Fullvalda innsiglaði pakkinn: nexus-airgap

Sum fullvalda svæði vilja fá útgáfu sem eina innsiglaða, undirritaða skrá þar sem eigin lýsiskrá bannar netaðgang. Fyrir þau er til annað snið, innsiglaði pakkinn, og tól hans, nexus-airgap, úr pakkanum @adverant/nexus-sovereign. Settu tólið upp úr pakkaskrá Adverant, aðskilið frá öllum pökkum sem það mun athuga. Pakki getur ekki ábyrgst sjálfan sig.

Innsiglaði pakkinn er ein undirrituð tar-skrá. Lýsiskrá hans er undirrituð með Ed25519 og telur upp SHA-256 fyrir hverja skrá. Tólið hefur fjórar aðgerðir.

Aðgerð Hvað hann gerir
nexus-airgap bundle Smíðar innsiglaðan pakka úr undirbúinni möppu og undirritar lýsiskrá hans.
nexus-airgap verify --bundle <file> --trusted-key <pem> --profile <profile> Athugar undirritunina gegn trausta lyklinum, endurreiknar tætigildi hverrar skrár, hafnar öllum skrám sem lýsiskráin telur ekki upp, og hafnar pakka þar sem netreglan er ekki tómi leyfislistinn með umferð útsendara (agent) eingöngu staðbundið. Breytir engu.
nexus-airgap install Sannreynir, og framkvæmir síðan uppsetningaráætlunina í réttri röð: hlaða inn myndunum, virkja lýsiskrárnar, keyra gagnagrunnsyfirfærslurnar (migrations), frumstilla færnina (skills), úthluta lyklunum.
nexus-airgap open Opnar valfrjálsan dulkóðaðan útflutning pakkans með eigin lyklaverði svæðisins, sem á lofteinangruðu svæði er TPM (Trusted Platform Module) kubbur vélarinnar.

Sannreyndu áður en nokkuð annað er gert:

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

--keep-staging heldur sannreynda, afþjappaða eintakinu og nefnir það sem stagingDir í úttakinu, svo þú vinnur út frá því sem var athugað.

Ef sannprófun mistekst með BUNDLE_INTEGRITY_VIOLATION breyttist skrá inni í pakkanum eftir að hann var undirritaður. Stöðvaðu þar. Tólið er með --no-strict rofa sem sleppir athuguninni á óskráðum skrám. Ekki nota hann á útgáfu.

Daginn sem næsti diskur berst

Tomás geymir stuttan gátlista límdan inni í skápnum í hliðhúsinu, og það er þess virði að afrita hann. Athugaðu .sha256 tar-skrárinnar. Keyrðu verify-bundle.sh með uppsetta lyklinum og lestu síðustu línuna. Flyttu inn nýjasta afturköllunarlistann. Þá, og aðeins þá, skaltu flytja útgáfuna inn af miðli og skipuleggja uppfærsluna. Diskur sem fellur á einhverju þessara skrefa fer aftur í umslagið sitt, merktur, fyrir öryggisteymið, og ekkert á netinu hefur breyst.