Bắt đầu
Xác thực
Khoá API, phạm vi quyền của khoá và các quy tắc mọi lệnh gọi phải qua.
Mọi lệnh gọi tới API và MCP server được xác thực bằng khoá API của workspace, gửi dạng bearer token:
Authorization: Bearer bxk_<prefix>.<secret>Tạo khoá
Owner và Admin tạo khoá ở Cài đặt → Khoá API. Mỗi khoá thuộc một workspace và hành động thay cho thành viên đã tạo nó. Phần bí mật chỉ hiện một lần; Browlix chỉ giữ bản băm nên không khôi phục được khoá đã mất — hãy thu hồi và tạo khoá mới.
Khoá được làm gì
Một lệnh gọi chỉ thành công khi cả hai đều có quyền mà thao tác cần (ghi trên từng trang tham chiếu):
- phạm vi quyền của khoá, chọn khi tạo, và
- thành viên đứng sau khoá, với vai trò và phạm vi nhóm hiện tại.
Nếu thành viên bị hạ vai trò hoặc rời workspace, khoá mất quyền đó ngay. Khoá không bao giờ thấy hồ sơ ngoài nhóm của thành viên và không bao giờ nhận mật khẩu proxy, cookie hay bí mật đã lưu.
Lỗi
| Tình huống | Mã | HTTP |
|---|---|---|
| Thiếu, sai định dạng, đã thu hồi hoặc hết hạn | UNAUTHENTICATED | 401 |
| Khoá hợp lệ nhưng thiếu quyền | FORBIDDEN | 403 |
| Quá nhiều yêu cầu cho khoá này | RATE_LIMITED | 429 |
Giữ khoá an toàn
- Lưu khoá trong biến môi trường hoặc kho bí mật; SDK và CLI không tự đọc khoá từ file hay dòng lệnh.
- Mỗi app hoặc agent một khoá riêng, chỉ với quyền cần thiết, để thu hồi một khoá mà không dừng các khoá khác.
- Browlix che mọi chuỗi trông giống khoá trong ticket phản hồi và thông báo lỗi, nhưng đừng dán khoá vào prompt hay log.