Quản lý, tạo lại và thu hồi các token API
Tìm các token API của bạn, tạo lại mã bí mật (một lần, với tùy chọn chồng lấp 24 giờ), thu hồi token, tìm hiểu về thời hạn và danh sách cho phép IP, cũng như xem lý do tại sao một token ngừng hoạt động.
Tab Các token liệt kê các token API của bạn cùng với quyền truy cập, giới hạn và lần sử dụng cuối cùng. Từ đó, bạn có thể tạo lại mã bí mật của token, thu hồi token và xem lý do tại sao một token ngừng hoạt động.
Tìm các token của bạn ở đâu
Mở menu không gian làm việc và chọn AI agents & API. Tab Các token là tab đầu tiên; mỗi tab hiển thị số lượng của nó.
Ai có thể thấy những token nào:
| Vai trò của bạn | Bạn thấy | Bạn có thể |
|---|---|---|
| Chủ sở hữu hoặc quản trị viên | "Mọi token trong không gian làm việc này. Các thành viên chỉ thấy token của riêng họ." Lọc theo người dùng bằng menu chủ sở hữu (Mọi người hiển thị tất cả). | Thu hồi bất kỳ token nào. Chỉ tạo lại token của riêng bạn. |
| Biên tập viên hoặc Người tạo nội dung | "Các token của bạn. Các agent sử dụng chúng sẽ hoạt động với tư cách là bạn." | Thu hồi và tạo lại các token của riêng bạn. |
Mỗi hàng hiển thị Tên (với các ký tự cuối của mã bí mật, như clv_agent_…k7Qe), Chủ sở hữu, Quyền truy cập (các quyền của nó), Các trang web mà nó bao gồm, Đã tạo, Sử dụng lần cuối và Hết hạn. Phần chân trang đếm số token đang hoạt động của không gian làm việc so với giới hạn. Các huy hiệu trên một hàng:
| Huy hiệu | Ý nghĩa |
|---|---|
| Sử dụng tín dụng | Token có credits:spend. Trỏ vào đó để xem các giới hạn: Mỗi công việc, Mỗi ngày, Mỗi tháng ("không giới hạn" khi trống) và "Tự động phê duyệt dưới n tín dụng" hoặc "Một người phê duyệt mọi lần bắt đầu trả phí". |
| Giới hạn IP | Token có danh sách cho phép IP và chỉ hoạt động từ các địa chỉ đó. |
| Vượt quá vai trò | "Vai trò của chủ sở hữu đã thay đổi. Các lệnh gọi cần các khả năng bị gạch bỏ sẽ bị từ chối." |
| Đã thu hồi / Đã hết hạn | Token không còn hoạt động. Lý do hiển thị bên cạnh nó (xem Tại sao một token ngừng hoạt động). |
Các token đã thu hồi và đã hết hạn bị ẩn theo mặc định. Nhấp vào Hiển thị các token đã thu hồi và hết hạn (count) để liệt kê chúng; chúng sẽ được liệt kê trong 30 ngày.
Thay đổi quyền truy cập của token
Các quyền, trang web, thời hạn, giới hạn chi tiêu và danh sách cho phép IP của token không thể chỉnh sửa sau khi đã tạo. Để thay đổi bất kỳ thông tin nào trong số đó, hãy tạo một token mới với các cài đặt mới, chuyển đổi agent của bạn, sau đó thu hồi token cũ.
Tạo lại mã bí mật của token
Hãy tạo lại khi mã bí mật có thể đã bị rò rỉ, hoặc để xoay vòng nó theo lịch trình. Mã bí mật mới có cùng tên, quyền truy cập, các trang web, danh sách cho phép IP, giới hạn chi tiêu và ngày hết hạn.
Mở menu của token
Trên tab Các token, mở menu ⋯ trên hàng của token và chọn Tạo lại mã bí mật.
Chọn thời điểm mã bí mật cũ ngừng hoạt động
Hộp thoại hỏi "Tạo lại “name”?": "Bạn nhận được một mã bí mật mới với cùng quyền truy cập. Mã cũ sẽ ngừng hoạt động." Đánh dấu vào Giữ cho mã bí mật cũ hoạt động trong 24 giờ nếu các agent vẫn đang sử dụng nó và bạn cần thời gian để chuyển đổi chúng. Để trống nếu muốn dừng mã bí mật cũ ngay lập tức.
Sao chép mã bí mật mới
Nhấp vào Tạo lại. Hộp thoại Token đã được tạo hiển thị mã bí mật mới một lần. Hãy sao chép nó, cập nhật agent hoặc kho lưu trữ bí mật của bạn, sau đó nhấp vào Tôi đã lưu nó.
Các quy tắc để tạo lại:
- Chỉ người tạo token mới có thể tạo lại nó. Chủ sở hữu hoặc quản trị viên không tạo ra nó sẽ thấy "Chỉ người tạo token này mới có thể tạo lại nó. Bạn có thể thu hồi nó."
- Một mã bí mật chỉ có thể được tạo lại một lần. Sau đó, hàng cũ hiển thị "Đã thay thế bằng một mã bí mật được tạo lại" và không có tùy chọn Tạo lại mã bí mật; hãy tạo lại token mới thay thế. Cố gắng thực hiện lại trên mã bí mật cũ sẽ trả về "Token này đã được tạo lại, thu hồi hoặc hết hạn; hãy sử dụng bản thay thế của nó hoặc tạo một token mới."
- Ngày hết hạn không thay đổi. Một token được tạo trong 90 ngày vẫn hết hạn vào ngày ban đầu. Nếu thời gian 24 giờ của mã bí mật cũ kéo dài qua ngày đó, nó sẽ dừng lại vào ngày hết hạn.
- Bạn có thể tạo lại ngay cả khi không gian làm việc đã đạt giới hạn token hoạt động. Trong thời gian chồng lấp 24 giờ, cả hai mã bí mật đều hoạt động và cả hai đều được tính là token đang hoạt động.
- Việc tạo lại yêu cầu không gian làm việc phải ở gói Pro trở lên; nếu không, Tạo lại mã bí mật sẽ mở hộp thoại nâng cấp.
Thu hồi token
- Mở menu ⋯ trên hàng của token và chọn Thu hồi.
- Xác nhận bằng Thu hồi token: "Các agent sử dụng token này sẽ mất quyền truy cập ngay lập tức. Hành động này không thể hoàn tác."
Một token bị thu hồi sẽ giải phóng vị trí của nó trong giới hạn token hoạt động của không gian làm việc ngay lập tức.
Hết hạn
Mọi token đều hết hạn. Bạn chọn thời hạn khi tạo nó: 7 ngày, 30 ngày, 90 ngày (mặc định) hoặc 1 năm. Không có tùy chọn "không bao giờ hết hạn", vì vậy một token bị lãng quên không thể duy trì hiệu lực mãi mãi. Cột Hết hạn hiển thị ngày đó.
Sau ngày hết hạn, mọi lệnh gọi sẽ trả về "Token này đã hết hạn. Hãy tạo một token mới trong Integrations → AI agents & API." Một token đã hết hạn không thể gia hạn hoặc tạo lại; hãy tạo một token mới.
Danh sách cho phép IP
Một token có thể bị giới hạn ở các địa chỉ mà agent của bạn chạy từ đó (ví dụ: trình chạy CI hoặc máy chủ). Bạn thiết lập nó ở bước Giới hạn của trình hướng dẫn trong phần Nâng cao → Danh sách cho phép IP: "Tùy chọn. Một địa chỉ hoặc phạm vi trên mỗi dòng; các lệnh gọi từ bất kỳ nơi nào khác đều bị từ chối."
- Nhập địa chỉ IPv4 hoặc IPv6 (
203.0.113.7) hoặc phạm vi theo dạng CIDR (198.51.100.0/24), tối đa 20 mục. - Để trống để cho phép bất kỳ địa chỉ nào. Bước xem xét sau đó sẽ hiển thị Bất kỳ địa chỉ nào.
- Một lệnh gọi từ địa chỉ khác sẽ trả về "Token này không thể được sử dụng từ địa chỉ IP này."
- Một mục không phải là địa chỉ hoặc phạm vi sẽ bị từ chối: "value không phải là một địa chỉ hoặc phạm vi IP."
Tại sao một token ngừng hoạt động
| Hiển thị trên token | Điều gì đã xảy ra | Cần làm gì |
|---|---|---|
| Đã hết hạn | Thời hạn của nó đã kết thúc. | Tạo một token mới. |
| "Đã thu hồi bởi chủ sở hữu" | Người tạo ra nó đã thu hồi nó. | Tạo một token mới nếu vẫn cần. |
| "Đã thu hồi bởi quản trị viên" | Chủ sở hữu không gian làm việc hoặc quản trị viên đã thu hồi nó. | Hỏi họ lý do trước khi tạo token mới. |
| "Đã thu hồi: chủ sở hữu đã rời không gian làm việc" | Người tạo ra nó đã bị xóa khỏi không gian làm việc. Tất cả token của họ đều bị thu hồi. | Một người vẫn còn trong không gian làm việc tạo token mới. |
| "Đã thu hồi: tài khoản của chủ sở hữu đã bị xóa" | Chủ sở hữu đã xóa tài khoản Clevera của họ. | Tạo một token mới. |
| "Đã thay thế bằng một mã bí mật được tạo lại" | Mã bí mật đã được tạo lại. | Sử dụng mã bí mật mới. |
| "Đã thu hồi: tìm thấy trong kho lưu trữ công khai" | Token được tìm thấy trong kho lưu trữ GitHub công khai và bị thu hồi tự động. | Xóa nó khỏi lịch sử kho lưu trữ, sau đó tạo token mới và giữ nó trong kho lưu trữ bí mật. |
| "Đã thu hồi: hoạt động bất thường" | Nó đã thực hiện nhiều yêu cầu bị từ chối trong vài phút (hơn 50 trong 10 phút). | Kiểm tra hoạt động để xem nó đã thử gì, sửa agent, sau đó tạo token mới. |
| "Đã thu hồi: phát hiện sử dụng lại token" / "Đã thu hồi: ứng dụng đã ngắt kết nối" | Những điều này áp dụng cho các ứng dụng đã kết nối, không phải token API. | Kết nối lại ứng dụng. |
| Mọi lệnh gọi trả về "Agent API không có trong gói của không gian làm việc này. Nó có trong gói Pro trở lên." | Không gian làm việc đã rời khỏi gói Pro, Business hoặc Custom. | Nâng cấp lên Pro. Xem Nếu không gian làm việc rời khỏi Pro. |
Hoạt động bất thường
Clevera theo dõi từng token để phát hiện các đợt bùng phát và thông báo cho chủ sở hữu không gian làm việc bằng thông báo "Hoạt động bất thường trên token":
- Nhiều yêu cầu bị từ chối trong vài phút: token bị thu hồi. "Nó đã thực hiện nhiều yêu cầu bị từ chối trong vài phút."
- Số lượng thay đổi cao bất thường trong vài phút (hơn 200 lần ghi hoặc 20 lần xóa trang trong 10 phút): các lần ghi của nó tạm dừng trong 10 phút. Các lệnh gọi trả về "Các lần ghi từ token này bị tạm dừng sau một đợt thay đổi bất thường. Chủ sở hữu không gian làm việc đã được thông báo." Các lần đọc vẫn hoạt động.
- Tín dụng được sử dụng nhanh bất thường: token không thể bắt đầu công việc trả phí trong 24 giờ. "Nó đã sử dụng một lượng tín dụng cao bất thường trong vài phút, vì vậy nó không thể bắt đầu công việc trả phí vào lúc này."
Nếu không gian làm việc rời khỏi Pro
AI agents & API có trong các gói Pro, Business và Custom. Nếu không gian làm việc chuyển sang gói Starter hoặc Free, trang sẽ hiển thị "AI agents & API được bao gồm trong Pro": "Nâng cấp để cho phép Claude, ChatGPT và các tập lệnh của bạn hoạt động trong không gian làm việc này. Các token và ứng dụng hiện có sẽ ngừng hoạt động cho đến lúc đó; bạn vẫn có thể thu hồi chúng tại đây."
- Các token vẫn được liệt kê và có thể bị thu hồi, nhưng mọi lệnh gọi đều bị từ chối với
plan_locked. - Tạo lại mã bí mật sẽ mở hộp thoại nâng cấp thay thế.
- Nâng cấp trở lại Pro sẽ làm cho các token hoạt động trở lại. Không có gì bị xóa; các token vẫn hết hạn vào ngày của chúng.