HyniRezervoni një prezantim

Kapitulli 2.10

Instalimi i izoluar nga rrjeti (air-gapped)

Barni një paketë të nënshkruar jashtë linje në një vend pa internet, verifikojeni atë kundrejt një çelësi që e keni sjellë veçmas, ngarkojeni në regjistrin tuaj dhe instalojeni. Edhe licencat, përditësimet dhe listat e revokimit e kalojnë hendekun me dorë.

Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

19 minuta lexim

Rrjeti i operacioneve të Harrow Port Authority nuk ka rrugë drejt internetit, me ligj dhe me dizajn. Trafiku i anijeve, planet e ankorimit dhe bllokimet doganore ndodhen të gjitha në të, dhe asgjë në të nuk mund të komunikojë jashtë. Kur Tomás Reilly instaloi Nexus atje, çdo bajt mbërriti në një disk që një korrier e solli në postbllok, dhe çdo bajt u kontrollua brenda objektit përpara se ndonjë gjë ta përdorte.

Ky kapitull është ai instalim. Ju merrni një paketë offline të nënshkruar, e kontrolloni me një çelës që ka mbërritur tek ju përmes një rruge tjetër, kopjoni imazhet e saj në regjistrin tuaj, i kontrolloni përsëri atje, dhe instaloni chart-in me emrin e regjistrit tuaj në vlerat. Pastaj vijnë gjërat që një objekt i izoluar nga rrjeti (air-gapped) i bën manualisht, të cilat një objekt i lidhur i merr falas: k3s dhe cert-manager pa shkarkim, përditësime në media, licenca përmes një shkëmbimi offline, dhe lista revokimi që i importoni vetë.

Në të majtë, një kuti "ana e lidhur" mban "downloads.adverant.ai" dhe "llogaria juaj Adverant". Dy shigjeta të ndara kalojnë një vijë të trashë vertikale të etiketuar "hendeku". Shigjeta e sipërme, e etiketuar "një herë, përmes një rruge të veçantë; gjurma digjitale e kontrolluar jashtë brezit", mbart "release.pub". Shigjeta e poshtme, e etiketuar "çdo version, në një disk", mbart "nexus-alpha-1.0.0-alpha.1-enterprise.tar". Në të djathtë, brenda "rrjeti i operacioneve të Harrow", të dyja mbërrijnë në një kuti "verify-bundle.sh: VERIFY-BUNDLE PASS", e cila të çon te "registry.harrow.example (cosign load, cosign verify)" dhe pastaj te "klasteri (helm install)".
Si një version dhe besueshmëria e tij e kalojnë hendekun përmes dy rrugëve të ndara.

Çfarë përmban paketa jashtë linje

Një paketë është një edicion i një versioni, si një skedar tar i pakompresuar me një skedar checksum pranë tij: nexus-alpha-1.0.0-alpha.1-enterprise.tar dhe nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256. Paketat Community janë publike në downloads.adverant.ai. Paketat Enterprise vijnë nga llogaria juaj Adverant në https://account.adverant.ai, pranë licencës suaj, dhe kurrë në mënyrë anonime.

E shpaketuar, duket kështu:

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

Çdo direktori images/<svc>/ është ajo që shkruan cosign save. Ajo mban indeksin e imazhit dhe të dyja imazhet e platformës, linux/amd64 dhe linux/arm64, me nënshkrimin cosign, një vërtetim SPDX SBOM (software bill of materials) për çdo platformë dhe një vërtetim të prejardhjes, të gjitha të bëra me çelësin e versionit të Adverant. Të njëjtat SBOM-e ndodhen në sbom/ si skedarë të thjeshtë, në mënyrë që një ekip sigurie të mund t'i lexojë ato pa cosign.

Shtresa e të dhënave përfshin softuer copyleft: PostgreSQL me PostGIS, dhe Neo4j Community Edition ndër të tjera. Paketa mbart kodin burimor të çdo imazhi të shtresës së të dhënave që shpërndan, dhe release/source-offer.json e thotë këtë për çdo imazh. Një paketë që do të shpërndante një binar copyleft pa kodin e tij burimor nuk ndërtohet.

release/facts.json emërton versionin, edicionin, arkitekturat dhe gjurmën digjitale (fingerprint) të çelësit të versionit me të cilin është nënshkruar paketa, si sha256:<hex>.

