Playbook: a critical supplier reports a breach
Turn a supplier notification into an inventory, access, data, continuity, and evidence response for your own organisation.
Scope
For vendor management, security, IT, privacy, legal, procurement, communications, and business owners.
Start with the situation, not the slogan
A playbook is a decision aid for tired people working with incomplete information. Playbook: a critical supplier reports a breach therefore names owners, evidence, containment and exit criteria instead of pretending every incident follows a flowchart. Read it before the incident, tailor the contacts and systems, and exercise the awkward branches.
The first objective is shared situational awareness: what is known, who owns the incident, what business process is at risk, and which decision is due next. A chat channel full of competent people is not the same as command. Assign a coordinator and a note taker, even when the organisation is small enough for both to use the same kettle.
A supplier breach matters through your connection: identities, tokens, integrations, data, software, remote access, operations, and trust. The supplier’s severity label may not match your exposure.
Composite scenario
How this usually reaches the desk
The playbook should activate when the team can establish its entry conditions, including: Contract owner, business service, technical integration, data flows, accounts, tokens, remote access, and dependencies are known. If the report remains ambiguous, open a low-severity record and time-box validation rather than ignoring it or declaring the end of civilisation. Escalate as evidence, privilege, spread or business impact increases.
This scenario combines common operational patterns; it is not presented as a report of one named incident.
What to look for
Begin with preserved, comparable evidence. One signal is rarely proof; use independent observations and a reliable timeline before declaring scope or intent.
Contract owner, business service, technical integration, data flows, accounts, tokens, remote access, and dependencies are known.
Confirm this condition from an authoritative source and note who supplied it. Mark assumptions as assumptions; they have an unfortunate habit of becoming facts in copied status updates.
The supplier provides incident window, affected services, indicators, containment status, and recommended actions.
Identify the decision that depends on the information and the deadline for obtaining it. Evidence is most useful when it changes action rather than merely decorating the timeline.
Internal logs can identify supplier identity and integration activity.
Check coverage and retention before containment. If a source is unavailable, record the gap and use independent evidence rather than silently treating absence as innocence.
Working examples
Run it, read it, decide what changes
These examples use documentation addresses, test identities and bounded targets. Replace placeholders only inside systems you own or are explicitly authorised to operate. Read the expected result and next action before running the command; a successful command is evidence, not yet a conclusion.
Scan a pinned container image
- Prerequisites
- Trivy installed and the exact image digest approved for scanning.
trivy image --severity HIGH,CRITICAL --ignore-unfixed --format table ghcr.io/example/app@sha256:REPLACE_WITH_REAL_DIGESTTrivy lists fixed high/critical package vulnerabilities for the exact image digest.
A CVE match still needs package, reachability and vendor-advisory review; `--ignore-unfixed` intentionally hides findings without a published fix.
Patch the base/application dependency, rebuild to a new digest, rerun, and document accepted residual findings.
Produce machine-readable evidence
- Prerequisites
- An owned image and write access to an artefact directory.
trivy image --format json --output trivy-results.json your-image:tested
sha256sum trivy-results.jsonA JSON report and its hash are produced.
The report reflects the vulnerability database and image contents at scan time; feeds and images change.
Store scan time, Trivy version, database metadata and immutable image digest beside the report.
Locate a secret in Git history without printing every file
- Prerequisites
- A unique, non-secret identifier or a revoked token prefix; never paste a live secret into shared shell history.
git log --all --oneline -S 'REVOKED_TOKEN_PREFIX'
git grep -n 'REVOKED_TOKEN_PREFIX' $(git rev-list --all) -- ':!vendor' ':!node_modules'Commits and matching paths containing the identifier are listed.
Removing the current file does not remove earlier commits, forks, CI logs, artefacts or cloned copies.
Revoke first, inspect provider audit logs for use, replace the secret everywhere, then rewrite history only with repository-owner coordination.
Response sequence
Read the whole sequence before starting. Several workstreams may run in parallel, but their evidence, authority and expected outcomes still need to be explicit. Every step below points back to a concrete example; use the example as implementation evidence, not as permission to operate outside the stated scope.
Operational judgement
Run the playbook as a checklist with judgement, not as a spell. For Third party, Playbook and Supply chain, localise tenant names, log locations, provider contacts, legal thresholds, emergency credentials and business priorities. A generic document becomes operational only when the people on duty can find the required access without consulting the person currently on holiday.
Use a decision log separate from the task list. For each consequential action, note time, owner, evidence, choice, expected effect and observed result. This gives later reviewers something better than a reconstructed story and helps the next shift understand why a seemingly obvious action was delayed or rejected.
Handover
Make the result useful to the next person
Prepare the playbook package before an incident: primary and deputy owners, current contact routes, system inventory, evidence locations, delegated authority, provider escalation, legal and privacy triggers, secure communication, and emergency credentials. Keep a printable or otherwise independent copy where an identity or collaboration outage cannot hide it. Review contact details during exercises; telephone numbers appear to age faster than almost any cryptographic primitive.
For this playbook, the incident record should open with “Open an internal incident and assign business, technical, legal, privacy, and vendor-management owners.” and drive deliberately towards “Track supplier updates, contractual and regulatory actions, customer communication, recovery proof, and long-term assurance.” A shift handover must state confirmed facts, open hypotheses, business impact, containment already applied, evidence at risk, approvals pending and the next scheduled update. After closure, turn lessons into owned changes to controls, documentation and exercises. A lesson without an owner and a date is simply a well-written regret.
Validate before you close
Exit when internal exposure is assessed, affected trust is rebuilt or removed, services are stable, obligations are complete, and supplier and internal remediation have accountable owners.
Capture the test, the expected result and the observed result. Where a person or business owner must accept restored service, name them in the record. A green dashboard can confirm that a component is answering; it cannot confirm that invoices, identities or restored data are trustworthy.
Finish with a compact closure note: the original trigger, confirmed scope, evidence retained, controls changed, tests passed, known gaps, residual risk, and the people responsible for the remaining work. Schedule a review while the timeline is still fresh enough to challenge. The purpose is not to find a person to blame; computers already perform blame with admirable efficiency. The purpose is to make the next response faster, safer and less dependent on one person remembering where the useful log was hidden.
Common mistakes
- Running the playbook without assigning a decision owner and note taker.
- Containing too early or too late because evidence and business impact were not compared.
- Closing the incident without documenting recovery checks and follow-up owners.
These errors usually come from haste, unclear ownership or misplaced confidence. Build the safeguard into the runbook: a required evidence field, a second-person review, a rollback test or a specific exit criterion.
Questions people ask when the clock is running
Who may activate the playbook?
Define that locally before an incident. Help desk or monitoring staff should be able to open a record and escalate; containment authority may sit with incident command, service ownership or an executive depending on impact.
Must every step be completed in order?
No. Evidence, containment, communication and recovery often run in parallel. Keep dependencies explicit and do not let a later checkbox imply that an earlier decision was actually verified.
What is the exit condition?
Exit when internal exposure is assessed, affected trust is rebuilt or removed, services are stable, obligations are complete, and supplier and internal remediation have accountable owners. Residual risk, communication and improvement actions still need named owners even after service is restored.
Safety boundary
Use these steps only on systems you own or are explicitly authorised to assess. Preserve evidence, follow your organisation’s legal and regulatory obligations, and prefer reversible actions when the situation is not yet understood.
Primary references
- SP 800-61 Rev. 3: Incident Response Recommendations and ConsiderationsNIST
- Cybersecurity Framework 2.0NIST
- Software Supply Chain Security Cheat SheetOWASP
- Trivy DocumentationAqua Security
Editorial status: first edition. Review the linked vendor documentation for product- and version-specific changes before acting.