PieteiktiesPieteikt konsultāciju

2.10. nodaļa

Instalēšana izolētā vidē

Nogādājiet parakstītu bezsaistes pakotni objektā bez interneta, pārbaudiet to ar atsevišķi piegādātu atslēgu, ielādējiet to savā reģistrā un instalējiet. Arī licences, atjauninājumi un atsaukumu saraksti šo robežu šķērso manuāli.

Šo lapu no oriģināla angļu valodā ir tulkojis MI. Neskaidrību gadījumā par pamatu jāņem lapa angļu valodā. Lasīt šo lapu angļu valodā

19 minūšu lasīšana

Harrow Port Authority operāciju tīklam gan pēc likuma, gan pēc uzbūves nav maršruta uz internetu. Tajā atrodas kuģu satiksmes dati, piestātņu plāni un muitas aizturējumi, un nekas šajā tīklā nedrīkst veikt izejošus savienojumus. Kad Tomás Reilly tur uzstādīja Nexus, katrs baits tika piegādāts diskā, ko kurjers atnesa līdz sargmājai, un katrs baits tika pārbaudīts objekta iekšienē, pirms jebkas to izmantoja.

Šī nodaļa ir par šo uzstādīšanu. Jūs saņemat parakstītu bezsaistes pakotni, pārbaudāt to ar atslēgu, kas pie jums nonākusi pa citu ceļu, iekopējat tās attēlus savā reģistrā, pārbaudāt tos tur vēlreiz un uzstādāt diagrammu, vērtībās norādot sava reģistra nosaukumu. Pēc tam seko darbības, kuras no tīkla izolētā objektā veic manuāli, bet savienotā objektā tās notiek automātiski: k3s un cert-manager bez lejupielādes, atjauninājumi datu nesējos, licences caur bezsaistes apmaiņu un atsaukumu saraksti, kurus importējat paši.

Kreisajā pusē lodziņā „savienotā puse” atrodas „downloads.adverant.ai” un „jūsu Adverant konts”. Divas atsevišķas bultiņas šķērso biezu vertikālu līniju ar apzīmējumu „izolācijas robeža”. Augšējā bultiņa ar apzīmējumu „vienreiz, pa atsevišķu ceļu; nospiedums pārbaudīts ārpus joslas” nes „release.pub”. Apakšējā bultiņa ar apzīmējumu „katrs laidiens, diskā” nes „nexus-alpha-1.0.0-alpha.1-enterprise.tar”. Labajā pusē, „Harrow operāciju tīkla” iekšienē, abas nonāk lodziņā „verify-bundle.sh: VERIFY-BUNDLE PASS”, kas ved uz „registry.harrow.example (cosign load, cosign verify)” un pēc tam uz „klasteri (helm install)”.
Kā laidiens un tā uzticamība šķērso izolācijas robežu pa diviem atsevišķiem ceļiem.

Ko satur bezsaistes pakotne

Pakotne ir viena laidiena viens izdevums nesaspiesta tar arhīva veidā, kam blakus ir kontrolsummas fails: nexus-alpha-1.0.0-alpha.1-enterprise.tar un nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256. Community pakotnes ir publiski pieejamas vietnē downloads.adverant.ai. Enterprise pakotnes ir pieejamas jūsu Adverant kontā vietnē https://account.adverant.ai, blakus jūsu licencei, un nekad nav pieejamas anonīmi.

Atpakotā veidā tas izskatās šādi:

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

Katra images/<svc>/ direktorija ir tas, ko ieraksta cosign save. Tajā glabājas attēlu indekss un abu platformu attēli — linux/amd64 un linux/arm64 — kopā ar cosign parakstu, SPDX SBOM (programmatūras materiālu saraksta) apliecinājumu katrai platformai un izcelsmes apliecinājumu, kas visi izveidoti ar Adverant laidiena atslēgu. Tie paši SBOM atrodas sbom/ kā vienkārši faili, lai drošības komanda varētu tos izlasīt bez cosign.

Datu līmenis ietver copyleft programmatūru: tostarp PostgreSQL ar PostGIS un Neo4j Community Edition. Pakotne satur katra tajā iekļautā datu līmeņa attēla pirmkodu, un release/source-offer.json to norāda katram attēlam. Pakotne, kas piegādātu copyleft bināro failu bez tā pirmkoda, netiek veidota.

