Lesson 4 of 4 · 25 min

Treat a leaked credential as a lifecycle incident

Plan revocation, replacement and evidence review for an exposed secret.

Mechanism and reasoning

A credential grants authority. When it is exposed, deleting the visible copy does not remove copies already obtained by others. The response must revoke or otherwise invalidate the old authority, replace legitimate use and investigate the exposure window. The exact order depends on the credential and service impact.
Inventory consumers before rotation. A shared static key may be used by several services, scheduled jobs and manual tools. Rotating without knowing those consumers can cause an outage. That does not justify leaving an exposed credential active indefinitely. Use the provider's supported overlap or emergency-revocation process and state the trade-off.
Short-lived credentials reduce the time a stolen value remains useful, but they are not harmless. An attacker may use them immediately or use their authority to create persistence. Scope and trust policy still matter. The ability to mint new credentials can be more important than the lifetime of one token.
Log access and administrative changes without logging the secret itself. Evidence should include credential identifier, actor, target, timestamps and action results where available. Missing logs do not prove no misuse. State the observed coverage and retention limits.
After replacement, verify both sides: legitimate consumers work with the new credential, and the old one is rejected. Check for related credentials, derived sessions and policy changes that may outlive the original value. In an interview, separate containment, service recovery and investigation rather than calling rotation the entire response.

Exposure timeline

Teaching incident: a deployment key with read access to one private repository is accidentally included in a public build log at 09:00. The log is removed at 09:20. Security discovers the exposure at 09:30. The key is revoked at 09:35 and a replacement reaches the legitimate deployment runner at 09:45.
The visible log existed for twenty minutes, but the old credential remained valid for thirty-five minutes after exposure. A copied value could be used after the log disappeared. The investigation window should not end at 09:20. It should include the period in which the credential could be used, plus relevant evidence about earlier exposure or derived access.
TimeEventSecurity meaning
09:00Key appears in public logAuthority may be copied
09:20Log removedVisible copy reduced; old key still valid
09:30Incident detectedBegin containment and evidence preservation
09:35Old key revokedNew use of that key should fail
09:45Runner uses replacementLegitimate service recovery verified
The key's scope limits the immediate authority, but the repository contents may include additional secrets or sensitive code. Review what the key could read, not just its label. If the exposed credential could write workflows or create new tokens, investigation must include those persistent changes. A read-only key has a different risk path from a deployment administrator.

Consumer migration plan

For a planned non-emergency rotation, a service may support two valid keys during a short overlap. Deploy the new key to known consumers, verify successful use, then revoke the old key and test rejection. During an active exposure, keeping both valid longer increases risk. The incident owner may choose immediate revocation and accept a bounded outage. State the reason and restore service with the least authority needed.
A consumer inventory can record service, credential reference, owner and last observed use. It should not contain the secret value. A scheduled weekly job may not reveal itself during a ten-minute smoke test, so historical usage and configuration references matter. After revocation, watch for legitimate failures that reveal an overlooked consumer. Do not re-enable the exposed key merely to make that failure disappear.

Verification artifact

CheckExpected resultWhat a failure means
New credential from approved runnerRequired operation succeedsReplacement or scope may be wrong
Old credential test in controlled environmentAuthentication deniedRevocation may be incomplete or delayed
Audit review for exposure windowKnown and unexplained actions separatedFurther investigation needed
Administrative policy reviewNo unauthorized persistent changesScope of incident may exceed one key
Log scan after repairSecret values absentThe leak path remains open if values recur
The controlled rejection test should follow provider policy and avoid printing the key. Use a safe validation mechanism or provider status where possible. The goal is to verify invalidation, not spread the credential into more logs.
The prevention should target the leak path. If a build step prints all environment variables, replacing the key alone leaves the same behavior. Remove broad environment dumping, limit which jobs receive secrets and test log redaction with a non-secret canary value. Secret scanning can help detect recurrence, but it should not become the sole prevention for a known logging defect.
In an interview, be explicit about uncertainty. 'No suspicious actions appeared in the available audit logs' is a bounded statement. 'The key was never used' is stronger and may be unsupported if logs are incomplete or retention is short. Good incident communication states the evidence window and what the credential could do.

