Verżjoni 1.0.0-alpha.1l-aħħar
Kapitlu 2.10
Installazzjoni air-gapped
Ġorr pakkett offline iffirmat f'sit mingħajr internet, ivverifikah ma' ċavetta li ġibt separatament, għabbih fir-reġistru tiegħek stess u installah. Il-liċenzji, l-aġġornamenti u l-listi ta' revoka jaqsmu l-ispazju bl-idejn ukoll.
Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

In-network tal-operat ta' Harrow Port Authority m'għandu l-ebda rotta lejn l-internet, bil-liġi u bid-disinn. It-traffiku tal-bastimenti, il-pjanijiet tal-irmiġġ u ż-żammiet tad-dwana kollha jgħixu fuqu, u xejn minn dak li hemm fuqu ma jista' jikkomunika 'l barra. Meta Tomás Reilly installa Nexus hemmhekk, kull byte wasal fuq disk li kurrier ġab sal-għassa tal-bieb, u kull byte ġie vverifikat ġewwa s-sit qabel ma ntuża minn xi ħaġa.
Dan il-kapitlu huwa dik l-installazzjoni. Inti tirċievi pakkett offline iffirmat, tivverifikah b'key li waslet għandek b'rotta differenti, tikkopja l-images tiegħu fir-reġistru tiegħek stess, terġa' tivverifikahom hemmhekk, u tinstalla ċ-chart bl-isem tar-reġistru tiegħek fil-values. Imbagħad jiġu l-affarijiet li sit air-gapped jagħmel bl-idejn u li sit konness jieħu b'xejn: k3s u cert-manager mingħajr tniżżil, aġġornamenti fuq midja, liċenzji permezz ta' skambju offline, u listi ta' revoka li timporta inti stess.
X'fih il-pakkett offline
Pakkett huwa edizzjoni waħda ta' rilaxx wieħed, bħala tar mhux ikkompressat b'fajl ta' checksum ħdejh: nexus-alpha-1.0.0-alpha.1-enterprise.tar u nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256. Il-pakketti Community huma pubbliċi fuq downloads.adverant.ai. Il-pakketti Enterprise jiġu mill-kont Adverant tiegħek fuq https://account.adverant.ai, ħdejn il-liċenzja tiegħek, u qatt b'mod anonimu.
Meta jinfetaħ, jidher hekk:
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
Kull direttorju images/<svc>/ huwa dak li jikteb cosign save. Fih l-indiċi tal-image u ż-żewġ images tal-pjattaforma, linux/amd64 u linux/arm64, bil-firma cosign, attestazzjoni SPDX SBOM (software bill of materials) għal kull pjattaforma u attestazzjoni ta' provenjenza, kollha magħmula bir-release key ta' Adverant. L-istess SBOMs jinsabu f'sbom/ bħala fajls sempliċi, sabiex tim tas-sigurtà jkun jista' jaqrahom mingħajr cosign.
Is-saff tad-data jinkludi software copyleft: PostgreSQL b'PostGIS, u Neo4j Community Edition fost oħrajn. Il-pakkett iġorr is-sors ta' kull image tas-saff tad-data li jibgħat, u release/source-offer.json jgħid hekk għal kull image. Pakkett li jibgħat binarju copyleft mingħajr is-sors tiegħu ma jinbeniex.
release/facts.json isemmi r-rilaxx, l-edizzjoni, l-arkitetturi u l-fingerprint tar-release key li biha ġie ffirmat il-pakkett, bħala sha256:<hex>.
Iċ-ċavetta pubblika tivvjaġġa separatament
Il-pakkett qatt ma jkun fih il-key li tivverifikah. Pakkett li jġorr il-key tiegħu stess jista' jiġi mibdul, bil-key u b'kollox, minn kulħadd, u kull verifika xorta tkun tgħaddi. L-iskript tal-verifika jirrifjuta key li tkun tinsab ġewwa d-direttorju tal-pakkett.
Ikseb il-public key tar-rilaxx darba, fuq magna konnessa, minn https://downloads.adverant.ai/nexus/1.0.0-alpha.1/. Issejvjaha bħala release.pub. Il-fingerprint tagħha hija x-SHA-256 tal-fajl:
sha256sum release.pubQabbel dak mal-fingerprint li jippubblika Adverant, u ma' dak fin-noti tar-rilaxx li rċevejt permezz ta' kanal separat. Kapitlu 2.4, Il-ksib u l-verifika ta' rilaxx, fih id-dettalji. Imbagħad ġorr release.pub ġewwa s-sit, b'rotta differenti mill-pakkett jekk tista', u żommha hemmhekk. It-tim ta' Tomás iżommha fuq il-file share tan-network tal-operat b'nota tad-data meta daħlet. Kull rilaxx ta' wara jiġi vverifikat ma' dik il-key installata, qatt ma' xi ħaġa li disk iġib miegħu.
Ivverifika l-pakkett
verify-bundle.sh huwa l-iskript li jivverifika pakkett, ippubblikat ma' kull rilaxx. Id-disk image tal-installatur iħaddem l-istess skript fl-ewwel ibbutjar. Għandu bżonn cosign v3, helm v4, u sha256sum jew shasum. Ma jaqra xejn minn ebda network u m'għandux bżonn Python, għalhekk jaħdem fuq node ta' installatur vojt kif ukoll fuq workstation.
- Ivverifika t-tar maċ-checksum tiegħu, imbagħad iftħu:
sha256sum -c nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256
tar -xf nexus-alpha-1.0.0-alpha.1-enterprise.tar- Ħaddem il-verifika bil-key li daħħalt:
./verify-bundle.sh nexus-alpha-1.0.0-alpha.1-enterprise release.pubIt-tielet argument isemmi fajl ta' values għall-verifiki taċ-chart. Mingħajru, l-iskript juża docs/example-values.yaml tal-pakkett.
- Aqra l-aħħar linja, li trid tkun
VERIFY-BUNDLE PASSqabel ma tkompli aktar.
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>
L-iskript jieqaf fl-ewwel verifika li tfalli. Hawn hu x'tagħmel kull waħda.
| Pass | X'jivverifika |
|---|---|
| 1 | Kull fajl elenkat f'SHA256SUMS jaqbel maċ-checksum tiegħu, u l-ebda fajl mhu preżenti li l-lista tħalli barra. Fajl żejjed imdaħħal ifalli żgur daqs wieħed mibdul. |
| 2 | SHA256SUMS.sigstore.json hija firma valida fuq SHA256SUMS bil-key li tajt. Bil-passi 1 u 2 flimkien, kull byte fil-pakkett huwa l-byte li ffirma Adverant. |
| 3 | Għal kull direttorju ta' image: l-index digest tal-image jinsab f'release/images.lock.json; hemm firma cosign li s-suġġett tagħha huwa dak id-digest eżatt, u tiġi vverifikata mal-key tiegħek; cosign verify u cosign verify-attestation --type spdxjson it-tnejn jgħaddu fuq il-layout issejvjat. |
| 4 | helm lint --strict jgħaddi fuq iċ-chart bil-values ta' eżempju, jew b'tiegħek. |
| 5 | Kull image fil-lock hija ssejvjata f'images/, u kull image li ċ-chart jiġġenera hija digest fil-lock. Xejn minn dak li jinstalla ċ-chart ma jiġi minn xi mkien ieħor. |
| 6 | Meta l-lock iżomm images tas-saff tad-data, release/source-offer.json ikun komplut, isemmi lil kull waħda minnhom, u kull fajl tas-sors li jelenka jkun preżenti biċ-checksum it-tajjeb. |
Il-pass 3 jivverifika l-firma nnifisha, skont id-digest, kif ukoll iħaddem cosign verify. Ir-raġuni hija l-imġiba ta' cosign stess: cosign verify fuq layout issejvjat joħroġ ukoll b'0 meta l-layout iżomm biss attestazzjoni bil-key u l-ebda firma. L-iskript ma jaċċettax dan.
Jekk dan ifalli
Falliment jintemm b'VERIFY-BUNDLE FAIL step=<k> <why>.
| L-aħħar linja | Xi tfisser | X'għandek tagħmel |
|---|---|---|
step=0 the public key must come from outside the bundle |
Il-key li semmejt tinsab ġewwa d-direttorju tal-pakkett. | Uża l-key li daħħalt separatament. |
step=1 checksum mismatch |
Fajl inbidel wara li saret il-lista, jew ġarrab ħsara waqt it-trasport. | Erġa' kkopja l-pakkett mill-midja oriġinali u erġa' vverifika. |
step=1 files not covered by SHA256SUMS |
Ġie miżjud fajl mal-pakkett. | Ittratta l-midja bħala mhux affidabbli. Tinstallax minnha. |
step=2 SHA256SUMS signature does not verify |
Il-lista taċ-checksums mhijiex iffirmata bir-release key li għandek. | Ieqaf. Irrapporta dan lit-tim tas-sigurtà tiegħek u itlob midja ġdida mingħand Adverant. |
step=3 image <svc>: ... |
Il-firma jew l-attestazzjoni SBOM ta' image hija nieqsa jew ma tiġix ivverifikata. | Ieqaf, bħal fil-pass 2. |
step=4, step=5 |
Iċ-chart jew il-lista tal-images tiegħu ma jaqblux flimkien. | Itlob pakkett ġdid mingħand Adverant. |
step=6 ... |
L-offerta tas-sors mhijiex kompluta. | Itlob pakkett ġdid mingħand Adverant. |
Il-falliment tal-passi 2 u 3 huwa l-każ li għalih jeżisti d-disinn kollu. Ifisser li l-fajls mhumiex dawk li ffirma Adverant. Żomm il-midja għat-tim tas-sigurtà tiegħek.
Għabbi l-immaġnijiet fir-reġistru tiegħek stess
In-nodes tiegħek jiġbdu l-images minn reġistru ġewwa s-sit. Ta' Harrow huwa registry.harrow.example. Kull image ta' Nexus tmur taħt il-passaġġ nexus/ f'dak ir-reġistru, minħabba li ċ-chart jirreferi għal kull image bħala <global.imageRegistry>/nexus/<svc>@<digest>.
- Idħol fir-reġistru tiegħek bl-għodda li normalment tuża, sabiex
cosignikun jista' jimbotta lejha. - Minn ġewwa d-direttorju tal-pakkett, tgħabbi kull image u erġa' vverifikaha fil-post il-ġdid tagħha:
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"
donecosign load iġorr il-firma u kull attestazzjoni flimkien mal-image, sabiex il-kopja tar-reġistru tiġi vverifikata mal-istess key. Il-verifika hawnhekk hija dik li tgħodd għall-cluster tiegħek: tipprova li dak li se jiġbdu n-nodes tiegħek huwa dak li ffirma Adverant.
verified nexus-alpha
verified nexus-auth
verified nexus-postgres
...
Kull image fil-lock għandha tipprintja linja waħda ta' verified. Linja nieqsa tfisser li t-tagħbija jew il-verifika ta' dik l-image falliet, u l-iżball tagħha jiġi pprintjat eżatt fuqha.
M'hemm l-ebda reġistru ta' trasparenza għar-rilaxxi ta' Nexus, għalhekk --insecure-ignore-tlog=true huwa meħtieġ fuq kull verifika. Ir-release key hija l-għerq kollu tal-fiduċja. Mingħajr il-flag, cosign jirrifjuta b'not enough verified log entries from transparency log: 0 < 1.
Installa mir-reġistru tiegħek
Il-fajl tal-values għal installazzjoni air-gapped tvarja minn waħda konnessa f'linja waħda: global.imageRegistry isemmi r-reġistru tiegħek.
# 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>"L-entrati <custodian-...-age-recipient> huma l-linji pubbliċi age1... tan-nies li jżommu r-recovery keys tal-key store. Kapitlu 2.8, Installazzjonijiet fuq magna waħda, jispjega kif kull wieħed jagħmel waħda. harrow-ssd hija l-klassi tal-ħażna ta' Harrow stess: poġġi tiegħek, jew ħalli storage.className barra biex tuża d-default tal-cluster.
- Ħaddem preflight kontra l-cluster b'dan il-fajl, kif jiddeskrivi kapitlu 2.5, Preflight b'nexusctl.
- Installa miċ-chart tal-pakkett, u ħalli barra
--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=900shelm install --wait joħloq deadlock ma' dan iċ-chart: post-install hook jagħti lil kull servizz il-password tad-database tiegħu, u --wait iżomm il-hooks lura sakemm is-servizzi jkunu mixgħula. Kapitlu 2.8, Installazzjonijiet fuq magna waħda, fih il-loop li jistenna wkoll lill-StatefulSets.
B'nexusctl, l-istess installazzjoni hija nexusctl install --context <kube-context> --values harrow-prod-values.yaml.
Xejn fiċ-chart ma joħroġ 'il barra min-namespace ħlief id-DNS (Domain Name System), il-Kubernetes API (application programming interface) għar-reviżjonijiet tat-tokens, u kwalunkwe indirizz li telenka f'networkPolicy.externalEgressCIDRs, li huwa vojt b'mod awtomatiku. L-ebda telemetrija ma toħroġ mill-installazzjoni, u telemetry.enabled ma jistax jiġi ssettjat għal xi ħaġa oħra ħlief false. Għall-IA (intelliġenza artifiċjali) fuq sit mingħajr internet, l-organizzazzjoni tikkonnettja s-server tal-mudell tagħha stess kompatibbli ma' OpenAI ġewwa s-sit, imsemmi f'ai.localProvider.baseUrl; kapitlu 2.14, Fornituri u mudelli tal-IA, ikopri dan.
Il-liċenzja mhijiex valur taċ-chart. Inti timportaha wara l-installazzjoni, kif deskritt hawn taħt.
k3s u cert-manager mingħajr tniżżil
Jekk Nexus sejjer fuq cluster k3s li tibni inti stess, k3s irid jiġi installat mingħajr network ukoll. Id-disk image tal-installatur jagħmel dan għalik (kapitlu 2.9, Id-disk image tal-installatur). Bl-idejn, fuq kull node:
- Ġib in-naħa l-oħra l-fajls tar-rilaxx ta' k3s v1.33.6+k3s1 għall-arkitettura tiegħek: il-binarju
k3s(k3s-arm64fuq arm64),install.sh,k3s-airgap-images-<arch>.tar.zstusha256sum-<arch>.txt. k3s jippubblika checksums għal dawn il-fajls u l-ebda firma. Ivverifika kull fajl ma'sha256sum-<arch>.txt, u kun ċar mat-tim tas-sigurtà tiegħek li dan huwa checksum mill-istess oriġini, mhux firma. - Poġġi l-binarju u l-images tas-sistema fejn k3s ifittixhom, u installa bit-tniżżil mitfi:
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=600scert-manager v1.21.3 huwa prerekwiżit: is-CA (awtorità taċ-ċertifikati) taċ-chart stess hija emittent ta' cert-manager. Ġib in-naħa l-oħra ċ-chart ta' cert-manager, cert-manager-v1.21.3.tgz, u l-images tiegħu. Fuq in-naħa konnessa, ivverifika l-images bil-key tal-proġett ta' cert-manager stess qabel ma jaqsmu:
cosign verify --signature-digest-algorithm sha512 --insecure-ignore-tlog=true \
--key cert-manager-pubkey-2021-09-20.pem quay.io/jetstack/<image>@<digest>Ġewwa s-sit, importa l-images fil-container store ta' kull node taħt l-ismijiet li jitlob iċ-chart ta' cert-manager, quay.io/jetstack/cert-manager-<name>:v1.21.3, imbagħad ivverifikahom u installa:
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 huwa tajjeb għal cert-manager. Huwa biss Nexus li m'għandux ikollu dan.
L-aġġornamenti u l-partijiet il-ġodda jaslu fuq midja ffirmata
Sit air-gapped jaġġorna minn disk ukoll. Fil-console, Import from media fuq il-paġni This installation jgħabbi rilaxx minn disk miġjub ġewwa s-sit. Jivverifika ċ-checksum ta' kull fajl, imbagħad il-firma mar-release key diġà installata fuq is-sit, qatt key li jġib id-disk, u mbagħad li r-rilaxx huwa aktar ġdid minn dak li qed jaħdem. L-importazzjoni tikkopja u tivverifika biss. In-nies ikomplu jaħdmu fuq ir-rilaxx li qed jaħdem, u xejn ma jinbidel sakemm tagħżel li taġġorna.
Mill-command line, l-istess rilaxx jidħol b'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.tarplan juri x'se jinbidel u ma jibdel xejn. apply jieħu backup l-ewwel u mbagħad jaġġorna. Kapitlu 2.15, It-tieni jum: it-tħaddim ta' Nexus, ikopri l-aġġornamenti b'mod sħiħ.
Meta l-firma ta' disk ma taqbilx, l-importazzjoni tiġi rrifjutata b'MEDIA_SIGNATURE_INVALID. Xejn ma jitgħabba jew jiġi kkopjat ġewwa, u r-rilaxx li qed jaħdem jibqa' jaħdem. Il-paġna tgħid liema verifiki għaddew, fejn waqfet, u l-key li stenniet ħdejn il-key li sabet. Żomm id-disk għat-tim tas-sigurtà tiegħek u itlob wieħed ġdid mingħand Adverant.
Il-partijiet Enterprise li liċenzja tixgħel jiġu bl-istess mod fuq sit air-gapped: fuq id-disk tar-rilaxx, permezz ta' Import from media, qabel ma tixgħelhom. Kull parti tiġi vverifikata mar-release key ta' Adverant qabel ma tinxtegħel, sabiex qatt ma tikkopja binarju fil-cluster bl-idejn.
Liċenzji mingħajr internet
Installazzjoni konnessa tirċievi l-liċenzja tagħha waħedha. Waħda air-gapped tiskambja fajls ma' Adverant bl-idejn, permezz tal-iskambju offline.
- Il-paġni tal-liċenzja tal-console jagħmlu fajl żgħir ta' talba għal liċenzja. L-installazzjoni tiffirmah bil-key tagħha stess, sabiex Adverant ikun jista' jgħid liema installazzjoni talbet.
- Xi ħadd iġorr il-fajl 'il barra fuq USB stick lejn kompjuter li huwa online, jidħol fil-kont ta' Adverant fuq
https://account.adverant.ai, u jtellgħu fuq il-paġna Offline exchange. - Huma jġibu l-fajl tal-liċenzja lura bl-istess mod.
- Importah. Fil-console, iftaħ Licence and what it unlocks u agħfas Import a new licence. Mill-command line:
nexusctl licence import harrow-port-licence.jsonIl-liċenzja tiġi vverifikata offline, ġewwa s-sit, mal-keys ta' Adverant. Adverant jiffirma kull liċenzja b'żewġ keys indipendenti, u ż-żewġ firem iridu jiġu vverifikati.
L-istess skambju jġorr id-dikjarazzjoni tal-użu ta' kull sena 'l barra. Fiha counters biss (seats, apparati, gruppi ta' karatteristiċi), u l-amministratur jaqraha linja b'linja fuq Usage statement for Adverant qabel ma toħroġ.
| Kodiċi | Stat | Xi tfisser |
|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Il-fajl mhuwiex liċenzja li ffirma Adverant, jew byte inbidel wara l-iffirmar. Ma jinbidel xejn. |
LICENCE_OTHER_INSTALLATION |
409 | Il-liċenzja hija ġenwina iżda nħarġet għal installazzjoni oħra. Itlob waħda maħruġa għall-id ta' din l-installazzjoni. |
LICENCE_CLOCK_BEHIND_FLOOR |
409 | L-arloġġ jaqra aktar kmieni mill-aħħar ħin li rat din l-installazzjoni. Li tissettja l-arloġġ lura ma jerġax jagħti l-ħajja lil liċenzja skaduta. |
LICENCE_REVOKED |
403 | Adverant irtira l-liċenzja b'revoka ffirmata. Il-partijiet Enterprise jieqfu milli jiġu offruti; Community u l-esportazzjoni jibqgħu. |
Kapitlu 2.13, Liċenzji, ikopri l-istati, il-perjodu ta' grazzja u t-tiġdid.
Il-listi ta' revoka jiġu importati bl-idejn
Meta Adverant jirtira liċenzja, jippubblika lista ta' revoka ffirmata. Il-lista hija kumulattiva: kull waħda ġġorr kull liċenzja rtirata qabilha. Installazzjoni konnessa ssir taf biha. Waħda air-gapped issir taf biss meta xi ħadd jimporta l-lista, għalhekk ġorr l-aħħar lista ġewwa ma' kull disk ta' rilaxx u importaha permezz tal-importazzjoni tar-revoki tal-installazzjoni fuq il-paġni tal-liċenzja, jew l-indirizz /api/v1/installation/licence/revocations fuq is-sign-in host.
Dan jaħdem fiż-żewġ naħat. Installazzjoni air-gapped li qatt ma timporta lista qatt ma ssir taf li liċenzja ġiet irrevokata, inkluża liċenzja ffirmata b'key li aktar tard instab li kienet kompromessa. L-importazzjoni tal-lista hija l-uniku mod kif dik l-aħbar taqsam il-vojt.
Il-pakkett issiġillat sovran: nexus-airgap
Xi siti sovrani jridu rilaxx bħala fajl wieħed issiġillat u ffirmat li l-manifest tiegħu stess jipprojbixxi l-aċċess għan-network. Għalihom hemm it-tieni format, il-pakkett issiġillat, u l-għodda tiegħu, nexus-airgap, mill-pakkett @adverant/nexus-sovereign. Installa l-għodda mir-reġistru tal-pakketti ta' Adverant, separatament minn kwalunkwe pakkett li se tivverifika. Pakkett ma jistaxul jagħmel tajjeb għalih innifsu.
Il-pakkett issiġillat huwa tarball wieħed iffirmat. Il-manifest tiegħu huwa ffirmat b'Ed25519 u jelenka SHA-256 għal kull fajl. L-għodda għandha erba' verbi.
| Verb | X'jagħmel |
|---|---|
nexus-airgap bundle |
Jibni pakkett issiġillat minn direttorju ppreparat u jiffirma l-manifest tiegħu. |
nexus-airgap verify --bundle <file> --trusted-key <pem> --profile <profile> |
Jivverifika l-firma mat-trusted key, jerġa' jagħmel hash ta' kull fajl, jirrifjuta kwalunkwe fajl li l-manifest ma jelenkax, u jirrifjuta pakkett li r-regola tan-network tiegħu mhijiex l-allow-list vojta bi traffiku tal-aġent lokali biss. Ma jibdel xejn. |
nexus-airgap install |
Jivverifika, imbagħad iwettaq il-pjan ta' installazzjoni fl-ordni: jgħabbi l-images, japplika l-manifests, iħaddem il-migrazzjonijiet, jiżra' l-ħiliet, jipprovdi l-keys. |
nexus-airgap open |
Jiftaħ l-esportazzjoni kkodifikata fakultattiva tal-pakkett bil-kustodju tal-key tas-sit stess, li fuq sit air-gapped hija ċ-ċippa TPM (Trusted Platform Module) tal-magna. |
Ivverifika qabel kull ħaġa oħra:
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 iżomm il-kopja vverifikata u miftuħa u jsemmiha bħala stagingDir fl-output, sabiex taħdem minn dak li ġie vverifikat.
Jekk il-verifika tfalli b'BUNDLE_INTEGRITY_VIOLATION, fajl ġewwa l-pakkett inbidel wara li ġie ffirmat. Ieqaf hemm. L-għodda għandha swiċċ --no-strict li jaqbeż il-verifika għal fajls mhux elenkati. Tużahx fuq rilaxx.
Il-ġurnata li tasal id-diska li jmiss
Tomás iżomm lista ta' kontroll qasira mwaħħla ġewwa l-armarju tal-għassa tal-bieb, u ta' min jikkopjaha. Ivverifika s-.sha256 tat-tar. Ħaddem verify-bundle.sh bil-key installata u aqra l-aħħar linja. Importa l-aktar lista ta' revoka ġdida. Imbagħad, u mbagħad biss, importa r-rilaxx mill-midja u ppjana l-aġġornament. Disk li jfalli fi kwalunkwe wieħed minn dawn il-passi jmur lura fl-envelopp tiegħu, ittikkettat, għat-tim tas-sigurtà, u xejn fuq in-network ma jkun inbidel.


