PrijavaZakažite brifing

Poglavlje 2.4

Preuzimanje i provera izdanja

Gde se nalazi svaki deo Nexus izdanja, kako se Enterprise slike preuzimaju pomoću tokena za preuzimanje i kako da van mreže, pre nego što bilo šta instalirate, dokažete da svaka slika, chart i preuzeta datoteka potiču od kompanije Adverant i da nisu izmenjeni.

Ovu stranicu je sa engleskog originala prevela AI tehnologija. Ako nešto nije jasno, merodavna je stranica na engleskom. Pročitajte ovu stranicu na engleskom

15 min čitanja

Svaka slika u izdanju Nexus potpisana je Adverantovim ključem za izdanja, a svaka slika je imenovana svojim digestom, nikada oznakom. Chart će prikazati samo slike navedene po digestu u sopstvenoj datoteci za zaključavanje slika. Sve zajedno, to znači da možete dokazati, na sopstvenoj radnoj stanici i bez veze sa bilo kim, da je ono što nameravate da pokrenete tačno ono što je Adverant izgradio.

U Harrow Port Authority smo sve proverili pre prve instalacije. Trajalo je dvadesetak minuta, a najveći deo toga otišao je na petlju kroz slike. Ovo poglavlje prolazi istim putem: gde se nalazi svaki deo izdanja, token za preuzimanje Enterprise slika, datoteka za zaključavanje slika, cosign provere sa tačnim komandama i šta učiniti kada provera ne uspe.

Gde se nalazi izdanje

Adresa Šta tamo preuzimate
registry.adverant.ai Slike platforme, na registry.adverant.ai/nexus/<service>@sha256:<digest>, i Helm chart, na oci://registry.adverant.ai/nexus/charts/nexus
https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ Javni ključ izdanja i njegov otisak, nexusctl binarne datoteke i oflajn paketi
https://account.adverant.ai Vaš Adverant nalog: Preuzimanja, Tokeni za preuzimanje i komande za instalaciju, Implementacije i stranice licence

Community slike i Community chart su javni; možete ih preuzeti bez prijavljivanja. Enterprise slike se preuzimaju pomoću tokena za preuzimanje iz vašeg naloga, a Enterprise chart i paket nalaze se na stranici Preuzimanja u nalogu, koja prati vašu licencu.

Preuzimanja
Preuzimanja
Preuzimanja u Adverant nalogu, po verziji i kanalu. Uz svaku datoteku stoje njen kontrolni zbir i potpis, a delovi van licence ostaju navedeni, zasivljeni, uz razlog.

Pročitajte napomene o izdanju pre svega ostalog

Napomene o izdanju isporučuju se u svakom paketu kao docs/RELEASE-NOTES.md, navedene u njegovom SHA256SUMS, a iste napomene nalaze se i na stranici izdanja u vašem nalogu. Pročitajte ih pre instalacije ili nadogradnje. Za 1.0.0-alpha.1 su kratke. To je prvo izdanje, pa nova instalacija nema nijednu od tačaka nadogradnje koje opisuju, a lista poznatih problema navodi da ništa u njoj ne utiče na novu instalaciju koja prati dokumentovane korake. Kasnija izdanja navode svaki poznati problem sa verzijom koja ga ispravlja.

Stranica izdanja takođe u tri reda navodi šta alfa izdanje obećava: funkcije se mogu promeniti pre prve stabilne verzije, nadogradnja čuva vaše podatke i prethodno pravi rezervnu kopiju, a bezbednosne ispravke stižu u roku od 7 dana. Odštampali smo tu stranicu i stavili je u zapis o promeni u Harrow, jer je to najbliže izjavi o podršci koju bi odbor za promene tražio.

Korak 1: preuzmite ključ izdanja i proverite ga drugim putem

