Giới thiệu
Hầu hết các API thực tế đều từ chối các request chưa được xác thực. Trước khi bạn có thể lấy dữ liệu từ Stripe, đăng lên Slack hay truy vấn CRM, bạn cần chứng minh bạn là ai. n8n xử lý việc này thông qua hệ thống Credentials — một kho lưu trữ được mã hóa an toàn, giữ các secret ra khỏi workflow JSON và cho phép tái sử dụng cùng một cấu hình xác thực trên nhiều node.
Bài học này bao gồm ba pattern bạn sẽ gặp trong ít nhất 80% các tích hợp: API keys được truyền dưới dạng header, Bearer tokens, và luồng OAuth2 authorization code. Đến cuối bài, bạn sẽ biết cách cấu hình từng loại trong n8n và cách kết nối chúng vào node HTTP Request khi chưa có node có sẵn cho dịch vụ mục tiêu của bạn.
API Keys và Custom Headers
Pattern xác thực đơn giản nhất: dịch vụ cấp cho bạn một key tĩnh và bạn gửi nó trong mỗi request, thường dưới dạng custom header như X-API-Key hoặc dưới dạng query parameter.
Trong n8n, vào Credentials > Add Credential > Header Auth. Bạn nhập tên header và giá trị một lần, n8n sẽ tự động chèn nó vào mọi request sử dụng credential đó.
Ví dụ: Kết nối với một weather API yêu cầu key trong header.
Trong node HTTP Request, đặt Authentication thành Header Auth, chọn credential đã lưu, sau đó cấu hình request:
n8n sẽ tự động đính kèm header — bạn không bao giờ hard-code key trong chính node đó. Nếu API yêu cầu key dưới dạng query parameter (ví dụ: ?apikey=...), hãy sử dụng loại credential Query Auth thay vì Header Auth. Cùng ý tưởng, vị trí khác.
Một lỗi phổ biến là dán key trực tiếp vào node Set hoặc trường URL. Cách làm này nhúng secret vào JSON của workflow, sau đó nó sẽ bị export, đưa vào version control và chia sẻ. Luôn sử dụng Credentials.
Bearer Tokens
Nhiều API — đặc biệt những API theo cơ chế OAuth2 client credentials hoặc cấp JWT ngắn hạn — yêu cầu một header Authorization với đúng định dạng sau:
Trong n8n, đây vẫn là một credential Header Auth. Đặt trường Name là Authorization và trường Value là Bearer theo sau là dấu cách rồi đến token của bạn:
Nếu token của bạn hết hạn và cần được refresh theo cách tự động, hãy thêm một node HTTP Request phía trước để gọi token endpoint, trích xuất access_token từ response bằng một biểu thức như {{ $json.access_token }}, và truyền nó vào header Authorization của node tiếp theo. Cách này tạo ra một mẫu refresh token hai node đơn giản mà không cần viết custom code nào.
OAuth2 Authorization Code Flow
OAuth2 với authorization code flow phức tạp hơn vì nó yêu cầu một redirect qua trình duyệt — người dùng phải truy cập provider, đăng nhập và cấp quyền trước khi n8n nhận được access token. n8n tự động hóa phần lớn quy trình này.
Bước 1: Tạo một credential OAuth2 API. Vào Credentials > Add Credential > OAuth2 API. Điền các trường từ thông tin đăng ký app của bạn phía provider:
Bước 2: Thiết lập redirect URI. n8n sẽ hiển thị callback URL của nó (có dạng https://your-n8n-instance.com/rest/oauth2-credential/callback). Copy URL này vào trường Authorized Redirect URIs của OAuth app trên dashboard của provider.
Bước 3: Nhấn Connect my account trong n8n. Một popup trình duyệt mở ra, bạn đăng nhập và chấp thuận, sau đó n8n tự động lưu trữ access token và refresh token thu được. Kể từ thời điểm này, n8n cũng tự động xử lý việc refresh token một cách âm thầm — khi access token hết hạn, nó sẽ dùng refresh token để lấy token mới mà bạn không cần thao tác gì thêm.
Đối với các node tích hợp sẵn như Google Sheets, Slack hay HubSpot, n8n đã điền sẵn Authorization URL và Access Token URL — bạn chỉ cần cung cấp Client ID, Client Secret và danh sách scope từ tài liệu của nhà cung cấp.
Các lỗi thường gặp và cách khắc phục
401 Unauthorized hầu như luôn có nghĩa là credential bị cấu hình sai hoặc token đã hết hạn. Hãy kiểm tra tên header phải khớp chính xác với tài liệu API — một số API dùng X-Auth-Token, số khác dùng api-key (viết thường), và sự không khớp này chỉ lộ ra khi chạy thực tế.
403 Forbidden nghĩa là token hợp lệ nhưng thiếu scope cần thiết. Hãy quay lại OAuth app, thêm scope còn thiếu và ủy quyền lại. n8n không tự động yêu cầu lại scope mới.
Nếu OAuth2 Connect thất bại với lỗi redirect_uri_mismatch, callback URL trong n8n và URL đã đăng ký trên nhà cung cấp không khớp chính xác — kiểm tra dấu gạch chéo ở cuối hoặc sự khác biệt giữa http và https.
Không bao giờ lưu secret trong workflow expressions hoặc tham số node. n8n mã hóa toàn bộ thông tin trong Credentials store bằng instance encryption key của bạn. Nếu cần xoay vòng key, chỉ cần cập nhật một lần trong Credential, và mọi workflow sử dụng nó sẽ nhận thay đổi ngay lập tức.
Tóm tắt
Dùng Header Auth cho API key tĩnh, dùng Bearer token header cho token ngắn hạn có bước refresh nếu cần, và dùng loại credential OAuth2 Authorization Code cho ủy quyền delegated user. Trong mọi trường hợp, hãy lưu secret trong n8n Credentials — không bao giờ nhúng trực tiếp vào workflow. Node HTTP Request hoạt động được với cả ba mô hình thông qua dropdown Authentication, biến nó thành phương án dự phòng cho mọi dịch vụ chưa có node n8n chuyên dụng.
Bài kiểm tra cuối bài
Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.