Çelësi publik udhëton veçmas

Paketa nuk e përmban kurrë çelësin që e kontrollon atë. Një paketë që do të mbarte çelësin e vet mund të zëvendësohej, me gjithë çelës, nga kushdo, dhe çdo kontroll do të kalonte përsëri me sukses. Skripti i verifikimit e refuzon një çelës që ndodhet brenda direktorisë së paketës.

Merrni çelësin publik të versionit një herë, në një makinë të lidhur me internetin, nga https://downloads.adverant.ai/nexus/1.0.0-alpha.1/. Ruajeni atë si release.pub. Gjurma e tij digjitale është SHA-256 e skedarit:

sha256sum release.pub

Krahasoni atë me gjurmën digjitale që publikon Adverant, dhe me atë në shënimet e versionit që keni marrë përmes një kanali të veçantë. Kapitulli 2.4, Marrja dhe verifikimi i një versioni, ka detajet. Pastaj silleni release.pub brenda objektit, përmes një rruge të ndryshme nga paketa nëse mundeni, dhe mbajeni atje. Ekipi i Tomás e mban atë në hapësirën e përbashkët të skedarëve të rrjetit të operacioneve me një shënim të datës kur ka hyrë. Çdo version i mëvonshëm kontrollohet kundrejt atij çelësi të instaluar, kurrë kundrejt diçkaje që sjell një disk me vete.

Verifikoni paketën

verify-bundle.sh është skripti që kontrollon një paketë, i publikuar me çdo version. Imazhi i diskut të instaluesit ekzekuton të njëjtin skript në ndezjen e parë. Ai ka nevojë për cosign v3, helm v4, dhe sha256sum ose shasum. Ai nuk lexon asgjë nga asnjë rrjet dhe nuk ka nevojë për Python, kështu që ekzekutohet si në një nyje instaluesi bazë ashtu edhe në një stacion pune.

  1. Kontrolloni skedarin tar kundrejt checksum-it të tij, pastaj shpaketojeni atë:
sha256sum -c nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256
tar -xf nexus-alpha-1.0.0-alpha.1-enterprise.tar
  1. Ekzekutoni verifikimin me çelësin që keni sjellë:
./verify-bundle.sh nexus-alpha-1.0.0-alpha.1-enterprise release.pub

Një argument i tretë emërton një skedar vlerash për kontrollet e chart-it. Pa të, skripti përdor docs/example-values.yaml të paketës.

  1. Lexoni rreshtin e fundit, i cili duhet të jetë VERIFY-BUNDLE PASS përpara se të vazhdoni më tej.
  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>

Skripti ndalon në kontrollin e parë që dështon. Ja çfarë bën secili.

Hapi Çfarë kontrollon
1 Çdo skedar i listuar në SHA256SUMS përputhet me checksum-in e tij, dhe nuk është i pranishëm asnjë skedar që lista e lë jashtë. Një skedar shtesë i futur fshehurazi dështon po aq sigurt sa edhe një skedar i ndryshuar.
2 SHA256SUMS.sigstore.json është një nënshkrim i vlefshëm mbi SHA256SUMS nga çelësi që keni dhënë. Me hapat 1 dhe 2 së bashku, çdo bajt në paketë është bajti që ka nënshkruar Adverant.
3 Për çdo direktori imazhi: digest-i i indeksit të imazhit është në release/images.lock.json; ka një nënshkrim cosign subjekti i të cilit është pikërisht ai digest, dhe ai verifikohet kundrejt çelësit tuaj; cosign verify dhe cosign verify-attestation --type spdxjson kalojnë të dyja në strukturën e ruajtur.
4 helm lint --strict kalon me sukses në chart me vlerat e shembullit, ose me tuajat.
5 Çdo imazh në skedarin lock është i ruajtur në images/, dhe çdo imazh që gjeneron chart-i është një digest në skedarin lock. Asgjë që instalon chart-i nuk vjen nga ndonjë vend tjetër.
6 Kur skedari lock mban imazhe të shtresës së të dhënave, release/source-offer.json është i plotë, emërton secilin prej tyre, dhe çdo skedar burimor që ai liston është i pranishëm me checksum-in e duhur.