release/facts.json norāda laidienu, izdevumu, arhitektūras un tās laidiena atslēgas nospiedumu, ar kuru pakotne tika parakstīta, kā sha256:<hex>.

Publiskā atslēga tiek piegādāta atsevišķi

Pakotne nekad nesatur atslēgu, ar kuru to pārbauda. Pakotni, kurā būtu iekļauta tās pašas atslēga, jebkurš varētu aizstāt ar visu atslēgu, un visas pārbaudes joprojām būtu sekmīgas. Verifikācijas skripts noraida atslēgu, kas atrodas pakotnes direktorijā.

Vienreiz iegūstiet laidiena publisko atslēgu savienotā datorā no https://downloads.adverant.ai/nexus/1.0.0-alpha.1/. Saglabājiet to kā release.pub. Tās nospiedums ir faila SHA-256:

sha256sum release.pub

Salīdziniet to ar Adverant publicēto nospiedumu un ar to, kas norādīts laidiena piezīmēs, kuras saņēmāt pa atsevišķu kanālu. Sīkāka informācija ir atrodama 2.4. nodaļā „Laidiena iegūšana un verificēšana”. Pēc tam nogādājiet release.pub objektā, ja iespējams, pa citu ceļu nekā pakotni, un glabājiet to tur. Tomás komanda to glabā operāciju tīkla koplietojamajā failu krātuvē ar atzīmi par saņemšanas datumu. Katrs turpmākais laidiens tiek pārbaudīts pret šo uzstādīto atslēgu, un nekad pret kaut ko tādu, kas atrodams atnestajā diskā.

Pakotnes pārbaude

verify-bundle.sh ir skripts, kas pārbauda pakotni un tiek publicēts ar katru laidienu. Instalētāja diska attēls palaiž to pašu skriptu pirmās sāknēšanas reizē. Tam ir nepieciešams cosign v3, helm v4 un sha256sum vai shasum. Tas neko nelasa no tīkla un tam nav nepieciešams Python, tāpēc tas darbojas gan uz tīra instalētāja mezgla, gan darbstacijā.

  1. Pārbaudiet tar failu pret tā kontrolsummu, pēc tam atpakojiet to:
sha256sum -c nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256
tar -xf nexus-alpha-1.0.0-alpha.1-enterprise.tar
  1. Palaidiet verifikāciju ar atslēgu, kuru ienesāt:
./verify-bundle.sh nexus-alpha-1.0.0-alpha.1-enterprise release.pub

Trešais arguments norāda vērtību failu diagrammas pārbaudēm. Bez tā skripts izmanto pakotnes docs/example-values.yaml.

  1. Izlasiet pēdējo rindiņu — pirms turpināt, tai ir jābūt 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>

Skripts apstājas pie pirmās nesekmīgās pārbaudes. Lūk, ko dara katra no tām.

Solis Ko tas pārbauda
1 Katrs SHA256SUMS uzskaitītais fails atbilst tā kontrolsummai, un nav neviena tāda faila, kurš nebūtu iekļauts sarakstā. Ievietots papildu fails izraisa nesekmīgu pārbaudi tikpat droši kā izmainīts fails.
2 SHA256SUMS.sigstore.json ir derīgs SHA256SUMS paraksts, kas izveidots ar jūsu norādīto atslēgu. Izpildoties 1. un 2. solim kopā, katrs baits pakotnē ir baits, ko parakstījis Adverant.
3 Katrai attēla direktorijai: attēla indeksa kontrolsumma (digest) atrodas release/images.lock.json; pastāv cosign paraksts, kura subjekts ir tieši šī kontrolsumma, un tas tiek verificēts ar jūsu atslēgu; gan cosign verify, gan cosign verify-attestation --type spdxjson saglabātajam izkārtojumam ir sekmīgi.
4 helm lint --strict ir sekmīgs diagrammai ar piemēra vērtībām vai ar jūsu vērtībām.
5 Katrs fiksācijas failā (lock) esošais attēls ir saglabāts images/, un katrs attēls, ko atveido diagramma, ir kontrolsumma fiksācijas failā. Nekas no tā, ko uzstāda diagramma, nenāk no citienes.
6 Ja fiksācijas failā ir datu līmeņa attēli, release/source-offer.json ir pilnīgs, tajā ir nosaukts katrs no tiem, un katrs tajā uzskaitītais pirmkoda fails ir klāt ar pareizo kontrolsummu.

