All tutorials
Tutorials · Cordon 0.7.0

Cordon tutorials

42 tutorials covering the scanner as release 0.7.0 ships it: each a single use case to read, run and move on from, with 177 diagrams. Start with your first scan, or go straight to the ecosystem and command reference. Every page and section links to its source on GitHub at v0.7.0.

Every ecosystem it reads

Every language it reads

Start here

  1. 01Your first scaninstall, scan, read the output, exit codes2 diagrams
  2. 02How detection worksthe pipeline: sources → detectors → findings2 diagrams

By what you want to catch

  1. 03Malware & known vulnerabilitiesadvisory DB, typosquats, dependency confusion2 diagrams
  2. 04Reachability, cut noise without hiding anythingcut CVE noise without hiding anything2 diagrams
  3. 05Provenance & attestation, prove the sourceprove a package was built from its real source2 diagrams
  4. 06Secrets, credentials and exfiltration61 secret rules, 27 exfiltration rules6 diagrams
  5. 07CI/CD pipeline attacksattacks on the pipeline, across seven CI systems6 diagrams
  6. 08Containers, Kubernetes and infrastructure as codeDockerfile, compose, Kubernetes, Terraform6 diagrams

Running it for real

  1. 09The advisory databasekeep the intel fresh (OSV + signed bundle)2 diagrams
  2. 10CI & git hooksfail-on gates, SARIF, fail-closed pre-commit2 diagrams
  3. 11Air-gapped installsoffline bundles, deterministic scans3 diagrams
  4. 12Vetting a package before you install itanswer "should I install this?" before you do7 diagrams

Going deeper

  1. 13AST rules & capabilitieshow rules see through obfuscation3 diagrams
  2. 14Config, policy & baselinesorg ceilings, adopt-incrementally3 diagrams
  3. 15Output formatstext | json | sarif | junit | markdown | github0 diagrams
  4. 16The sandbox -- running what you do not trustthe one component that executes, and its isolation6 diagrams
  5. 17Source, build systems, binaries and licencesbuild systems, binaries, licences, scan scope6 diagrams
  6. 18AI agents, MCP servers and skillsevery agent's instruction, MCP and hook files4 diagrams
  7. 19What changed since the last releasewhat changed since the version you trust2 diagrams
  8. 20Findings in the editorfindings on the line, in VS Code and JetBrains IDEs1 diagram
  9. 30Cordon for AI agents: the MCP serverAI agents check packages, skills and servers first2 diagrams
  10. 31Rule files: your own signatures, matched against every fileyour own signatures, matched against every file0 diagrams

Across a team

  1. 21Reviewing a dependency updatewhat an update adds, on every pull request2 diagrams
  2. 22Code arriving from someone elseclone and pull, scanned before they land4 diagrams
  3. 23Machines and vendor SBOMsinstalled packages, images, supplier SBOMs2 diagrams
  4. 24Policy for every repositoryone ceiling, pinned by digest; pins kept current2 diagrams
  5. 32Putting Cordon to work: choose your pathwhich of the ten to start with2 diagrams
  6. 33On your laptopvet a package first, scan, fail-closed git hooks2 diagrams
  7. 34Guard your installs: pnpm, npm and pippnpm, npm and pip: read before anything runs1 diagram
  8. 35GitHub Actions, from one step to a full workflowone step to a full workflow, SARIF, PR review2 diagrams
  9. 36GitLab CI: the template, code quality and a merge-request gatethe template, code quality, merge-request gate1 diagram
  10. 37Jenkins, Azure Pipelines, Bitbucket, CircleCI, Buildkite, and any shellJenkins, Azure, Bitbucket, CircleCI, Buildkite, shell1 diagram
  11. 38Containers and images: before they are pushed or runan image before it is pushed or run1 diagram
  12. 39Rolling out across an organisationone policy, baselines, expiring suppressions, alerts1 diagram
  13. 40Air-gapped: a verified install and current intel with no networka verified install and current intel, no network1 diagram
  14. 41AI agents: Cordon as the check before an agent installs anythingthe MCP server, set up for each coding agent1 diagram
  15. 42From your own code: the Python API and the JSON resultthe Python API and the JSON result1 diagram

Reference

  1. 25Every ecosystemall 28: the files read, the checks, the commands28 diagrams
  2. 26Every commandevery command and option, from the parser itself52 diagrams
  3. 27Every AI agent and MCP locationeach agent's files, MCP configs, hooks and rules0 diagrams
  4. 28Every ruleall 1,501 rules and every Agent Threat Rule0 diagrams

When something goes wrong

  1. 29Troubleshootingexit codes, coverage notes, CI, hooks, images4 diagrams

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 asks OSV only what advisories changed, the same requests for everyone, naming nothing; --offline (or CORDON_OFFLINE=1) makes no request at all. A scan is safe to point at hostile packages and safe to run in an air-gap.