Hapi 3 kontrollon vetë nënshkrimin, sipas digest-it, si dhe ekzekuton cosign verify. Arsyeja është vetë sjellja e cosign: cosign verify në një strukturë të ruajtur gjithashtu del me kodin 0 kur struktura mban vetëm një vërtetim nga çelësi dhe asnjë nënshkrim. Skripti nuk e pranon këtë.

Nëse kjo dështon

Një dështim përfundon me VERIFY-BUNDLE FAIL step=<k> <why>.

Rreshti i fundit Çfarë do të thotë Çfarë duhet të bëni
step=0 the public key must come from outside the bundle Çelësi që keni emërtuar ndodhet brenda direktorisë së paketës. Përdorni çelësin që keni sjellë veçmas.
step=1 checksum mismatch Një skedar ka ndryshuar pasi është bërë lista, ose është dëmtuar gjatë transportit. Kopjoni paketën përsëri nga media origjinale dhe rikontrollojeni.
step=1 files not covered by SHA256SUMS Një skedar i është shtuar paketës. Trajtojeni median si të pabesueshme. Mos instaloni prej saj.
step=2 SHA256SUMS signature does not verify Lista e checksum-it nuk është e nënshkruar nga çelësi i versionit që ju mbani. Ndaloni. Raportojeni tek ekipi juaj i sigurisë dhe kërkojini Adverant media të reja.
step=3 image <svc>: ... Nënshkrimi i një imazhi ose vërtetimi SBOM mungon ose nuk verifikohet. Ndaloni, njësoj si për hapin 2.
step=4, step=5 Chart-i ose lista e imazheve të tij nuk përputhen me njëra-tjetrën. Kërkojini Adverant një paketë të re.
step=6 ... Oferta e kodit burimor është e paplotë. Kërkojini Adverant një paketë të re.

Dështimi i hapave 2 dhe 3 është rasti për të cilin ekziston i gjithë ky dizajn. Kjo do të thotë që skedarët nuk janë ata që ka nënshkruar Adverant. Mbajeni median për ekipin tuaj të sigurisë.

Ngarkoni imazhet në regjistrin tuaj

Nyjet tuaja tërheqin imazhe nga një regjistër brenda objektit. Ai i Harrow është registry.harrow.example. Çdo imazh i Nexus shkon nën shtegun nexus/ në atë regjistër, sepse chart-i i referohet çdo imazhi si <global.imageRegistry>/nexus/<svc>@<digest>.

  1. Hyni në regjistrin tuaj me mjetin që përdorni zakonisht, në mënyrë që cosign të mund të dërgojë (push) në të.
  2. Nga brenda direktorisë së paketës, ngarkoni çdo imazh dhe verifikojeni përsëri në vendndodhjen e tij të re:
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 mbart nënshkrimin dhe çdo vërtetim bashkë me imazhin, kështu që kopja e regjistrit verifikohet kundrejt të njëjtit çelës. Verifikimi këtu është ai që vlen për klasterin tuaj: ai vërteton se ajo që nyjet tuaja do të tërheqin është ajo që ka nënshkruar Adverant.

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

Çdo imazh në skedarin lock duhet të printojë një rresht verified. Një rresht që mungon do të thotë që ngarkimi ose kontrolli i atij imazhi ka dështuar, dhe gabimi i tij printohet fiks më lart.

Nuk ka regjistër transparence (transparency log) për versionet e Nexus, kështu që --insecure-ignore-tlog=true nevojitet në çdo kontroll. Çelësi i versionit është e gjithë rrënja e besimit. Pa këtë flamur (flag), cosign refuzon me not enough verified log entries from transparency log: 0 < 1.

Instaloni nga regjistri juaj

Skedari i vlerave për një instalim të izoluar nga rrjeti ndryshon nga një i lidhur në një rresht të vetëm: global.imageRegistry emërton regjistrin tuaj.

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