3. solis pārbauda pašu parakstu pēc kontrolsummas, kā arī palaiž cosign verify. Iemesls ir paša cosign darbības loģika: cosign verify saglabātam izkārtojumam atgriež 0 arī tad, ja izkārtojumā ir tikai ar atslēgu veikts apliecinājums, bet nav paraksta. Skripts to nepieņem.

Ja tas neizdodas

Kļūme beidzas ar VERIFY-BUNDLE FAIL step=<k> <why>.

Pēdējā rindiņa Ko tas nozīmē Kā rīkoties
step=0 the public key must come from outside the bundle Jūsu norādītā atslēga atrodas pakotnes direktorijā. Izmantojiet atslēgu, ko ienesāt atsevišķi.
step=1 checksum mismatch Fails ir mainījies pēc saraksta izveides vai ticis bojāts pārsūtīšanas laikā. Nokopējiet pakotni vēlreiz no oriģinālā datu nesēja un pārbaudiet no jauna.
step=1 files not covered by SHA256SUMS Pakotnei ir pievienots fails. Uzskatiet datu nesēju par neuzticamu. Neveiciet uzstādīšanu no tā.
step=2 SHA256SUMS signature does not verify Kontrolsummu saraksts nav parakstīts ar jūsu rīcībā esošo laidiena atslēgu. Apstājieties. Ziņojiet par to savai drošības komandai un pieprasiet Adverant jaunu datu nesēju.
step=3 image <svc>: ... Trūkst attēla paraksta vai SBOM apliecinājuma, vai arī to neizdodas verificēt. Apstājieties, tāpat kā 2. solī.
step=4, step=5 Diagramma vai tās attēlu saraksts nesaskan. Pieprasiet Adverant jaunu pakotni.
step=6 ... Pirmkoda piedāvājums ir nepilnīgs. Pieprasiet Adverant jaunu pakotni.

2. un 3. soļa nesekmīga izpilde ir gadījums, kura dēļ visa šī sistēma pastāv. Tas nozīmē, ka šie faili nav tie, kurus parakstījis Adverant. Saglabājiet datu nesēju savai drošības komandai.

Attēlu ielāde savā reģistrā

Jūsu mezgli izgūst attēlus no reģistra, kas atrodas objekta iekšienē. Harrow reģistrs ir registry.harrow.example. Katrs Nexus attēls šajā reģistrā tiek ievietots ceļā nexus/, jo diagramma uz katru attēlu atsaucas kā <global.imageRegistry>/nexus/<svc>@<digest>.

  1. Pierakstieties savā reģistrā ar rīku, ko parasti izmantojat, lai cosign varētu tajā augšupielādēt datus.
  2. No pakotnes direktorijas iekšienes ielādējiet katru attēlu un verificējiet to vēlreiz tā jaunajā atrašanās vietā:
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 kopā ar attēlu pārnes arī parakstu un katru apliecinājumu, tādējādi reģistra kopija tiek verificēta ar to pašu atslēgu. Šī verifikācija ir izšķirošā jūsu klasterim: tā pierāda, ka tas, ko jūsu mezgli izgūs, ir tas, ko parakstījis Adverant.

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

Katram fiksācijas failā esošajam attēlam vajadzētu izvadīt vienu verified rindiņu. Trūkstoša rindiņa nozīmē, ka attiecīgā attēla ielāde vai pārbaude neizdevās, un tā kļūda ir izdrukāta tieši virs tās.

Nexus laidieniem nav caurredzamības žurnāla (transparency log), tāpēc katrā pārbaudē ir nepieciešams --insecure-ignore-tlog=true. Laidiena atslēga ir visa uzticamības sakne. Bez šī karodziņa cosign atsaka darbību ar not enough verified log entries from transparency log: 0 < 1.

Instalēšana no sava reģistra

Vērtību fails uzstādīšanai izolētā vidē atšķiras no savienotas vides faila vienā rindiņā: global.imageRegistry norāda jūsu reģistru.

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

