Phan Đông GiangPhan Đông Giang
Tất cả bài viết

API key và OAuth: khác nhau ở đâu, dùng khi nào?

Phân biệt key, access token, refresh token và scope; chọn cách cấp quyền phù hợp cho ứng dụng, API AI và workflow tự động.

API key là một secret để dịch vụ nhận diện ứng dụng, project hoặc tài khoản đang gửi request. OAuth là khuôn khổ ủy quyền, trong đó ứng dụng nhận access token để sử dụng tài nguyên theo quyền đã cấp. Key thường thuận tiện cho script và backend; OAuth phù hợp cho tích hợp cần cấp và thu hồi quyền theo ứng dụng hoặc người dùng.

Các công cụ như n8n, OpenClaw thường nhận API key để gọi model. Bạn có thể bắt đầu từ cụm hướng dẫn API LLM. Một số tích hợp hỗ trợ đăng nhập bằng tài khoản qua OAuth; hãy kiểm tra điều kiện của dịch vụ và công cụ, chẳng hạn luồng kết nối Codex với OpenClaw.

Trước tiên, tại sao cần xác thực?

Hãy hình dung mỗi request là một đơn hàng có người chịu phí. Nếu máy chủ không kiểm tra người gửi và quyền được cấp, người lạ có thể sử dụng tài nguyên dưới tên tài khoản khác.

Cơ chế kiểm soát truy cập giúp máy chủ xác định request đến từ đâu, được phép làm gì và chi phí được ghi vào tài khoản nào. Đây là nền tảng của việc hạn chế sử dụng trái phép.

API key và OAuth là hai cách thường gặp trong hệ sinh thái API, nhưng không phải hai tên gọi có thể thay thế nhau. Để chọn đúng, cần hiểu chúng đại diện cho quyền gì và cách vòng đời secret/token được quản lý.

Vậy OAuth và API Key khác nhau thế nào?

Một key thường được phát hành trực tiếp cho ứng dụng hoặc project. Với OAuth, authorization server cấp token theo một luồng ủy quyền. Token có thể đại diện quyền người dùng hoặc quyền của client; scope, thời hạn và quy tắc thu hồi do hệ thống triển khai quy định.

API Key là gì?

API key thường là chuỗi ký tự khó đoán, được cấp để nhận diện bên gọi API và ánh xạ request tới quyền, quota hoặc billing. Key có thể gắn với project, service account hay người dùng tùy dịch vụ; không nên mặc định mọi key đều có toàn quyền.

Ưu điểm là cấu hình đơn giản: ứng dụng gửi key theo header hoặc cơ chế mà API yêu cầu. Nhiều key tồn tại dài hạn, nhưng dịch vụ cũng có thể hỗ trợ ngày hết hạn, scope hoặc giới hạn quyền. Khi key lộ, người giữ nó có thể thực hiện các hành động trong phạm vi đã cấp, nên cần thu hồi và thay key ngay.

Ví dụ hình thức một key giả:

Sk-EXAMPLE_NOT_A_REAL_KEY

Có thể coi key như chìa khóa của một khu vực được chỉ định: ai giữ chìa thường có quyền mở khu vực ấy. Vì vậy, chọn đúng phạm vi quyền và nơi lưu key quan trọng không kém việc tạo key.

Luồng sử dụng phổ biến:

  • Tạo tài khoản và project tại OpenAI, Claude hoặc Gemini.
  • Tạo key với quyền phù hợp, lưu vào credentials hoặc secret manager.
  • Ứng dụng gửi key theo tài liệu API; máy chủ kiểm tra quyền, quota và xử lý request.

OAuth là gì?

OAuth 2.0 mô tả cách client được ủy quyền truy cập tài nguyên bằng token, thay vì yêu cầu người dùng đưa mật khẩu gốc cho ứng dụng bên thứ ba. Khi tích hợp đúng, người dùng có thể cấp quyền cho từng ứng dụng và thu hồi khi không còn nhu cầu.

Authorization server phát hành access token gắn với quyền được cấp. Trong luồng có người dùng, họ đăng nhập tại bên cung cấp danh tính/tài nguyên và chấp thuận yêu cầu truy cập. OAuth 2.1 tập hợp nhiều thực hành bảo mật hiện đại; xem tình trạng tài liệu IETF khi triển khai.

