Versio 1.0.0-alpha.1uusin
Luku 2.10
Ilmarakoasennus (air-gapped)
Vie allekirjoitettu offline-paketti toimipisteeseen, jossa ei ole internet-yhteyttä, vahvista se erikseen tuodulla avaimella, lataa se omaan rekisteriisi ja asenna. Myös lisenssit, päivitykset ja sulkulistat siirretään ilmaraon yli manuaalisesti.
Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

Harrow Port Authorityn operatiivisesta verkosta ei ole reittiä internetiin – sekä lain nojalla että suunnitteluperiaatteiden mukaisesti. Alusliikenne, laituripaikkasuunnitelmat ja tullin pidätykset sijaitsevat kaikki kyseisessä verkossa, eikä mikään siellä oleva järjestelmä saa ottaa yhteyttä ulospäin. Kun Tomás Reilly asensi Nexuksen sinne, jokainen tavu saapui levyllä, jonka lähetti toi porttirakennukseen, ja jokainen tavu tarkistettiin toimipaikan sisällä ennen kuin mikään järjestelmä käytti sitä.
Tämä luku käsittelee kyseistä asennusta. Hankit allekirjoitetun offline-paketin, tarkistat sen avaimella, joka on toimitettu sinulle toista reittiä pitkin, kopioit sen levykuvat omaan rekisteriisi, tarkistat ne siellä uudelleen ja asennat kaavion niin, että rekisterisi nimi on määritetty arvoissa. Tämän jälkeen tulevat asiat, jotka ilmavälillä eristetty toimipaikka tekee käsin, mutta jotka verkkoon liitetty toimipaikka saa automaattisesti: k3s ja cert-manager ilman latausta, päivitykset tallennusvälineillä, lisenssit offline-vaihdon kautta sekä sulkulistat, jotka tuot itse.
Mitä offline-paketti sisältää
Paketti on yhden julkaisun yksi versio pakkaamattomana tar-tiedostona, jonka vieressä on tarkistussummatiedosto: nexus-alpha-1.0.0-alpha.1-enterprise.tar ja nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256. Community-paketit ovat julkisesti saatavilla osoitteessa downloads.adverant.ai. Enterprise-paketit ladataan Adverant-tililtäsi osoitteesta https://account.adverant.ai, lisenssisi vierestä, eikä niitä koskaan jaeta anonyymisti.
Purettuna se näyttää tältä:
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
Jokainen images/<svc>/-hakemisto on cosign save-komennon kirjoittama. Se sisältää levykuvaindeksin ja molempien alustojen levykuvat, linux/amd64 ja linux/arm64, sekä cosign-allekirjoituksen, SPDX SBOM (software bill of materials, ohjelmiston osaluettelo) -varmenteen kullekin alustalle ja alkuperävarmenteen, jotka kaikki on luotu Adverantin julkaisuavaimella. Samat SBOM-luettelot ovat sbom/-hakemistossa tavallisina tiedostoina, jotta tietoturvatiimi voi lukea niitä ilman cosign-työkalua.
Tietokerros sisältää copyleft-ohjelmistoja: muun muassa PostgreSQL ja PostGIS sekä Neo4j Community Edition. Paketti sisältää jokaisen toimittamansa tietokerroksen levykuvan lähdekoodin, ja release/source-offer.json ilmoittaa tämän jokaisen levykuvan osalta. Pakettia, joka toimittaisi copyleft-binaarin ilman sen lähdekoodia, ei edes koosteta.
release/facts.json nimeää julkaisun, version, arkkitehtuurit ja sen julkaisuavaimen sormenjäljen, jolla paketti allekirjoitettiin, muodossa sha256:<hex>.
Julkinen avain kulkee erikseen
Paketti ei koskaan sisällä avainta, jolla se tarkistetaan. Jos paketti sisältäisi oman avaimensa, kuka tahansa voisi korvata koko paketin avaimineen, ja jokainen tarkistus menisi silti läpi. Varmennusskripti hylkää avaimen, joka sijaitsee paketin hakemistossa.
Hae julkaisun julkinen avain kerran verkkoon liitetyllä koneella osoitteesta https://downloads.adverant.ai/nexus/1.0.0-alpha.1/. Tallenna se nimellä release.pub. Sen sormenjälki on tiedoston SHA-256-tiiviste:
sha256sum release.pubVertaa sitä Adverantin julkaisemaan sormenjälkeen sekä erillistä kanavaa pitkin saamiesi julkaisutietojen sormenjälkeen. Luku 2.4, Julkaisun hankkiminen ja varmentaminen, sisältää tarkemmat tiedot. Vie sitten release.pub toimipaikkaan, eri reittiä kuin itse paketti, jos mahdollista, ja säilytä se siellä. Tomásin tiimi säilyttää sitä operatiivisen verkon tiedostojaossa varustettuna merkinnällä sen saapumispäivästä. Jokainen myöhempi julkaisu tarkistetaan tätä asennettua avainta vasten, ei koskaan mitään levyn mukana tulevaa vastaan.
Vahvista paketti
verify-bundle.sh on skripti, joka tarkistaa paketin, ja se julkaistaan jokaisen julkaisun yhteydessä. Asennuslevykuva suorittaa saman skriptin ensimmäisellä käynnistyskerralla. Se tarvitsee työkalut cosign v3, helm v4 sekä sha256sum tai shasum. Se ei lue mitään mistään verkosta eikä tarvitse Pythonia, joten se toimii niin pelkistetyllä asennussolmulla kuin työasemallakin.
- Tarkista tar-tiedosto sen tarkistussummaa vasten ja pura se sitten:
sha256sum -c nexus-alpha-1.0.0-alpha.1-enterprise.tar.sha256
tar -xf nexus-alpha-1.0.0-alpha.1-enterprise.tar- Suorita varmennus mukana tuomallasi avaimella:
./verify-bundle.sh nexus-alpha-1.0.0-alpha.1-enterprise release.pubKolmas argumentti nimeää arvotiedoston kaavion tarkistuksia varten. Ilman sitä skripti käyttää paketin tiedostoa docs/example-values.yaml.
- Lue viimeinen rivi, jonka on oltava
VERIFY-BUNDLE PASSennen kuin jatkat eteenpäin.
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 pysähtyy ensimmäiseen epäonnistuvaan tarkistukseen. Tässä on kuvattu, mitä kukin vaihe tekee.
| Vaihe | Mitä se tarkistaa |
|---|---|
| 1 | Jokainen tiedostossa SHA256SUMS lueteltu tiedosto täsmää tarkistussummansa kanssa, eikä mukana ole yhtäkään tiedostoa, jota ei ole luettelossa. Lisätty ylimääräinen tiedosto aiheuttaa hylkäyksen yhtä varmasti kuin muuttunut tiedosto. |
| 2 | SHA256SUMS.sigstore.json on kelvollinen allekirjoitus tiedostolle SHA256SUMS antamallasi avaimella. Kun vaiheet 1 ja 2 yhdistetään, jokainen paketin tavu on varmasti Adverantin allekirjoittama. |
| 3 | Jokaisen levykuvahakemiston osalta: levykuvan indeksitiiviste on tiedostossa release/images.lock.json; olemassa on cosign-allekirjoitus, jonka kohteena on täsmälleen kyseinen tiiviste, ja se varmentuu avaintasi vasten; sekä cosign verify että cosign verify-attestation --type spdxjson menevät läpi tallennetussa rakenteessa. |
| 4 | helm lint --strict menee läpi kaaviossa esimerkkiarvoilla tai omilla arvoillasi. |
| 5 | Jokainen lukitustiedoston levykuva on tallennettu hakemistoon images/, ja jokainen kaavion muodostama levykuva on tiiviste lukitustiedostossa. Mikään kaavion asentama osa ei tule mistään muualta. |
| 6 | Kun lukitustiedosto sisältää tietokerroksen levykuvia, release/source-offer.json on täydellinen, nimeää niistä jokaisen, ja jokainen sen luettelema lähdekooditiedosto on mukana oikealla tarkistussummalla. |
Vaihe 3 tarkistaa itse allekirjoituksen tiivisteen perusteella sen lisäksi, että se suorittaa komennon cosign verify. Syynä on cosign-työkalun oma toimintatapa: tallennetulle rakenteelle ajettu cosign verify palauttaa paluukoodin 0 myös silloin, kun rakenne sisältää pelkän avaimella tehdyn varmenteen eikä lainkaan allekirjoitusta. Skripti ei hyväksy tätä.
Jos tämä epäonnistuu
Epäonnistuminen päättyy tekstiin VERIFY-BUNDLE FAIL step=<k> <why>.
| Viimeinen rivi | Mitä se tarkoittaa | Mitä tehdä |
|---|---|---|
step=0 the public key must come from outside the bundle |
Nimeämäsi avain on paketin hakemiston sisällä. | Käytä erikseen tuomaasi avainta. |
step=1 checksum mismatch |
Tiedosto on muuttunut luettelon luomisen jälkeen tai vahingoittunut siirron aikana. | Kopioi paketti uudelleen alkuperäiseltä tallennusvälineeltä ja tarkista se uudelleen. |
step=1 files not covered by SHA256SUMS |
Pakettiin on lisätty tiedosto. | Käsittele tallennusvälinettä epäluotettavana. Älä asenna siltä. |
step=2 SHA256SUMS signature does not verify |
Tarkistussummaluetteloa ei ole allekirjoitettu hallussasi olevalla julkaisuavaimella. | Keskeytä. Ilmoita asiasta tietoturvatiimillesi ja pyydä Adverantilta uusi tallennusväline. |
step=3 image <svc>: ... |
Levykuvan allekirjoitus tai SBOM-varmenne puuttuu tai sen varmennus epäonnistuu. | Keskeytä, kuten vaiheessa 2. |
step=4, step=5 |
Kaavio tai sen levykuvaluettelo on ristiriitainen. | Pyydä Adverantilta uusi paketti. |
step=6 ... |
Lähdekooditarjous on puutteellinen. | Pyydä Adverantilta uusi paketti. |
Vaiheiden 2 ja 3 epäonnistuminen on juuri se tilanne, jota varten koko tämä rakenne on luotu. Se tarkoittaa, etteivät tiedostot ole Adverantin allekirjoittamia. Säilytä tallennusväline tietoturvatiimiäsi varten.
Lataa levykuvat omaan rekisteriisi
Solmusi hakevat levykuvat toimipaikan sisäisestä rekisteristä. Harrow'n rekisteri on registry.harrow.example. Jokainen Nexus-levykuva sijoitetaan kyseisessä rekisterissä polun nexus/ alle, koska kaavio viittaa jokaiseen levykuvaan muodossa <global.imageRegistry>/nexus/<svc>@<digest>.
- Kirjaudu rekisteriisi normaalisti käyttämälläsi työkalulla, jotta
cosignvoi viedä sinne levykuvia. - Lataa jokainen levykuva paketin hakemistosta käsin ja varmenna se uudelleen sen uudessa sijainnissa:
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 vie allekirjoituksen ja jokaisen varmenteen levykuvan mukana, joten rekisterissä oleva kopio voidaan varmentaa samaa avainta vasten. Tässä tehtävä varmennus on klusterisi kannalta se ratkaiseva: se todistaa, että se, mitä solmusi hakevat, on Adverantin allekirjoittamaa.
verified nexus-alpha
verified nexus-auth
verified nexus-postgres
...
Jokaisen lukitustiedostossa olevan levykuvan tulisi tulostaa yksi verified-rivi. Puuttuva rivi tarkoittaa, että kyseisen levykuvan lataus tai tarkistus epäonnistui, ja sitä koskeva virhe tulostuu suoraan yläpuolelle.
Nexus-julkaisuille ei ole läpinäkyvyyslokia, joten valitsinta --insecure-ignore-tlog=true tarvitaan jokaisessa tarkistuksessa. Julkaisuavain toimii koko luottamusjuurena. Ilman tätä valitsinta cosign kieltäytyy ja antaa virheen not enough verified log entries from transparency log: 0 < 1.
Asenna omasta rekisteristäsi
Ilmavälillä eristetyn asennuksen arvotiedosto eroaa verkkoon liitetyn asennuksen tiedostosta yhdellä rivillä: global.imageRegistry nimeää rekisterisi.
# 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>"Kohdan <custodian-...-age-recipient> merkinnät ovat niiden henkilöiden julkisia age1...-rivejä, joilla on hallussaan avainsäilön palautusavaimet. Luku 2.8, Yhden koneen asennukset, selittää, miten kukin luo sellaisen. harrow-ssd on Harrow'n oma tallennusluokka: aseta tähän omasi tai jätä storage.className pois käyttääksesi klusterin oletusarvoa.
- Suorita klusterille valmiustarkistus tällä tiedostolla, kuten luvussa 2.5, Valmiustarkistus nexusctl-työkalulla, kuvataan.
- Asenna paketin kaaviosta ja jätä
--waitpois.
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 aiheuttaa lukkiutumisen tämän kaavion kanssa: asennuksen jälkeinen koukku (post-install hook) antaa kullekin palvelulle sen tietokantasalasanan, ja --wait pidättelee koukkuja, kunnes palvelut ovat käynnissä. Luku 2.8, Yhden koneen asennukset, sisältää silmukan, joka odottaa myös StatefulSet-resursseja.
Työkalulla nexusctl sama asennus on nexusctl install --context <kube-context> --values harrow-prod-values.yaml.
Mikään kaaviossa ei ota yhteyttä nimiavaruuden ulkopuolelle lukuun ottamatta DNS:ää (Domain Name System, nimipalvelujärjestelmä), Kubernetes API:a (application programming interface, ohjelmointirajapinta) pääsyvaltuuksien tarkistuksia varten sekä osoitteita, jotka luettelet kohdassa networkPolicy.externalEgressCIDRs, joka on oletusarvoisesti tyhjä. Asennuksesta ei lähde telemetriatietoja, eikä asetusta telemetry.enabled voi asettaa mihinkään muuhun arvoon kuin false. Tekoälyä (AI, artificial intelligence) varten toimipaikassa, jossa ei ole internet-yhteyttä, organisaatio yhdistää toimipaikan sisällä oman OpenAI-yhteensopivan mallipalvelimensa, joka nimetään kohdassa ai.localProvider.baseUrl; luku 2.14, Tekoälypalveluntarjoajat ja -mallit, käsittelee tätä.
Lisenssi ei ole kaavion arvo. Tuot sen asennuksen jälkeen, kuten alla kuvataan.
k3s ja cert-manager ilman latausta
Jos Nexus asennetaan itse rakentamaasi k3s-klusteriin, myös k3s on asennettava ilman verkkoyhteyttä. Asennuslevykuva tekee tämän puolestasi (luku 2.9, Asennuslevykuva). Käsin tehtynä jokaisella solmulla:
- Siirrä arkkitehtuuriasi vastaavat k3s v1.33.6+k3s1 -julkaisutiedostot:
k3s-binaari (k3s-arm64arm64-arkkitehtuurissa),install.sh,k3s-airgap-images-<arch>.tar.zstjasha256sum-<arch>.txt. k3s julkaisee näille tiedostoille tarkistussummat, mutta ei allekirjoitusta. Tarkista jokainen tiedosto tiedostoasha256sum-<arch>.txtvasten ja tee tietoturvatiimillesi selväksi, että kyseessä on samasta lähteestä peräisin oleva tarkistussumma, ei allekirjoitus. - Aseta binaari ja järjestelmän levykuvat paikkaan, josta k3s etsii niitä, ja asenna lataukset poiskytkettyinä:
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 on esivaatimus: kaavion oma CA (certificate authority, varmentaja) on cert-manager-myöntäjä. Siirrä cert-managerin kaavio, cert-manager-v1.21.3.tgz, ja sen levykuvat. Tarkista levykuvat verkkoon liitetyllä puolella cert-manager-projektin omalla avaimella ennen kuin ne ylittävät ilmavälin:
cosign verify --signature-digest-algorithm sha512 --insecure-ignore-tlog=true \
--key cert-manager-pubkey-2021-09-20.pem quay.io/jetstack/<image>@<digest>Tuo toimipaikan sisällä levykuvat jokaisen solmun konttisäilöön niillä nimillä, joita cert-manager-kaavio pyytää, quay.io/jetstack/cert-manager-<name>:v1.21.3, tarkista ne sitten ja asenna:
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 oikea valinta cert-managerille. Vain Nexuksen kohdalla sitä ei saa käyttää.
Päivitykset ja uudet osat saapuvat allekirjoitetulla tietovälineellä
Ilmavälillä eristetty toimipaikka päivitetään niin ikään levyltä. Konsolin tämä asennus -sivuilla oleva Tuo tallennusvälineeltä -toiminto lataa julkaisun toimipaikkaan tuodulta levyltä. Se tarkistaa jokaisen tiedoston tarkistussumman, sen jälkeen allekirjoituksen toimipaikkaan jo asennettua julkaisuavainta vasten – ei koskaan levyn mukana tulevaa avainta vasten – ja lopuksi sen, että julkaisu on uudempi kuin parhaillaan ajossa oleva. Tuonti ainoastaan kopioi ja tarkistaa. Käyttäjät jatkavat työskentelyä ajossa olevalla julkaisulla, eikä mikään muutu, ennen kuin päätät suorittaa päivityksen.
Komentoriviltä sama julkaisu viedään sisään komennolla 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 näyttää, mikä muuttuu, mutta ei muuta mitään. apply ottaa ensin varmuuskopion ja päivittää vasta sitten. Luku 2.15, Toinen päivä: Nexuksen käyttö ja ylläpito, käsittelee päivityksiä kokonaisuudessaan.
Kun levyn allekirjoitus ei täsmää, tuonti hylätään virheellä MEDIA_SIGNATURE_INVALID. Mitään ei ladata tai kopioida sisään, ja ajossa oleva julkaisu jatkaa toimintaansa. Sivulla kerrotaan, mitkä tarkistukset menivät läpi, mihin se pysähtyi, ja mitä avainta se odotti verrattuna avaimeen, jonka se löysi. Säilytä levy tietoturvatiimiäsi varten ja pyydä Adverantilta uusi.
Lisenssin käyttöön ottamat Enterprise-osat saapuvat ilmavälillä eristettyyn toimipaikkaan samalla tavalla: julkaisulevyllä, Tuo tallennusvälineeltä -toiminnon kautta, ennen kuin kytket ne päälle. Jokainen osa tarkistetaan Adverantin julkaisuavainta vasten ennen sen käyttöönottoa, joten et koskaan kopioi binaaria klusteriin käsin.
Lisenssit ilman internetiä
Verkkoon liitetty asennus vastaanottaa lisenssinsä automaattisesti. Ilmavälillä eristetty asennus vaihtaa tiedostoja Adverantin kanssa käsin offline-vaihdon kautta.
- Konsolin lisenssisivut luovat pienen lisenssipyyntötiedoston. Asennus allekirjoittaa sen omalla avaimellaan, jotta Adverant voi tunnistaa, mikä asennus pyynnön teki.
- Joku vie tiedoston USB-muistitikulla tietokoneelle, joka on verkossa, kirjautuu Adverant-tilille osoitteessa
https://account.adverant.aija lähettää tiedoston Offline-vaihto -sivulla. - Lisenssitiedosto tuodaan takaisin samalla tavalla.
- Tuo se järjestelmään. Avaa konsolissa Lisenssi ja mitä se avaa ja paina Tuo uusi lisenssi. Komentoriviltä:
nexusctl licence import harrow-port-licence.jsonLisenssi tarkistetaan offline-tilassa, toimipaikan sisällä, Adverantin avaimia vasten. Adverant allekirjoittaa jokaisen lisenssin kahdella toisistaan riippumattomalla avaimella, ja molempien allekirjoitusten varmennuksen on mentävä läpi.
Vuotuinen käyttöilmoitus viedään ulos saman vaihdon kautta. Se sisältää ainoastaan laskureita (käyttäjäpaikat, laitteet, ominaisuusryhmät), ja pääkäyttäjä voi lukea sen rivi riviltä Käyttöilmoitus Adverantille -sivulla ennen kuin se viedään ulos.
| Koodi | Tila | Mitä se tarkoittaa |
|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Tiedosto ei ole Adverantin allekirjoittama lisenssi, tai jokin tavu on muuttunut allekirjoittamisen jälkeen. Mikään ei muutu. |
LICENCE_OTHER_INSTALLATION |
409 | Lisenssi on aito, mutta se on myönnetty toiselle asennukselle. Pyydä lisenssi, joka on myönnetty tämän asennuksen tunnukselle. |
LICENCE_CLOCK_BEHIND_FLOOR |
409 | Kello näyttää aikaisempaa aikaa kuin viimeisin aika, jonka tämä asennus on nähnyt. Kellon siirtäminen taaksepäin ei palauta vanhentunutta lisenssiä voimaan. |
LICENCE_REVOKED |
403 | Adverant on peruuttanut lisenssin allekirjoitetulla peruutuksella. Enterprise-osien tarjoaminen lakkaa; Community ja vientitoiminnot säilyvät. |
Luku 2.13, Lisenssit, käsittelee tiloja, lisäaikaa ja uusimista.
Sulkulistat tuodaan käsin
Kun Adverant peruuttaa lisenssin, se julkaisee allekirjoitetun sulkulistan. Lista on kumulatiivinen: jokainen lista sisältää kaikki sitä ennen peruutetut lisenssit. Verkkoon liitetty asennus saa tiedon tästä automaattisesti. Ilmavälillä eristetty asennus saa tiedon vain silloin, kun joku tuo listan järjestelmään, joten tuo uusin lista jokaisen julkaisulevyn mukana ja tuo se asennukseen lisenssisivujen peruutusten tuontitoiminnolla tai kirjautumispalvelimen osoitteessa /api/v1/installation/licence/revocations.
Tämä toimii molempiin suuntiin. Ilmavälillä eristetty asennus, johon ei koskaan tuoda listaa, ei koskaan saa tietää lisenssin peruuttamisesta – ei edes silloin, kun lisenssi on allekirjoitettu avaimella, jonka on myöhemmin havaittu vaarantuneen. Listan tuominen on ainoa tapa, jolla tämä tieto ylittää ilmavälin.
Suvereeni sinetöity paketti: nexus-airgap
Jotkin täysin riippumattomat toimipaikat haluavat julkaisun yhtenä sinetöitynä, allekirjoitettuna tiedostona, jonka oma manifesti kieltää verkkoyhteydet. Niitä varten on olemassa toinen muoto, sinetöity paketti, ja sen työkalu, nexus-airgap, paketista @adverant/nexus-sovereign. Asenna työkalu Adverantin pakettirekisteristä, erillään mistään paketista, jota sillä tarkistetaan. Paketti ei voi taata omaa luotettavuuttaan.
Sinetöity paketti on yksittäinen allekirjoitettu tar-arkisto. Sen manifesti on allekirjoitettu Ed25519-algoritmilla ja se sisältää SHA-256-tiivisteen jokaiselle tiedostolle. Työkalulla on neljä komentoa.
| Komento | Mitä se tekee |
|---|---|
nexus-airgap bundle |
Koostaa sinetöidyn paketin valmistellusta hakemistosta ja allekirjoittaa sen manifestin. |
nexus-airgap verify --bundle <file> --trusted-key <pem> --profile <profile> |
Tarkistaa allekirjoituksen luotettua avainta vasten, laskee jokaisen tiedoston tiivisteen uudelleen, hylkää kaikki tiedostot, joita manifesti ei luettele, ja hylkää paketin, jonka verkkosääntö ei ole tyhjä sallittujen lista vain paikallisella agenttiliikenteellä. Ei muuta mitään. |
nexus-airgap install |
Varmentaa ja suorittaa sen jälkeen asennussuunnitelman järjestyksessä: lataa konttikuvat, ottaa manifestit käyttöön, ajaa migraatiot, alustaa taidot ja provisioi avaimet. |
nexus-airgap open |
Avaa paketin valinnaisen salatun viennin toimipaikan omalla avainten säilyttäjällä, joka ilmavälillä eristetyssä toimipaikassa on koneen TPM (Trusted Platform Module) -siru. |
Varmenna ennen mitään muuta:
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 säilyttää varmennetun, puretun kopion ja nimeää sen tulosteessa nimellä stagingDir, jotta työskentelet varmasti tarkistetun sisällön parissa.
Jos varmennus epäonnistuu virheellä BUNDLE_INTEGRITY_VIOLATION, paketin sisällä oleva tiedosto on muuttunut allekirjoittamisen jälkeen. Keskeytä tähän. Työkalussa on valitsin --no-strict, joka ohittaa luettelemattomien tiedostojen tarkistuksen. Älä käytä sitä julkaisun yhteydessä.
Päivä, jolloin seuraava levy saapuu
Tomás pitää lyhyttä tarkistuslistaa teipattuna porttirakennuksen kaapin sisäpuolelle, ja siitä kannattaa ottaa mallia. Tarkista tar-tiedoston .sha256. Suorita verify-bundle.sh asennetulla avaimella ja lue viimeinen rivi. Tuo uusin sulkulista. Vasta sitten, ja vain silloin, tuo julkaisu tallennusvälineeltä ja suunnittele päivitys. Levy, joka epäonnistuu missä tahansa näistä vaiheista, laitetaan takaisin kuoreensa, merkitään ja toimitetaan tietoturvatiimille, eikä mikään verkossa ole muuttunut.


