Admin Cognito Hardening¶
Date: 2026-06-25 Status: Accepted for the first paid pilot. Roadmap item: EP8-T6.
Decision¶
Production admin Cognito configuration is accepted for the first paid pilot.
The production admin user pool is staff-only and MFA-protected. The production admin client has hosted OAuth redirects disabled and no callback/logout URLs, so there are no placeholder admin redirect URLs to remove before launch.
Verified Controls¶
| Area | Accepted posture |
|---|---|
| Admin pool creation | Staff users are created by operators only; self sign-up is disabled. |
| MFA | Software-token MFA is required on admin user pools. |
| OAuth redirects | Admin clients do not use hosted OAuth flows. |
| Callback URLs | Admin clients have no callback URLs. |
| Logout URLs | Admin clients have no logout URLs. |
| Identity providers | Admin clients use only Cognito. |
| Runtime config | Web-admin receives admin pool/client ids, region, and API URL only. |
| Authorization | Backend admin endpoints still require the Cognito ADMIN group. |
Evidence¶
- Architecture runbook:
docs/runbooks/admin-cognito-auth.md. - Production Terraform:
terraform/aws-production/main.tf. - Production backend runtime contract:
terraform/aws-production/runtime.tf. - Architecture guard:
Cognito auth email infrastructure > documents admin Cognito access controls and production redirect posture.
Remaining Boundary¶
This closes the admin Cognito hardening gate for EP8-T6. Later EP8 records cover integration domain consistency and release worktree hygiene.