When a vendor discloses a breach, know what to check, what to rotate and what to tell customers, within one working day
A runbook with fill-in templates for founders and engineering leads at small SaaS teams (2-30 people) who rely on third-party auth, docs, billing and content providers. Not legal advice; no compliance guarantee.
Instant download. 14-day refund, no questions asked. Prices include any applicable VAT.
What you get
- The first 60 minutes: a set of triage questions that tells you whether the vendor's incident touches your data, your secrets or your customers, and who needs to be pulled in right away.
- Dependency inventory and vendor-to-exposure mapping: a worksheet to list every third-party service you use, what data it holds and which keys, tokens and integrations it can reach, so the next announcement takes minutes to assess instead of hours.
- Credential rotation order and checklist: a sensible sequence for rotating API keys, OAuth tokens, webhook secrets and shared passwords, with notes on what to rotate first and what can break when you do.
- Log review prompts for suspicious access: specific questions to ask of your auth, API and admin logs so you can look for unusual use of the credentials a vendor may have held.
- Customer and internal notice templates, plus a post-incident review and a quarterly vendor risk refresh: draft clear messages for customers and your team, then capture lessons and keep the inventory current. Edit all wording to fit your facts and have counsel review anything with legal implications.
Inside: Vendor Breach Response Runbook for Small SaaS Teams
- The first 60 minutes: triage questions
- Building a third-party dependency inventory
- Mapping vendor to data and secrets exposed
- Credential rotation order and checklist
- Log review prompts for suspicious access
- Customer and internal notice templates
- Post-incident review template
- Quarterly vendor risk refresh routine
Not for: Not for large organisations with a staffed security or incident response team and established vendor risk program, who likely have this covered. It is also not a substitute for legal counsel, a forensic investigation or your regulatory obligations: it does not provide legal advice, it cannot tell you what notification laws apply to you, and it does not guarantee compliance or any particular outcome.
Free sample chapter
The first 60 minutes: triage questions
A vendor has announced a breach. You have an email, a status page post, or a link in a group chat. You don't yet know if it affects you. This section gets you from "something happened" to "we know what we're doing next" in one hour, without rotating everything in a panic or ignoring it.
Rule for the hour: answer questions first, change things second. The exception is a secret you can confirm was exposed; rotate that immediately (the full order is in a later section).
Minute 0-10: Open the incident and assign roles
- Create one place for notes. A doc or a channel named
incident-vendor-YYYYMMDD. Everything goes there with timestamps. - Assign three roles (one person can hold two in a team of 2-5):
- Lead: makes decisions, keeps the clock.
- Investigator: reads the vendor notice, checks your systems.
- Communicator: drafts internal and customer messages, handles inbound questions.
- Save the source. Paste the vendor's announcement URL and a copy of the text into the doc. Notices get edited, and you'll want the original wording later.
INCIDENT LOG
Vendor:
Announced (vendor's timestamp + timezone):
Source URL:
We learned of it at:
Lead / Investigator / Communicator:
Status: TRIAGE
Minute 10-30: Answer the six triage questions
Write one-line answers. "Unknown" is a valid answer, but it must come with an owner and a way to find out.
- Do we use this vendor, and for what? Check your inventory sheet (built in the next section). No inventory yet? Search your password manager, billing statements, SSO app list,
.envfiles and CI secrets for the vendor name. - What did the vendor say was affected? Separate their wording into: systems accessed, data types, time window, and whether they've confirmed customer data was involved. Note vague phrases ("a subset of customers", "limited access") and treat them as unknown, not as reassurance.
- What do we send them? Customer data, employee data, source code, internal docs, payment data, or only metadata?
- What credentials do they hold or can they reach? API keys you gave them, OAuth tokens, SSO/SAML config, webhook signing secrets, service accounts, and keys pasted into their documents or pages.
- What can their access reach in our systems? An auth provider may reach every login. A docs tool may hold pasted credentials. A billing provider may reach customer payment references.
- Did the exposure window overlap with our usage? If the vendor says access occurred in a given date range, did we have an active integration or stored data then?
Worked example. Vendor: a hosted documentation platform. Announcement says an attacker accessed internal storage; some customer content may have been viewed.
Q1 Use it? Yes, public docs + internal runbooks (owner: Priya)
Q2 Affected: storage access, "customer content", window unclear -> UNKNOWN
Q3 We send: page content, editor emails
Q4 Credentials: API token for CI doc publishing; SSO via Google
Q5 Reach: token can publish to docs; no prod access
Q6 Window: we've used it for 2 years -> assume overlap
Likely exposure: internal runbooks (check for pasted secrets), editor emails
Minute 30-45: Classify and decide
Choose one level. When in doubt, pick the higher one for the first hour; you can downgrade later with evidence.
| Level | Meaning | Action |
|---|---|---|
| A: Confirmed | Vendor says our data or credentials were exposed, or we find evidence | Rotate exposed secrets now; start log review; prepare customer notice |
| B: Possible | We use the vendor, scope unclear | Rotate high-privilege secrets; review logs; request details from vendor; draft notice, don't send |
| C: Not affected | No use, or affected product/feature not used | Record reasoning; re-check in 24 hours |
Quick-decision checklist:
Minute 45-60: Contact, communicate, schedule
- Ask the vendor for specifics. Send it from your account's support channel or security contact:
Subject: Security incident inquiry - [Account/Workspace name]
We use [product] under account [ID/email]. Regarding your notice dated [date]:
1. Was our account's data or any credential associated with it accessed?
2. What is the exposure time window?
3. Which secrets or tokens do you recommend we rotate?
4. Are there indicators of compromise (IPs, user agents) we should search for?
Please reply with a named contact and expected update time.
- Post an internal update (even if the only news is "investigating"):
[Time] Vendor incident: [Vendor]. Level: [A/B/C].
Known: [one line]. Unknown: [one line].
Doing now: [rotation / log review / vendor contact].
Please do not: post about this publicly or message customers.
Next update: [time, within 2 hours].
- Set the next checkpoint on the calendar. Vendors update notices for days.
Common mistakes
- Rotating everything at once. You break production and lose track of what mattered. Rotate by exposure and privilege.
- Trusting "no evidence of customer data access." That means they haven't found it, not that it didn't happen. Treat as Level B.
- Forgetting secrets pasted in docs, tickets or chat. Search the vendor's own tools.
- No timestamps. You'll need them for the review and any customer questions.
- Telling customers too early or never. Draft early; send only what you can state accurately. Templates come later in this playbook.
Instant download. 14-day refund, no questions asked. Prices include any applicable VAT.
Questions
Does this tell me whether I'm legally required to notify customers or regulators?
No. The runbook helps you work out what was exposed and draft communication, but it is not legal advice. Notification duties depend on your jurisdiction, contracts and the data involved, so check with qualified counsel. The notice templates are starting drafts, not approved legal wording.
Will it work with the specific vendors I use?
It is vendor-agnostic. The process and worksheets apply whether the affected provider handles authentication, documentation, billing or content. You fill in your own services, data and secrets, so the specifics come from your inventory rather than from assumptions about any one company.
How much time do I need to set it up before an incident?
The inventory and vendor-mapping worksheets are the main upfront work, and how long they take depends on how many vendors you use. Doing them before an incident is what makes the first hour faster. If you haven't, the runbook still works mid-incident, just with more filling in on the spot. The free sample chapter lets you judge the format before buying.
This guide was researched and written with the help of AI and reviewed by an automated quality check. It is general educational information, not professional advice.