> ## Documentation Index > Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt > Use this file to discover all available pages before exploring further. # Drata > Kết nối Drata để agent xem xét các test thất bại, mức độ sẵn sàng của control và các thiếu sót về nhân sự, đồng thời thực hiện thay đổi qua Approvals của bạn Kết nối Drata để các agent CloudThinker cho biết monitoring test nào thất bại và chúng chặn những control nào, tìm các control chưa có bằng chứng, và liệt kê những người còn thiếu đào tạo hoặc các bước kiểm tra khác. Drata xác thực bằng một **API key** bạn tạo trong Drata, và với key có quyền đọc và ghi, agent cũng có thể thay đổi bản ghi qua [Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md) của bạn. ## Đ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 **1. Tạo API key trong Drata** Trong Drata, chọn tài khoản ở góc dưới bên trái, rồi **Settings → API Keys**, và nhấn **Create API Key**. Đặt: * **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](https://cloudthinker.io/contact). * **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. Lưu key và sao chép. Drata chỉ hiển thị toàn bộ key một lần. Nếu bạn làm mất, hãy tạo key mới. **2. Mở Drata trong CloudThinker** Trên thanh bên, nhấn **More → Workspace settings → Connections**. Trên tab **Builtin Connections**, tìm **Drata** và nhấn **Connect**. **3. Nhập key và region** Điền: * **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. Nhấn **Connect**. CloudThinker gọi Drata để kiểm tra key. **Trạng thái thành công:** kết nối hiển thị trạng thái **Connected** và `Drata connection verified (, )`. ## Chi tiết kết nối | Trường | Mô tả | Ví dụ | | - | - | - | | **API key** | Key từ **Settings → API Keys** | `` | | **Region** | Danh sách thả xuống: **US**, **EU** hoặc **APAC**, mỗi lựa chọn hiển thị kèm địa chỉ API. Mặc định **US** | **EU** | Mỗi region có địa chỉ API Drata riêng, và region bạn chọn quyết định CloudThinker gọi địa chỉ nào. | Region | Ứng dụng Drata | Địa chỉ API Drata | | - | - | - | | **US** | `app.drata.com` | `public-api.drata.com` | | **EU** | `app.eu.drata.com` | `public-api.eu.drata.com` | | **APAC** | `app.apac.drata.com` | `public-api.apac.drata.com` | ## Quyền yêu cầu | Mục tiêu | Quyền truy cập của key Drata | | - | - | | Chỉ điều tra | **All read** | | Điều tra và thực hiện các thay đổi đã được phê duyệt | **All read and write** | **All read** và **All read and write** cũng bao phủ các scope mà Drata thêm sau này. > [!TIP] > > Bắt đầu với **All read**. Bạn có thể chỉnh sửa scope của một key đang hoạt động bất kỳ lúc nào, nên có thể thêm quyền ghi sau mà không cần key mới. Key **Custom** chỉ dùng được nếu cấp quyền cho mọi khu vực mà agent đọc; khu vực bị thiếu sẽ thất bại với thông báo 403 trong phần Khắc phục sự cố. ## Khả năng của agent | Khả năng | Agent đọc gì | | - | - | | **Tổng quan** | Công ty, gói, workspace và các framework đã bật, kèm mức độ sẵn sàng của từng framework | | **Test thất bại** | Các monitoring test thất bại, cũ nhất trước, các tài nguyên liên quan và các control mà chúng chặn | | **Control và bằng chứng** | Các control chưa sẵn sàng hoặc chưa có bằng chứng, cùng yêu cầu framework, policy và audit | | **Nhân sự** | Ai còn thiếu đào tạo, kiểm tra lý lịch, chấp nhận policy, MFA hoặc kiểm tra thiết bị | | **Vendor và rủi ro** | Vendor, đánh giá bảo mật và sổ đăng ký rủi ro, nếu gói Drata của bạn có các mục này | | **Tích hợp** | Tình trạng các tích hợp Drata của bạn, và tích hợp nào đang gặp vấn đề | Agent chỉ báo cáo những gì đọc được trong cuộc hội thoại hiện tại, vì test và nhân sự thay đổi thường xuyên. Khi gói Drata của bạn không có một mục nào đó, agent sẽ nói rõ thay vì báo cáo là trống. ### 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: ```text theme={null} Summarize my Drata account: workspaces, framework readiness, and the oldest failing tests ``` **Kết quả mong đợi:** tên công ty, các workspace, mức độ sẵn sàng của từng framework, và các test thất bại lâu nhất kèm thời gian đã thất bại. ### Ví dụ prompt ```text theme={null} Which Drata tests have been failing the longest, and which controls do they block? List the people who haven't finished security training or a background check Which Drata controls have no evidence in the framework I'm preparing for? ``` ## 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 **Allow writes** bật theo mặc định, nên key đọc và ghi có thể hành động ngay khi bạn kết nối. Để giữ kết nối ở chế độ chỉ đọc, mở **Drata** trong **More → Workspace settings → Connections** và tắt **Allow writes**. Mọi thay đổi do agent thực hiện đều đi qua [Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md) của workspace trước. Ở chế độ mặc định **Auto · Rules + AI · Ask me**, AI judgment có thể cho một thay đổi an toàn chạy mà không cần hỏi. Allow Rule cũng vậy, sau khi CloudThinker bật [Rule enforcement](https://docs.cloudthinker.io/vi/guide/approvals/rules.md#khắc-phục-sự-cố) cho workspace của bạn. Chọn **Manual** nếu bạn muốn tự phê duyệt mọi thay đổi. Cách thay đổi được thực hiện: 1. Thao tác đọc chạy mà không cần phê duyệt. 2. 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. 3. 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. 4. 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. Agent thực hiện một thay đổi cho mỗi lần phê duyệt. Nếu một thay đổi hết thời gian chờ, agent không thử lại. Thay vào đó, agent đọc lại bản ghi và cho bạn biết thay đổi đã được áp dụng hay chưa. Chỉ phê duyệt lại nếu chưa. Agent không thể tải tệp lên hoặc thay đổi các kết nối AWS, Azure, GCP hoặc GitLab của bạn trong Drata. Hãy thực hiện những thay đổi đó trong ứng dụng Drata. ## 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.** > > Kiểm tra rằng bạn đã sao chép toàn bộ key, trạng thái của key trong **Settings → API Keys** là **Active**, và **Region** khớp với tài khoản của bạn. Key đã hết hạn hoặc bị thu hồi không thể kích hoạt lại, vì vậy hãy tạo key mới. > **Drata accepted the key but refused the request. Check the key's scopes and its IP allowlist in Settings > API Keys.** > > Key hợp lệ nhưng không thể thực hiện yêu cầu này. Mở key trong **Settings → API Keys**, kiểm tra rằng scope của key bao phủ những gì bạn yêu cầu, và **Allowed IP addresses** để trống hoặc bao gồm các egress IP của CloudThinker. > **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.** > > Admin Drata phải đăng nhập vào Drata và chấp nhận các điều khoản hiển thị ở đó. Sau đó nhấn **Connect** lại. > **Drata rate-limited the test. The limit is 500 requests per minute per source IP, so wait a minute and test again.** > > Chờ một phút và kiểm tra lại. Nếu thông báo lặp lại, các công cụ khác gọi Drata từ cùng địa chỉ có thể đang dùng chung giới hạn. Hãy tạm dừng các công cụ đó trước. > **Could not reach the Drata API. Check network access.** > > CloudThinker không thể kết nối đến địa chỉ Drata cho region của bạn. Kiểm tra **Region**, rồi kiểm tra lại. > **Drata answered, but did not name the company for this API key. Create a new key in Settings > API Keys, then test again.** > > Key hoạt động, nhưng Drata không trả về tên công ty. Tạo key mới với **All read** hoặc **All read and write**, và cập nhật kết nối. > **Choose a Drata region: us, eu, or apac.** > > **Region** đang trống hoặc không phải một trong ba lựa chọn. Thông báo dùng mã region viết thường; trong biểu mẫu, hãy chọn **US**, **EU** hoặc **APAC** từ danh sách thả xuống và kết nối lại. > **Agent báo một mục Drata không có trong gói này** > > Gói Drata của bạn không bao gồm khu vực đó, chẳng hạn vendor hoặc rủi ro. Kết nối vẫn hoạt động. Hãy hỏi người sở hữu tài khoản Drata về gói. ## 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 đó. ## Liên quan > **[Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md)** > > Quyết định thay đổi Drata nào được chạy và thay đổi nào chờ bạn > **[Kết nối Prowler](https://docs.cloudthinker.io/vi/guide/connections/prowler.md)** > > Phát hiện bảo mật thất bại và trạng thái tuân thủ cloud This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.