Sve navedeno u nastavku počiva na jednoj datoteci: Adverantovom javnom ključu za izdanja. Ključ koji je stigao sa istog mesta kao i ono za šta jemči dokazuje vrlo malo, zato proverite njegov otisak u odnosu na kopiju koja je do vas stigla nekim drugim putem.

  1. Preuzmite ključ iz fascikle izdanja na stranici Preuzimanja.

    curl -fsSLO https://downloads.adverant.ai/nexus/1.0.0-alpha.1/release.pub
  2. Izračunajte njegov otisak. Otisak je SHA-256 (Secure Hash Algorithm 256) same datoteke ključa.

    sha256sum release.pub

    Na macOS-u, shasum -a 256 release.pub daje isti rezultat.

  3. Uporedite ga, znak po znak, sa otiskom odštampanim u vašem ugovoru sa kompanijom Adverant i u napomenama o izdanju. Stranica Preuzimanja takođe objavljuje otisak, ali ta kopija je stigla istim putem kao i ključ, pa ona nije provera.

Ako se bilo koji znak razlikuje, stanite. Ne instalirajte i ne tražite drugu kopiju ključa na internetu. Otvorite zahtev za podršku iz svog naloga i navedite šta ste videli.

Korak 2: preuzmite nexusctl

nexusctl je interfejs komandne linije (CLI) za operatora sistema Nexus. Radi na vašoj radnoj stanici i čita vaš klaster preko vašeg kubeconfig-a. Stranica Preuzimanja nudi četiri verzije:

Datoteka Platforma
nexusctl-linux-amd64 Linux na Intel ili AMD procesoru
nexusctl-darwin-arm64 macOS na Apple silicon procesoru
nexusctl-darwin-amd64 macOS na Intel procesoru
nexusctl-windows-amd64.exe Windows

Uz svaku datoteku nalazi se njen paket potpisa, istog imena sa .sigstore.json na kraju. Proverite binarnu datoteku pre nego što je pokrenete:

curl -fsSLO https://downloads.adverant.ai/nexus/1.0.0-alpha.1/nexusctl-linux-amd64
curl -fsSLO https://downloads.adverant.ai/nexus/1.0.0-alpha.1/nexusctl-linux-amd64.sigstore.json
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
  --bundle nexusctl-linux-amd64.sigstore.json nexusctl-linux-amd64
Verified OK

Zatim je dodajte u svoju putanju i proverite njenu verziju:

install -m 0755 nexusctl-linux-amd64 /usr/local/bin/nexusctl
nexusctl version

Od ovog trenutka, nexusctl verify može umesto vas da obavlja provere datoteka. Poglavlje 2.5, Preliminarna provera pomoću nexusctl, pokriva njegov glavni zadatak, preliminarnu proveru.

Zašto zastavica kaže „insecure“

Svaka cosign komanda u ovom poglavlju sadrži --insecure-ignore-tlog=true. Nexus izdanja potpisuju se Adverantovim ključem i ne beleže se ni u jednom javnom dnevniku transparentnosti, tako da provera izdanja nikada ne zahteva vezu sa bilo kim, uključujući Sigstore. Podrazumevano cosign zahteva unos u dnevniku; zastavica mu nalaže da se osloni samo na ključ. Bez nje, provera ne uspeva ovako:

Error: not enough verified log entries from transparency log: 0 < 1

Kada je zastavica postavljena, cosign i dalje ispisuje rečenicu „Existence of the claims in the transparency log was verified offline“. To je fiksni tekst u cosign; iza njega ne stoji nikakav unos u dnevniku. Provera potpisa u odnosu na ključ je stvarna, i to je deo koji je bitan.

Korak 3: token za preuzimanje, za Enterprise

Enterprise slike zaštićene su tokenom za preuzimanje. Kreirate ga u svom nalogu, na stranici Tokeni za preuzimanje i komande za instalaciju:

  1. Pritisnite Dodaj token.
  2. Navedite za koji je klaster, šta sme da preuzima i kada ističe.
  3. Pritisnite Kopiraj token i odmah ga nalepite tamo gde čuvate akreditive, jer ga stranica prikazuje samo ovaj put.

