All tutorials
You are reading the tutorials for Cordon 0.5 (0.5.1). Read this for 0.7, the current release.
Cordon tutorials
20 tutorials covering the scanner as release 0.5.1 ships it: each a single use case to read, run and move on from, with 64 diagrams. Start with your first scan. Every page and section links to its source on GitHub at v0.5.1.
Start here
By what you want to catch
- 03Malware & known vulnerabilitiesadvisory DB, typosquats, dependency confusion2 diagrams
- 04Reachability, cut noise without hiding anythingcut CVE noise without hiding anything2 diagrams
- 05Provenance & attestation, prove the sourceprove a package was built from its real source2 diagrams
- 06Secrets, credentials and exfiltration61 secret rules, 12 exfiltration rules6 diagrams
- 07CI/CD pipeline attacksattacks on the pipeline, across seven CI systems6 diagrams
- 08Containers, Kubernetes and infrastructure as codeDockerfile, compose, Kubernetes, Terraform5 diagrams
Running it for real
- 09The advisory databasekeep the intel fresh (OSV + signed bundle)2 diagrams
- 10CI & git hooksfail-on gates, SARIF, fail-closed pre-commit2 diagrams
- 11Air-gapped installsoffline bundles, deterministic scans3 diagrams
- 12Vetting a package before you install itanswer "should I install this?" before you do7 diagrams
Going deeper
- 13AST rules & capabilitieshow rules see through obfuscation ([ast-js])3 diagrams
- 14Config, policy & baselinesorg ceilings, adopt-incrementally3 diagrams
- 15Output formatstext | json | sarif | junit | markdown | github0 diagrams
- 16The sandbox -- running what you do not trustthe one component that executes, and its isolation6 diagrams
- 17Source, build systems, binaries and licencesbuild systems, binaries, licences, scan scope6 diagrams
- 18AI agents, MCP servers and skillsevery agent's instruction, MCP and hook files2 diagrams
- 19What changed since the last releasewhat changed since the version you trust2 diagrams
- 20Findings in the editorfindings on the line, in VS Code1 diagram
The one thing to remember
Cordon READS. It never runs the code it is scanning, and it never sends anything about your code or dependencies anywhere unless you ask. By default it makes no network request at all; --offline (or CORDON_OFFLINE=1) guarantees it. A scan is safe to point at hostile packages and safe to run in an air-gap.