👋 Chào mừng đến với Nocoem — kiến thức Backend, System Design và lập trình. Khám phá ngay

API Gateway: Khi nào cần sử dụng và những trường hợp phù hợp nhất

Khám phá các trường hợp nên sử dụng API Gateway, lợi ích và những cân nhắc quan trọng khi triển khai trong kiến trúc microservices hiện đại.
Sơ đồ vai trò của API Gateway đứng giữa client và các microservice
API Gateway: Khi nào cần sử dụng và những trường hợp phù hợp nhất
TL;DR: Cổng API (API Gateway) là một lớp trung gian đứng giữa client và các microservice phía sau, gom xác thực (authentication), định tuyến (routing), giới hạn tốc độ (rate limiting) và bộ nhớ đệm (cache) vào một chỗ. Nên dùng khi hệ thống có từ vài microservice trở lên hoặc cần bảo mật/quản lý tập trung. Với hệ thống nguyên khối (monolithic) nhỏ, thêm gateway chỉ khiến mọi thứ chậm và phức tạp hơn.

Giả sử app di động của bạn gọi thẳng tới 5 microservice khác nhau: service người dùng, service đơn hàng, service thanh toán, service thông báo, service tìm kiếm. Mỗi service một địa chỉ, một cơ chế xác thực riêng. Client phải nhớ hết, xử lý hết. Thêm một service mới là phải sửa lại app. Đó chính là lúc bạn cần một cổng API (API Gateway) đứng ra làm đầu mối.

API Gateway là gì?

Nói ngắn gọn, API Gateway là một service đứng giữa client (web, mobile, bên thứ ba) và tập hợp các microservice phía sau. Mọi request từ client đều đi qua gateway trước, gateway xử lý các việc chung (xác thực, định tuyến, giới hạn tốc độ, cache...) rồi mới chuyển tiếp tới đúng service cần gọi.

Với client, gateway giống như một địa chỉ duy nhất. Client không cần biết đằng sau có bao nhiêu service, service nào nằm ở đâu, hay service đó được viết bằng ngôn ngữ gì.

Cách hoạt động

Khi một request tới, API Gateway thường xử lý tuần tự các bước sau:

  1. Xác thực (authentication) token hoặc API key của request.
  2. Kiểm tra giới hạn tốc độ (rate limiting) để chặn client gọi quá nhiều trong thời gian ngắn.
  3. Định tuyến (route) request tới đúng service phía sau, dựa trên đường dẫn (path) hoặc header.
  4. Tổng hợp dữ liệu (request aggregation) nếu client cần thông tin từ nhiều service trong một lần gọi.
  5. Trả kết quả về client, có thể lấy từ cache sẵn để khỏi gọi lại service phía sau.
Client API Gateway Xac thuc, dinh tuyen Cache, rate limit Service A Service B Service C

Khi nào nên dùng API Gateway

Hệ thống có nhiều microservice

  • Ứng dụng của bạn được chia thành nhiều microservice độc lập.
  • Bạn cần một điểm truy cập tập trung để quản lý và điều phối request, thay vì để client tự gọi từng service.
  • Bạn muốn giảm độ phức tạp trong giao tiếp giữa client và service.

Cần xác thực và bảo mật tập trung

  • Bạn muốn triển khai xác thực (authentication) và phân quyền (authorization) ở một nơi duy nhất, thay vì lặp lại logic đó trong từng service.
  • Bạn cần kiểm soát access token và quản lý quyền truy cập tập trung.
  • Bạn muốn che các service nội bộ khỏi bị gọi trực tiếp từ bên ngoài.

Cần tối ưu hiệu năng

  • Bạn cần cache response để giảm tải cho service phía sau.
  • Bạn muốn tổng hợp yêu cầu (request aggregation) để giảm số lần gọi API từ client.
  • Bạn cần cân bằng tải (load balancing) để phân phối request đều giữa các instance của service.

Cần kết hợp dữ liệu (API composition)

  • Bạn muốn gộp dữ liệu từ nhiều service thành một response duy nhất.
  • Bạn cần định dạng lại response cho phù hợp với từng loại client (web khác mobile).
  • Bạn muốn đơn giản hoá giao diện API mà client nhìn thấy.

Khi nào không cần API Gateway

Ứng dụng đơn giản

  • Hệ thống nguyên khối (monolithic) nhỏ gọn, chưa tách microservice.
  • Số lượng API endpoint còn hạn chế.
  • Chưa có nhu cầu bảo mật phức tạp.

Hệ thống chỉ dùng nội bộ

  • Các service chỉ giao tiếp với nhau trong nội bộ, không có client bên ngoài.
  • Đã có cơ chế bảo mật ở tầng mạng (network level) rồi.
