Man hinh setup lan dau Aura CMS cho superadmin
CMS setup lan dau

DINHDANH Creator · Bài X11 · Xử lý sự cố

CMS không login /
quên superadmin

Không vào được /{url}/cms - setup lần đầu, sai mật khẩu, hoặc hết session. Reset phải qua API/platform, không tự “sửa login.json”.

Mục tiêu: Phân biệt setup lần đầu vs login thường; dùng đúng role (T07); reset mật khẩu qua platform - không invent.

Trước: G01, T07, T04 · Sau: X12

UI: /{url}/cms · form setup superadmin · Username · Password · Confirm · đăng nhập · Backend · Add admin

1. Sơ đồ chẩn đoán

Mở https://site/{url}/cms
→ Lần đầu (chưa có admin): badge setup · form tạo superadmin
Username · Password · Confirm → tạo user đầu tiên (role superadmin)
→ Đã có user: form đăng nhập Username / Password
→ Sai pass: không đọc login.json (T04) · không AI writeFile reset
Còn superadmin khác → đổi pass qua API changePassword hoặc Add admin từ Backend
→ Hết phiên: kiểm tra còn đăng nhập admin thất bại → đăng nhập lại
→ Mất hết admin: liên hệ hỗ trợ DINHDANH theo policy tài khoản

2. Role liên quan (T07)

RoleCMS loginQuản lý admin
superadminUser setup đầu tiên; toàn quyền CMSregisterAdmin · deleteAdmin · changePassword
adminCRUD nội dung · route · uploadKhông xóa superadmin
userBiên tập nội dung hạn chếKhông quản lý tài khoản
guestKhông vào /cms-

3. Các bước xử lý

Dieu huong CMS sau khi login thanh cong
CMS sau login
  1. Lần đầu: Mở /{url}/cms → điền Username (pattern: chữ, số, _ - .) · Password (độ dài tối thiểu theo form) · Confirm → tạo superadmin.
  2. Quên mật khẩu - còn superadmin khác: Admin đó đăng nhập → tab Creator Backend → Add admin hoặc trang admin dùng API changePassword cho user bị quên.
  3. Phiên hết hạn: Xóa cache tạm trên máy bạn không giúp - đăng nhập lại; sau khi đăng nhập CMS, phiên quản trị được giữ trong trình duyệt và được làm mới sau login.
  4. 404 /cms: Kiểm CMS đã bật (G01); route cms tồn tại; đã Lưu thay đổi sau bootstrap.
  5. AI đề xuất “reset bằng writeFile login.json”: Từ chối - file deny (T04); dùng API auth chính thức.

4. Việc được / không · Bảo mật

Được: setup superadmin lần đầu; thêm admin từ Backend khi còn superadmin; changePassword qua API; đăng nhập lại sau invalidate session.
Không: mở login.json để xem mật khẩu (không xem được mật khẩu gốc); paste mật khẩu plain vào chat AI; tự invent API reset không có trong Aura Storage.

Reset qua platform: nếu mất toàn bộ quyền admin trên link production - ghi ticket support DINHDANH kèm tên link / mã dự án trên DINHDANH và xác minh chủ tài khoản. Không có nút “Quên mật khẩu email” tự động trên mọi cấu hình CMS - phụ thuộc app bạn/AI đã viết.

5. Sự cố · Lời khuyên

Tình huốngXử lý
Form setup không hiện dù “chưa login”Đã có admin trong login.json - dùng form login hoặc reset qua superadmin còn sống
Login OK nhưng CMS trống menuThiếu __cms_manifest__ hoặc CMS chưa bootstrap (G01/T05)
user role không xóa được bàiĐúng T07 - nâng admin hoặc nhờ admin xóa
Áp template (X08) → mất admin cũXóa dữ liệu tạm của dự án - setup superadmin lại trên /cms

6. Checklist

  1. Bạn biết URL đúng là /{url}/cms (không phải /admin tùy app)?
  2. Bạn không cố đọc/sửa login.json?
  3. Bạn có superadmin dự phòng hoặc runbook reset qua Backend?

Tiếp: X12 - Thư viện CDN không chạy