Worked example

Teaching authority calculation: key K1 can read repository A but cannot write it. Repository A contains a workflow file that references, but does not reveal, another secret. The immediate confirmed exposure is K1's read authority. Do not claim the referenced secret leaked unless its value or an access path was exposed. Revoke K1, inspect repository-read evidence and review actual contents for additional secrets. Keep confirmed scope separate from possible follow-on risk.

Exercise

An exposed API key is removed from a document but remains active. The team sees no suspicious calls in seven days of available logs, while the document may have been public for thirty days. Write the containment action and a bounded evidence statement.

Model solution and rubric

Invalidate the old key through the provider's supported process and migrate authorized consumers to a scoped replacement. Verify old-key rejection and new-key function. State that no suspicious calls were found in the seven-day available log window; the prior twenty-three days are not covered by that evidence. Review authority and persistent changes according to the key's scope. Deleting the document is not revocation.
Score out of four: one point for the correct result, one for showing the intermediate reasoning, one for identifying the stated failure case, and one for a verification that could disprove the answer. Do not award the reasoning point for a tool name alone.

Failure modes and misconceptions

Misconception 1: removing the exposed file contains the secret. Copies can remain usable until authority expires or is revoked. Misconception 2: no suspicious logs proves no misuse. The conclusion is limited by logging coverage, retention and what actions the provider records.

Interview probe

Evidence class: recommended. Original practice.
What is missing from 'we rotated the leaked key, incident closed'?
Strong answer: Consumer verification, old-key invalidation, scope and exposure review, possible persistent changes and a fix for the leak path. I would distinguish restored service from completed investigation and state log coverage limits.
Follow-up: How does your response change if the key can create new credentials?
Weak answer indicators: Deleting the visible copy only; reusing the old key after a consumer breaks; claiming certainty from incomplete logs.

Sources

Technical references: OWASP secrets management; OWASP logging. Sources support the documented mechanisms. The numbers, decisions, rubrics and interview prompts in this lesson are original teaching examples, not measurements or employer question claims.
docsOWASP secrets managementcheatsheetseries.owasp.orgdocsOWASP loggingcheatsheetseries.owasp.org

Checkpoint

The public log is removed, but its exposed key is active. What remains true?

AEvery copied key is invalidatedBA copied value can still exercise its authorityCIts permissions automatically become read-onlyDThe investigation window ends when the log disappears
Sign up free to answer and see why

Checkpoint

Which pair most directly verifies replacement and containment?

ANew key exists and the old document is privateBNo alert fires during one short testCApproved consumers succeed with the new key and the old key is rejectedDConsumers succeed after rotation while the old key is left untested
Sign up free to answer and see why

Checkpoint

Logs cover seven days of a possible thirty-day exposure. Which claim is supported?

ANo misuse happened in thirty daysBThe other twenty-three days were safe because no alert existsCRevocation proves the past was safeDNo suspicious action appeared in the observed seven-day window
Sign up free to answer and see why

Checkpoint

The stolen token expires soon but can create durable credentials. What requires review?

ACredentials and other persistent authority created before expiryBOnly whether the original token has expiredCOnly whether the leaked page is removedDOnly successful calls after the original expiry
Sign up free to answer and see why

Checkpoint

A deployment step prints all environment values. Which repair addresses recurrence?

ARotate frequently while keeping the dumpBRemove the broad dump, restrict secret injection and test logs with a non-secret canaryCRename the replacement variable but retain the dumpDMake the log private while continuing to expose every secret to every job
Sign up free to answer and see why

Explain how you would plan revocation, replacement and evidence review for an exposed secret without reading the solution. State one assumption that could change your answer, and one observation that would make you revise it.

Not yetGetting thereConfident

Wrap-up

  • Revoke authority, restore legitimate use and investigate the actual evidence window. Fix the path that exposed the credential.

Sources

Free to read · better with Enzo

Learn it with Enzo

Save your progress, answer the checkpoints, and let Enzo quiz you on what you just read.