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
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).
Dùng ak secrets remote trên một máy không được giữ secret, như sandbox của
một coding Agent trên cloud. Lệnh nhờ endpoint remote MCP của vault chạy một
chương trình trên một relay device đang trực tuyến của chính bạn, theo các exec
grant của thiết bị đó, rồi in đầu ra với mọi giá trị đã cấp phát được che đi.
Các giá trị không bao giờ tới máy gọi lệnh. Chạy lệnh nhóm không kèm lệnh con
sẽ in help.
Bản xem trước
ak secrets remote là bản xem trước. Endpoint vault từ xa mà lệnh dùng đ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ị,
ak secrets remote login thất bại với mã thoát 5.
Cách dùng
ak secrets remote <command>ak secrets remote login
ak secrets remote run --env STRIPE_API_KEY=STRIPE_API_KEY -- stripe customers listLệnh nhóm không nhận argument và không có cờ riêng.
Quy trình
-
Trên một thiết bị giữ vault, giữ một kết nối relay luôn mở:
ak secrets sync now --watch --relay -
Trên máy không được giữ secret, đăng nhập bằng
ak secrets remote login. Với sandbox không giữ lại thư mục home của AgentKit, hãy dùng--exporttrên một máy tin cậy và đặt token được in ra làmAK_VAULT_MCP_REFRESH_TOKENtrong kho secret của sandbox. -
Chạy chương trình bằng
ak secrets remote run. Nếu không exec grant nào trên relay device bao phủ lần chạy, lệnh thoát với mã8và một yêu cầu chờ trên thiết bị đó. Duyệt yêu cầu ở đó bằngak secrets approve, rồi chạy lại lệnh. Hãy duyệt mọi phạm vi mà một tác vụ cần trước khi tác vụ bắt đầu.
Những gì đi qua đâu
- Giá trị secret tới relay device và chương trình mà thiết bị đó chạy, không bao giờ tới máy gọi lệnh.
- Máy chủ vault thấy lệnh, tên biến và tên secret, cùng đầu ra đã che giá trị, trong bộ nhớ khi chuyển tiếp chúng.
- Việc che chỉ xoá đúng các giá trị nguyên văn. Chương trình in một giá trị đã mã hoá, bị tách nhỏ hoặc chỉ một phần thì không bị phát hiện.
Lệnh con
| Lệnh | Kết quả | Tác động lên đĩa |
|---|---|---|
ak secrets remote login | Đăng nhập bằng mã thiết bị, hoặc xuất refresh token cho một sandbox. | Ghi AGENTKIT_HOME/state/vault-remote.json (0600), trừ khi dùng --export. |
ak secrets remote run | Chạy một chương trình trên relay device và in đầu ra đã che giá trị. | Gia hạn thông tin đăng nhập trong cùng file khi cần. Không chạy gì cục bộ. |
Không lệnh con nào đọc vault cục bộ.
Kết quả và mã thoát
| Mã | Ý nghĩa |
|---|---|
0 | Thành công. |
1 | Lệnh thất bại. |
2 | Cờ hoặc argument không hợp lệ. |
Trang của từng lệnh con liệt kê mã thoát riêng.