<custodian-...-age-recipient> ieraksti ir to personu publiskās age1... rindiņas, kurām ir atslēgu krātuves atkopšanas atslēgas. 2.8. nodaļā „Uzstādīšana vienā mašīnā” ir paskaidrots, kā katrs to izveido. harrow-ssd ir paša Harrow krātuves klase: ievadiet savējo vai izlaidiet storage.className, lai izmantotu klastera noklusējumu.

  1. Palaidiet klastera pirmspārbaudi (preflight) ar šo failu, kā aprakstīts 2.5. nodaļā „Pirmspārbaude ar nexusctl”.
  2. Uzstādiet no pakotnes diagrammas un izlaidiet --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 ar šo diagrammu nonāk strupceļā (deadlock): pēcuzstādīšanas āķis (post-install hook) piešķir katram pakalpojumam tā datubāzes paroli, savukārt --wait aiztur āķus, līdz pakalpojumi darbojas. 2.8. nodaļā „Uzstādīšana vienā mašīnā” ir parādīts cikls, kas gaida arī StatefulSets gatavību.

Ar nexusctl tā pati uzstādīšana ir nexusctl install --context <kube-context> --values harrow-prod-values.yaml.

Nekas diagrammā nesniedzas ārpus nosaukumvietas, izņemot DNS (domēna vārdu sistēmu), Kubernetes API (lietojumprogrammu saskarni) pilnvaru pārbaudēm un jebkuru adresi, ko norādāt networkPolicy.externalEgressCIDRs, kas pēc noklusējuma ir tukšs. No instalācijas netiek sūtīta nekāda telemetrija, un telemetry.enabled nevar iestatīt ne uz ko citu kā tikai false. Lai nodrošinātu MI (mākslīgo intelektu) objektā bez interneta, organizācija objekta iekšienē pieslēdz savu ar OpenAI saderīgu modeļu serveri, kas norādīts ai.localProvider.baseUrl; tas ir apskatīts 2.14. nodaļā „MI nodrošinātāji un modeļi”.

Licence nav diagrammas vērtība. To importē pēc uzstādīšanas, kā aprakstīts tālāk.

k3s un cert-manager bez lejupielādes

Ja Nexus tiks izvietots k3s klasterī, kuru veidojat pats, arī k3s ir jāuzstāda bez tīkla. Instalētāja diska attēls to izdara jūsu vietā (2.9. nodaļa „Instalētāja diska attēls”). Manuāli katrā mezglā:

  1. Pārnesiet savai arhitektūrai atbilstošos k3s v1.33.6+k3s1 laidiena failus: k3s bināro failu (k3s-arm64 uz arm64), install.sh, k3s-airgap-images-<arch>.tar.zst un sha256sum-<arch>.txt. k3s šiem failiem publicē kontrolsummas, bet ne parakstu. Pārbaudiet katru failu pret sha256sum-<arch>.txt un skaidri informējiet savu drošības komandu, ka tā ir kontrolsumma no tā paša avota, nevis paraksts.
  2. Novietojiet bināro failu un sistēmas attēlus tur, kur k3s tos meklē, un uzstādiet ar izslēgtām lejupielādēm:
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 ir priekšnosacījums: pašas diagrammas CA (sertifikātu iestāde) ir cert-manager izdevējs. Pārnesiet cert-manager diagrammu, cert-manager-v1.21.3.tgz, un tā attēlus. Savienotajā pusē pirms pārnešanas pārbaudiet attēlus ar paša cert-manager projekta atslēgu:

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

Objekta iekšienē importējiet attēlus katra mezgla konteineru krātuvē ar nosaukumiem, kādus pieprasa cert-manager diagramma, quay.io/jetstack/cert-manager-<name>:v1.21.3, pēc tam pārbaudiet tos un uzstādiet:

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 ir pareizs priekš cert-manager. Tikai Nexus to nedrīkst izmantot.

Atjauninājumi un jaunas komponentes parakstītos datu nesējos

Arī no tīkla izolētā objektā jaunināšana notiek no diska. Konsoles lapās „Šī instalācija” opcija Importēt no datu nesēja ielādē laidienu no objektā ienesta diska. Tā pārbauda katra faila kontrolsummu, pēc tam parakstu pret objektā jau uzstādīto laidiena atslēgu (nekad pret atslēgu no diska) un visbeidzot to, vai laidiens ir jaunāks par pašlaik darbojošos. Importēšana tikai nokopē un pārbauda. Lietotāji turpina strādāt ar darbojošos laidienu, un nekas nemainās, kamēr neizvēlaties veikt jaunināšanu.