Nếu bạn rơi vào nhóm này, thêm API Gateway lúc này chỉ khiến hệ thống có thêm một tầng (layer) phải vận hành mà chưa mang lại lợi ích tương xứng. Bạn hoàn toàn có thể thêm sau, khi hệ thống thực sự lớn lên.

Ví dụ

Để hình dung rõ hơn, hãy thử viết một API Gateway tối giản bằng Node.js và Express. Gateway này xác thực token, sau đó định tuyến request tới đúng service phía sau:

const express = require('express');
const { createProxyMiddleware } = require('http-proxy-middleware');

const app = express();

// Xac thuc tap trung: moi request deu phai qua middleware nay truoc
app.use((req, res, next) => {
  const token = req.headers['authorization'];
  if (!token) return res.status(401).json({ error: 'Thieu token' });
  next();
});

// Dinh tuyen request toi dung microservice phia sau
app.use('/users', createProxyMiddleware({ target: 'http://user-service:3001' }));
app.use('/orders', createProxyMiddleware({ target: 'http://order-service:3002' }));

app.listen(8080, () => console.log('API Gateway dang chay o cong 8080'));

Gọi thử tới gateway khi có token hợp lệ:

curl -H "Authorization: Bearer abc123" http://localhost:8080/users/42
{"id":42,"name":"Nguyen Van A"}

Nếu thiếu token, gateway chặn ngay tại đây. Service user-service phía sau không cần biết gì về việc xác thực:

curl http://localhost:8080/users/42
{"error":"Thieu token"}

Nếu vẫn thấy trừu tượng, hãy hình dung API Gateway giống lễ tân của một khách sạn lớn. Khách (client) không cần biết bộ phận dọn phòng, bếp, hay bảo vệ nằm ở đâu, chỉ cần ra quầy lễ tân và nói yêu cầu. Lễ tân kiểm tra bạn có phải khách đã đặt phòng không (xác thực), rồi mới gọi đúng bộ phận xử lý (định tuyến). Khách sạn có thêm bộ phận mới thì khách vẫn chỉ cần biết mỗi quầy lễ tân, không phải học lại quy trình.

Cạm bẫy và lưu ý thực tế

Độ phức tạp tăng thêm

  • Gateway là thêm một tầng (layer) trong kiến trúc, nghĩa là thêm một thứ phải vận hành và bảo trì.
  • Nếu gateway sập, toàn bộ hệ thống có thể sập theo, đây là rủi ro điểm lỗi đơn (single point of failure - SPOF). Bạn nên chạy nhiều instance gateway phía sau một load balancer để giảm rủi ro này.

Chi phí hiệu năng

  • Mỗi request đi qua gateway sẽ cộng thêm một chút độ trễ (latency) so với gọi thẳng service.
  • Gateway cần đủ tài nguyên (CPU, RAM) và khả năng mở rộng (scalability) để không trở thành nút thắt cổ chai (bottleneck) khi traffic tăng.
Đừng nhét quá nhiều logic nghiệp vụ vào gateway. Gateway nên chỉ lo phần hạ tầng chung (xác thực, định tuyến, cache, rate limit), logic nghiệp vụ vẫn nên nằm trong service tương ứng. Nhét lộn xộn thì gateway sẽ phình to thành một service khổng lồ khó bảo trì, đi ngược lại tinh thần microservices.

Vận hành nghiêm túc

  • Theo dõi (monitor) và ghi log tại gateway giúp bạn thấy toàn cảnh traffic của hệ thống ở một chỗ.
  • Đặt cảnh báo (alert) khi tỉ lệ lỗi hoặc độ trễ tăng bất thường.
  • Cập nhật thường xuyên các dependency và rà soát bảo mật định kỳ, vì gateway là cửa ngõ duy nhất, lỗi ở đây ảnh hưởng toàn hệ thống.

Tóm tắt

  • API Gateway là lớp trung gian gom xác thực, định tuyến, cache, rate limiting vào một chỗ giữa client và các microservice.
  • Nên dùng khi hệ thống có nhiều microservice, cần bảo mật/quản lý tập trung, hoặc cần kết hợp dữ liệu từ nhiều service.
  • Không cần thiết với hệ thống nguyên khối nhỏ hoặc hệ thống chỉ giao tiếp nội bộ.
  • Đánh đổi lớn nhất là thêm độ phức tạp vận hành, thêm độ trễ, và rủi ro điểm lỗi đơn nếu không thiết kế tính sẵn sàng cao (high availability) cho gateway.

Hãy cân nhắc kỹ quy mô (scale), yêu cầu bảo mật và nguồn lực vận hành trước khi quyết định thêm API Gateway vào dự án của bạn.

- Kai

Thấy bài viết hữu ích?

0 lượt thích

Đăng nhận xét