Secret
Hai công cụ env_set và env_list để agent lưu khoá API và token của dịch vụ ngoài cho backend của app; giá trị không bao giờ được trả lại cho agent.
Backend đọc secret qua env:
app/payments/post.ts
import { env } from "manh/env";
// …
const res = await fetch("https://api.example.com/charge", {
headers: { Authorization: `Bearer ${env.PAYMENT_API_KEY}` },
});Không viết khoá thẳng vào code: check từ chối chuỗi trông giống khoá thật.
env_set
Đặt hoặc xoá một secret. Chỉ có ở bộ công cụ đầy đủ.
- Tham số:
project.name: tên dạngUPPER_SNAKE, ví dụPAYMENT_API_KEY. Tên dành cho nền tảng vàJWT_SECRETbị từ chối.value: giá trị, tối đa 5 KB.nullđể xoá.
- Trả về:
ok,name,action(sethoặcdeleted),livecho biết app đang chạy đã nhận giá trị mới chưa, và ghi chú. - Khi nào gọi: khi bạn đưa cho agent khoá của một dịch vụ ngoài. Agent hỏi bạn giá trị, không tự bịa.
App hiện tại nhận secret mới ngay. App cũ hơn nhận ở lần deploy sau.
env_list
Liệt kê tên secret của project, không có giá trị.
- Tham số:
project. - Trả về:
secrets: mỗi secret có tên, độ dài, lần đổi cuối,pending(chưa deploy) vàneedsReset(cần đặt lại);pendingRemovals: tên đã xoá nhưng chưa deploy. - Khi nào gọi: trước khi viết code đọc
env.NAME, để biết secret đã có chưa.
manh.run tự đặt MANH_APP_URL và JWT_SECRET (tạo ở lần deploy đầu). Bạn xem và sửa giá trị trong trang Secret của project. Ở địa chỉ /directory không có env_set, nên secret chỉ đặt được trong dashboard.
Bước tiếp theo
- Gọi API bên ngoài: dùng secret khi gọi hệ thống ngoài.
- Dữ liệu và bảo mật: secret được giữ thế nào.
- Lệnh của agent: hai bộ công cụ.
Cập nhật