All tutorials
You are reading the tutorials for Cordon 0.4 (0.4.1). Read this for 0.7, the current release.

Air-gapped installs

Cordon 0.4.13 sections · 3 diagramsView this tutorial on GitHub

Cordon is offline by default, which makes an air-gap the easy case, not the hard one. Nothing about a normal scan reaches the network.

Air-gapped installs, figure 1
   INTERNET SIDE                    │  AIR GAP │              SECURE SIDE
   ─────────────                    │          │              ──────────
   cordon-scanner bundle create ───▶│  copy    │───▶ cordon-scanner bundle verify
     (wheel + rules + advisories)   │  the     │     cordon-scanner bundle install
                                    │  bundle  │              │
                                    │          │              ▼
                                    │          │        scan, fully offline
   bundle create  -o cordon-bundle.tar  <source-dir>    build a bundle from a dir   bundle verify     cordon-bundle.tar                   check it against its manifest   bundle install    cordon-bundle.tar                   verify, THEN extract
Air-gapped installs, figure 2
   VERIFY-BEFORE-EXTRACT
   ┌──────────────────────────────────────────────────────────────┐
   │ install = verify the manifest, then safe-extract (no path    │
   │ traversal, no symlink escape). A bundle that fails the check │
   │ is never unpacked.                                           │
   └──────────────────────────────────────────────────────────────┘
Air-gapped installs, figure 3
   internet host:   cordon-scanner advisories sync            (build the data)
        │           tar it up, carry it across the gap
        ▼
   air-gapped host: cordon-scanner scan . --advisories path/to/advisories/

Or use a signed advisory bundle (tutorial 09) so the secure side verifies an Ed25519 signature before trusting a single byte.

   same input  +  same rules  +  same advisory data   ─▶   byte-identical result   no network  =  no "it changed between runs"          =  auditable, cacheable

Next: 12 · Vetting a package before you install it.