Hyrjet <custodian-...-age-recipient> janë rreshtat publikë age1... të personave që mbajnë çelësat e rikuperimit të ruajtësit të çelësave. Kapitulli 2.8, Instalimet në një makinë të vetme, shpjegon se si secili krijon një të tillë. harrow-ssd është klasa e ruajtjes së vetë Harrow: vendosni tuajën, ose lini storage.className jashtë për të përdorur parazgjedhjen e klasterit.

  1. Ekzekutoni kontrollin paraprak (preflight) kundrejt klasterit me këtë skedar, siç e përshkruan kapitulli 2.5, Kontrolli paraprak me nexusctl.
  2. Instaloni nga chart-i i paketës, dhe lini jashtë --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 krijon bllokim të ndërsjellë (deadlock) me këtë chart: një hook pas instalimit i jep çdo shërbimi fjalëkalimin e tij të bazës së të dhënave, dhe --wait i mban pezull hook-et derisa shërbimet të jenë ngritur. Kapitulli 2.8, Instalimet në një makinë të vetme, ka ciklin që pret gjithashtu për StatefulSets.

Me nexusctl, i njëjti instalim është nexusctl install --context <kube-context> --values harrow-prod-values.yaml.

Asgjë në chart nuk del jashtë namespace-it përveç DNS (Domain Name System), Kubernetes API (application programming interface) për rishikimet e token-ave, dhe çdo adrese që ju listoni në networkPolicy.externalEgressCIDRs, e cila është bosh si parazgjedhje. Asnjë telemetri nuk del nga instalimi, dhe telemetry.enabled nuk mund të vendoset në asgjë tjetër përveç false. Për AI (artificial intelligence) në një objekt pa internet, organizata lidh serverin e saj të modeleve të përputhshëm me OpenAI brenda objektit, të emërtuar në ai.localProvider.baseUrl; kapitulli 2.14, Ofruesit dhe modelet e AI, e mbulon këtë.

Licenca nuk është një vlerë e chart-it. Ju e importoni atë pas instalimit, siç përshkruhet më poshtë.

k3s dhe cert-manager pa shkarkim

Nëse Nexus po vendoset në një klaster k3s që e ndërtoni vetë, edhe k3s duhet të instalohet pa rrjet. Imazhi i diskut të instaluesit e bën këtë për ju (kapitulli 2.9, Imazhi i diskut të instaluesit). Manualisht, në çdo nyje:

  1. Sillni skedarët e versionit k3s v1.33.6+k3s1 për arkitekturën tuaj: binarin k3s (k3s-arm64 në arm64), install.sh, k3s-airgap-images-<arch>.tar.zst dhe sha256sum-<arch>.txt. k3s publikon checksum-e për këta skedarë dhe asnjë nënshkrim. Kontrolloni çdo skedar kundrejt sha256sum-<arch>.txt, dhe jini të qartë me ekipin tuaj të sigurisë se ky është një checksum nga e njëjta origjinë, jo një nënshkrim.
  2. Vendosni binarin dhe imazhet e sistemit atje ku i kërkon k3s, dhe instaloni me shkarkimet të çaktivizuara:
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 është një parakusht: vetë CA (certificate authority) e chart-it është një lëshues cert-manager. Sillni chart-in e cert-manager, cert-manager-v1.21.3.tgz, dhe imazhet e tij. Në anën e lidhur me internetin, kontrolloni imazhet me çelësin e vetë projektit cert-manager përpara se ato të kalojnë:

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

Brenda objektit, importoni imazhet në ruajtësin e kontejnerëve të çdo nyjeje nën emrat që kërkon chart-i i cert-manager, quay.io/jetstack/cert-manager-<name>:v1.21.3, pastaj kontrollojini dhe instaloni:

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 është i duhuri për cert-manager. Është vetëm Nexus ai që nuk duhet ta ketë atë.

Përditësimet dhe pjesët e reja mbërrijnë në media të nënshkruara

Një objekt i izoluar nga rrjeti përditësohet gjithashtu nga një disk. Në konsolë, Importo nga media në faqet Ky instalim ngarkon një version nga një disk i sjellë brenda objektit. Ai kontrollon checksum-in e çdo skedari, pastaj nënshkrimin kundrejt çelësit të versionit të instaluar tashmë në objekt, kurrë një çelës që sjell disku, dhe më pas kontrollon që versioni të jetë më i ri se ai që po ekzekutohet. Importimi vetëm kopjon dhe kontrollon. Njerëzit vazhdojnë të punojnë në versionin që po ekzekutohet, dhe asgjë nuk ndryshon derisa ju të zgjidhni të përditësoni.