Bạn có thể đã gặp luồng này khi một ứng dụng xin kết nối Google hoặc Facebook. Riêng việc “đăng nhập” còn thường dùng OpenID Connect trên OAuth để trao thông tin danh tính; OAuth tự nó tập trung vào quyền truy cập, không phải một giao thức đăng nhập đầy đủ.

Một cách hình dung là thẻ khách được cấp theo phạm vi và thời gian nhất định. Thẻ mở được cửa nào phụ thuộc quyền đã cấp; giữ thẻ không có nghĩa được phép sử dụng mọi dịch vụ trong tòa nhà.

Một luồng ủy quyền có người dùng thường diễn ra như sau:

  • Ứng dụng đề nghị quyền cụ thể, ví dụ đọc email thay mặt người dùng.
  • Người dùng đăng nhập tại dịch vụ gốc và chấp thuận phạm vi được yêu cầu.
  • Client nhận token theo luồng OAuth và dùng token để gọi tài nguyên trong phạm vi được cấp.

Dùng OAuth có miễn phí không?

Không thể suy ra giá dịch vụ chỉ từ việc nó dùng OAuth. Cách cấp quyền và cách tính phí là hai lớp khác nhau.

Điểm cần nhớ: access token xác định quyền sử dụng tài nguyên, còn gói dịch vụ, quota và billing quyết định bạn được dùng bao nhiêu và phải trả tiền thế nào.

Ví dụ khi kết nối dịch vụ AI:

Một tích hợp đăng nhập bằng ChatGPT có thể sử dụng quyền của gói được nhà cung cấp cho phép, trong khi cấu hình API key gọi endpoint API theo billing của API organization. Không được mặc định mọi ứng dụng bên thứ ba đều có quyền sử dụng thuê bao của bạn; hãy kiểm tra tài liệu và điều khoản của chính tích hợp.

Để hiểu luồng tính tiền, xem gói chat, token và credit API. OAuth không tự chuyển số dư giữa các hệ thống billing.

Khi hết quota, request có thể bị từ chối hoặc cần nâng gói, tùy dịch vụ. Việc token vẫn còn hạn không có nghĩa quota hoặc credit vẫn còn.

Nên dùng cách xác thực nào? OAuth hay API Key?

Nếu API chính thức yêu cầu key cho script/backend, hãy dùng key với quyền tối thiểu. Nếu cần người dùng cấp quyền cho ứng dụng truy cập dữ liệu của họ, OAuth thường là lựa chọn phù hợp. Dù chọn cách nào, phải tuân theo cơ chế mà API hỗ trợ.

Không có cơ chế tốt nhất cho mọi bài toán. Hãy cân nhắc bên sở hữu dữ liệu, môi trường chạy, vòng đời quyền, cách thu hồi và khả năng vận hành của đội ngũ.

API key thường dễ tích hợp trong tác vụ máy chủ gọi dịch vụ. Tách key theo ứng dụng, đặt scope/ngày hết hạn nếu được hỗ trợ và luân chuyển key có kế hoạch. Không nên dựa vào tính đơn giản để bỏ qua việc giám sát hoặc lưu secret an toàn.

OAuth phù hợp cho truy cập có ủy quyền, nhất là khi người dùng cần tự cấp và thu hồi quyền. Nó cho phép thiết kế token có hạn, scope rõ ràng và vòng đời linh hoạt, nhưng cũng đòi hỏi triển khai đúng luồng, bảo vệ token và xử lý lỗi. Chọn OAuth không tự động làm hệ thống an toàn nếu cấu hình sai.

Bảng dưới tóm tắt khác biệt để bạn chọn cơ chế theo yêu cầu tích hợp.

Tiêu chíAPI keyOAuth
Vai tròSecret nhận diện/cấp quyền ứng dụng hoặc projectKhuôn khổ ủy quyền bằng token
Triển khaiThường cấu hình key trực tiếp theo tài liệu APICần xử lý luồng cấp quyền, token và lỗi
Phạm vi quyềnPhụ thuộc cấu hình key của providerScope/audience và quyền được cấp
Vòng đờiCó thể dài hạn hoặc có expiry theo dịch vụAccess token có expiry; refresh tùy luồng
Thu hồiRevoke key ở dịch vụ cấp phátHành vi revoke và hiệu lực theo triển khai
Trường hợp phổ biếnScript/backend gọi API hỗ trợ keyTích hợp được người dùng ủy quyền hoặc các luồng client được hỗ trợ