Svaki token je ograničen na ono što sme da preuzima i ima datum isteka. Povlačenje tokena odmah zaustavlja nova preuzimanja; slike koje je klaster već preuzeo nastavljaju da rade. U Harrow smo napravili po jedan token za svaki klaster, tako da povlačenje tokena testnog klastera nikada ne utiče na produkciju. Community instalaciji token uopšte nije potreban; kreirate ga tek kada pređete na Enterprise, i to možete učiniti istog dana.

Tokeni za preuzimanje i komande za instalaciju
Tokeni za preuzimanje i komande za instalaciju
Tokeni za preuzimanje u Adverant nalogu. Svaki token prikazuje šta sme da preuzima, ko ga je kreirao i kada ističe; novi token se prikazuje samo jednom, a povlačenje tokena zaustavlja nova preuzimanja bez zaustavljanja bilo čega što već radi.

Chart nema vrednost za pull secret. Slike preuzimaju vaši čvorovi, pa token pripada izvršnom okruženju kontejnera na čvorovima. Na k3s, dodajte registar u /etc/rancher/k3s/registries.yaml na svakom čvoru i tamo ponovo pokrenite k3s:

# /etc/rancher/k3s/registries.yaml (on every node)
configs:
  "registry.adverant.ai":
    auth: {username: "<registry-user>", password: "<pull-token>"}

<registry-user> je korisničko ime za registar iz vaše Adverant pozivnice, a <pull-token> je token koji ste kopirali. Datoteka sadrži akreditiv, zato neka je čitljiva samo za root korisnika.

Na upravljanom klasteru čiji čvorovi ne čitaju tu datoteku, kopirajte slike u registar kojem vaši čvorovi već veruju i podesite global.imageRegistry na njega; svaki čvor mora da veruje Transport Layer Security (TLS) sertifikatu tog registra. Poglavlje 2.11, Varijacije: spoljna skladišta, TLS i ingress, pokriva to, a poglavlje 2.10, Instalacija bez mrežne veze, pokriva isto kopiranje za lokaciju bez izlazne veze.

Korak 4: pročitajte datoteku zaključavanja slika (images lock)

Nexus chart nikada ne imenuje sliku oznakom. Svaku imenuje digestom njenog višeplatformskog indeksa, preuzetim iz datoteke za zaključavanje slika, koju chart nosi kao files/images.lock.json. Oflajn paket nosi istu datoteku za zaključavanje kao release/images.lock.json.

Preuzmite chart i raspakujte ga da biste pročitali datoteku za zaključavanje:

helm pull oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1
tar -xzf nexus-1.0.0-alpha.1.tgz
jq -r '.version, .edition' nexus/files/images.lock.json
1.0.0-alpha.1
community

Najviši nivo datoteke za zaključavanje navodi kojem izdanju i kojoj ediciji pripada. Svaki unos pod images opisuje jednu sliku:

Polje Šta sadrži
svc Servis, kao što je nexus-auth ili nexus-postgres
index sha256: digest indeksa slike, koji pokriva i linux/amd64 i linux/arm64
edition community, enterprise ili all za sloj podataka
kind service, migrations ili data-tier za pet skladišta podataka i OpenBao
verified Kada je proces izgradnje izdanja verifikovao njen potpis i atestacije

Chart prikazuje svaku sliku kao <global.imageRegistry>/nexus/<svc>@<index>. Dakle, sa global.imageRegistry: registry.adverant.ai, servis za prijavljivanje je registry.adverant.ai/nexus/nexus-auth@sha256: praćen sa 64 heksadecimalna znaka, i ništa u klasteru ne može da ga zameni nečim drugim sa istim imenom.

