3.2.0-beta.10). Tính năng có thể thay đổi trước bản stable tiếp theo.Chuyển sang stable →remote
ak secrets remote login
Đăng nhập bằng mã thiết bị để máy này chạy được lệnh qua vault, hoặc xuất refresh token cho kho secret của một sandbox trên cloud (bản xem trước).
Dùng ak secrets remote login trên máy sẽ chạy
ak secrets remote run. Lệnh chạy luồng OAuth
device authorization grant: bạn mở một đường link trên bất kỳ thiết bị nào đang
đăng nhập agentkit.best và xác nhận một mã.
Bản xem trước
Endpoint vault từ xa đang ở giai đoạn tiền phát hành và có thể chưa dùng được
với mọi tài khoản. Nếu máy chủ đăng nhập chưa hỗ trợ đăng nhập bằng mã thiết
bị, lệnh thất bại với mã thoát 5.
Cách dùng
ak secrets remote login [flags]ak secrets remote login
ak secrets remote login --exportTuỳ chọn
| Cờ | Mặc định | Mô tả |
|---|---|---|
--export | Tắt | In refresh token ra stdout cho một kho secret thay vì giữ lại. Không có dạng --json. |
--scope string | vault-mcp:use | Các OAuth scope cần xin. |
--issuer string | https://agentkit.best, hoặc AGENTKIT_OAUTH_ISSUER | Origin của máy chủ cấp quyền. |
--vault-origin string | https://vault.agentkit.best | Origin của vault. |
Các cờ dùng chung nằm trong quy ước CLI.
Lệnh làm gì
Lệnh in một đường link và một mã ra stderr, kèm số phút còn lại trước khi mã
hết hạn, rồi chờ bạn xác nhận. Quyền được cấp chỉ cho phép chạy lệnh (scope
vault-mcp:use) và có hiệu lực 30 ngày.
Khi không dùng --export, thông tin đăng nhập được ghi vào
AGENTKIT_HOME/state/vault-remote.json với mode 0600, thay cho lần đăng nhập
trước nếu có. Thông tin đăng nhập đã lưu gắn với một issuer và một vault origin;
một lần remote run sau đó với issuer hoặc vault origin khác sẽ yêu cầu bạn
đăng nhập lại.
Refresh token đổi mới sau mỗi lần dùng, và gửi lại một token đã dùng sẽ thu hồi
quyền. Vì vậy token chỉ được giữ trong đúng file đó và được gia hạn dưới một
khoá (AGENTKIT_HOME/locks/vault-remote.lock), chờ tối đa 2 phút nếu một tiến
trình ak khác đang giữ khoá. Nếu filesystem không khoá được file, lệnh cảnh
báo một lần rằng các lệnh ak secrets remote chạy song song không được xếp
tuần tự; hãy chạy từng lệnh một. Nếu câu trả lời của một lần gia hạn bị mất
trên đường truyền, lần gia hạn kế tiếp có thể thấy quyền đã bị thu hồi; khi đó
hãy chạy lại ak secrets remote login.
Sandbox trên cloud
Với --export, refresh token được in một lần ra stdout và máy này không giữ
lại gì. Đặt token đó làm AK_VAULT_MCP_REFRESH_TOKEN trong kho secret của
sandbox. Một máy chưa có thông tin đăng nhập đã lưu sẽ dùng biến này làm hạt
giống (seed) một lần. Seed bị dùng hết ngay ở lần dùng đầu tiên, nên mỗi
sandbox không giữ lại thư mục home của AgentKit cần một lần đăng nhập riêng.
Seed đã dùng sẽ bị từ chối, kèm thông báo chạy ak secrets remote login hoặc
đặt một token mới.
Đầu ra
Khi thành công, lệnh in
Signed in. `ak secrets remote run` can now use <vault origin>. ra stderr.
Với --export, stdout chỉ chứa refresh token.
Lệnh không có đầu ra JSON khi thành công, kể cả với --json. Với --json, một
lần thất bại in error envelope chuẩn ra stderr. --export cùng --json bị từ
chối trước mọi lời gọi mạng, để token không bao giờ rơi vào log có cấu trúc.
Kết quả và mã thoát
| Mã | Ý nghĩa |
|---|---|
0 | Đã đăng nhập, hoặc đã xuất token. |
1 | Lệnh thất bại. |
2 | --export cùng --json, hoặc --issuer hay --vault-origin không hợp lệ. |
5 | Đăng nhập thất bại: máy chủ không hỗ trợ đăng nhập bằng mã thiết bị, mã bị từ chối hoặc hết hạn, hoặc không lưu được thông tin đăng nhập. |
Lệnh liên quan
ak secrets remote
Chạy một chương trình với secret trong vault trên một relay device đang trực tuyến của bạn, từ một máy không được giữ secret, như sandbox của Agent trên cloud (bản xem trước).
ak secrets remote run
Chạy một chương trình trên một relay device đang trực tuyến của bạn với secret trong vault đặt vào môi trường, rồi in đầu ra đã che giá trị; không chạy gì cục bộ (bản xem trước).