Skip to content

Xác thực người dùng ​

Tính năng này cho phép khách đăng ký, xác minh email, đăng nhập (email hoặc Google), lấy lại mật khẩu và đổi mật khẩu. Trang dành cho người muốn hiểu người dùng đi qua những màn hình nào, và cho developer cần biết mỗi màn hình dùng hook nào.

Vì sao cần ​

Ứng viên phải có tài khoản để ứng tuyển, lưu việc và theo dõi công ty; nhà tuyển dụng và quản trị viên cần đăng nhập để vào khu vực quản trị. Việc gửi mã xác minh qua email giúp bảo đảm tài khoản dùng email có thật.

Đối tượng: khách (đăng ký, đăng nhập), người dùng đã đăng nhập (đổi mật khẩu, đặt mật khẩu), mọi vai trò.

Đánh đổi: access token được lưu trong localStorage nên mọi script trên trang đều đọc được; đây là hiện trạng của code, xem Xác thực.

Giao diện ​

Trang đăng nhập

Trang đăng nhập: form email và mật khẩu, nút đăng nhập Google và đường dẫn tới đăng ký, quên mật khẩu.

Trang đăng ký

Trang đăng ký: họ tên, email, mật khẩu, xác nhận mật khẩu và đồng ý điều khoản.

Hai cách vào: trang riêng và modal ​

Cùng một nghiệp vụ được đưa ra bằng hai giao diện:

Trang riêngModal
Mở bằngVào /login, /registeropenModal("signin" hoặc "signup") từ AuthModalContext
Dùng khiNgười dùng chủ động đăng nhập, hoặc bị chuyển về do phiên hết hạnĐang ở giữa một thao tác cần đăng nhập, ví dụ nộp đơn, theo dõi công ty, dùng chatbot
Sau khi đăng nhậpChuyển tới returnUrl nếu đó là đường dẫn trong site (bắt đầu bằng đúng một dấu /), nếu không thì tới trang mặc định theo vai tròGọi callback onSuccess đã truyền khi mở modal (ví dụ mở hộp thoại ứng tuyển)
Sau khi đăng kýChuyển sang /verify-email?email=...Quay về tab đăng nhập của modal

Các trang (auth) chỉ dành cho khách: layout.tsx chuyển người đã đăng nhập tới trang mặc định của họ.

Luồng nghiệp vụ ​

Sơ đồ rút gọn hành trình của khách; luồng token xem Đăng nhập và làm mới token.

Chức năngMàn hìnhHành vi
Đăng ký/register, tab đăng ký của modalGửi form, thành công thì sang bước xác minh
Xác minh email/verify-email?email=...Nhập OTP 6 số, tự gửi khi đủ 6 số; nút gửi lại có thời gian chờ 60 giây; thiếu email trong URL thì quay về /register; thành công thì sang /login?verified=true
Đăng nhập email/login, modalXem bảng trang mặc định bên dưới
Đăng nhập GoogleNút trên /login và modalGửi credential của Google lên backend rồi xử lý như đăng nhập thường
Quên mật khẩu/forgot-passwordGửi email; luôn hiện thông báo thành công, kể cả khi lỗi, để không lộ email nào đã đăng ký; thời gian chờ 60 giây chỉ đặt khi gửi thành công
Đặt lại mật khẩu/reset-password?token=..&email=..Thiếu token hoặc email thì quay về /forgot-password; thành công thì đếm ngược rồi về /login
Đổi mật khẩuTrang cài đặt hồ sơ; /admin/change-passwordCần mật khẩu hiện tại
Đặt mật khẩuTrang cài đặt hồ sơChỉ cho tài khoản Google chưa có mật khẩu (authProvider là google và hasPassword là false)
Đăng xuấtMenu ở header, layout quản trị, layout HRĐặt cờ đăng xuất rồi gọi POST /auth/logout

Trang mặc định sau đăng nhập theo vai trò:

Vai tròTrang
SUPER ADMIN/admin
HR/admin/resumes
NORMAL USER/

NOTE

Đăng ký bằng Google chưa có: nút Google trên trang đăng ký chỉ hiện cảnh báo "sắp có". Người dùng Google đăng nhập bằng nút ở màn hình đăng nhập.

API liên quan ​

HookEndpoint
useLoginMutation, useGoogleLoginMutationPOST /auth/login, POST /auth/google/login
useRegisterMutationPOST /auth/register
useVerifyEmailMutation, useResendCodeMutationPOST /auth/verify, POST /auth/resend-code
useForgotPasswordMutation, useResetPasswordMutationPOST /auth/forgot-password, POST /auth/reset-password
useChangePasswordMutation, useSetPasswordMutationPOST /auth/change-password, POST /auth/set-password
useGetMeQuery, useLogoutMutationGET /auth/me, POST /auth/logout

Bảng đầy đủ: Endpoint Auth.

Dữ liệu và kiểm tra ​

Quy tắc kiểm tra dữ liệu ở form, gồm mật khẩu 8 đến 128 ký tự cùng các điều kiện về chữ hoa, chữ thường, số và ký tự đặc biệt, nằm ở Endpoint Auth. Dạng dữ liệu người dùng: Model User.

Trường hợp lỗi ​

Tình huốngHành vi
Sai email hoặc mật khẩu, tài khoản có vấn đềToast với error.data.message của backend; không lưu token
Chưa xác minh emailBackend quyết định thông báo; frontend hiện nguyên văn
OTP chưa đủ 6 sốThông báo "chưa nhập đủ mã"
Google không trả credentialToast báo thiếu thông tin đăng nhập từ Google
Phiên hết hạn lúc đang dùngXem Xác thực về các điểm chưa chắc chắn

Test cases ​

TestNội dung
src/components/modals/auth-modal.test.tsxModal hiện đúng ngôn ngữ cho tab đăng nhập và đăng ký; đăng ký xong thì quay về tab đăng nhập
src/components/modals/auth-modal-lazy.test.tsxModal chưa được tải và chưa render trước lần mở đầu tiên; mở thì tải và render, đóng vẫn giữ lại
src/app/[locale]/(auth)/login/page.test.tsxSau khi đăng nhập: đi theo returnUrl nội bộ, bỏ qua returnUrl trỏ ra ngoài site
src/features/auth/redux/auth.slice.test.tsHợp nhất danh sách việc đã lưu; chọn vai trò từ state
src/features/auth/schemas/auth.schema.test.tsQuy tắc kiểm tra dữ liệu của schema xác thực

Chưa có test cho: luồng làm mới token, trang xác minh email, quên và đặt lại mật khẩu, đổi và đặt mật khẩu, đăng nhập Google.

Source code liên quan ​

Tài liệu backend: Auth và phiên và Use case xác thực.

Đọc tiếp: Đăng nhập và làm mới token, Phân quyền, Vai trò người dùng.

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code