Datoteka za zaključavanje je posebna za svaku ediciju. Community datoteka navodi samo slike čija je edicija community ili all. Enterprise datoteka navodi te slike i Enterprise verzije. Chart to proverava pri svakom prikazivanju i odbija da nastavi umesto da nagađa:

Šta chart kaže Zašto
edition=enterprise but enterprise.enabled=false: they must agree Dve vrednosti edicije u vašoj datoteci vrednosti se ne slažu
files/images.lock.json is the community lock; this install is edition enterprise Instalirate Enterprise iz Community charta, ili obrnuto
image nexus-auth is not in files/images.lock.json Chart i njegova datoteka za zaključavanje ne pripadaju jedno drugom; ponovo preuzmite chart
image ... is in the lock but was never verified by build-all Unos u datoteci za zaključavanje nema vreme verifikacije; ne instalirajte iz njega
NEXUS_EDITION_INVALID edition je prazno ili nije jedno od community i enterprise
RELEASE_VERSION_MISSING Datoteka za zaključavanje ne navodi verziju

Navedite sve slike i digeste odjednom:

jq -r '.images[] | "\(.svc) \(.index)"' nexus/files/images.lock.json

Korak 5: proverite potpis svake slike

Svaki indeks slike je potpisan, kao i svaki manifest platforme u njemu. Verifikujte po digestu, direktno iz datoteke za zaključavanje, kako biste proverili tačno ono što će chart pokrenuti:

jq -r '.images[] | "\(.svc)@\(.index)"' nexus/files/images.lock.json |
while read -r ref; do
  cosign verify --key release.pub --insecure-ignore-tlog=true \
    "registry.adverant.ai/nexus/$ref" > /dev/null && echo "OK $ref" || echo "FAILED $ref"
done

Svaki red treba da počinje sa OK. Na našoj vezi petlja je trajala nekoliko minuta, većinom u čekanju na registar. Čita samo potpise i ne preuzima slojeve slika, pa je jeftino ponavljati je posle svake nadogradnje. Red sa FAILED znači da treba stati: sledeći odeljak objašnjava šta svaka poruka znači.

Za pojedinačnu sliku, uklonite preusmeravanje i pročitajte šta je cosign proverio:

cosign verify --key release.pub --insecure-ignore-tlog=true \
  registry.adverant.ai/nexus/nexus-auth@sha256:<digest>
The following checks were performed on each of these signatures:
  - Existence of the claims in the transparency log was verified offline
  - The signatures were verified against the specified public key

<digest> je 64 heksadecimalna znaka iz index u datoteci za zaključavanje za tu sliku. Enterprise slikama je za ovu proveru potreban vaš token za preuzimanje, kao i za svako preuzimanje iz registra.

Vertikalni lanac od pet okvira povezanih strelicama nadole. Vrh: „Javni ključ izdanja, otisak proveren u odnosu na Vaš ugovor“. Drugi: „Chart paket nexus-1.0.0-alpha.1, potpisan“. Treći: „Lock datoteka slika unutar charta: svaka slika po digestu indeksa, jedno izdanje“. Četvrti: „Svaki indeks slike, potpisan, sa atestacijama spiska softverskih komponenti (SBOM) i porekla“. Dno: „Podovi u imenskom prostoru nexus, preuzeti po digestu“. Bočna strelica od gornjeg okvira pokazuje na drugi i četvrti okvir, sa oznakom „cosign verify, bez mrežne veze“.
Šta za šta jemči, od ključa koji ste proverili do podova koji rade.

Obe platforme i šta treba sačuvati

Svaki indeks slike sadrži dva manifesta platforme, linux/amd64 i linux/arm64, i svaki od njih je takođe potpisan. cosign verify uspeva na digestu indeksa i na digestu bilo koje platforme, pa je klaster sa mešovitim čvorovima pokriven istom proverom. Da biste videli dve platforme iza indeksa, zatražite od registra sirovi indeks:

