EzyLogin là plugin xác thực cho website xây dựng trên EzyPlatform. Chỉ cần cài đặt plugin, website của bạn có ngay đầy đủ các màn đăng nhập, đăng ký, quên mật khẩu, đăng nhập bằng Google, Facebook hay hệ thống SSO của doanh nghiệp, cùng với xác thực hai lớp và quản lý phiên đăng nhập. Mọi thứ đều được cấu hình trong trang quản trị, bạn không cần viết thêm dòng mã nào.
Bài viết này đi qua EzyLogin theo hai góc nhìn: những gì người dùng nhìn thấy trên website, và những gì quản trị viên điều khiển phía sau trong trang quản trị. Các con số màu đỏ trên mỗi ảnh tương ứng với phần giải thích ngay bên dưới ảnh đó.

Người dùng nhìn thấy gì trên website

Ngay khi được cài đặt, EzyLogin thay website của bạn đảm nhận toàn bộ hành trình tài khoản của người dùng: từ lần đăng ký đầu tiên, những lần đăng nhập hằng ngày, cho tới khi quên mật khẩu hay cần bảo vệ tài khoản chặt chẽ hơn. Các hộp thoại đều mở ngay trên trang người dùng đang xem, nên họ không bị gián đoạn. Phần dưới đây đi lần lượt qua từng màn hình theo đúng thứ tự người dùng thường gặp.

Đăng nhập

Khi người dùng bấm đăng nhập hoặc truy cập một trang cần đăng nhập, EzyLogin hiển thị hộp thoại đăng nhập ngay trên trang hiện tại. Sau khi đăng nhập thành công, người dùng được đưa về đúng trang họ đang xem.
Hộp thoại đăng nhập của EzyLogin
  1. Đăng nhập bằng tài khoản bên ngoài: các nút Google, Facebook, OAuth2.0 khác hoặc SSO chỉ xuất hiện khi quản trị viên đã cấu hình và bật nhà cung cấp tương ứng.
  2. Đăng nhập bằng tài khoản của website: người dùng có thể nhập tên đăng nhập, email hoặc số điện thoại tuỳ theo cài đặt Cho phép đăng nhập bằng trong trang quản trị. Nếu nhập sai mật khẩu quá số lần cho phép, tài khoản sẽ tạm thời bị chặn đăng nhập.
  3. Quên mật khẩu: mở hộp thoại để nhận đường dẫn tạo mật khẩu mới qua email.
  4. Đăng ký: chuyển sang hộp thoại tạo tài khoản mới.

Đăng ký tài khoản

Hộp thoại đăng ký dùng chung bố cục với hộp thoại đăng nhập, nên người dùng dễ dàng chuyển qua lại giữa hai màn.
Hộp thoại đăng ký của EzyLogin
  1. Thông tin tài khoản: các trường tên đăng nhập, email, số điện thoại và tên hiển thị. Quản trị viên quyết định trường nào là bắt buộc trong phần Thông tin đăng ký.
  2. Mật khẩu: người dùng nhập mật khẩu hai lần để tránh gõ nhầm.
  3. Đồng ý điều khoản sử dụng trước khi tạo tài khoản.
Nếu website bật Yêu cầu kích hoạt, EzyLogin gửi email kích hoạt sau khi đăng ký, và người dùng chỉ đăng nhập được sau khi bấm vào đường dẫn trong email. Người dùng chưa nhận được email có thể yêu cầu gửi lại.

Quên mật khẩu

Hộp thoại quên mật khẩu của EzyLogin
  1. Người dùng nhập email đã đăng ký.
  2. Bấm Gửi đi để nhận đường dẫn tạo mật khẩu mới. Đường dẫn này dẫn tới trang đặt lại mật khẩu của EzyLogin.

Xác thực hai lớp (2FA)

Khi quản trị viên cho phép, người dùng có thể bật xác thực hai lớp cho tài khoản của mình. Sau khi nhập đúng mật khẩu, họ phải nhập thêm mã gửi qua email hoặc mã từ ứng dụng xác thực như Google Authenticator hay Microsoft Authenticator. Nhờ vậy, kể cả khi mật khẩu bị lộ, kẻ xấu vẫn không thể đăng nhập.

Đăng nhập từ dòng lệnh (CLI)

