API Key and Token Service  ·  View 06 of 22  ·  Act 3 · Structure

Layered Architecture

Six layers, and the rule that no arrow in the data plane points upward.

Editable source SVG draw.io All views
Experience Developer console keys, scopes, rotation Management API REST, tenant-scoped Partner check endpoint live-or-not only Control plane Issuance entropy, digest, quota Scope registry versioned vocabulary Rotation and expiry overlap windows Revocation intake single and bulk Leak-response policy per tenant, per class Propagation Revocation log append-only, ordered Revocation feed push + poll fallback Snapshot builder per region, 60 s Staleness heartbeat proves the feed lives Data plane Verification library in-process Verification sidecar Envoy ext_authz Verification API fallback for thin clients Staleness guard fail closed at 120 s State Credential store Cloud Spanner Usage counters Bigtable, lossy Audit store BigQuery + GCS Cryptographic base Cloud KMS / HSM versioned pepper Envelope keys per tenant Workload identity mTLS between planes issue record append publish overlay warm start sampled Layered Architecture — the control plane writes, the data plane reads Application we own Interface / broker Security / platform Data store Queue / topic Decision point synchronous event / async batch Nothing in the data plane draws an arrow upward. A verification never calls the control plane. v 1.0 · owner Security Platform Architecture · date 2026-09

The load-bearing layer

  • Propagation is the layer a first draft omits. Without it the choice is between a network call on every request and a credential that cannot be revoked; with it, neither.
  • The staleness heartbeat is in this layer rather than in observability, because its absence changes behaviour rather than raising a ticket.

Reading the direction

  • Control plane writes downward into state; propagation carries state sideways into the data plane; the data plane reads and emits telemetry. No verification ever calls upward.
  • The cryptographic base is drawn beneath state deliberately: the pepper is not in the store it protects.