docker buildx imagetools inspect registry.adverant.ai/nexus/nexus-auth@sha256:<digest> --raw

Njegova lista manifests navodi jedan unos amd64 i jedan unos arm64.

Sačuvajte izlaz gornje petlje uz zapis o promeni, pored otiska koji ste proverili. Kada vas neko, mesecima kasnije, pita kako znate da klaster pokreće ono što je Adverant isporučio, ta datoteka i digesti iz datoteke za zaključavanje daju odgovor. Naš revizor u Harrow postavio je upravo to pitanje, a odgovor je trajao minut.

Korak 6: pročitajte atestacije

Svaka slika nosi i dve potpisane atestacije, napravljene iz slike u vreme izgradnje: softversku listu materijala (SBOM) i izjavu o poreklu.

SBOM je u formatu Software Package Data Exchange (SPDX), po jedan za svaku platformu, pa indeks nosi dva. Navodi svaki paket u slici sa njegovom licencom. Pre izdanja, te licence se proveravaju u odnosu na listu zabranjenih; nijedna Community slika ne sadrži kod pod licencama GNU Affero General Public License (AGPL), Server Side Public License (SSPL), Redis Source Available License (RSAL) ili Business Source License (BUSL). Izjava o poreklu je Supply-chain Levels for Software Artifacts (SLSA) v1. Navodi izvorni commit iz kojeg je slika izgrađena, digeste osnovnih slika i alate za izgradnju sa njihovim verzijama, tako da se slika može pratiti do pregledanog izvornog koda bez obraćanja kompaniji Adverant.

Obe se proveravaju u odnosu na ključ izdanja koji već imate:

cosign verify-attestation --key release.pub --insecure-ignore-tlog=true \
  --type spdxjson registry.adverant.ai/nexus/nexus-auth@sha256:<digest>
cosign verify-attestation --key release.pub --insecure-ignore-tlog=true \
  --type slsaprovenance1 registry.adverant.ai/nexus/nexus-auth@sha256:<digest>

Provera spdxjson ispisuje dva rezultata, po jedan za SBOM svake platforme. Da biste videli sve što je priloženo uz sliku bez verifikacije, koristite cosign tree:

cosign tree registry.adverant.ai/nexus/nexus-auth@sha256:<digest>

Navodi jedan paket potpisa, dve spdx.dev/Document atestacije i jednu slsa.dev/provenance/v1 atestaciju. Zahtev za tip koji slika ne nosi, kao što je --type cyclonedx, ne uspeva sa none of the attestations matched the predicate type: cyclonedx. Taj neuspeh je ispravan; izdanje prilaže SPDX, a ne CycloneDX.

Korak 7: proverite chart i preuzete datoteke

Chart u registru potpisan je na svom OCI digestu (OCI je Open Container Initiative, format slika i artefakata koji registri koriste). helm pull ispisuje digest koji je preuzeo; proverite taj digest na isti način kao sliku:

cosign verify --key release.pub --insecure-ignore-tlog=true \
  registry.adverant.ai/nexus/charts/nexus@sha256:<chart-digest>

Za chart datoteku koju ste preuzeli, ili za oflajn paket, nexusctl verify proverava datoteku u odnosu na Adverantov ključ izdanja:

nexusctl verify nexus-1.0.0-alpha.1.tgz

Uspešan rezultat se završava navođenjem Adverantovog ključa izdanja i početka njegovog otiska. Uporedite te grupe sa otiskom koji ste proverili u koraku 1.

Oflajn paket je jedna nekomprimovana tar datoteka po ediciji, nexus-alpha-1.0.0-alpha.1-community.tar ili nexus-alpha-1.0.0-alpha.1-enterprise.tar, sa datotekom .sha256 pored nje. Unutra sadrži:

