OAuth2 & OpenID Connect
Authorization Code Flow với PKCE, Client Credentials Flow, sự khác nhau giữa OAuth2 (authorization) và OpenID Connect (authentication), và SSO.
"Đăng nhập bằng Google" mà hầu như mọi ứng dụng đều có chính là OAuth2/OpenID Connect — nhưng rất nhiều engineer dùng nó mà không hiểu luồng thật sự đang chạy, dẫn đến triển khai sai (ví dụ bỏ qua PKCE cho mobile app, hoặc nhầm lẫn OAuth2 dùng để authorization với việc nó cũng xác thực được danh tính người dùng). Hiểu đúng bản chất giúp bạn tích hợp đúng và debug được khi có sự cố, thay vì copy-paste code mẫu không hiểu vì sao nó hoạt động.
🎯 Mục tiêu học tập
- Giải thích đúng vai trò của Authorization Server, Resource Server, và Client trong OAuth2
- Triển khai đúng Authorization Code Flow kèm PKCE cho ứng dụng web/mobile
- Phân biệt khi nào dùng Client Credentials Flow cho giao tiếp machine-to-machine
- Giải thích rõ OpenID Connect bổ sung gì cho OAuth2 để giải quyết bài toán authentication
3 vai trò cốt lõi trong OAuth2
- Authorization Server: nơi người dùng đăng nhập và cấp quyền (ví dụ accounts.google.com)
- Resource Server: API chứa dữ liệu được bảo vệ (ví dụ Google Calendar API)
- Client: ứng dụng của bạn, muốn truy cập dữ liệu ở Resource Server thay mặt người dùng
Điều quan trọng cần nhớ: OAuth2 sinh ra để giải quyết bài toán authorization (uỷ quyền) — cho phép ứng dụng A truy cập tài nguyên của người dùng trên hệ thống B mà không cần biết mật khẩu của họ ở hệ thống B — không phải để xác thực danh tính (đó là việc của OpenID Connect, phần cuối module).
Authorization Code Flow + PKCE — luồng chuẩn cho web/mobile app
- Client chuyển hướng người dùng tới Authorization Server kèm
code_challenge(hash của 1 chuỗi ngẫu nhiêncode_verifiermà client tự sinh và giữ bí mật) - Người dùng đăng nhập và đồng ý cấp quyền tại Authorization Server
- Authorization Server redirect về client kèm 1 authorization code ngắn hạn
- Client gửi code này kèm
code_verifiergốc tới Authorization Server để đổi lấy access token (và thường cả refresh token) - Authorization Server kiểm tra hash của
code_verifierkhớp vớicode_challengeban đầu — nếu khớp, trả về token
PKCE (Proof Key for Code Exchange) giải quyết vấn đề: nếu 1 ứng dụng mobile/SPA không
thể giữ bí mật tuyệt đối (client secret có thể bị decompile từ app, hoặc bị lộ qua trình duyệt), kẻ tấn
công đánh cắp được authorization code (qua lỗ hổng khác) vẫn không thể đổi được token vì
không có code_verifier gốc chỉ tồn tại trong bộ nhớ của client hợp lệ. PKCE giờ là khuyến
nghị bắt buộc cho mọi loại client, kể cả server truyền thống có thể giữ bí mật.
Client Credentials Flow — giao tiếp machine-to-machine
POST /oauth/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials&client_id=...&client_secret=...&scope=read:orders
Dùng khi không có người dùng nào đứng giữa — 1 service backend cần gọi API của service backend khác thay mặt chính nó, không thay mặt ai (ví dụ 1 cron job đồng bộ dữ liệu). Đơn giản hơn nhiều so với Authorization Code Flow vì không cần bước redirect người dùng đăng nhập — chỉ cần client id/secret trao đổi trực tiếp lấy access token.
OAuth2 vs OpenID Connect — uỷ quyền vs xác thực
OAuth2 thuần chỉ trả về access token — chứng minh "client này được phép gọi API thay
mặt user", nhưng không có định dạng chuẩn để biết user đó là ai. OpenID Connect (OIDC) là 1 lớp
xây trên OAuth2, thêm ID Token — một JWT chuẩn hoá chứa thông tin danh tính người dùng
(sub, email, name) mà client có thể verify độc lập.
Đây là lý do "Đăng nhập bằng Google" hoạt động: nó dùng OIDC (không phải OAuth2 thuần) để lấy ID Token xác thực danh tính, dù dưới nền vẫn dùng chung luồng Authorization Code Flow + PKCE của OAuth2. Nhầm lẫn phổ biến: dùng access token OAuth2 thuần (dùng để gọi API) để "xác thực" người dùng — sai về bản chất, vì access token không đảm bảo định dạng/nội dung chuẩn để biết chắc chắn danh tính.
🏋️ Bài tập thực hành
Đăng ký 1 OAuth2 Client trên Google Cloud Console. Triển khai luồng đăng nhập đầy đủ: redirect người dùng, nhận authorization code, đổi code lấy access token VÀ id_token, verify chữ ký id_token, giải mã lấy thông tin email/tên người dùng để tạo session trong hệ thống của bạn. Bắt buộc dùng PKCE dù server của bạn có khả năng giữ client secret bí mật. Giải thích bằng lời sự khác nhau giữa access_token và id_token trong response bạn nhận được.
📚 Tài nguyên học tập
-
RFC 6749 — The OAuth 2.0 Authorization FrameworkChuẩn chính thức OAuth2RFC
-
RFC 7636 — PKCEChuẩn chính thức Proof Key for Code ExchangeRFC
-
OpenID Connect — Core 1.0Chuẩn chính thức OpenID ConnectDocs
✅ Tự đánh giá hoàn thành
- Giải thích rõ vai trò Authorization Server/Resource Server/Client bằng ví dụ cụ thể
- Triển khai hoàn chỉnh Authorization Code Flow kèm PKCE, giải thích PKCE chống lại tấn công gì
- Chọn đúng Client Credentials Flow cho bài toán machine-to-machine, không dùng nhầm Authorization Code Flow
- Giải thích rõ ràng OpenID Connect bổ sung gì cho OAuth2, phân biệt access_token và id_token