Importimi nga media (pa internet)
Importimi nga media (pa internet)
Një version në një disk duke u importuar në Harrow. Nënshkrimi kontrollohet kundrejt çelësit të instaluar në objekt, dhe versioni që po ekzekutohet mbetet i paprekur derisa dikush të përditësojë.

Nga rreshti i komandës, i njëjti version hyn 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 tregon se çfarë do të ndryshojë dhe nuk ndryshon asgjë. apply bën një kopje rezervë (backup) fillimisht dhe pastaj përditëson. Kapitulli 2.15, Dita e dytë: operimi i Nexus, mbulon përditësimet plotësisht.

Kur nënshkrimi i një disku nuk përputhet, importimi refuzohet me MEDIA_SIGNATURE_INVALID. Asgjë nuk ngarkohet apo kopjohet brenda, dhe versioni aktual vazhdon të ekzekutohet. Faqja thotë se cilat kontrolle kaluan, ku ndaloi, dhe çelësin që priste krahas çelësit që gjeti. Mbajeni diskun për ekipin tuaj të sigurisë dhe kërkojini Adverant një të ri.

Importimi nga media dështoi
Importimi nga media dështoi
Një importim i refuzuar. Çdo checksum u përputh, por nënshkrimi u bë nga një çelës i panjohur, kështu që asgjë nuk u ngarkua dhe versioni që po ekzekutohej u la i paprekur.

Pjesët Enterprise që aktivizon një licencë vijnë në të njëjtën mënyrë në një objekt të izoluar nga rrjeti: në diskun e versionit, përmes Importo nga media, përpara se t'i aktivizoni ato. Çdo pjesë kontrollohet kundrejt çelësit të versionit të Adverant përpara se të aktivizohet, kështu që ju kurrë nuk kopjoni një binar në klaster manualisht.

Licencat pa internet

Një instalim i lidhur me internetin e merr licencën e tij vetë. Një instalim i izoluar nga rrjeti shkëmben skedarë me Adverant manualisht, përmes shkëmbimit offline.

  1. Faqet e licencës së konsolës krijojnë një skedar të vogël kërkese për licencë. Instalimi e nënshkruan atë me çelësin e vet, në mënyrë që Adverant të mund të dallojë se cili instalim e kërkoi.
  2. Dikush e nxjerr skedarin jashtë në një USB drejt një kompjuteri që është online, hyn në llogarinë Adverant në https://account.adverant.ai, dhe e ngarkon atë në faqen Shkëmbimi offline.
  3. Ata e sjellin skedarin e licencës mbrapsht në të njëjtën mënyrë.
  4. Importojeni atë. Në konsolë, hapni Licenca dhe çfarë zhbllokon ajo dhe shtypni Importo një licencë të re. Nga rreshti i komandës:
nexusctl licence import harrow-port-licence.json

Licenca kontrollohet offline, brenda objektit, kundrejt çelësave të Adverant. Adverant nënshkruan çdo licencë me dy çelësa të pavarur, dhe të dy nënshkrimet duhet të verifikohen.

Shkëmbimi jashtë linje
Shkëmbimi jashtë linje
Faqja Shkëmbimi offline në llogarinë Adverant, ku një skedar kërkese i nënshkruar ngarkohet dhe një skedar licence kthehet mbrapsht.

I njëjti shkëmbim nxjerr jashtë pasqyrën vjetore të përdorimit. Ajo mban vetëm numërues (vende përdoruesish, pajisje, grupe funksionesh), dhe administratori e lexon atë rresht pas rreshti në Pasqyra e përdorimit për Adverant përpara se të dalë.

Kodi Statusi Çfarë do të thotë
LICENCE_SIGNATURE_INVALID 422 Skedari nuk është një licencë që e ka nënshkruar Adverant, ose një bajt ka ndryshuar pas nënshkrimit. Asgjë nuk ndryshon.
LICENCE_OTHER_INSTALLATION 409 Licenca është autentike por është lëshuar për një instalim tjetër. Kërkoni një të lëshuar për id-në e këtij instalimi.
LICENCE_CLOCK_BEHIND_FLOOR 409 Ora tregon më herët sesa koha më e fundit që ka parë ky instalim. Kthimi i orës pas nuk rijetëson një licencë të skaduar.
LICENCE_REVOKED 403 Adverant e tërhoqi licencën me një revokim të nënshkruar. Pjesët Enterprise ndalojnë së ofruari; Community dhe eksportimi mbeten.