Putanja Šta je to
release/images.lock.json Datoteka za zaključavanje slika za tu ediciju
release/facts.json Podaci o izdanju: verzija, edicija, arhitekture i otisak ključa izdanja
images/<service>/ Svaka slika sa obe platforme, njen potpis i njene atestacije
charts/nexus-1.0.0-alpha.1.tgz Chart
sbom/ SPDX SBOM svake slike, po platformi
docs/ Napomene o izdanju, vodič za instalaciju bez mrežne veze i primeri vrednosti
SHA256SUMS i SHA256SUMS.sigstore.json Kontrolni zbir svake datoteke i njegov potpis

Javni ključ izdanja nikada se ne nalazi u paketu; ključ koji se isporučuje uz ono što potpisuje ne dokazuje ništa. Proverite ceo paket pomoću dve komande, iz njegove fascikle:

sha256sum -c SHA256SUMS
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
  --bundle SHA256SUMS.sigstore.json SHA256SUMS

Svaki red prvog treba da se završava sa OK, a drugi treba da ispiše Verified OK. Poglavlje 2.10, Instalacija bez mrežne veze, preuzima paket od tog trenutka: učitavanje slika u Vaš sopstveni registar, ponovnu proveru svake od njih tamo i sopstvenu proveru paketa od početka do kraja.

Kako proveriti preuzimanje
Kako proveriti preuzimanje
Kako proveriti preuzimanje, u Adverant nalogu. Dve provere bez mrežne veze, prikaz dobrog i lošeg rezultata, i otisak ključa izdanja u grupama od po četiri znaka radi vizuelnog poređenja.

Kada provera potpisa ne uspe

Stanite. Nemojte instalirati i nemojte menjati komandu dok provera ne prođe. Neuspela provera potpisa znači da sistem radi: to znači da datoteka koju imate nije datoteka koju je Adverant potpisao, ili da ključ koji posedujete nije Adverant-ov.

Šta vidite Šta znači Šta učiniti
accepted signatures do not match threshold, Found: 0, Expected 1 (izlazni kod 1) Slika je potpisana, ali ne ključem koji ste naveli Proverite da ste koristili ključ izdanja čiji ste otisak proverili u koraku 1
no signatures found (izlazni kod 10) Ništa na tom digestu nije potpisano Proverite da li digest potiče iz lock datoteke; nikada ne proveravajte tag
not enough verified log entries from transparency log: 0 < 1 --insecure-ignore-tlog=true nedostaje Dodajte opciju; sa slikom nije ništa pogrešno
none of the attestations matched the predicate type Zatražili ste tip atestacije koji slika ne sadrži Koristite spdxjson ili slsaprovenance1
Error: invalid signature when validating ASN.1 encoded signature Preuzeta datoteka je izmenjena nakon što je potpisana Preuzmite je ponovo
FAILED iz sha256sum -c Datoteka nije ona za koju je izračunata kontrolna suma Preuzmite je ponovo

Ako preuzimanje ne uspe dva puta, otvorite zahtev za podršku iz svog naloga i navedite naziv datoteke i poruku. Sačuvajte neispravnu datoteku; Vaš bezbednosni tim će je možda zatražiti.

Na instalaciji koja učitava izdanja sa diska, konzola izvršava iste provere i odbija izdanje čiji potpis ne odgovara instaliranom ključu, uz MEDIA_SIGNATURE_INVALID. Navodi šta je provereno, kojim redosledom, gde se zaustavila i da ništa nije izmenjeno: nijedna slika nije učitana, a pokrenuta verzija je netaknuta.

Uvoz sa medija nije uspeo
Uvoz sa medija nije uspeo
Izdanje na disku koje nije prošlo proveru potpisa. Obratite pažnju na provere prikazane redom, sa onom koja ga je zaustavila, na očekivani i pronađeni otisak ključa, kao i na jasnu izjavu da ništa nije učitano niti izmenjeno.

Kada ključ, slike i chart prođu sve provere, sledeći korak je preflight provera Vašeg klastera, u poglavlju 2.5, Preflight sa nexusctl.