Tôi từng thấy không ít API nội bộ chỉ bảo vệ bằng một cặp username/password gửi kèm mỗi request, qua HTTPS là xong. Nghe có vẻ ổn cho tới khi bạn nhận ra: HTTPS chỉ bảo vệ đường truyền, còn cách bạn xác thực (authentication) mới quyết định ai thật sự vào được hệ thống. Bài này liệt kê những nguyên tắc nền tảng để làm đúng phần xác thực cho API, từ việc nên tránh gì tới cách triển khai cụ thể.
Tránh sử dụng Basic Authentication
Bạn nên tránh sử dụng Basic Authentication và thay vào đó, sử dụng các phương pháp xác thực tiêu chuẩn như OAuth, JWT, v.v.
Basic Authentication (định nghĩa trong RFC 7617) là phương thức xác thực đơn giản: client ghép username:password rồi mã hoá base64, gửi trong header Authorization: Basic .... Điểm cần nhớ: base64 không phải mã hoá (encryption), nó chỉ là một cách biểu diễn dữ liệu, giải mã ngược lại chỉ tốn một lệnh, không cần khoá bí mật nào cả.
echo -n "kai:matkhau123" | base64
Và ai bắt được chuỗi này cũng giải mã ngược lại được ngay, không cần khoá:
echo "a2FpOm1hdGtoYXUxMjM=" | base64 -d
Nói cách khác, Basic Auth giống như bạn viết mật khẩu ra một tờ giấy rồi dán ngay ngoài phong bì thay vì niêm phong nó: ai cầm được phong bì cũng đọc được, dù có "trông" như đã được xử lý qua một bước. Với HTTPS, phong bì (kết nối) được bảo vệ trong lúc di chuyển, nhưng nếu kết nối bị chặn ở bất kỳ điểm nào (proxy log, man-in-the-middle, lỗi cấu hình TLS...), mật khẩu lộ ra ngay lập tức. Đó là lý do nên tránh Basic Authentication bất cứ khi nào có thể.
Những lý do cần tránh sử dụng Basic Authentication:
- Thiếu tính bảo mật: Basic Authentication chỉ mã hoá base64 thông tin đăng nhập, nghĩa là bất kỳ ai chặn được luồng dữ liệu cũng có thể đọc được thông tin đăng nhập và truy cập tài khoản người dùng.
- Thiếu tính toàn vẹn: Phương pháp này không có cơ chế đảm bảo dữ liệu được truyền đi không bị thay đổi. Điều này cho phép kẻ tấn công can thiệp vào dữ liệu để truy cập trái phép hoặc thực hiện các hoạt động độc hại.
- Không đủ mạnh: Basic Authentication chỉ dựa vào thông tin đăng nhập của người dùng. Nếu kẻ tấn công lấy được thông tin này (qua phishing hoặc social engineering), chúng dễ dàng truy cập tài khoản. Vì mật khẩu được gửi lại nguyên vẹn ở mọi request, mỗi request đều là một cơ hội để lộ mật khẩu.
- Không hỗ trợ xác thực đa yếu tố (MFA): Basic Authentication không tích hợp MFA, một biện pháp bảo mật quan trọng để tăng cường bảo vệ chống lại truy cập trái phép.
Ngược lại, các phương thức như OAuth, OpenID Connect và SAML cung cấp các cơ chế xác thực an toàn hơn, thường sử dụng giao thức mã hoá để bảo vệ thông tin đăng nhập, đảm bảo tính toàn vẹn dữ liệu, và hỗ trợ MFA. Vì vậy, chúng là lựa chọn tối ưu và nên được áp dụng thay vì Basic Authentication.
Cơ chế xác thực tiêu chuẩn
Sử dụng các cơ chế xác thực tiêu chuẩn để tạo token, lưu trữ thông tin đăng nhập và xác thực người dùng.
Một số cơ chế phổ biến:
OAuth 2.0: Chuẩn mở cho phép người dùng cấp quyền truy cập tài nguyên cho ứng dụng bên thứ ba mà không cần chia sẻ mật khẩu. Giống như bạn đưa nhân viên giữ xe chiếc "chìa khoá valet" (valet key) chỉ khởi động được xe chứ không mở được cốp: ứng dụng thứ ba chỉ nhận được đúng quyền cần thiết, không cầm luôn mật khẩu gốc của bạn.
- Ví dụ: Đăng nhập bằng tài khoản mạng xã hội như Google hoặc Facebook.
-
OpenID Connect: Lớp xác thực xây dựng trên OAuth 2.0, cho phép người dùng đăng nhập nhiều trang web hoặc ứng dụng bằng một tài khoản duy nhất.
- Ví dụ: Single Sign-On (SSO) trên nhiều nền tảng.
-
SAML: Chuẩn XML cho phép trao đổi dữ liệu xác thực và uỷ quyền giữa các bên, thường dùng trong SSO cho nhiều tổ chức hoặc miền.
-
Băm mật khẩu (password hashing): Sử dụng thuật toán như bcrypt hoặc scrypt để lưu mật khẩu. Đây là điểm hay bị nhầm: bcrypt/scrypt là hàm băm (hash) một chiều, không phải "mã hoá" (encryption). Mã hoá thì giải mã lại được nếu có khoá, còn băm thì không có chiều ngược, chỉ so khớp được. Đó chính là lý do dù dữ liệu bị lộ, mật khẩu vẫn khó bị khôi phục. Bài Hàm băm Bcrypt là gì? giải thích chi tiết cơ chế này.
-
Xác thực hai yếu tố (2FA): Yêu cầu người dùng cung cấp hai hình thức xác minh, chẳng hạn như mật khẩu và mã OTP từ thiết bị di động.
Vì sao token tốt hơn việc gửi lại mật khẩu mỗi request
Điểm khác biệt cốt lõi giữa Basic Auth và các cơ chế token (OAuth, JWT...) nằm ở tần suất mật khẩu "xuất đầu lộ diện":
Basic Auth - gửi lại mật khẩu ở mọi request:
Client -> header Authorization: Basic base64(user:pass) -> Server kiểm tra lại với CSDL ở từng request
Token - đăng nhập một lần, tái sử dụng token:
Client -> đăng nhập bằng user/pass đúng một lần -> Server cấp token có hạn dùng -> Client dùng token đó cho các request tiếp theo (không gửi lại mật khẩu)
Với mô hình token, nếu một request bị lộ, kẻ tấn công chỉ lấy được cái token có hạn dùng ngắn và có thể thu hồi (revoke), chứ không lấy được mật khẩu gốc. Đó là lý do OAuth/JWT được xem là an toàn hơn cho API so với việc gửi username/password ở mọi request.
Giới hạn số lần thử đăng nhập (Max Retry) và cơ chế khoá (Jail)
Các tính năng "Max retry" và "Jail" thường được sử dụng trong cơ chế đăng nhập để tăng cường bảo mật và ngăn chặn các cuộc tấn công bằng cách dùng vũ lực.
-
Max Retry: Hạn chế số lần nhập sai mật khẩu trong một khoảng thời gian nhất định. Sau khi vượt quá giới hạn, tài khoản bị khoá tạm thời (vài phút hoặc vài giờ).
- Ví dụ: Người dùng nhập sai mật khẩu 5 lần sẽ bị khoá tài khoản trong 10 phút.
-
Jail: Chặn địa chỉ IP hoặc tài khoản đã vượt quá số lần đăng nhập sai. Địa chỉ hoặc tài khoản bị khoá trong một khoảng thời gian xác định, giảm nguy cơ tấn công brute-force.
- Ví dụ: Một hacker cố đoán mật khẩu bị chặn IP sau 3 lần thử thất bại.
Về mặt triển khai, logic thường đơn giản: đếm số lần sai theo username (hoặc IP), khoá tạm nếu vượt ngưỡng.
const MAX_RETRY = 5;
const LOCK_MINUTES = 10;
async function handleLogin(username, password) {
const attempts = await getFailedAttempts(username);
if (attempts.count >= MAX_RETRY && !isExpired(attempts.lockedAt, LOCK_MINUTES)) {
throw new Error("Tai khoan dang bi khoa tam thoi, thu lai sau.");
}
const ok = await verifyPassword(username, password);
if (!ok) {
await incrementFailedAttempts(username);
throw new Error("Sai thong tin dang nhap.");
}
await resetFailedAttempts(username);
return createSession(username);
}
Đây là bản đơn giản hoá để dễ hình dung luồng chính; hệ thống thật cần thêm cơ chế chống giả mạo IP, cảnh báo cho người dùng khi tài khoản bị khoá, và cân nhắc kỹ điểm ở mục cạm bẫy bên dưới.
Mã hoá dữ liệu nhạy cảm
Mã hoá dữ liệu là yếu tố quan trọng để bảo vệ dữ liệu nhạy cảm khỏi truy cập trái phép, trộm cắp, hoặc khai thác.
-
Quy trình mã hoá: Dữ liệu dạng văn bản thuần được chuyển thành văn bản mã hoá, chỉ giải mã lại được bằng khoá thích hợp. Khác với băm mật khẩu ở trên, mã hoá (encryption) luôn đi kèm khả năng giải mã ngược - đây chính là điểm khác biệt cần nhớ giữa hai khái niệm.
-
Công cụ mã hoá phổ biến:
- AES (Advanced Encryption Standard): Mã hoá đối xứng (cùng một khoá để mã hoá và giải mã), thường dùng để mã hoá dữ liệu nhạy cảm như thông tin cá nhân lưu trong CSDL.
- RSA (Rivest-Shamir-Adleman): Mã hoá bất đối xứng (khoá công khai để mã hoá, khoá riêng để giải mã), phổ biến khi cần trao đổi khoá hoặc ký số qua kênh không tin cậy.
-
Quản lý khoá: Sử dụng hệ thống quản lý khoá mạnh mẽ (KMS, Vault...) để lưu trữ và bảo vệ khoá mã hoá, tuyệt đối không hardcode khoá trong code.
-
Bảo mật bổ sung:
- Áp dụng kiểm soát truy cập, tường lửa, và hệ thống phát hiện xâm nhập (IDS) để bảo vệ dữ liệu toàn diện hơn.
Ví dụ tối giản với module crypto có sẵn của Node.js để mã hoá một chuỗi nhạy cảm bằng AES:
const crypto = require("crypto");
const key = crypto.randomBytes(32); // 256-bit, thuc te phai lay tu KMS, khong random moi lan chay
const iv = crypto.randomBytes(16); // moi lan ma hoa nen dung IV moi, luu kem ciphertext
function encrypt(text) {
const cipher = crypto.createCipheriv("aes-256-cbc", key, iv);
return Buffer.concat([cipher.update(text, "utf8"), cipher.final()]).toString("hex");
}
function decrypt(hex) {
const decipher = crypto.createDecipheriv("aes-256-cbc", key, iv);
const data = Buffer.from(hex, "hex");
return Buffer.concat([decipher.update(data), decipher.final()]).toString("utf8");
}
const encrypted = encrypt("012345678900");
console.log(encrypted);
console.log(decrypt(encrypted));
Đây là ví dụ đơn giản hoá để minh hoạ ý tưởng mã hoá đối xứng; bản thật cần lưu iv kèm ciphertext (vì cần nó để giải mã) và lấy key từ một hệ thống quản lý khoá thay vì random mỗi lần chạy chương trình.
Cạm bẫy và lưu ý thực tế
- "Có HTTPS là đủ an toàn": HTTPS chỉ bảo vệ dữ liệu trên đường truyền. Nếu cơ chế xác thực yếu (như Basic Auth), mật khẩu vẫn lộ ngay khi request tới được server qua proxy log, lỗi cấu hình TLS, hay bị log nhầm ở tầng ứng dụng.
- Nhầm băm với mã hoá: đừng "mã hoá" mật khẩu bằng thuật toán có thể giải mã ngược (kể cả AES). Mật khẩu phải được băm một chiều bằng bcrypt/scrypt/Argon2, không phải mã hoá.
- Jail theo IP có thể bị lợi dụng ngược: nếu chỉ khoá theo IP, kẻ tấn công dùng nhiều IP khác nhau để né; nếu chỉ khoá theo tài khoản, kẻ xấu có thể cố tình đăng nhập sai liên tục để khoá tài khoản người khác (một dạng từ chối dịch vụ - DoS). Thường cần kết hợp cả hai, cộng thêm CAPTCHA khi nghi ngờ.
- Tự chế thuật toán mã hoá/ký riêng: đừng tự nghĩ ra thuật toán mã hoá của riêng bạn. Dùng thư viện đã được kiểm chứng (thư viện crypto chuẩn của ngôn ngữ, hoặc các chuẩn như AES, RSA đã nêu ở trên).
- Hardcode khoá bí mật trong code: khoá mã hoá, JWT secret hay API key nằm thẳng trong source code (và lỡ commit lên git) là lỗi rất phổ biến. Luôn đưa vào biến môi trường hoặc hệ thống quản lý khoá riêng.
Tóm tắt
- Basic Authentication chỉ mã hoá base64, không phải mã hoá thật; giải mã ngược chỉ tốn một lệnh, nên cần tránh dùng cho API.
- OAuth 2.0 là khung uỷ quyền, OpenID Connect mới là lớp xác thực xây trên OAuth 2.0; SAML là lựa chọn khác cho SSO ở quy mô tổ chức.
- Cơ chế dựa trên token giúp mật khẩu chỉ "xuất hiện" một lần khi đăng nhập, thay vì gửi lại ở mọi request như Basic Auth.
- Max retry và jail giúp chặn brute-force, nhưng cần cân bằng để tránh bị lợi dụng làm công cụ khoá tài khoản người khác.
- Băm mật khẩu (bcrypt/scrypt) khác với mã hoá dữ liệu (AES/RSA): băm là một chiều để lưu mật khẩu, mã hoá thì giải mã lại được nên dùng cho dữ liệu nhạy cảm khác cần đọc lại.
Nguồn tham khảo
- RFC 7617 - The 'Basic' HTTP Authentication Scheme, định nghĩa chính thức của Basic Authentication.
- RFC 6749 - The OAuth 2.0 Authorization Framework.
- OWASP Authentication Cheat Sheet - khuyến nghị thực hành xác thực, bao gồm giới hạn số lần thử đăng nhập.
- Kai