> ## 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.

# Prowler

> Kết nối Prowler để agent rà soát các phát hiện bảo mật không đạt, tài nguyên bị lộ và trạng thái tuân thủ trên các tài khoản cloud của bạn

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](https://cloudthinker.io/contact). Xem [Truy cập dịch vụ nội bộ](https://docs.cloudthinker.io/vi/guide/connections/overview.md#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](#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**.

> [!NOTE]
>
> **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

| Trường | Bắt buộc | Mô tả | Ví dụ |
| - | - | - | - |
| **PROWLER\_API\_KEY** | Có | Prowler API key | `<your-api-key>` |
| **API\_BASE\_URL** | Không | Địa chỉ Prowler API. Mặc định là `https://api.prowler.com/api/v1` (Prowler Cloud) | `https://prowler.example.com/api/v1` |

## 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.

| Mục tiêu | Thiết lập Prowler |
| - | - |
| Đọc phát hiện, tài nguyên và trạng thái tuân thủ | **Unlimited Visibility**, hoặc chỉ các provider group mà agent cần thấy |
| Tạo key | **Manage Account** |

> [!TIP]
>
> 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

| Khả năng | Agent đọc gì |
| - | - |
| **Phạm vi provider** | Các tài khoản cloud mà Prowler giám sát và tổng quan phát hiện của từng tài khoản |
| **Phát hiện không đạt** | Các kiểm tra không đạt, lọc theo mức độ nghiêm trọng (critical, high, medium, low, informational), được nhóm và kèm chi tiết |
| **Tài nguyên** | Danh mục tài nguyên, chi tiết của một tài nguyên và các phát hiện trên tài nguyên đó |
| **Tuân thủ** | Trạng thái theo từng framework và các yêu cầu không đạt |
| **Kiểm tra và tài liệu** | Phạm vi của một kiểm tra Prowler hoặc framework tuân thủ, từ danh mục Prowler Hub và tài liệu Prowler |

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:

```text theme={null}
Summarize my Prowler providers and the count of failed findings by severity
```

**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ố](#khắc-phục-sự-cố)).

### Ví dụ prompt

```text theme={null}
List the critical failed Prowler findings and the resources they affect
Which Prowler compliance frameworks have the most failing requirements?
Show the Prowler resource inventory for my AWS accounts
```

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ố

> **Mọi request đều thất bại với 401**
>
> 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.

> **Request thất bại với lỗi not-found**
>
> **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`.

> **Agent không thấy provider hay phát hiện nào**
>
> 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.

> **Thiếu một số provider hoặc phát hiện**
>
> 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.

> **Agent báo không thể khởi chạy scan hoặc thêm tài khoản**
>
> Đâ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](https://docs.cloudthinker.io/vi/guide/connections/aws.md)**
>
> Kiểm tra và khắc phục các tài khoản mà Prowler scan

> **[Kết nối Drata](https://docs.cloudthinker.io/vi/guide/connections/drata.md)**
>
> 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ự


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.