Logi sisseBroneerige tutvustus

Peatükk 2.10

Võrgust eraldatud (air-gapped) paigaldus

Viige allkirjastatud võrguväline pakett internetiühenduseta asukohta, kontrollige seda eraldi toodud võtme abil, laadige see oma registrisse ja paigaldage. Litsentsid, uuendused ja tühistusnimekirjad liiguvad üle võrgueralduse samuti käsitsi.

Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

19 minutit lugemist

Harrow Port Authority operatsioonivõrgul puudub nii seadusest tulenevalt kui ka ülesehituselt ühendus internetiga. Seal asuvad laevaliikluse andmed, sildumisplaanid ja tollikinnipidamised ning miski selles võrgus ei tohi väljapoole ühendust võtta. Kui Tomás Reilly sinna Nexuse paigaldas, saabus iga bait kettal, mille kuller tõi väravahoonesse, ja iga bait kontrolliti objektil üle enne, kui miski seda kasutas.

See peatükk käsitlebki seda paigaldust. Te hangite allkirjastatud võrguühenduseta paketi, kontrollite seda teist teed pidi saabunud võtmega, kopeerite selle tõmmised oma registrisse, kontrollite neid seal uuesti ja paigaldate charti, määrates väärtustes oma registri nime. Seejärel tulevad toimingud, mida õhuvahega (air-gapped) asukoht teeb käsitsi, kuid mille võrguühendusega asukoht saab automaatselt: k3s ja cert-manager ilma allalaadimiseta, uuendused andmekandjal, litsentsid võrguühenduseta vahetuse kaudu ning tühistamisnimekirjad, mille impordite ise.