Importēšana no datu nesēja (bez interneta)
Importēšana no datu nesēja (bez interneta)
Diskā esoša laidiena importēšana Harrow objektā. Paraksts tiek pārbaudīts pret objektā uzstādīto atslēgu, un darbojošās versijas darbība netiek traucēta, līdz kāds veic jaunināšanu.

No komandrindas to pašu laidienu ielādē ar 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 parāda, kas mainīsies, un neko nemaina. apply vispirms izveido dublējumu un pēc tam veic jaunināšanu. 2.15. nodaļā „Otrā diena: Nexus ekspluatācija” jaunināšana ir aprakstīta pilnībā.

Ja diska paraksts nesakrīt, importēšana tiek noraidīta ar MEDIA_SIGNATURE_INVALID. Nekas netiek ielādēts vai iekopēts, un darbojošais laidiens turpina darbu. Lapā ir norādīts, kuras pārbaudes bija sekmīgas, kur process apstājās, kā arī gaidītā atslēga blakus atrastajai atslēgai. Saglabājiet disku savai drošības komandai un pieprasiet Adverant jaunu.

Importēšana no datu nesēja neizdevās
Importēšana no datu nesēja neizdevās
Noraidīts imports. Visas kontrolsummas sakrita, bet paraksts bija izveidots ar nezināmu atslēgu, tāpēc nekas netika ielādēts un darbojošais laidiens netika aiztikts.

Enterprise komponentes, kuras ieslēdz licence, izolētā objektā tiek piegādātas tādā pašā veidā: laidiena diskā, izmantojot „Importēt no datu nesēja”, pirms jūs tās ieslēdzat. Katra komponente pirms ieslēgšanas tiek pārbaudīta pret Adverant laidiena atslēgu, tāpēc jūs nekad manuāli nekopējat bināro failu klasterī.

Licences bez interneta

Savienota instalācija savu licenci saņem automātiski. Izolēta instalācija apmainās ar failiem ar Adverant manuāli, izmantojot bezsaistes apmaiņu.

  1. Konsoles licenču lapās tiek izveidots neliels licences pieprasījuma fails. Instalācija to paraksta ar savu atslēgu, lai Adverant varētu noteikt, kura instalācija to pieprasīja.
  2. Kāds iznes šo failu USB zibatmiņā uz datoru, kas ir tiešsaistē, pierakstās Adverant kontā vietnē https://account.adverant.ai un augšupielādē to lapā Bezsaistes apmaiņa.
  3. Licences failu atnes atpakaļ tādā pašā veidā.
  4. Importējiet to. Konsolē atveriet Licence un ko tā atbloķē un nospiediet Importēt jaunu licenci. No komandrindas:
nexusctl licence import harrow-port-licence.json

Licence tiek pārbaudīta bezsaistē, objekta iekšienē, pret Adverant atslēgām. Adverant paraksta katru licenci ar divām neatkarīgām atslēgām, un abiem parakstiem ir jāiziet verifikācija.

Bezsaistes apmaiņa
Bezsaistes apmaiņa
Lapa „Bezsaistes apmaiņa” Adverant kontā, kur tiek augšupielādēts parakstīts pieprasījuma fails un saņemts atpakaļ licences fails.

Izmantojot to pašu apmaiņu, tiek iznests ikgadējais lietojuma pārskats. Tajā ir tikai skaitītāji (vietas, ierīces, funkciju grupas), un administrators pirms iznešanas to izskata rindiņu pa rindiņai sadaļā Lietojuma pārskats priekš Adverant.

Kods Statuss Ko tas nozīmē
LICENCE_SIGNATURE_INVALID 422 Fails nav Adverant parakstīta licence, vai arī pēc parakstīšanas ir mainījies kāds baits. Nekas nemainās.
LICENCE_OTHER_INSTALLATION 409 Licence ir īsta, bet izsniegta citai instalācijai. Pieprasiet licenci, kas izsniegta šīs instalācijas ID.
LICENCE_CLOCK_BEHIND_FLOOR 409 Pulkstenis rāda agrāku laiku nekā pēdējais laiks, ko šī instalācija ir fiksējusi. Pulksteņa pagriešana atpakaļ neatjauno licenci, kurai beidzies derīguma termiņš.
LICENCE_REVOKED 403 Adverant atsauca licenci ar parakstītu atsaukumu. Enterprise komponentes vairs netiek piedāvātas; Community un eksports paliek.