Kinh nghiệm bảo mật xác thực cần nhớ

Với cả key và OAuth, cần bảo vệ thông tin bí mật, cấp quyền tối thiểu và giám sát sử dụng. Thiết lập ngân sách hoặc cảnh báo phù hợp cho API AI; kiểm tra xem tùy chọn đó là trần chặn hay chỉ gửi thông báo.

  • Không đưa secret vào GitHub, frontend, log hoặc ảnh chụp công khai.
  • Dùng key/token riêng theo ứng dụng để thu hồi cục bộ khi có sự cố.
  • Rà soát các ứng dụng đã cấp quyền và xóa quyền không còn cần.
  • Theo dõi Usage và điều tra ngay mức dùng bất thường.
  • Dùng HTTPS và không gửi secret qua kênh không được bảo vệ.
  • Thiết lập quyền tối thiểu, quota/ngân sách phù hợp; lưu key trong credentials n8n khi dùng workflow.

Kết luận

API key và OAuth giải quyết quyền truy cập bằng những mô hình khác nhau. Hãy chọn theo API và bài toán thực tế, quản lý vòng đời secret/token và kiểm tra billing riêng. Nếu cần hiểu cách máy chủ xác minh token, đọc tiếp opaque token và JWT.

Câu hỏi thường gặp

API Key và mật khẩu có khác nhau không?

Mật khẩu thường dùng để đăng nhập tài khoản, còn API key là secret được cấp cho việc gọi API. Dù hình thức khác, cả hai đều có thể gây mất quyền hoặc chi phí khi lộ. Vì vậy cần lưu, phân quyền và thu hồi key nghiêm túc như các thông tin đăng nhập quan trọng.

Tôi có thể dùng OAuth thay API Key cho mọi trường hợp không?

Không thể tùy ý đổi cơ chế nếu API không hỗ trợ. OAuth có luồng authorization code với người dùng và client credentials cho một số giao tiếp máy với máy. Tác vụ chạy nền có thể dùng token đã được cấp hoặc refresh token khi phù hợp. Với nhiều API model AI, key vẫn là cách tích hợp chính thức phổ biến.

Nếu tôi xóa quyền OAuth của một ứng dụng, ứng dụng đó có còn truy cập được không?

Ứng dụng sẽ mất khả năng tiếp tục truy cập theo cách dịch vụ thực thi thu hồi. Không nên khẳng định mọi access token bị vô hiệu tức thì: token tự chứa có thể còn hiệu lực tới khi hết hạn nếu resource server không kiểm tra trạng thái thu hồi. Hãy đọc hành vi revoke và thời hạn token của provider.

Tại sao Codex yêu cầu OAuth còn OpenAI thông thường chỉ cần API Key?

Codex có thể hỗ trợ đăng nhập bằng tài khoản ChatGPT hoặc dùng API key tùy môi trường và điều kiện dịch vụ. Hai cách này có thể ánh xạ tới quyền sử dụng và billing khác nhau. Khi nối một công cụ bên thứ ba, phải xác nhận luồng được hỗ trợ thay vì suy ra OAuth luôn dùng được thay key.

Access token trong OAuth hết hạn thì app có ngừng hoạt động không?

Nếu client được cấp refresh token và provider cho phép, nó có thể xin access token mới mà không cần người dùng đăng nhập lại mỗi lần. Không phải luồng nào cũng có refresh token. Khi refresh token hết hạn, bị revoke hoặc chính sách yêu cầu, ứng dụng phải xin quyền hoặc đăng nhập lại.

Bộ SKILLS EDIT VIDEOBạn quay. AI edit tự động.Ủng hộ mình 1 ly cafe
Video thật. Thành quả từ bộ Skills.
Trọn bộ 8 Skills · Mua một lần, dùng trọn đời

Để AI edit.
Dành thời gian cho điều quan trọng.

Thời gian edit mỗi video
3–4 giờ5–10 phút
Ưu đãi có hạn2.199.000đXem giá hiện tạiTrọn bộ 8 Skills & video hướng dẫn

Tiết kiệm 800.000đ · Mua một lần, dùng trọn đời.

Sở hữu bộ 8 SKILLS ngay!

Nhận bộ Skills và video hướng dẫn qua email.