Các công cụ dòng lệnh và AI agent (ví dụ công cụ đưa tài liệu lên chợ EzyPlatform) có thể đăng nhập vào website theo chuẩn OAuth 2.0 Authorization Code + PKCE. Công cụ tự mở trình duyệt, người dùng đăng nhập như bình thường rồi phê duyệt trên màn hình dưới đây, nên không cần sao chép token bằng tay.
Màn hình phê duyệt đăng nhập từ dòng lệnh
  1. Tên công cụ đang xin quyền truy cập.
  2. Quyền mà công cụ sẽ có: gọi API thay người dùng, giống như khi đăng nhập trên trình duyệt.
  3. Cảnh báo an toàn: chỉ phê duyệt khi chính bạn vừa chạy lệnh đăng nhập trên máy tính của mình.
  4. Địa chỉ nhận kết quả: luôn là một địa chỉ trên chính máy tính đang chạy công cụ (127.0.0.1 hoặc localhost).
  5. Huỷ hoặc Phê duyệt.
Mỗi lần đăng nhập từ dòng lệnh tạo một phiên đăng nhập riêng, có thể xem và đăng xuất như mọi phiên khác. Tính năng này mặc định tắt và được bật riêng cho người dùng và cho quản trị viên trong Cài đặt thường.

Quản trị viên điều khiển EzyLogin như thế nào

Mọi điều người dùng nhìn thấy ở phần trên đều do quản trị viên quyết định trong trang quản trị: hộp thoại đăng ký có những trường nào, người dùng đăng nhập bằng gì, nút Google hay Facebook có xuất hiện hay không, một tài khoản được đăng nhập trên bao nhiêu thiết bị. Phần này giới thiệu các màn cấu hình theo thứ tự trong menu, từ cài đặt chung, các nhà cung cấp đăng nhập, cho tới SSO và quản lý phiên đăng nhập.

Menu EzyLogin

Sau khi cài đặt, EzyLogin có một nhóm menu riêng trong trang quản trị:
Menu EzyLogin trong trang quản trị
  1. Cài đặt chung và các nhà cung cấp đăng nhập: cài đặt thường, Google, Facebook và các nhà cung cấp OAuth2.0 khác.
  2. Các OAuth2.0 Client ID: các ứng dụng được phép đăng nhập bằng tài khoản trên website của bạn.
  3. SSO: cài đặt SSO và các nhà cung cấp SSO, cho cả người dùng lẫn quản trị viên.
  4. Các phiên người dùng: theo dõi và quản lý các phiên đăng nhập.

Cài đặt thường

Đây là nơi bạn quyết định website hoạt động thế nào với người dùng. Ở đầu trang còn có các trình chạy nền của EzyLogin, gồm trình thu hồi phiên hết hạn, trình đánh chỉ mục OAuth2.0 Client ID và trình tự động gia hạn token cho quản trị viên, kèm nút dừng và khởi động lại.
Cài đặt thường của EzyLogin
  1. Xác thực hai lớp (2FA): cho phép quản trị viên và người dùng tự bật xác thực hai lớp cho tài khoản của mình.
  2. Các đường dẫn: trang chủ, trang đăng nhập, trang báo lỗi đăng nhập và trang kích hoạt tài khoản.
  3. Đăng ký và đăng nhập: yêu cầu kích hoạt tài khoản qua email, cho phép người dùng ẩn danh, cho phép đăng ký, đăng ký mở, đăng nhập và bắt buộc đăng nhập bằng số điện thoại.
  4. Đăng nhập trên nhiều thiết bị: giới hạn số thiết bị được đăng nhập cùng lúc, luôn lưu phiên người dùng, và cách xử lý các thiết bị cũ khi người dùng đăng nhập trên thiết bị mới.
  5. Đăng nhập từ dòng lệnh (CLI): bật riêng cho người dùng và cho quản trị viên.
  6. Bảo vệ tài khoản: danh sách tên đăng nhập không được phép sử dụng (như admin, root), số lần đăng nhập sai tối đa và thời gian chặn đăng nhập sau khi vượt quá.
Bạn có thể nhấn Ctrl + S hoặc Command + S để lưu nhanh. Phía dưới trang là hai nhóm cài đặt quyết định trực tiếp giao diện của các hộp thoại đăng ký và đăng nhập:
Thông tin đăng ký và các cách đăng nhập
  1. Thông tin đăng ký: các trường mà người dùng bắt buộc phải nhập khi đăng ký.
  2. Cho phép đăng nhập bằng: tên đăng nhập, email và/hoặc số điện thoại.

Đăng nhập bằng Google, Facebook và OAuth2.0 khác

Ba màn Cài đặt Google, Cài đặt Facebook và Cài đặt OAuth2.0 khác có cùng cách cấu hình. Bạn tạo ứng dụng ở phía nhà cung cấp, rồi điền thông tin của ứng dụng vào EzyLogin.
Cài đặt Google
  1. Client ID và Client Secret do nhà cung cấp cấp cho ứng dụng của bạn. Client Secret được mã hoá khi lưu và luôn hiển thị dạng ẩn.
  2. Đường dẫn chuyển hướng: sao chép đường dẫn này và khai báo vào cấu hình ứng dụng phía nhà cung cấp.
  3. Cho phép: chỉ khi được bật, nút đăng nhập tương ứng mới xuất hiện trong hộp thoại đăng nhập.
