Skip to content
NewSee how fast an edit goes live on this site
Halftone

SecurityEngineering

Our approach to audit logs, part 2

How we make the safe path the easy path.

Our approachto auditlogs, part 2HALFTONE / JOURNAL
Dee Marsh / Jun Calder
Published 2 min read

Credentials never reach the code that runs on your behalf. A broker holds them and hands out short-lived tokens scoped to a single task. This post covers what we changed, why, and what it means for you.

#The constraint

We publish what we change and why. Customers should be able to check our work, not just take our word for it.

We assume something will go wrong and design for recovery. Containment, rollback and clear alerts matter more than any single control.

Security work is mostly about making the safe path the easy path. If doing the right thing takes extra steps, people will eventually skip them.

#What we measured

Every action is attributed to a person or an agent acting for one. The audit log answers who did what, when, and with which permissions.

Permissions only shrink during a run. A task can give up access it no longer needs, but it can never gain access it did not start with.

  • Skip what has not changed
  • Cache what never changes
  • Run independent steps in parallel

#What we would do differently

Credentials never reach the code that runs on your behalf. A broker holds them and hands out short-lived tokens scoped to a single task.

We publish what we change and why. Customers should be able to check our work, not just take our word for it.

We assume something will go wrong and design for recovery. Containment, rollback and clear alerts matter more than any single control.

“Good defaults are invisible until they are missing.”
Bo Lindqvist

#What changed

Security work is mostly about making the safe path the easy path. If doing the right thing takes extra steps, people will eventually skip them.

Every action is attributed to a person or an agent acting for one. The audit log answers who did what, when, and with which permissions.

Permissions only shrink during a run. A task can give up access it no longer needs, but it can never gain access it did not start with.

#Trade-offs

Credentials never reach the code that runs on your behalf. A broker holds them and hands out short-lived tokens scoped to a single task.

We publish what we change and why. Customers should be able to check our work, not just take our word for it.

Diagram of the request path before and after the change
Figure: the request path, before and after.

#What's next

We assume something will go wrong and design for recovery. Containment, rollback and clear alerts matter more than any single control.

Security work is mostly about making the safe path the easy path. If doing the right thing takes extra steps, people will eventually skip them.

Every action is attributed to a person or an agent acting for one. The audit log answers who did what, when, and with which permissions.