Điều kiện tiên quyết
- Tài khoản Admin Drata. Chỉ Admin mới mở được Settings → API Keys.
- Region Drata của bạn: US (
app.drata.com), EU (app.eu.drata.com) hoặc APAC (app.apac.drata.com). - Admin Drata đã chấp nhận điều khoản của Drata cho tài khoản của bạn. Drata từ chối các yêu cầu API cho đến khi điều này được thực hiện.
- Quyền chỉnh sửa kết nối trong workspace CloudThinker của bạn.
Thiết lập
Tạo API key trong Drata
- Name:
cloudthinker. Bạn không thể đổi tên sau này. - Expiration date: 12 tháng (mặc định), một ngày tùy chọn, hoặc Never.
- Allowed IP addresses: thêm các egress IP của CloudThinker, hoặc để trống. Key bị giới hạn ở các địa chỉ khác sẽ khiến bài kiểm tra kết nối thất bại. Tài liệu này không công bố danh sách egress IP của CloudThinker: hãy hỏi đầu mối liên hệ CloudThinker của bạn, hoặc liên hệ chúng tôi.
- Access: All read để chỉ điều tra, hoặc All read and write để cho phép agent thực hiện các thay đổi đã được phê duyệt.
Mở Drata trong CloudThinker
Nhập key và region
- API key: key bạn đã sao chép.
- Region: chọn region của tài khoản Drata từ danh sách thả xuống.
Drata connection verified (<your company>, <REGION>).Chi tiết kết nối
Quyền yêu cầu
Khả năng của agent
Xác minh kết nối
Bắt đầu một cuộc chat, nhập# và chọn Drata, rồi hỏi:
Ví dụ prompt
Quyền ghi
Key có All read and write cho phép agent thay đổi:- Bằng chứng và policy
- Control và người sở hữu control
- Nhân sự
- Vendor và rủi ro
- Task, ghi chú và dữ liệu tùy chỉnh
- Thao tác đọc chạy mà không cần phê duyệt.
- Trước khi hỏi, agent đọc bản ghi hiện tại và cho bạn biết điều gì sẽ thay đổi.
- Agent cảnh báo khi thay đổi không thể hoàn tác, chẳng hạn thao tác xóa, kiểm tra lý lịch, chạy lại test, hành động về nhân sự và policy, và import.
- Sau khi thay đổi, agent đọc lại bản ghi và báo cáo thay đổi đã được xác nhận hay chưa.
Khắc phục sự cố
Các tiêu đề accordion viết thành câu hoàn chỉnh và kết thúc bằng dấu chấm là chính xác các thông báo CloudThinker hiển thị khi bài kiểm tra kết nối thất bại.Drata rejected the API key. Check that it was copied whole, that it has not expired or been revoked in Settings > API Keys, and that the region matches your Drata tenant.
Drata rejected the API key. Check that it was copied whole, that it has not expired or been revoked in Settings > API Keys, and that the region matches your Drata tenant.
Drata accepted the key but refused the request. Check the key's scopes and its IP allowlist in Settings > API Keys.
Drata accepted the key but refused the request. Check the key's scopes and its IP allowlist in Settings > API Keys.
Drata refused the request because the tenant has not accepted Drata's terms. A Drata admin must sign in and accept them, then test again.
Drata refused the request because the tenant has not accepted Drata's terms. A Drata admin must sign in and accept them, then test again.
Drata rate-limited the test. The limit is 500 requests per minute per source IP, so wait a minute and test again.
Drata rate-limited the test. The limit is 500 requests per minute per source IP, so wait a minute and test again.
Could not reach the Drata API. Check network access.
Could not reach the Drata API. Check network access.
Drata answered, but did not name the company for this API key. Create a new key in Settings > API Keys, then test again.
Drata answered, but did not name the company for this API key. Create a new key in Settings > API Keys, then test again.
Choose a Drata region: us, eu, or apac.
Choose a Drata region: us, eu, or apac.
Agent báo một mục Drata không có trong gói này
Agent báo một mục Drata không có trong gói này
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.
- Dùng key riêng. Đặt tên là
cloudthinker, để bạn có thể xem lần dùng gần nhất trong Settings → API Keys và thu hồi mà không ảnh hưởng đến các công cụ khác. - Xoay vòng trước khi hết hạn. Key hết hạn sau 12 tháng theo mặc định. Tạo key mới và cập nhật kết nối trước thời điểm đó.