Chuyển tới nội dung chính

Sessions (sessions)

Mỗi bản ghi là một phiên đăng nhập trên một thiết bị, gắn với một refresh token. Cho phép đăng nhập nhiều thiết bị, thu hồi từng phiên và giới hạn số phiên.

  • Nguồn schema: session.schema.ts
  • Phân loại dữ liệu: có dữ liệu cá nhân gián tiếp (ipAddress, userAgent) và giá trị băm của refresh token.
  • Soft-delete: schema không khai báo, nhưng plugin thêm isDeleted và deletedAt vào mọi schema. Phiên bị xóa thật bằng deleteOne hoặc deleteMany (sessions.service.ts), không dùng xóa mềm.

Data dictionary​

FieldTypeRequiredDefaultRàng buộcÝ nghĩa
userIdObjectIdCó—ref: UserNgười sở hữu phiên
refreshTokenStringCó—ẩn mặc định khi truy vấn; uniqueCùng giá trị với refreshTokenHash (HMAC-SHA256 của refresh token), không phải token thô. Giữ lại tên field cũ
refreshTokenHashStringCó——HMAC-SHA256 của refresh token, dùng để tra cứu phiên
userAgentStringCó——Chuỗi User-Agent của thiết bị đăng nhập
ipAddressStringCó——Địa chỉ IP lúc đăng nhập
expiresAtDateCó——Thời điểm phiên hết hạn
isActiveBooleanKhôngtrue—false khi phiên bị vô hiệu hóa nhưng chưa bị xóa
lastUsedAtDateKhông(fn)—Lần dùng gần nhất, dùng để chọn phiên cũ nhất khi vượt giới hạn
createdAtDateKhông——Thời điểm tạo, do timestamps
updatedAtDateKhông——Thời điểm sửa gần nhất, do timestamps
isDeletedBooleanCófalsethêm bởi plugin xóa mềmCờ xóa mềm do plugin thêm vào, xem database-overview
deletedAtDateKhôngnullthêm bởi plugin xóa mềmCờ xóa mềm do plugin thêm vào, xem database-overview

Indexes​

KeysThuộc tínhMục đích
{ refreshToken: 1 }uniqueRàng buộc unique trên token đã băm
{ refreshTokenHash: 1 }—Tra cứu phiên theo hash (khai báo thường, xem Known Limitation)
{ expiresAt: 1 }—Index thường từ index: true (xem Known Limitation)
{ userId: 1, isActive: 1 }—Đếm và liệt kê phiên đang hoạt động của người dùng
{ userId: 1, expiresAt: 1 }—Liệt kê phiên còn hạn của người dùng
{ expiresAt: 1 }TTL 0sKhai báo TTL expireAfterSeconds: 0 (xem Known Limitation)
{ refreshTokenHash: 1 }unique, sparseKhai báo unique sparse (xem Known Limitation)

Known Limitation: index trùng key pattern​

Schema khai báo hai cặp index cùng key nhưng khác option:

KeyKhai báo 1 (từ index: true trên field)Khai báo 2 (gọi SessionSchema.index)
{ expiresAt: 1 }index thườngTTL expireAfterSeconds: 0
{ refreshTokenHash: 1 }index thườngunique: true, sparse: true

MongoDB không cho hai index cùng key pattern với option khác nhau cùng tồn tại. Một trong hai lần tạo sẽ lỗi, và index nào thắng phụ thuộc thứ tự Mongoose gửi lệnh tạo. Hệ quả có thể là TTL không tồn tại (phiên hết hạn không tự bị xóa) hoặc không có ràng buộc unique trên refreshTokenHash.

Trạng thái: Chưa xác minh. Cần chạy db.sessions.getIndexes() trên database thật. Code có hàm xóa phiên hết hạn thủ công (expiresAt: { $lt: now } ở sessions.service.ts) nên rủi ro bị giảm nhẹ, nhưng chưa kiểm tra có được gọi định kỳ không.

Quan hệ​

FieldLoạiĐích
userIdReference (ObjectId)users

Ví dụ document​

{
"_id": "665f1a2b3c4d5e6f70819401",
"userId": "665f1a2b3c4d5e6f70819201",
"refreshTokenHash": "<hmac-sha256-hex>",
"userAgent": "Mozilla/5.0 (Macintosh) Example",
"ipAddress": "203.0.113.10",
"expiresAt": "2026-10-08T03:00:00.000Z",
"isActive": true,
"lastUsedAt": "2026-10-01T03:00:00.000Z",
"isDeleted": false
}

Vòng đời​

  • Tạo: khi đăng nhập thành công. Giá trị lưu là HMAC-SHA256 của refresh token, khóa là secret của refresh token (sessions.service.ts). Token thô không được lưu.
  • Dùng: tra cứu theo hash, điều kiện isActive: true và expiresAt chưa qua. Hàm updateLastUsedAt cập nhật lastUsedAt.
  • Giới hạn: enforceSessionLimit mặc định giữ tối đa 5 phiên đang hoạt động mỗi người, xóa các phiên có lastUsedAt cũ nhất.
  • Kết thúc: đăng xuất (deleteSession hoặc deactivateSession), thu hồi toàn bộ phiên của người dùng (isActive: false), hoặc hết hạn.