vault chính thức trong sandbox do CloudThinker quản lý và đăng nhập bằng token hoặc AppRole (một role ID cùng một secret ID mà Vault đổi lấy token ngắn hạn).
Điều kiện tiên quyết
- Một địa chỉ Vault mà CloudThinker truy cập được qua mạng, chẳng hạn tên DNS công khai hoặc endpoint của HCP Vault Dedicated.
localhostvà địa chỉ riêng được phân giải tại nơi CloudThinker chạy lệnh, không phải trên mạng của bạn. Với Vault nằm sau firewall, xem Reaching private services. - Quyền ghi policy và tạo token hoặc AppRole.
- Vai trò Admin trong workspace CloudThinker, cần để thêm kết nối. Xem Vai trò.
- Với Vault Enterprise hoặc HCP Vault Dedicated: namespace chứa các secret của bạn. HCP mặc định dùng
admin.
Mỗi workspace có một kết nối Vault. Agent truy cập được đúng những gì policy trên token hoặc AppRole của bạn cho phép. Mọi thứ khác Vault đều từ chối theo mặc định.
Chọn phương thức xác thực
Thiết lập
1
Viết policy quyền tối thiểu
Bắt đầu với quyền read và list trên các path mà agent cần thấy. Thay
secret bằng tên KV mount của bạn và thu hẹp path theo đúng nhu cầu. Ví dụ này giả định KV v2 mount:read trên secret/data/* cho phép token đọc giá trị secret. CloudThinker chỉ hiển thị tên key trừ khi bạn yêu cầu giá trị, nhưng đó là hành vi của CloudThinker, không phải giới hạn của Vault. Để Vault thực thi giới hạn này, hãy bỏ khối secret/data/*: agent vẫn liệt kê được path và đọc metadata, nhưng không liệt kê được các key bên trong một secret.Với KV v1 mount, thay hai khối secret/ bằng một khối: path "secret/*" { capabilities = ["read", "list"] }.Xem Quyền yêu cầu để thêm quyền kiểm toán policy hoặc dynamic credential.2
Tạo thông tin xác thực
- AppRole
- Token
Bật AppRole (bỏ qua nếu đã bật), gắn một role với policy, rồi lấy role ID và một secret ID:Sao chép
role_id và secret_id từ kết quả.3
Thêm kết nối trong CloudThinker
Trên thanh bên, nhấn More → Workspace settings → Connections và chọn HashiCorp Vault. Nhập VAULT_ADDR, đặt VAULT_NAMESPACE nếu bạn dùng Enterprise hoặc HCP, chọn AppRole hoặc Token trong VAULT_AUTH_METHOD, rồi điền các trường thông tin xác thực hiện ra. Nhấn Connect.Trạng thái thành công: kết nối hiển thị Connecting và Verifying, rồi Connected. Với token, CloudThinker chạy
vault token lookup. Với AppRole, CloudThinker đăng nhập qua auth/approle/login và kiểm tra Vault có trả về token hay không.Chi tiết kết nối
Quyền yêu cầu
Chỉ cấp những dòng bạn cần. Mỗi dòng thêm path vào policy ở bước thiết lập.
Để ghi KV v2 dưới
secret/myapp/, thêm:
sys/health) và vault token lookup trên chính token của bên gọi đã chạy được với policy default có sẵn của Vault, nên bạn không cần thêm chúng.
Khả năng của agent
Agent báo cáo key và metadata, không báo cáo giá trị secret trừ khi bạn yêu cầu, và không bao giờ in token hay secret ID của bạn. Trong Vault, cấp dynamic credential trông giống thao tác đọc, nhưng thao tác này tạo ra lease, nên CloudThinker xem đó là thao tác ghi. Thao tác ghi đi qua Approvals trước khi chạy.
Xác minh kết nối
secret/ (KV v2) và auth method như approle/.
Ví dụ prompt
Khắc phục sự cố
Connection fails with "no such host" or connection refused
Connection fails with "no such host" or connection refused
VAULT_ADDR trỏ tới một địa chỉ CloudThinker không truy cập được.
localhost, 127.0.0.1 và hostname riêng được phân giải tại nơi CloudThinker chạy lệnh. Hãy dùng tên DNS công khai hoặc endpoint HCP của bạn. Vault nằm sau firewall hoặc VPN cần có endpoint truy cập được hoặc được đưa vào allowlist trước.unsupported protocol scheme
unsupported protocol scheme
Địa chỉ thiếu scheme. Hãy dùng
https://vault.example.com:8200, không phải vault.example.com:8200.Invalid Vault token configuration, or Invalid Vault AppRole configuration
Invalid Vault token configuration, or Invalid Vault AppRole configuration
Một trường thông tin xác thực của phương thức đã chọn đang để trống. Điền VAULT_TOKEN với Token, hoặc cả VAULT_ROLE_ID và VAULT_SECRET_ID với AppRole.
403 permission denied
403 permission denied
Vault trả về 403 cả khi policy không bao phủ path lẫn khi path không tồn tại, nên lỗi 403 không bao giờ chứng minh được secret không tồn tại. Hãy hỏi agent token đang có những policy nào, rồi thêm
read hoặc list trên path đó. Với KV v2, đọc secret/myapp cần policy trên secret/data/myapp.Nếu các request từng chạy được nay đều trả về 403, nhiều khả năng token đã hết hạn. Hãy cấp token mới và cập nhật VAULT_TOKEN."no handler for route" on HCP or Enterprise
"no handler for route" on HCP or Enterprise
VAULT_NAMESPACE đang trống hoặc sai. Đặt trường này thành namespace chứa các secret của bạn. HCP Vault Dedicated mặc định dùng
admin.invalid secret_id
invalid secret_id
Secret ID của AppRole đã quá
secret_id_ttl. Hãy tạo secret ID mới và dán vào VAULT_SECRET_ID như mô tả trong phần Bảo mật:Every request fails and health shows sealed: true
Every request fails and health shows sealed: true
Cụm đang bị seal, nên không thao tác đọc hay ghi nào thành công được. Operator của Vault cần unseal cụm bằng
vault operator unseal.Bảo mật
- Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
- Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
- Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
- Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
- Thay thông tin xác thực: mở More → Workspace settings → Connections, chọn HashiCorp Vault, nhấn biểu tượng bút chì (Edit) trên kết nối, dán token hoặc secret ID mới, rồi nhấn Save and test. Nếu kiểm tra thất bại, kết nối giữ thông tin xác thực trước đó.
- Ưu tiên AppRole cho production: mỗi phiên nhận một token hết hạn theo TTL bạn đặt, và bạn xoay vòng secret ID mà không phải đụng tới role.
- Giữ giá trị secret ngoài cuộc chat: theo mặc định agent chỉ liệt kê key. Nếu bạn yêu cầu một giá trị, giá trị đó xuất hiện trong cuộc hội thoại, nên chỉ yêu cầu khi thật sự cần.
- Thu hồi lease không còn dùng: hãy yêu cầu agent thu hồi dynamic credential khi đã xong việc, thay vì chờ credential hết hạn.
Liên quan
Approvals
Quyết định thao tác ghi nào lên Vault được chạy, thao tác nào chờ người duyệt hoặc bị từ chối.
Connections
Xem mọi dịch vụ bạn có thể kết nối và cách trạng thái kết nối hoạt động.