Credential (thông tin xác thực) trong n8n là nơi lưu API key, token OAuth, tên đăng nhập và mật khẩu mà node dùng để kết nối dịch vụ bên ngoài. n8n mã hóa credential trong cơ sở dữ liệu bằng một khóa riêng của instance; bạn tạo credential một lần rồi chọn lại ở nhiều node, nhiều workflow.
Bài này giải thích credential trong n8n gồm những loại nào, ai xem được, cách tạo, gắn vào node, sửa, xóa và mang sang máy khác. Credential là bước bắt buộc khi tạo workflow trên n8n có kết nối Google, OpenAI, Telegram hay bất kỳ API nào. Nội dung đối chiếu docs.n8n.io ngày 22/10/2026.
Credential là gì và vì sao n8n tách riêng?
Credential nói chung là bằng chứng danh tính để một hệ thống cho phép bạn truy cập: mật khẩu, khóa API, chứng chỉ. Trong n8n, credential là một bản ghi riêng: thay vì dán API key thẳng vào từng node, bạn tạo credential, đặt tên, rồi node chỉ tham chiếu tới tên đó.
Cách tách này giúp ba việc:
- Không lộ khóa khi chia sẻ workflow: file JSON export của workflow chỉ chứa tên và ID credential, không chứa giá trị khóa.
- Tái sử dụng: một credential dùng cho nhiều node, nhiều workflow mà không phải nhập lại.
- Đổi một chỗ, áp dụng mọi nơi: khi API key hết hạn hoặc đổi mật khẩu, bạn sửa credential một lần, mọi workflow đang dùng nó nhận giá trị mới.
Khóa mã hóa đó là N8N_ENCRYPTION_KEY. Nếu không đặt, n8n tự sinh khóa ngẫu nhiên khi chạy lần đầu và lưu trong thư mục ~/.n8n (file config). Theo tài liệu đặt khóa mã hóa tùy chỉnh, khi chạy nhiều instance hoặc chuyển sang máy mới, bạn phải dùng cùng một khóa; khác khóa thì n8n không giải mã được credential cũ.
Các loại credential phổ biến trong n8n
n8n hỗ trợ nhiều phương thức xác thực để khớp với hầu hết dịch vụ. Năm loại bạn gặp thường xuyên nhất:
Loại Cách hoạt động Ví dụ dùng API Key / API Token Dịch vụ cấp một chuỗi bí mật; bạn dán vào ô tương ứng OpenAI, OpenWeatherMap, n8n API OAuth2 n8n chuyển bạn sang trang đăng nhập của dịch vụ; bạn đồng ý cấp quyền, dịch vụ trả token cho n8n Google Sheets, Gmail, Microsoft 365 Header Auth Gửi khóa trong header của request, ví dụ Authorization: Bearer ... hoặc X-Api-KeyAPI nội bộ, webhook có xác thực Query Auth Gắn khóa vào URL dạng ?api_key=...; dễ lộ trong log nên chỉ dùng khi API bắt buộcMột số API cũ Username & Password Tên đăng nhập và mật khẩu, n8n mã hóa và lưu lại Cơ sở dữ liệu, SMTP, FTP
Khi nào node cần credential?
Bất cứ khi nào node cần “danh tính” để truy cập tài nguyên hoặc thực hiện hành động trên nền tảng khác, node đó cần credential:
- Node của ứng dụng cụ thể: Google Sheets, Slack, Telegram, Notion… đều yêu cầu credential của tài khoản bạn.
- Truy vấn cơ sở dữ liệu: đọc, ghi PostgreSQL, MySQL, MSSQL, MongoDB cần thông tin kết nối.
- Dịch vụ lưu trữ file: S3, FTP, SFTP, Google Drive.
- API tùy chỉnh qua node HTTP Request: chọn Predefined Credential Type hoặc Generic (Header, Query, Bearer…). Xem cách thêm API vào n8n.
Mỗi credential có thiết lập Allowed HTTP Request Domains: All (mọi URL), Specific Domains (danh sách tên miền) hoặc None (cấm dùng trong HTTP Request). Thiết lập này chỉ áp dụng cho node HTTP Request, không ảnh hưởng node riêng của ứng dụng (docs: Create and edit credentials). Nên giới hạn tên miền để khóa không bị gửi nhầm sang địa chỉ lạ.
Ai xem và dùng được credential của bạn?
Ở bản Community tự host, chỉ instance owner và người tạo truy cập được một credential. Chia sẻ credential (và workflow) cho người khác là tính năng không có trong bản Community, chỉ có ở n8n Cloud và gói Business, Enterprise tự host (Community edition features). Người khác trên cùng instance không tự thấy credential của bạn.
Ở gói có Projects, credential thuộc về một project; thành viên project dùng được theo vai trò. n8n Cloud và bản tự host Enterprise còn có kiểu credential OAuth “End-user”: mỗi người chạy workflow bằng tài khoản của chính họ.
Cách tạo credential trong n8n
Ví dụ dưới tạo credential Google Sheets OAuth2. Các dịch vụ khác làm tương tự, chỉ khác phần thông tin cần nhập (node OpenAI chỉ cần API key). Cách lấy Client ID, Client Secret trên Google Cloud có ở bài xác thực credential Google trên n8n.
Bước 1: Mở hộp thoại tạo credential
Ở n8n 2.x, bấm nút Create ở góc trên bên trái thanh menu (hoặc nút Create trên trang Overview hay trong một project) rồi chọn Credential. Bạn cũng có thể tạo ngay trong node: mở ô Credential to connect with và chọn Create new credential.
Ảnh chụp ở bản n8n 1.x (nút Create Workflow có mũi tên xổ xuống). Ở n8n 2.x, nút Create nằm ở góc trên bên trái thanh menu.
Bước 2: Chọn loại credential
Trong hộp thoại Add new credential, gõ “Google Sheets” và chọn Google Sheets OAuth2 API, bấm Continue. Làm tương tự cho Drive, Gmail, Calendar.
Bước 3: Nhập Client ID và Client Secret
n8n điền sẵn OAuth Redirect URL; bạn sao chép URL này vào Google Cloud Console, rồi dán Client ID và Client Secret lấy từ Google về ô tương ứng.
Bước 4: Đăng nhập Google và cấp quyền
Bấm Sign in with Google, chọn tài khoản, đánh dấu các quyền n8n xin (xem, sửa bảng tính) và bấm Allow. Cửa sổ Google tự đóng, credential báo Account connected.
Bước 5: Đặt tên và lưu
Đổi tên credential cho dễ nhận (ví dụ “Google Sheets – kế toán”), bấm Save. n8n thử kết nối khi lưu và báo nếu thông tin sai.
Cách gắn credential vào node
Thêm node Google Sheets vào workflow. Ở ô Credential to connect with, chọn credential vừa tạo. Sau đó nhập link hoặc ID file Sheet; file phải thuộc (hoặc được chia sẻ cho) tài khoản Google đã đăng nhập ở credential.
Cách sửa và xóa credential
Sửa credential
Mở tab Credentials trên trang Overview (hoặc trong project), bấm vào credential cần sửa, thay giá trị (ví dụ API key mới) và bấm Save.
Xóa credential
Tại danh sách Credentials, bấm dấu ba chấm bên phải credential, chọn Delete, rồi xác nhận Yes, delete.
Lưu ý: xóa credential làm mọi node đang dùng nó lỗi xác thực ngay ở lần chạy sau. Trước khi xóa, mở các workflow liên quan và chọn credential thay thế.
Lỗi thường gặp với credential
| Hiện tượng | Nguyên nhân hay gặp | Cách xử lý |
|---|---|---|
| 401 Unauthorized | API key sai, hết hạn, thiếu tiền tố Bearer | Kiểm tra lại khóa và kiểu xác thực, xem cách sửa lỗi 401 |
| Credential Google phải đăng nhập lại sau 7 ngày | App OAuth trên Google Cloud đang ở trạng thái Testing | Publish app rồi kết nối lại, xem sửa lỗi Google Sheets/Drive |
| Lỗi giải mã credential sau khi chuyển máy | Máy mới dùng N8N_ENCRYPTION_KEY khác | Đặt lại đúng khóa cũ, hoặc export credential dạng đã giải mã rồi import |
| Không thấy credential của đồng nghiệp | Bản Community không chia sẻ credential | Người tạo tự dùng, hoặc chuyển sang gói có chia sẻ |
Các mã lỗi khác khi n8n gọi API có ở bảng mã lỗi kết nối API trong n8n.
Muốn chạy n8n 24/7 mà không tự cài? VPS n8n của Tino cài sẵn n8n trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm.
Những câu hỏi thường gặp
Dữ liệu credential được lưu ở đâu, có an toàn không?
Credential được mã hóa và lưu trong database của n8n (SQLite mặc định hoặc PostgreSQL). Có file database mà không có N8N_ENCRYPTION_KEY thì không đọc được giá trị khóa. Vì vậy hãy sao lưu khóa này riêng, tách khỏi bản sao lưu database.
Có chia sẻ credential cho người khác trong team được không?
Ở bản Community, không: chỉ instance owner và người tạo dùng được credential. Chia sẻ credential cho người hoặc project khác có ở n8n Cloud và gói Business, Enterprise tự host. Khi chia sẻ, người nhận dùng được credential trong workflow nhưng không xem được giá trị gốc.
Điều gì xảy ra khi xóa một credential?
Mọi node đang dùng credential đó sẽ lỗi xác thực ở lần chạy tiếp theo. Thao tác xóa không hoàn tác được, nên chuyển các node sang credential khác trước.
Dùng một credential cho nhiều dịch vụ được không?
Mỗi credential gắn với một loại dịch vụ: Google Sheets, Slack, OpenAI cần credential riêng. Riêng Google, credential Google OAuth2 API chung có thể cấp nhiều scope để dùng cho Sheets, Drive, Gmail.
Chuyển credential sang máy chủ n8n khác thế nào?
Export credential bằng lệnh n8n export:credentials, mang theo đúng N8N_ENCRYPTION_KEY rồi import ở máy mới. Hướng dẫn chi tiết: cách backup và restore workflow, credential n8n.
