Chuyển đến nội dung chính
Kết nối Prowler để các agent CloudThinker liệt kê các kiểm tra bảo mật thất bại theo mức độ nghiêm trọng, hiển thị tài nguyên liên quan và báo cáo những yêu cầu chưa đạt trong từng framework tuân thủ. Prowler xác thực bằng API key, và kết nối ở chế độ chỉ đọc: agent không bao giờ khởi chạy scan, mute phát hiện hay thay đổi provider.

​
Điều kiện tiên quyết

  • Một tài khoản Prowler Cloud, hoặc một Prowler tự quản lý có API truy cập được từ internet. Để giới hạn ai có thể truy cập, hãy đưa các egress IP của CloudThinker vào allowlist. 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 CloudThinker của bạn, hoặc liên hệ chúng tôi. Xem Truy cập dịch vụ nội bộ để biết các lựa chọn khác.
  • Ít nhất một tài khoản cloud (Prowler gọi là provider) mà Prowler đã scan. Agent đọc kết quả scan; agent không thể chạy scan.
  • Một người dùng Prowler có quyền Manage Account. Prowler yêu cầu quyền này để tạo API key.
  • Quyền sửa kết nối trong workspace CloudThinker của bạn.

​
Thiết lập

1

Tạo API key trong Prowler

Đăng nhập Prowler bằng người dùng có đúng mức quyền bạn muốn cấp cho agent (xem Quyền yêu cầu). Vào Profile → Account và nhấn Create API Key để mở biểu mẫu.Đặt tên key là cloudthinker và tùy chọn đặt ngày hết hạn. Nếu không đặt, key hết hạn sau 365 ngày. Sau đó nhấn Create API Key trong biểu mẫu.Prowler chỉ hiển thị key mới một lần. Sao chép key trước khi đóng hộp thoại.
2

Mở Prowler trong CloudThinker

Trên thanh bên, nhấn More → Workspace settings → Connections. Trên tab Builtin Connections, tìm Prowler và nhấn Connect.
3

Nhập key và kết nối

Điền hai trường. Biểu mẫu hiển thị đúng các tên sau:
  • PROWLER_API_KEY: key bạn đã sao chép.
  • API_BASE_URL: giữ giá trị mặc định cho Prowler Cloud, hoặc nhập địa chỉ API của Prowler tự quản lý.
Nhấn Connect.Trạng thái thành công: kết nối Prowler hiển thị trạng thái Connected.
Connected không chứng minh key hoạt động. Prowler chỉ kiểm tra key lần đầu agent gọi đến, vì vậy hãy chạy prompt xác minh bên dưới ngay sau khi kết nối.

​
Chi tiết kết nối

​
Quyền yêu cầu

Prowler API key có cùng quyền truy cập với người dùng đã tạo key.
Tạo key từ một người dùng Prowler riêng. Cấp cho người dùng đó một vai trò có Manage Account (cần để người dùng này tự tạo key) cùng Unlimited Visibility hoặc chỉ các provider group mà CloudThinker cần. Khi đó bạn có thể thay đổi hoặc gỡ quyền truy cập của người dùng này mà không ảnh hưởng đến người khác.

​
Khả năng của agent

Kiểm tra và tài liệu lấy từ Prowler Hub công khai và tài liệu Prowler, không lấy từ tenant của bạn. Mọi thứ khác được đọc bằng API key của bạn. Agent không thể thêm hoặc xóa provider, khởi chạy hoặc lên lịch scan, tạo hoặc thay đổi mute rule, hay gửi phát hiện sang Jira. Hãy làm những việc đó trong Prowler.

​
Xác minh kết nối

Bắt đầu một cuộc chat, nhập # và chọn Prowler, rồi hỏi:
Kết quả mong đợi: danh sách provider của bạn kèm số phát hiện không đạt theo từng mức độ nghiêm trọng. Nếu key sai, agent sẽ báo lỗi 401 (xem Khắc phục sự cố).

​
Ví dụ prompt

Agent trả lời dựa trên những gì đọc được trong cuộc hội thoại hiện tại. Lệnh gọi Prowler thất bại được báo là lỗi, không bao giờ bị báo thành không có phát hiện nào.

​
Khắc phục sự cố

Prowler đã từ chối key. Key có thể bị gõ sai, đã hết hạn hoặc bị thu hồi, hoặc người dùng của key đã bị xóa khỏi tenant. Tạo key mới trong Profile → Account và cập nhật kết nối.
API_BASE_URL sai. Khôi phục https://api.prowler.com/api/v1 cho Prowler Cloud, hoặc nhập địa chỉ API tự quản lý kết thúc bằng /api/v1.
Người dùng của key không thấy provider nào, hoặc Prowler chưa có kết quả scan. Cấp cho người dùng Unlimited Visibility hoặc đúng provider group, và kiểm tra trong Prowler rằng một lượt scan đã hoàn tất.
Người dùng của key chỉ thấy các provider group mà vai trò của người dùng đó cho phép. Thêm các provider group còn thiếu vào vai trò đó, hoặc cấp cho vai trò Unlimited Visibility, rồi hỏi lại.
Đây là hành vi mong đợi. Kết nối ở chế độ chỉ đọc. Thêm tài khoản cloud và chạy scan trong Prowler, rồi hỏi lạ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.
  • Thu hồi, không xóa. Prowler không cho phép xóa API key. Dùng Revoke để vô hiệu hóa key bạn không còn cần.
  • Xoay vòng trước khi hết hạn. Key mặc định hết hạn sau 365 ngày. Tạo key mới và cập nhật kết nối trước thời điểm đó.

​
Liên quan

Kết nối AWS

Kiểm tra và khắc phục các tài khoản mà Prowler scan

Kết nối Drata

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ự