Với Cài đặt OAuth2.0 khác, bạn có thể thêm bất kỳ nhà cung cấp nào hỗ trợ OAuth2.0, bằng cách khai báo thêm đường dẫn xác thực và đường dẫn lấy token.

Biến website thành nhà cung cấp đăng nhập

Không chỉ đăng nhập bằng tài khoản bên ngoài, EzyLogin còn cho phép các ứng dụng khác đăng nhập bằng tài khoản trên website của bạn, theo chuẩn OAuth2.0 hoặc OpenID Connect (SSO).
Các OAuth2.0 Client ID
  1. Thêm mới một ứng dụng được phép đăng nhập.
  2. Bộ lọc: theo dịch vụ (web hoặc quản trị viên), loại ứng dụng (OAuth2.0 hoặc Single Sign On), chế độ nhắc phê duyệt, và từ khoá.
  3. Danh sách ứng dụng cùng Client ID và trạng thái của từng ứng dụng.

SSO (đăng nhập một lần)

EzyLogin hỗ trợ SSO theo chuẩn OpenID Connect theo cả hai chiều, và có thể cấu hình riêng cho người dùng và cho quản trị viên.
Các nhà cung cấp SSO dùng khi bạn muốn người dùng đăng nhập bằng một hệ thống SSO bên ngoài, chẳng hạn hệ thống tài khoản chung của doanh nghiệp:
Các nhà cung cấp SSO
  1. Nhà cung cấp: tên, tên hiển thị và biểu tượng của nút đăng nhập.
  2. Client ID, Client Secret và các phạm vi (scope) cần xin.
  3. Đường dẫn chuyển hướng cần khai báo ở phía nhà cung cấp SSO.
  4. Nhà phát hành (issuer) của nhà cung cấp SSO.
  5. Cho phép để hiển thị nút đăng nhập SSO.
Cài đặt SSO dùng khi chính website của bạn đóng vai trò nhà cung cấp SSO cho các ứng dụng khác:
Cài đặt SSO
  1. URL gốc của nhà phát hành: địa chỉ mà các ứng dụng khác dùng để xác thực với website của bạn.
  2. Thời hạn của các token: access token, refresh token, ID token và pushed authorization request.
  3. Các tham số OpenID Connect được hỗ trợ: response type, grant type, scope, subject type, thuật toán ký ID token, claim và prompt.

Quản lý phiên đăng nhập

Mỗi lần người dùng đăng nhập, kể cả đăng nhập từ dòng lệnh, EzyLogin ghi lại một phiên. Quản trị viên theo dõi toàn bộ các phiên này tại Các phiên người dùng:
Các phiên người dùng
  1. Hành động hàng loạt, ví dụ đăng xuất nhiều phiên cùng lúc.
  2. Bộ lọc theo người dùng, trạng thái và lý do thu hồi.
  3. Danh sách phiên gồm địa chỉ IP, trình duyệt hoặc công cụ đã đăng nhập, trạng thái, lý do thu hồi (người dùng tự đăng xuất, bị quản trị viên đăng xuất, hết hạn, ...) và các mốc thời gian.
Người dùng cũng tự xem được danh sách thiết bị đang đăng nhập và đăng xuất từ xa các thiết bị lạ.

Bắt đầu sử dụng

Bạn không cần cấu hình hết mọi thứ ngay từ đầu. Chỉ với vài bước dưới đây, website đã có đăng ký và đăng nhập hoạt động; các tính năng nâng cao có thể bật dần khi nhu cầu tăng lên.
  1. Cài plugin EzyLogin: trong trang quản trị, mở mục quản lý plugin, tìm EzyLogin trên chợ và cài đặt.
  2. Cấu hình cơ bản: vào EzyLogin → Cài đặt thường, kiểm tra các đường dẫn, quyết định có yêu cầu kích hoạt tài khoản hay không, chọn các trường đăng ký và cách đăng nhập.
  3. Bật các phương thức đăng nhập cần dùng: Google, Facebook, OAuth2.0 khác hoặc SSO.
  4. Tăng cường bảo mật: giới hạn số lần đăng nhập sai, bật xác thực hai lớp và chính sách đăng nhập trên nhiều thiết bị.
  5. Mở rộng khi cần: cấp OAuth2.0 Client ID cho các ứng dụng khác, hoặc bật đăng nhập từ dòng lệnh cho các công cụ và AI agent.