Chuyển đến nội dung chính
Kết nối cụm HashiCorp Vault để agent của CloudThinker kiểm tra trạng thái seal và sức khỏe, liệt kê nội dung của một secret path, kiểm toán policy, auth method và audit device, và cấp credential ngắn hạn cho database hoặc cloud qua Approvals của bạn. Agent chạy CLI 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. localhost và đị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

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ả.
Cả hai ví dụ đều hết hạn sau 30 ngày (720h): secret ID của AppRole hoặc token ngừng hoạt động và kết nối thất bại. Hãy đặt lời nhắc, rồi cấp thông tin xác thực mới và cập nhật kết nối như mô tả trong phần Bảo mật.
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:
Kiểm tra sức khỏe (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.
Hãy bắt đầu ở chế độ chỉ đọc. Chỉ thêm các dòng quyền ghi khi bạn có quy trình thật sự cần đến. Kể cả khi đó, mọi thao tác ghi đều đi qua Approvals trước. Chọn Manual để mọi thay đổi đều do người duyệt. Khi CloudThinker bật Rule enforcement cho workspace của bạn, Rule Ask first có thể thu hẹp phạm vi đó vào riêng kết nối Vault.

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

Kết quả mong đợi gồm trạng thái seal, phiên bản Vault, danh sách mount như secret/ (KV v2) và auth method như approle/.

Ví dụ prompt

Khắc phục sự cố

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.
Địa chỉ thiếu scheme. Hãy dùng https://vault.example.com:8200, không phải vault.example.com:8200.
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.
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.
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.
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:
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.