Kapitulli 2.13, Licencat, mbulon gjendjet, periudhën e tolerancës dhe rinovimin.

Listat e revokimit importohen manualisht

Kur Adverant tërheq një licencë, ai publikon një listë revokimi të nënshkruar. Lista është kumulative: secila mbart çdo licencë të tërhequr përpara saj. Një instalim i lidhur me internetin mëson për të. Një instalim i izoluar nga rrjeti mëson vetëm kur dikush e importon listën, prandaj sillni listën më të fundit me çdo disk versioni dhe importojeni atë përmes importimit të revokimeve të instalimit në faqet e licencës, ose adresës /api/v1/installation/licence/revocations në host-in e hyrjes.

Kjo ka dy anë. Një instalim i izoluar nga rrjeti që nuk importon kurrë një listë nuk mëson kurrë se një licencë është revokuar, përfshirë një licencë të nënshkruar nga një çelës që më vonë u zbulua se ishte komprometuar. Importimi i listës është e vetmja mënyrë që ky lajm të kalojë hendekun.

Paketa sovrane e vulosur: nexus-airgap

Disa objekte sovrane duan një version si një skedar të vetëm të vulosur dhe të nënshkruar, manifesti i të cilit ndalon aksesin në rrjet. Për ta ekziston një format i dytë, paketa e vulosur (sealed bundle), dhe mjeti i saj, nexus-airgap, nga paketa @adverant/nexus-sovereign. Instaloni mjetin nga regjistri i paketave të Adverant, veçmas nga çdo paketë që ai do të kontrollojë. Një paketë nuk mund të garantojë për veten e saj.

Paketa e vulosur është një tarball i vetëm i nënshkruar. Manifesti i saj është i nënshkruar me Ed25519 dhe liston një SHA-256 për çdo skedar. Mjeti ka katër komanda veprimi (verbs).

Komanda Çfarë bën
nexus-airgap bundle Ndërton një paketë të vulosur nga një direktori e përgatitur dhe nënshkruan manifestin e saj.
nexus-airgap verify --bundle <file> --trusted-key <pem> --profile <profile> Kontrollon nënshkrimin kundrejt çelësit të besuar, rillogarit hash-in e çdo skedari, refuzon çdo skedar që manifesti nuk e liston, dhe refuzon një paketë rregulli i rrjetit të së cilës nuk është lista e lejuar bosh me trafik agjentësh vetëm lokal. Nuk ndryshon asgjë.
nexus-airgap install Verifikon, pastaj zbaton planin e instalimit sipas radhës: ngarkon imazhet, aplikon manifestet, ekzekuton migrimet, mbjell aftësitë (skills), siguron çelësat.
nexus-airgap open Hap eksportin opsional të enkriptuar të paketës me kujdestarin e çelësave të vetë objektit, i cili në një objekt të izoluar nga rrjeti është çipi TPM (Trusted Platform Module) i makinës.

Verifikoni përpara çdo gjëje tjetër:

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 mban kopjen e verifikuar dhe të shpaketuar dhe e emërton atë si stagingDir në rezultat, në mënyrë që të punoni nga ajo që është kontrolluar.

Nëse verifikimi dështon me BUNDLE_INTEGRITY_VIOLATION, një skedar brenda paketës ka ndryshuar pasi është nënshkruar. Ndaloni aty. Mjeti ka një opsion --no-strict që anashkalon kontrollin për skedarët e palistuar. Mos e përdorni atë në një version.

Dita kur mbërrin disku tjetër

Tomás mban një listë të shkurtër kontrolli të ngjitur brenda dollapit të postbllokut, dhe ia vlen të kopjohet. Kontrolloni .sha256 të skedarit tar. Ekzekutoni verify-bundle.sh me çelësin e instaluar dhe lexoni rreshtin e fundit. Importoni listën më të re të revokimit. Pastaj, dhe vetëm pastaj, importoni versionin nga media dhe planifikoni përditësimin. Një disk që dështon në cilindo prej këtyre hapave kthehet mbrapsht në zarfin e tij, i etiketuar, për ekipin e sigurisë, dhe asgjë në rrjet nuk ka ndryshuar.