Internal Auth And Admin Delegation Chain
Internal auth protects service-to-service and operator admin flows with signed headers, service identities, nonce replay protection, route identity policies, and audit records.
Purpose
Use this page when an admin action fails before reaching the handler, when rotating internal keys, or when debugging the panel-to-login-to-control-plane delegation chain.
Actors And Identities
Control panel signs operator actions as the control-panel identity. Login server owns account and admin API boundaries. Control plane owns coordination and Redis cleanup routes. Game server owns game-specific admin surfaces.
Signed Header Contract
Signed requests include service identity, key id, timestamp, nonce, content hash, and signature. The verifier checks identity, key, timestamp skew, content hash, and signature before route code runs.
Key IDs And Rotation
Key ids allow a route to accept multiple configured signing keys during rotation. Unknown key ids should fail clearly. Do not rotate the secret in only one service.
Nonce Scopes
Nonce replay keys are scoped by service and route owner. A repeated nonce inside the skew window should be rejected before side effects occur.
Delegation Flow
Panel admin/account actions route through signed login-server endpoints. Login can delegate specific Redis cleanup to control plane. Each hop should produce its own audit or status record so operators can find where a failure happened.
Failure Map
Missing headers, bad signatures, timestamp skew, nonce replay, disallowed identity, unsupported RPC version, operator token failure, and handler validation failure are distinct. Debug them in that order.