On this page
- Quick read
- Readiness check
- Inventory where credentials are shared today
- Replace the shared secret with a named account
- Use a secret manager for the handoff
- Redact before pasting logs or screenshots
- Rotate on any suspected exposure
- Review the sharing pattern each quarter
- Train the team on the handoff
- Role brief
- Frequently asked questions
- Sources
Is the handoff ready?
Use these checks before access expands or the first ticket begins.
Account
Ready: Each engineer has a named staging account.
Needs work: A shared password used by the whole team.
Handoff
Ready: A secret-manager reference and expiry are recorded.
Needs work: A password pasted into a ticket or chat.
Evidence
Ready: Logs and screenshots are redacted before sharing.
Needs work: A raw log with tokens attached to the ticket.
Review
Ready: Access is removed when the ticket closes.
Needs work: A grant that remains active after the work ends.
Use a secret manager for the handoff
When a credential must be shared, put it in the approved secret manager and send a reference, not the value. Set an expiry that matches the task and revoke it when the task ends. Record who requested the secret and which ticket it supports. The ticket should show the reference and the expiry, never the secret itself.
Check that the secret manager is available from the engineer's environment before the handoff. A reference that the engineer cannot open is not a handoff. Test the access path during onboarding and record the result. If the manager is down, the fallback should be a time-bound access grant, not a pasted password.
Redact before pasting logs or screenshots
Logs and screenshots are a common source of credential leaks because they capture more than the author intended. Use a redaction filter before attaching a log, and crop screenshots to the relevant region. Check the edges for tokens, email addresses, and connection strings. A manual glance is not a reliable redaction method.
If the evidence cannot be redacted without destroying the point, describe the finding in text and keep the raw evidence in the approved incident system. Record that the raw evidence exists and who can access it. The ticket should contain only what the reviewer needs to understand the issue. Delete the raw copy from the ticket after the reference is recorded.
Rotate on any suspected exposure
Treat a credential pasted into a ticket as compromised, even if the message was deleted quickly. Rotate the secret, revoke the old value, and confirm that dependent services still work. Record the exposure time, the audience, and the rotation time. Deleting the message is not a remediation.
Check whether the secret was copied into a log, a backup, or a vendor tool that the team does not control. If it was, the rotation may need to include downstream systems. Notify the client security contact when the credential belongs to them. A quiet rotation without a record leaves the next responder without context.
Review the sharing pattern each quarter
Review the credential inventory and the access grants each quarter. Look for secrets that are still shared, grants that outlived their ticket, and accounts that no one recognizes. Remove what is no longer needed and record the removal. The review should take less than an hour if the inventory is current.
Compare the review with the incident log and the access log. A credential that was rotated after an incident should not reappear in a ticket. If the same practice keeps returning, change the onboarding material or the ticket template. The control is only working if the behavior changes.
Train the team on the handoff
Include the credential handoff in onboarding and practice it with a fake secret. Ask the new engineer to request access, retrieve the secret, use it, and revoke it. Observe where they hesitate and fix the instructions. A practice run is safer than discovering the gap during an incident.
Tell the team what to do if they see a secret in a ticket. Give them a short path to report it, rotate it, and record the exposure. Do not punish the person who reports a mistake. A culture that hides leaks will produce longer exposures.
Copy-ready brief
Put the operating agreement in writing.
The engineer requests a named account and a short-lived secret reference.
The client owner approves the minimum role and the expiry.
The client security owner confirms rotation and removal.
Frequently asked questions
Is a shared staging password acceptable?
Only as a documented exception with a compensating control, a short rotation period, and a named review date.
What should be pasted into a ticket?
A secret-manager reference and expiry, never the credential value. Redact logs and screenshots before attaching them.
What if a secret was already exposed?
Rotate it, revoke the old value, verify dependent services, and record the exposure and rotation times.
Sources
- OWASP Application Security Verification Standard
Authoritative guidance used to frame this field guide.
- CISA Secure by Design
Authoritative guidance used to frame this field guide.
- NIST Secure Software Development Framework
Authoritative guidance used to frame this field guide.