2.13. nodaļā „Licences” ir apskatīti stāvokļi, labvēlības periodi un atjaunošana.

Atsaukumu saraksti tiek importēti manuāli

Kad Adverant atsauc licenci, tas publicē parakstītu atsaukumu sarakstu. Saraksts ir kumulatīvs: katrā nākamajā ir iekļautas visas iepriekš atsauktās licences. Savienota instalācija par to uzzina pati. Izolēta instalācija to uzzina tikai tad, kad kāds šo sarakstu importē, tāpēc ienesiet jaunāko sarakstu ar katru laidiena disku un importējiet to, izmantojot instalācijas atsaukumu importu licenču lapās vai /api/v1/installation/licence/revocations adresi pierakstīšanās resursdatorā.

Tam ir divējādas sekas. Izolēta instalācija, kurā nekad netiek importēts saraksts, nekad neuzzina, ka licence ir atsaukta, ieskaitot licenci, kas parakstīta ar atslēgu, kura vēlāk atzīta par kompromitētu. Saraksta importēšana ir vienīgais veids, kā šī ziņa šķērso izolācijas robežu.

Suverēnā aizzīmogotā pakotne: nexus-airgap

Dažos suverēnos objektos laidiens ir nepieciešams kā viens aizzīmogots, parakstīts fails, kura paša manifests aizliedz piekļuvi tīklam. Tiem ir paredzēts otrs formāts — aizzīmogotā pakotne — un tās rīks nexus-airgap no pakotnes @adverant/nexus-sovereign. Uzstādiet šo rīku no Adverant pakotņu reģistra atsevišķi no jebkuras pakotnes, ko tas pārbaudīs. Pakotne nevar galvot pati par sevi.

Aizzīmogotā pakotne ir viens parakstīts tar arhīvs. Tās manifests ir parakstīts ar Ed25519, un tajā ir norādīts SHA-256 katram failam. Rīkam ir četras komandas (verbs).

Komanda Ko tas dara
nexus-airgap bundle Izveido aizzīmogotu pakotni no sagatavotas direktorijas un paraksta tās manifestu.
nexus-airgap verify --bundle <file> --trusted-key <pem> --profile <profile> Pārbauda parakstu pret uzticamo atslēgu, pārrēķina katra faila jaucējvērtību, noraida jebkuru failu, kas nav uzskaitīts manifestā, un noraida pakotni, kuras tīkla kārtula nav tukšs atļauto adrešu saraksts ar tikai lokālu aģentu datplūsmu. Neko nemaina.
nexus-airgap install Verificē, pēc tam secīgi izpilda uzstādīšanas plānu: ielādē attēlus, piemēro manifestus, palaiž migrācijas, ievieto sākotnējās prasmes (skills), nodrošina atslēgas.
nexus-airgap open Atver pakotnes neobligāto šifrēto eksportu ar paša objekta atslēgu glabātāju, kas izolētā objektā ir mašīnas TPM (Trusted Platform Module) mikroshēma.

Pirms jebkādām citām darbībām veiciet verifikāciju:

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 saglabā verificēto, atpakoto kopiju un izvadē to norāda kā stagingDir, lai jūs strādātu ar to, kas tika pārbaudīts.

Ja verifikācija neizdodas ar BUNDLE_INTEGRITY_VIOLATION, kāds fails pakotnes iekšienē ir mainījies pēc tās parakstīšanas. Šajā vietā apstājieties. Rīkam ir slēdzis --no-strict, kas izlaiž sarakstā neiekļauto failu pārbaudi. Neizmantojiet to laidienam.

Diena, kad tiek piegādāts nākamais disks

Tomás sargmājas skapīša iekšpusē tur pielīmētu īsu kontrolsarakstu, kuru ir vērts pārņemt. Pārbaudiet tar faila .sha256. Palaidiet verify-bundle.sh ar uzstādīto atslēgu un izlasiet pēdējo rindiņu. Importējiet jaunāko atsaukumu sarakstu. Tad, un tikai tad, importējiet laidienu no datu nesēja un plānojiet jaunināšanu. Disks, kuram kāds no šiem soļiem ir nesekmīgs, tiek ielikts atpakaļ aploksnē, nomarķēts un nodots drošības komandai, un tīklā nekas nav mainījies.