Vasakul on kast "connected side" (võrguühendusega pool), mis sisaldab üksusi "downloads.adverant.ai" ja "your Adverant account" (teie Adveranti konto). Kaks eraldi noolt ületavad paksu vertikaalset joont sildiga "the gap" (õhuvahe). Ülemine nool sildiga "once, by a separate route; fingerprint checked out of band" (üks kord, eraldi teed pidi; sõrmejälg kontrollitud kõrvalkanali kaudu) kannab faili "release.pub". Alumine nool sildiga "every release, on a disk" (iga väljalase, kettal) kannab faili "nexus-alpha-1.0.0-alpha.1-enterprise.tar". Paremal, kasti "Harrow operations network" (Harrow' operatsioonivõrk) sees, jõuavad mõlemad kasti "verify-bundle.sh: VERIFY-BUNDLE PASS", mis viib edasi üksusesse "registry.harrow.example (cosign load, cosign verify)" ja seejärel üksusesse "the cluster (helm install)" (klaster).
Kuidas väljalase ja selle usaldus ületavad õhuvahe kahte eraldi teed pidi.

Mida võrguväline pakett sisaldab

Pakett on ühe väljalaske üks väljaanne pakkimata tar-failina, mille kõrval on kontrollsumma fail: nexus-alpha-1.0.0-alpha.1-enterprise.tar ja nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256. Community paketid on avalikud aadressil downloads.adverant.ai. Enterprise'i paketid pärinevad teie Adveranti kontolt aadressil https://account.adverant.ai, asuvad teie litsentsi kõrval ega ole kunagi anonüümsed.

Lahtipakituna näeb see välja selline:

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

Iga images/<svc>/ kataloog on see, mille cosign save kirjutab. See sisaldab tõmmiste indeksit ja mõlema platvormi (linux/amd64 ja linux/arm64) tõmmiseid koos cosign-allkirjaga, SPDX SBOM-i (tarkvara koostisosade loetelu) kinnitust iga platvormi kohta ja päritolukinnitust, mis kõik on loodud Adveranti väljalaskevõtmega. Samad SBOM-id asuvad kataloogis sbom/ tavaliste failidena, et turvameeskond saaks neid lugeda ilma cosign-tööriistata.

Andmekiht sisaldab copyleft-tarkvara: muu hulgas PostgreSQL koos PostGIS-iga ja Neo4j Community Edition. Pakett sisaldab iga tarnitava andmekihi tõmmise lähtekoodi ning release/source-offer.json kinnitab seda iga tõmmise puhul. Paketti, mis tarniks copyleft-binaarfaili ilma selle lähtekoodita, ei looda.

release/facts.json nimetab väljalaske, väljaande, arhitektuurid ja selle väljalaskevõtme sõrmejälje, millega pakett allkirjastati, kujul sha256:<hex>.

Avalik võti liigub eraldi

Pakett ei sisalda kunagi võtit, millega seda kontrollitakse. Paketi, mis kannaks endaga kaasas omaenda võtit, võiks igaüks koos võtmega välja vahetada ja kõik kontrollid läbiksid ikkagi edukalt. Kontrollskript keeldub võtmest, mis asub paketi kataloogi sees.

Hankige väljalaske avalik võti üks kord võrguühendusega masinas aadressilt https://downloads.adverant.ai/nexus/1.0.0-alpha.1/. Salvestage see nimega release.pub. Selle sõrmejälg on faili SHA-256 räsi:

sha256sum release.pub

Võrrelge seda sõrmejäljega, mille Adverant avaldab, ja sellega, mis on teise kanali kaudu saadud väljalaskemärkmetes. Peatükk 2.4, Väljalaske hankimine ja kontrollimine, sisaldab üksikasju. Seejärel viige release.pub objektile, võimaluse korral teist teed pidi kui pakett, ja hoidke seda seal. Tomási meeskond hoiab seda operatsioonivõrgu failiserveris koos märkega saabumiskuupäeva kohta. Iga hilisemat väljalaset kontrollitakse selle paigaldatud võtme, mitte kunagi kettaga kaasatoodud failide alusel.

Kontrollige paketti

verify-bundle.sh on paketti kontrolliv skript, mis avaldatakse iga väljalaskega. Paigaldusketta tõmmis käivitab sama skripti esimesel alglaadimisel. See vajab tööriistu cosign v3, helm v4 ning sha256sum või shasum. See ei loe võrgust midagi ega vaja Pythonit, seega töötab see nii puhtal paigaldussõlmel kui ka tööjaamas.

  1. Kontrollige tar-faili selle kontrollsumma alusel ja pakkige seejärel lahti:
sha256sum -c nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256
tar -xf nexus-alpha-1.0.0-alpha.1-enterprise.tar
  1. Käivitage kontroll sissetoodud võtmega:
./verify-bundle.sh nexus-alpha-1.0.0-alpha.1-enterprise release.pub

Kolmas argument määrab väärtuste faili charti kontrollimiseks. Ilma selleta kasutab skript paketi faili docs/example-values.yaml.

  1. Lugege viimast rida, mis peab enne jätkamist olema VERIFY-BUNDLE PASS.
  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>

Skript peatub esimese ebaõnnestunud kontrolli juures. Siin on kirjeldatud, mida iga samm teeb.

Samm Mida see kontrollib
1 Iga failis SHA256SUMS loetletud fail vastab oma kontrollsummale ja ühtegi faili, mida nimekirjas pole, ei esine. Lisatud võõras fail põhjustab sama kindla tõrke kui muudetud fail.
2 SHA256SUMS.sigstore.json on kehtiv allkiri failile SHA256SUMS, mis on antud teie esitatud võtmega. Kui sammud 1 ja 2 on läbitud, on iga bait paketis täpselt see bait, mille Adverant allkirjastas.
3 Iga tõmmise kataloogi puhul: tõmmise indeksi räsi (digest) on failis release/images.lock.json; leidub cosign-allkiri, mille subjekt on täpselt see räsi, ja see valideerub teie võtmega; nii cosign verify kui ka cosign verify-attestation --type spdxjson läbivad salvestatud paigutuse kontrolli.
4 helm lint --strict läbib charti kontrolli näidisväärtuste või teie enda väärtustega.
5 Iga lukustusfailis olev tõmmis on salvestatud kataloogi images/ ja iga tõmmis, mille chart genereerib, on lukustusfailis olev räsi. Miski, mida chart paigaldab, ei pärine kuskilt mujalt.
6 Kui lukustusfail sisaldab andmekihi tõmmiseid, on release/source-offer.json täielik, nimetab neist igaühe ja iga selles loetletud lähtekoodifail on olemas koos õige kontrollsummaga.

Samm 3 kontrollib lisaks käsu cosign verify käivitamisele ka allkirja ennast räsi alusel. Põhjuseks on cosigni enda käitumine: cosign verify salvestatud paigutusel tagastab samuti koodi 0, kui paigutus sisaldab ainult võtmega antud kinnitust, kuid mitte allkirja. Skript seda ei aktsepteeri.

Kui see ebaõnnestub

Tõrge lõpeb teatega VERIFY-BUNDLE FAIL step=<k> <why>.

Viimane rida Mida see tähendab Mida teha
step=0 the public key must come from outside the bundle Teie määratud võti asub paketi kataloogi sees. Kasutage võtit, mille tõite sisse eraldi.
step=1 checksum mismatch Faili on muudetud pärast nimekirja koostamist või on see edastamise käigus kahjustada saanud. Kopeerige pakett uuesti algselt andmekandjalt ja kontrollige uuesti.
step=1 files not covered by SHA256SUMS Paketti on lisatud fail. Käsitlege andmekandjat ebausaldusväärsena. Ärge paigaldage sellelt.
step=2 SHA256SUMS signature does not verify Kontrollsummade nimekiri ei ole allkirjastatud teie käes oleva väljalaskevõtmega. Peatuge. Teatage sellest oma turvameeskonnale ja küsige Adverantilt uus andmekandja.
step=3 image <svc>: ... Tõmmise allkiri või SBOM-i kinnitus puudub või ei valideeru. Peatuge, nagu 2. sammu puhul.
step=4, step=5 Chart või selle tõmmiste nimekiri ei ole kooskõlas. Küsige Adverantilt uus pakett.
step=6 ... Lähtekoodi pakkumine on puudulik. Küsige Adverantilt uus pakett.

Sammude 2 ja 3 ebaõnnestumine on just see juhtum, mille jaoks kogu see ülesehitus on loodud. See tähendab, et failid ei ole need, mille Adverant allkirjastas. Hoidke andmekandja oma turvameeskonna jaoks alles.

Laadige tõmmised oma registrisse

Teie sõlmed tõmbavad tõmmiseid objekti sees asuvast registrist. Harrow' oma on registry.harrow.example. Iga Nexuse tõmmis läheb selles registris asukohta nexus/, kuna chart viitab igale tõmmisele kujul <global.imageRegistry>/nexus/<svc>@<digest>.

  1. Logige oma registrisse sisse tööriistaga, mida tavaliselt kasutate, et cosign saaks sinna tõmmiseid lükata.
  2. Laadige paketi kataloogist iga tõmmis ja kontrollige seda uues asukohas uuesti:
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 kannab koos tõmmisega üle ka allkirja ja kõik kinnitused, nii et registri koopia valideerub sama võtme alusel. Siinne kontroll on teie klastri jaoks otsustava tähtsusega: see tõestab, et see, mida teie sõlmed tõmbavad, on see, mille Adverant allkirjastas.

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

Iga lukustusfailis olev tõmmis peaks väljastama ühe verified rea. Puuduv rida tähendab, et selle tõmmise laadimine või kontroll ebaõnnestus, ning vastav veateade kuvatakse vahetult ülalpool.

Nexuse väljalasete jaoks puudub läbipaistvuslogi, seega on --insecure-ignore-tlog=true vajalik igal kontrollil. Väljalaskevõti on kogu usaldusjuur. Ilma selle liputa keeldub cosign töötlemisest teatega not enough verified log entries from transparency log: 0 < 1.

Paigaldamine oma registrist

Õhuvahega paigalduse väärtuste fail erineb võrguühendusega paigalduse omast ühe rea poolest: global.imageRegistry määrab teie registri.

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

Kirjed <custodian-...-age-recipient> on nende inimeste avalikud age1... read, kelle käes on võtmehoidla taastevõtmed. Peatükk 2.8, Ühe masina paigaldused, selgitab, kuidas igaüks neist selle loob. harrow-ssd on Harrow' enda salvestusklass: sisestage enda oma või jätke storage.className välja, et kasutada klastri vaikeväärtust.

  1. Käivitage selle failiga klastri eelkontroll (preflight), nagu kirjeldab peatükk 2.5, Eelkontroll tööriistaga nexusctl.
  2. Paigaldage paketi chartist ja jätke --wait välja.
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 põhjustab selle chartiga ummikseisu (deadlock): paigaldusjärgne haak (post-install hook) annab igale teenusele selle andmebaasi parooli, kuid --wait hoiab haake kinni, kuni teenused on üleval. Peatükk 2.8, Ühe masina paigaldused, sisaldab tsüklit, mis ootab ära ka StatefulSetid.

Tööriistaga nexusctl on sama paigaldus nexusctl install --context <kube-context> --values harrow-prod-values.yaml.

Miski chartis ei pöördu nimeruumist väljapoole, välja arvatud DNS (domeeninimede süsteem), Kubernetese API (rakendusliides) lubade (token) kontrollimiseks ja mis tahes aadress, mille loetlete parameetris networkPolicy.externalEgressCIDRs, mis on vaikimisi tühi. Paigaldusest ei välju telemeetriat ning telemetry.enabled väärtuseks ei saa määrata midagi muud peale false. AI (tehisintellekti) kasutamiseks ilma internetita asukohas ühendab organisatsioon objekti sees omaenda OpenAI-ga ühilduva mudeliserveri, mis määratakse parameetris ai.localProvider.baseUrl; seda käsitleb peatükk 2.14, AI teenusepakkujad ja mudelid.

Litsents ei ole charti väärtus. Te impordite selle pärast paigaldamist, nagu allpool kirjeldatud.

k3s ja cert-manager ilma allalaadimiseta

Kui Nexus paigaldatakse k3s-klastrile, mille ehitate ise, peab ka k3s olema paigaldatav ilma võrguta. Paigaldusketta tõmmis teeb selle teie eest ära (peatükk 2.9, Paigaldusketta tõmmis). Käsitsi, igal sõlmel:

  1. Tooge üle oma arhitektuurile vastavad k3s v1.33.6+k3s1 väljalaskefailid: k3s binaarfail (k3s-arm64 arm64 puhul), install.sh, k3s-airgap-images-<arch>.tar.zst ja sha256sum-<arch>.txt. k3s avaldab nende failide jaoks kontrollsummad, kuid mitte allkirja. Kontrollige iga faili sha256sum-<arch>.txt alusel ja selgitage oma turvameeskonnale, et see on samast allikast pärinev kontrollsumma, mitte allkiri.
  2. Asetage binaarfail ja süsteemitõmmised sinna, kust k3s neid otsib, ning paigaldage nii, et allalaadimised on välja lülitatud:
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 on eeltingimus: charti enda CA (sertifitseerimiskeskus) on cert-manageri väljaandja. Tooge üle cert-manageri chart, cert-manager-v1.21.3.tgz, ja selle tõmmised. Võrguühendusega poolel kontrollige tõmmiseid enne üleviimist cert-manageri projekti enda võtmega:

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

Objekti sees importige tõmmised iga sõlme konteinerihoidlasse nimede all, mida cert-manageri chart nõuab (quay.io/jetstack/cert-manager-<name>:v1.21.3), seejärel kontrollige neid ja paigaldage:

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 on cert-manageri jaoks õige. Ainult Nexusel ei tohi seda olla.

Uuendused ja uued osad saabuvad allkirjastatud andmekandjal

Õhuvahega asukoht uuendab süsteemi samuti kettalt. Konsooli lehtedel This installation (See paigaldus) laadib valik Import from media (Impordi andmekandjalt) väljalaske objektile toodud kettalt. See kontrollib iga faili kontrollsummat, seejärel allkirja objektil juba paigaldatud väljalaskevõtme alusel (mitte kunagi kettaga kaasas oleva võtme alusel) ning seejärel veendub, et väljalase on uuem kui praegu töötav versioon. Importimine ainult kopeerib ja kontrollib. Inimesed jätkavad tööd töötava väljalaskega ja miski ei muutu enne, kui otsustate uuendada.

Import andmekandjalt (ilma internetita)
Import andmekandjalt (ilma internetita)
Kettal oleva väljalaske importimine Harrow's. Allkirja kontrollitakse objektil paigaldatud võtme alusel ja töötav versioon jääb puutumata, kuni keegi süsteemi uuendab.

Käsurealt lisatakse sama väljalase käsuga 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 näitab, mis muutub, kuid ei muuda midagi. apply teeb esmalt varukoopia ja seejärel uuendab. Peatükk 2.15, Teine päev: Nexuse käitamine, käsitleb uuendamist täies mahus.

Kui ketta allkiri ei klapi, keeldutakse impordist teatega MEDIA_SIGNATURE_INVALID. Midagi ei laadita ega kopeerita sisse ning töötav väljalase jääb edasi tööle. Lehel kuvatakse, millised kontrollid läbiti, kus protsess peatus, ning oodatud võti kõrvuti leitud võtmega. Hoidke ketas oma turvameeskonna jaoks alles ja küsige Adverantilt uus.

Import meediumilt ebaõnnestus
Import meediumilt ebaõnnestus
Tagasilükatud import. Kõik kontrollsummad klappisid, kuid allkiri oli antud tundmatu võtmega, mistõttu midagi ei laaditud ja töötav väljalase jäeti puutumata.

Enterprise'i osad, mille litsents sisse lülitab, saabuvad õhuvahega asukohta samamoodi: väljalaskekettal, funktsiooni Import from media kaudu, enne kui te need sisse lülitate. Iga osa kontrollitakse enne sisselülitamist Adveranti väljalaskevõtme alusel, nii et te ei kopeeri kunagi binaarfaili klastrisse käsitsi.

Litsentsid ilma internetita

Võrguühendusega paigaldus saab oma litsentsi automaatselt. Õhuvahega paigaldus vahetab Adverantiga faile käsitsi, võrguühenduseta vahetuse (offline exchange) kaudu.

  1. Konsooli litsentsilehed loovad väikese litsentsitaotluse faili. Paigaldus allkirjastab selle oma võtmega, et Adverant saaks tuvastada, milline paigaldus taotluse esitas.
  2. Keegi viib faili USB-mälupulgal võrguühendusega arvutisse, logib sisse Adveranti kontole aadressil https://account.adverant.ai ja laadib selle üles lehel Offline exchange (Võrguühenduseta vahetus).
  3. Litsentsifail tuuakse samal viisil tagasi.
  4. Importige see. Avage konsoolis Licence and what it unlocks (Litsents ja mida see avab) ning vajutage Import a new licence (Impordi uus litsents). Käsurealt:
nexusctl licence import harrow-port-licence.json

Litsentsi kontrollitakse võrguühenduseta, objekti sees, Adveranti võtmete alusel. Adverant allkirjastab iga litsentsi kahe sõltumatu võtmega ja mõlemad allkirjad peavad valideeruma.

Võrguühenduseta vahetus
Võrguühenduseta andmevahetus
Leht Offline exchange Adveranti kontol, kuhu laaditakse üles allkirjastatud taotlusfail ja kust saadakse vastu litsentsifail.

Sama vahetuskanali kaudu viiakse välja ka iga-aastane kasutusaruanne. See sisaldab ainult loendureid (kasutajakohad, seadmed, funktsioonirühmad) ja administraator saab seda enne väljaviimist lehel Usage statement for Adverant (Kasutusaruanne Adverantile) rida-realt lugeda.

Kood Olek Mida see tähendab
LICENCE_SIGNATURE_INVALID 422 Fail ei ole Adveranti allkirjastatud litsents või on mõnda baiti pärast allkirjastamist muudetud. Miski ei muutu.
LICENCE_OTHER_INSTALLATION 409 Litsents on ehtne, kuid väljastatud teisele paigaldusele. Küsige litsentsi, mis on väljastatud selle paigalduse ID jaoks.
LICENCE_CLOCK_BEHIND_FLOOR 409 Kell näitab varasemat aega kui hiliseim aeg, mida see paigaldus on näinud. Kella tagasikeeramine ei taasta aegunud litsentsi.
LICENCE_REVOKED 403 Adverant võttis litsentsi tagasi allkirjastatud tühistamisega. Enterprise'i osade pakkumine lõpetatakse; Community ja eksport jäävad alles.

Peatükk 2.13, Litsentsid, käsitleb olekuid, ajapikendust ja uuendamist.

Tühistamisnimekirjad imporditakse käsitsi

Kui Adverant litsentsi tagasi võtab, avaldab ta allkirjastatud tühistamisnimekirja. Nimekiri on kumulatiivne: iga nimekiri sisaldab kõiki enne seda tagasi võetud litsentse. Võrguühendusega paigaldus saab sellest ise teada. Õhuvahega paigaldus saab sellest teada ainult siis, kui keegi nimekirja impordib, seega tooge uusim nimekiri sisse iga väljalaskekettaga ja importige see paigalduse tühistamiste impordi kaudu litsentsilehtedel või sisselogimishosti aadressil /api/v1/installation/licence/revocations.

See toimib mõlemat pidi. Õhuvahega paigaldus, mis ei impordi kunagi ühtegi nimekirja, ei saa kunagi teada, et litsents on tühistatud, sealhulgas litsents, mis on allkirjastatud võtmega, mis hiljem osutus kompromiteerituks. Nimekirja importimine on ainus viis, kuidas see teave õhuvahe ületab.

Suveräänne pitseeritud pakett: nexus-airgap

Mõned suveräänsed asukohad soovivad väljalaset ühe pitseeritud ja allkirjastatud failina, mille enda manifest keelab võrguühenduse. Nende jaoks on olemas teine vorming, pitseeritud pakett (sealed bundle), ja selle tööriist nexus-airgap paketist @adverant/nexus-sovereign. Paigaldage tööriist Adveranti paketiregistrist, eraldi mis tahes paketist, mida see kontrollima hakkab. Pakett ei saa iseenda eest kosta.

Pitseeritud pakett on üksainus allkirjastatud tar-arhiiv. Selle manifest on allkirjastatud Ed25519-ga ja sisaldab iga faili SHA-256 räsi. Tööriistal on neli käsku (verbi).

Käsk Mida see teeb
nexus-airgap bundle Ehitab ettevalmistatud kataloogist pitseeritud paketi ja allkirjastab selle manifesti.
nexus-airgap verify --bundle <file> --trusted-key <pem> --profile <profile> Kontrollib allkirja usaldusväärse võtme alusel, arvutab uuesti iga faili räsi, keeldub igast failist, mida manifestis pole loetletud, ja keeldub paketist, mille võrgureegel ei ole tühi lubatud nimekiri (allow-list) koos ainult kohaliku agendiliiklusega. Ei muuda midagi.
nexus-airgap install Kontrollib ja seejärel täidab paigaldusplaani õiges järjekorras: laadib tõmmised, rakendab manifestid, käivitab migratsioonid, eeltäidab oskused (skills), varustab võtmed.
nexus-airgap open Avab paketi valikulise krüpteeritud ekspordi asukoha enda võtmehoidjaga, milleks õhuvahega asukohas on masina TPM-kiip (Trusted Platform Module).

Kontrollige enne kõike muud:

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 hoiab kontrollitud ja lahtipakitud koopia alles ning nimetab selle väljundis kui stagingDir, nii et töötate sellega, mida kontrolliti.

Kui kontroll ebaõnnestub veaga BUNDLE_INTEGRITY_VIOLATION, on paketi sees olevat faili pärast allkirjastamist muudetud. Peatuge seal. Tööriistal on lüliti --no-strict, mis jätab loetlemata failide kontrolli vahele. Ärge kasutage seda väljalaske puhul.

Päev, mil saabub järgmine ketas

Tomás hoiab väravahoone kapi siseküljele kleebituna lühikest kontrollnimekirja ja seda tasub eeskujuks võtta. Kontrollige tar-faili .sha256. Käivitage verify-bundle.sh paigaldatud võtmega ja lugege viimast rida. Importige uusim tühistamisnimekiri. Alles seejärel importige väljalase andmekandjalt ja planeerige uuendus. Ketas, mis mõnes neist sammudest läbi kukub, läheb sildistatuna tagasi ümbrikusse turvameeskonna jaoks ning võrgus ei ole miski muutunud.