Tích hợp Google (đăng nhập)
Đăng nhập bằng Google ID token, không dùng luồng chuyển hướng OAuth phía server. Nguồn: auth-google.service.ts, route POST /api/v1/auth/google/login (auth endpoints).
Cách hoạt động
- Giao diện lấy ID token từ Google và gửi cho backend.
- Backend gọi
google-auth-libraryverifyIdTokenvớiaudience = GOOGLE_CLIENT_ID. - Từ chối nếu không có payload hoặc
email_verifiedsai (401). - Lấy
sub(thànhgoogleId),email,name,picture(thànhavatar) rồi xử lý theo bảng dưới. - Cấp access token và refresh token như đăng nhập thường (refresh-token).
Cấu hình
| Biến | Ghi chú |
|---|---|
GOOGLE_CLIENT_ID | Dùng làm audience khi xác minh |
GOOGLE_CLIENT_SECRET | Có trong .env.example; chưa thấy dùng trong luồng ID token đã đọc. Chưa xác minh |
Quy tắc và giới hạn
- Tài khoản Google không có mật khẩu; có thể đặt sau bằng
POST /auth/set-password. - Tạo tài khoản mới luôn gán
NORMAL USER. - Route có giới hạn 10 lần mỗi 5 phút.
Xử lý theo trạng thái tài khoản (googleLogin)
| Tình huống | Hành vi |
|---|---|
Đã có tài khoản với googleId này | Đăng nhập |
Chưa có googleId, có tài khoản đang hoạt động cùng email | Liên kết tự động (linkGoogleAccount): đặt googleId và đổi authProvider thành google, giữ nguyên các field khác |
Chưa có googleId, có tài khoản chưa kích hoạt cùng email | Xóa tài khoản chưa kích hoạt đó, rồi tạo tài khoản Google mới (isActive = true, NORMAL USER, password = null) |
| Không có tài khoản | Tạo mới như trên |
Sau đó assertAuthenticatedAccountState chặn tài khoản bị khóa hoặc đang chờ xóa.
Known Limitation
- Liên kết tự động dựa trên việc Google xác nhận
email_verified; người nắm tài khoản Google có email đó đăng nhập được vào tài khoảnlocalcùng email. Đây là hành vi phổ biến, nhưng cần chủ dự án xác nhận là chủ ý. - Phiên của đăng nhập Google được ghi
userAgent = 'unknown'vàipAddress = 'google-login'(giá trị cứng tronggoogleLogin), nên danh sách phiên và dấu vết IP của các phiên này không có thông tin thật (auth-google.service.ts). googleIdcó index unique sparse trong schema (users).