prowler-cloud/prowlerProwler هي منصة أمن سحابي مفتوحة المصدر الأكثر استخدامًا على مستوى العالم، وهي تعمل على أتمتة الأمن والامتثال عبر أي بيئة سحابية. اربط وكلاءك الآن وابنِ على Agentic Cloud Defender.
<p align="center">
<img align="center" alt="Prowler logo" src="https://raw.githubusercontent.com/prowler-cloud/prowler/master/docs/img/prowler-logo-black.png#gh-light-mode-only" width="50%" height="50%">
<img align="center" alt="Prowler logo" src="https://raw.githubusercontent.com/prowler-cloud/prowler/master/docs/img/prowler-logo-white.png#gh-dark-mode-only" width="50%" height="50%">
</p>
<p align="center">
<b><i>Prowler</b> هي منصة الأمن السحابي المفتوحة الموثوقة من قبل الآلاف لأتمتة الأمن والامتثال في أي بيئة سحابية. مع آلاف الفحوصات الجاهزة للاستخدام وأطر الامتثال، تقدم Prowler مراقبة في الوقت الفعلي وقابلة للتخصيص وتكاملات سلسة، مما يجعل الأمن السحابي بسيطًا وقابلًا للتوسع وفعالًا من حيث التكلفة للمؤسسات من أي حجم.
</p>
<p align="center">
<b>المدافع السحابي الوكيل</i></b>
</p>
<p align="center">
<a href="https://cloud.prowler.com/sign-up">جرّب Prowler Cloud</a>
</p>
<p align="center">
<a href="https://goto.prowler.com/slack"><img width="30" height="30" alt="Prowler community on Slack" src="https://assets.kitploit.com/production/public/readmes/2538/6815b86accf315cdf23afa1d72f1d9f88f899835d8ecddcd84f8479de05471c1.png"></a>
<br>
<a href="https://goto.prowler.com/slack">انضم إلى مجتمع Prowler!</a>
</p>
<hr>
<p align="center">
<a href="https://goto.prowler.com/slack"><img alt="Slack Shield" src="https://img.shields.io/badge/slack-prowler-brightgreen.svg?logo=slack"></a>
<a href="https://pypi.org/project/prowler/"><img alt="Python Version" src="https://img.shields.io/pypi/v/prowler.svg"></a>
<a href="https://pypi.python.org/pypi/prowler/"><img alt="Python Version" src="https://img.shields.io/pypi/pyversions/prowler.svg"></a>
<a href="https://pypistats.org/packages/prowler"><img alt="PyPI Downloads" src="https://img.shields.io/pypi/dw/prowler.svg?label=downloads"></a>
<a href="https://hub.docker.com/r/toniblyx/prowler"><img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/toniblyx/prowler"></a>
<a href="https://gallery.ecr.aws/prowler-cloud/prowler"><img width="120" height="19" alt="AWS ECR Gallery" src="https://assets.kitploit.com/production/public/readmes/2538/303a8488b665aa89d4361d05140d3c00466f7bf8caef7bd602e2ca23fa11ecaa.png"></a>
<a href="https://codecov.io/gh/prowler-cloud/prowler"><img alt="Codecov coverage" src="https://codecov.io/gh/prowler-cloud/prowler/graph/badge.svg?token=OflBGsdpDl"/></a>
<a href="https://insights.linuxfoundation.org/project/prowler-cloud-prowler"><img alt="Linux Foundation insights health score" src="https://insights.linuxfoundation.org/api/badge/health-score?project=prowler-cloud-prowler"/></a>
</p>
<p align="center">
<a href="https://github.com/prowler-cloud/prowler/releases"><img alt="Version" src="https://img.shields.io/github/v/release/prowler-cloud/prowler"></a>
<a href="https://github.com/prowler-cloud/prowler/releases"><img alt="Version" src="https://img.shields.io/github/release-date/prowler-cloud/prowler"></a>
<a href="https://github.com/prowler-cloud/prowler"><img alt="Contributors" src="https://img.shields.io/github/contributors-anon/prowler-cloud/prowler"></a>
<a href="https://github.com/prowler-cloud/prowler/issues"><img alt="Issues" src="https://img.shields.io/github/issues/prowler-cloud/prowler"></a>
<a href="https://github.com/prowler-cloud/prowler"><img alt="License" src="https://img.shields.io/github/license/prowler-cloud/prowler"></a>
<a href="https://twitter.com/ToniBlyx"><img alt="Twitter" src="https://img.shields.io/twitter/follow/toniblyx?style=social"></a>
<a href="https://twitter.com/prowlercloud"><img alt="Twitter" src="https://img.shields.io/twitter/follow/prowlercloud?style=social"></a>
</p>
<hr>
<p align="center">
<img align="center" alt="Prowler Cloud demo" src="https://assets.kitploit.com/production/public/readmes/2538/043a71fa35a004ac2df2e07065732f30229319ec9b6460dd27eb71b91335963a.gif" width="100%" height="100%">
</p>
# الوصف
**Prowler** هي _منصة الأمن السحابي مفتوحة المصدر_ الأكثر استخدامًا على مستوى العالم، والتي تُؤتمت الأمن والامتثال عبر **أي بيئة سحابية**. مع آلاف الفحوصات الأمنية الجاهزة للاستخدام، وإرشادات المعالجة، وأطر الامتثال، صُممت Prowler لـ _"تأمين أي سحابة بسرعة الذكاء الاصطناعي"_. تقدّم Prowler تقييمات **مدفوعة بالذكاء الاصطناعي**، و**قابلة للتخصيص**، و**سهلة الاستخدام**، بالإضافة إلى لوحات المعلومات والتقارير والتكاملات، مما يجعل الأمن السحابي **بسيطًا** و**قابلًا للتوسع** و**فعّالًا من حيث التكلفة** للمؤسسات من أي حجم.
تتضمن Prowler مئات الضوابط المدمجة لضمان الامتثال للمعايير والأطر، بما في ذلك:
- **Prowler ThreatScore:** تسجيل مرجّح لتحديد أولويات المخاطر يساعدك على التركيز على النتائج الأمنية الأكثر خطورة أولًا
- **معايير الصناعة:** CIS وNIST 800 وNIST CSF وCISA وMITRE ATT&CK
- **الامتثال التنظيمي والحوكمة:** RBI وFedRAMP وPCI-DSS وNIS2
- **أطر البيانات الحساسة والخصوصية:** GDPR وHIPAA وFFIEC
- **أطر الحوكمة التنظيمية ومراقبة الجودة:** SOC2 وGXP وISO 27001
- **أطر خاصة بالسحابة:** AWS Foundational Technical Review (FTR) وAWS Well-Architected Framework وBSI C5
- **معايير الأمن الوطني:** ENS (مخطط الأمن الوطني الإسباني) وKISA ISMS-P (الكوري)
- **أطر أمنية مخصصة:** مصممة وفقًا لاحتياجاتك
## Prowler Cloud & Prowler Local Server
[Prowler Cloud](https://cloud.prowler.com/sign-up) وProwler Local Server، نسخته مفتوحة المصدر ذاتية الاستضافة، هما تطبيقان ويب يبسّطان تشغيل Prowler عبر حسابات مزوّد السحابة لديك. يوفّران واجهة سهلة الاستخدام لتصوّر النتائج وتبسيط تقييماتك الأمنية.
>لمزيد من التفاصيل، راجع [وثائق Prowler Local Server](https://docs.prowler.com/getting-started/installation/prowler-app)
## Prowler CLI
```console
prowler <provider>
```
## لوحة تحكم Prowler المحلية
```console
prowler dashboard
```
## مسارات الهجوم
تعمل ميزة مسارات الهجوم (Attack Paths) تلقائيًا على توسيع كل فحص AWS مكتمل باستخدام رسم بياني يجمع بين جرد السحابة الخاص بـ Cartography ونتائج Prowler. تعمل هذه الميزة في عامل API بعد كل فحص.
يتم دعم خلفيتين للرسم البياني كمستقبل طويل الأمد:
- **Neo4j** (الافتراضي؛ تتضمن ملفات Docker Compose بالفعل خدمة `neo4j`).
- **Amazon Neptune** (مُدار سحابيًا؛ اختياري).
اختر المستقبل باستخدام `ATTACK_PATHS_SINK_DATABASE` (`neo4j` أو `neptune`؛ الافتراضي `neo4j`).
> ملاحظة: يستخدم استيعاب Cartography دائمًا قاعدة بيانات Neo4j مؤقتة، بغض النظر عن المستقبل المُهيأ. يجب أن تظل متغيرات `NEO4J_*` أدناه مضبوطة حتى عند تعيين `ATTACK_PATHS_SINK_DATABASE=neptune`.
### مستقبل Neo4j
| المتغير | الوصف | الافتراضي |
| --- | --- | --- |
| `NEO4J_HOST` | اسم المضيف الذي تستخدمه حاويات API. | `neo4j` |
| `NEO4J_PORT` | منفذ Bolt الذي يعرضه Neo4j. | `7687` |
| `NEO4J_USER` / `NEO4J_PASSWORD` | بيانات اعتماد تمتلك صلاحيات إنشاء قواعد بيانات لكل مستأجر. | `neo4j` / `neo4j_password` |
### مستقبل Neptune
| المتغير | الوصف | الافتراضي |
| --- | --- | --- |
| `NEPTUNE_WRITER_ENDPOINT` | مضيف Bolt لنسخة كاتب Neptune. مطلوب عندما يكون المستقبل `neptune`. | _فارغ_ |
| `NEPTUNE_READER_ENDPOINT` | نقطة نهاية قارئ اختيارية للاستعلامات للقراءة فقط. يعود إلى الكاتب عند عدم تعيينه. | _فارغ_ |
| `NEPTUNE_PORT` | منفذ Bolt الذي يعرضه Neptune. | `8182` |
| `AWS_REGION` | المنطقة التي توجد فيها مجموعة Neptune. مطلوب عندما يكون المستقبل `neptune`. | _فارغ_ |
تتم مصادقة Neptune باستخدام SigV4 عبر سلسلة بيانات الاعتماد القياسية لـ boto3. يوفر دور IAM الخاص بالعامل (أو `AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`) بيانات الاعتماد. لا يوجد متغير كلمة مرور لـ Neptune.
سيقوم كل فحص لمزوّد AWS بإدراج مهمة استيعاب مسارات الهجوم تلقائيًا في قائمة الانتظار. ستُضاف مزوّدات سحابية أخرى في التكرارات المستقبلية.
# Prowler في لمحة
> [!Tip]
> للحصول على المعلومات الأكثر دقة وحداثة حول الفحوصات والخدمات والأطر والفئات، قم بزيارة [**Prowler Hub**](https://hub.prowler.com).
| المزوّد | الفحوصات | الخدمات | [أطر الامتثال](https://docs.prowler.com/user-guide/compliance/tutorials/compliance) | [الفئات](https://docs.prowler.com/user-guide/cli/tutorials/misc#categories) | الدعم | الواجهة |
|---|---|---|---|---|---|---|
| AWS | 639 | 86 | 47 | 19 | رسمي | UI, API, CLI |
| Azure | 191 | 22 | 21 | 16 | رسمي | UI, API, CLI |
| GCP | 109 | 20 | 19 | 12 | رسمي | UI, API, CLI |
| Kubernetes | 92 | 7 | 8 | 11 | رسمي | UI, API, CLI |
| GitHub | 24 | 3 | 2 | 5 | رسمي | UI, API, CLI |
| M365 | 143 | 10 | 6 | 10 | رسمي | UI, API, CLI |
| OCI | 52 | 14 | 5 | 10 | رسمي | UI, API, CLI |
| Alibaba Cloud | 63 | 9 | 6 | 9 | رسمي | UI, API, CLI |
| Cloudflare | 29 | 3 | 2 | 5 | رسمي | UI, API, CLI |
| IaC | [راجع وثائق `trivy`.](https://trivy.dev/latest/docs/coverage/iac/) | غير متاح | غير متاح | غير متاح | رسمي | UI, API, CLI |
| MongoDB Atlas | 10 | 3 | 1 | 8 | رسمي | UI, API, CLI |
| LLM | [راجع وثائق `promptfoo`.](https://www.promptfoo.dev/docs/red-team/plugins/) | غير متاح | غير متاح | غير متاح | رسمي | CLI |
| Image | غير متاح | غير متاح | غير متاح | غير متاح | رسمي | UI, API, CLI |
| Google Workspace | 65 | 11 | 3 | 6 | رسمي | UI, API, CLI |
| OpenStack | 34 | 5 | 1 | 9 | رسمي | UI, API, CLI |
| Vercel | 26 | 6 | 1 | 8 | رسمي | UI, API, CLI |
| Okta | 29 | 8 | 2 | 2 | رسمي | UI, API, CLI |
| Linode [اتصل بنا](https://prowler.com/contact) | 10 | 3 | 1 | 4 | غير رسمي | CLI |
| Huawei Cloud [اتصل بنا](https://prowler.com/contact) | 25 | 10 | 1 | 6 | غير رسمي | CLI |
| E2E Networks [اتصل بنا](https://prowler.com/contact) | 27 | 6 | 0 | 2 | غير رسمي | CLI |
| Scaleway [اتصل بنا](https://prowler.com/contact) | 1 | 1 | 1 | 1 | غير رسمي | CLI |
| StackIT [اتصل بنا](https://prowler.com/contact) | 8 | 2 | 1 | 3 | غير رسمي | CLI |
| NHN | 6 | 2 | 2 | 0 | غير رسمي | CLI |
> [!Note]
> يتم تحديث الأرقام في الجدول بشكل دوري.
> [!Note]
> استخدم الأوامر التالية لعرض فحوصات Prowler والخدمات وأطر الامتثال والفئات المتاحة:
> - `prowler <provider> --list-checks`
> - `prowler <provider> --list-services`
> - `prowler <provider> --list-compliance`
> - `prowler <provider> --list-categories`
# 💻 التثبيت
## Prowler Local Server
يوفر Prowler Local Server طرق تثبيت مرنة مصممة لمختلف البيئات:
> للحصول على تعليمات مفصلة حول استخدام Prowler Local Server، راجع [دليل الاستخدام](https://docs.prowler.com/user-guide/tutorials/prowler-app).
### Docker Compose
#### المتطلبات
- تثبيت `Docker Compose`: https://docs.docker.com/compose/install/.
#### الأوامر
_macOS/Linux:_
``` console
VERSION=$(curl -s https://api.github.com/repos/prowler-cloud/prowler/releases/latest | jq -r .tag_name)
curl -sLO "https://raw.githubusercontent.com/prowler-cloud/prowler/refs/tags/${VERSION}/docker-compose.yml"
# Environment variables can be customized in the .env file. Using default values in production environments is not recommended.
curl -sLO "https://raw.githubusercontent.com/prowler-cloud/prowler/refs/tags/${VERSION}/.env"
docker compose up -d
```
_Windows PowerShell:_
``` powershell
$VERSION = (Invoke-RestMethod -Uri "https://api.github.com/repos/prowler-cloud/prowler/releases/latest").tag_name
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/prowler-cloud/prowler/refs/tags/$VERSION/docker-compose.yml" -OutFile "docker-compose.yml"
# Environment variables can be customized in the .env file. Using default values in production environments is not recommended.
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/prowler-cloud/prowler/refs/tags/$VERSION/.env" -OutFile ".env"
docker compose up -d
```
> [!WARNING]
> 🔒 لإعداد آمن، تُنشئ واجهة API تلقائيًا زوج مفاتيح فريدًا، `DJANGO_TOKEN_SIGNING_KEY` و `DJANGO_TOKEN_VERIFYING_KEY`، وتخزّنه في `~/.config/prowler-api` (خارج الحاوية) أو في وحدة تخزين Docker المرتبطة في `_data/api` (داخل الحاوية). لا تُدرج أو تُعِد استخدام مفاتيح ثابتة/افتراضية أبدًا. لتدوير المفاتيح، احذف ملفات المفاتيح المخزّنة وأعد تشغيل واجهة API.
بعد الإعداد، يمكنك الوصول إلى Prowler Local Server على http://localhost:3000. سجّل باستخدام بريدك الإلكتروني وكلمة المرور للبدء.
### المشكلات الشائعة مع تثبيت Docker Pull
> [!Note]
إذا كنت ترغب في استخدام افتراض دور AWS (على سبيل المثال، مع خيار "Connect assuming IAM Role")، فقد تحتاج إلى ربط دليل `.aws` المحلي الخاص بك داخل الحاوية كوحدة تخزين (على سبيل المثال، `- "${HOME}/.aws:/home/prowler/.aws:ro"`). هناك عدة طرق لتكوين بيانات الاعتماد لحاويات Docker. راجع قسم [استكشاف الأخطاء وإصلاحها](https://github.com/prowler-cloud/prowler/blob/master/docs/troubleshooting.mdx) للحصول على مزيد من التفاصيل والأمثلة.
يمكنك العثور على مزيد من المعلومات في قسم [استكشاف الأخطاء وإصلاحها](https://github.com/prowler-cloud/prowler/blob/master/docs/troubleshooting.mdx).
### من GitHub
#### المتطلبات
- تثبيت `git`.
- تثبيت `uv`: [تثبيت uv](https://docs.astral.sh/uv/getting-started/installation/).
- تثبيت `pnpm`: [تثبيت pnpm](https://pnpm.io/installation).
- تثبيت `Docker Compose`: https://docs.docker.com/compose/install/.
#### أوامر تشغيل واجهة API
``` console
git clone https://github.com/prowler-cloud/prowler
cd prowler/api
uv sync
source .venv/bin/activate
set -a
source .env
docker compose up postgres valkey -d
cd src/backend
python manage.py migrate --database admin
gunicorn -c config/guniconf.py config.wsgi:application
```
> بعد إكمال الإعداد، يمكنك الوصول إلى توثيق API على http://localhost:8080/api/v1/docs.
#### أوامر تشغيل عامل API
``` console
git clone https://github.com/prowler-cloud/prowler
cd prowler/api
uv sync
source .venv/bin/activate
set -a
source .env
cd src/backend
python -m celery -A config.celery worker -l info -E
```
#### أوامر لتشغيل API Scheduler
``` console
git clone https://github.com/prowler-cloud/prowler
cd prowler/api
uv sync
source .venv/bin/activate
set -a
source .env
cd src/backend
python -m celery -A config.celery beat -l info --scheduler django_celery_beat.schedulers:DatabaseScheduler
```
#### أوامر تشغيل واجهة المستخدم
``` console
git clone https://github.com/prowler-cloud/prowler
cd prowler/ui
pnpm install
pnpm run build
pnpm start
```
> بعد الإعداد، يمكنك الوصول إلى Prowler Local Server على http://localhost:3000. سجّل باستخدام بريدك الإلكتروني وكلمة المرور للبدء.
#### إعداد خطافات pre-commit
تتطلب بعض خطافات pre-commit أدوات مثبّتة على نظامك:
1. **ثبّت [TruffleHog](https://github.com/trufflesecurity/trufflehog#install)** (فحص الأسرار) — راجع [خيارات التثبيت الرسمية](https://github.com/trufflesecurity/trufflehog#install).
2. **ثبّت [Hadolint](https://github.com/hadolint/hadolint#install)** (فحص Dockerfile) — راجع [خيارات التثبيت الرسمية](https://github.com/hadolint/hadolint#install).
## Prowler CLI
### حزمة Pip
يتوفر Prowler CLI كمشروع في [PyPI](https://pypi.org/project/prowler-cloud/). وبالتالي، يمكن تثبيته باستخدام pip مع Python >=3.10، <3.13:
```console
pip install prowler
prowler -v
```
>لمزيد من الإرشادات، راجع [https://docs.prowler.com](https://docs.prowler.com/getting-started/installation/prowler-cli)
### الحاويات
#### الإصدارات المتاحة من Prowler CLI
تتوفر الإصدارات التالية من Prowler CLI، وفقًا لمتطلباتك:
- `latest`: يتزامن مع فرع `master`. لاحظ أن هذا الإصدار غير مستقر.
- `v4-latest`: يتزامن مع فرع `v4`. لاحظ أن هذا الإصدار غير مستقر.
- `v3-latest`: يتزامن مع فرع `v3`. لاحظ أن هذا الإصدار غير مستقر.
- `<x.y.z>` (إصدار): إصدارات مستقرة تقابل إصدارات محددة. راجع [القائمة الكاملة لإصدارات Prowler](https://github.com/prowler-cloud/prowler/releases).
- `stable`: يشير دائمًا إلى أحدث إصدار.
- `v4-stable`: يشير دائمًا إلى أحدث إصدار لـ v4.
- `v3-stable`: يشير دائمًا إلى أحدث إصدار لـ v3.
صور الحاويات متاحة هنا:
- Prowler CLI:
- [DockerHub](https://hub.docker.com/r/prowlercloud/prowler/tags)
- [AWS Public ECR](https://gallery.ecr.aws/prowler-cloud/prowler)
- Prowler Local Server:
- [DockerHub - Prowler UI](https://hub.docker.com/r/prowlercloud/prowler-ui/tags)
- [DockerHub - Prowler API](https://hub.docker.com/r/prowlercloud/prowler-api/tags)
### من GitHub
يتطلب Python >=3.10، <3.13 مع [uv](https://docs.astral.sh/uv/):
``` console
git clone https://github.com/prowler-cloud/prowler
cd prowler
uv sync
source .venv/bin/activate
python prowler-cli.py -v
```
> [!IMPORTANT]
> لاستنساخ Prowler على Windows، قم بتهيئة Git لدعم مسارات الملفات الطويلة عن طريق تشغيل الأمر التالي: `git config core.longpaths true`.
# 🛡️ إجراء GitHub
يقوم **إجراء Prowler الرسمي على GitHub** بتشغيل عمليات فحص Prowler في سير عمل GitHub الخاصة بك باستخدام صورة Docker الرسمية [`prowlercloud/prowler`](https://hub.docker.com/r/prowlercloud/prowler). تعمل عمليات الفحص على أي [مزوّد مدعوم](https://docs.prowler.com/user-guide/providers/)، مع خيار [`--push-to-cloud`](https://docs.prowler.com/user-guide/tutorials/prowler-import-findings) الاختياري لإرسال النتائج إلى Prowler Cloud وخيار رفع SARIF الاختياري بحيث تظهر النتائج في علامة التبويب **Security → Code scanning** الخاصة بالمستودع وكملاحظات مضمّنة في طلبات السحب (PR).
```yaml
name: Prowler IaC Scan
on:
pull_request:
permissions:
contents: read
security-events: write
actions: read
jobs:
prowler:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: prowler-cloud/[email protected]
with:
provider: iac
output-formats: sarif json-ocsf
upload-sarif: true
flags: --severity critical high
```
التكوين الكامل، والمصادقة لكل مزوّد، وأمثلة SARIF: [Prowler GitHub Action tutorial](https://github.com/prowler-cloud/prowler/blob/master/docs/user-guide/tutorials/prowler-app-github-action.mdx). قائمة Marketplace: [Prowler Security Scan](https://github.com/marketplace/actions/prowler-security-scan).
# ✏️ البنية عالية المستوى
## Prowler Local Server
يتكوّن **Prowler Local Server** من أربعة مكوّنات رئيسية:
- **Prowler UI**: واجهة قائمة على الويب، مبنية باستخدام Next.js، توفّر تجربة سهلة الاستخدام لتنفيذ عمليات فحص Prowler وعرض النتائج.
- **Prowler API**: خدمة خلفية، مطوّرة باستخدام Django REST Framework، مسؤولة عن تشغيل عمليات فحص Prowler وتخزين النتائج المُولّدة.
- **Prowler SDK**: حزمة تطوير برمجيات Python مصمّمة لتوسيع وظائف Prowler CLI لإتاحة قدرات متقدمة.
- **Prowler MCP Server**: خادم Model Context Protocol يوفّر أدوات ذكاء اصطناعي لـ Lighthouse، المساعد الأمني المدعوم بالذكاء الاصطناعي. وهو اعتماد بالغ الأهمية لوظائف Lighthouse.
```mermaid
flowchart TB
user([User / Security Team])
cli([Prowler CLI])
subgraph APP["Prowler Local Server"]
ui["Prowler UI<br/>(Next.js)"]
api["Prowler API<br/>(Django REST Framework)"]
worker["API Worker<br/>(Celery)"]
beat["API Scheduler<br/>(Celery Beat)"]
mcp["Prowler MCP Server<br/>(Lighthouse AI tools)"]
end
sdk["Prowler SDK<br/>(Python)"]
subgraph DATA["Data Layer"]
pg[("PostgreSQL")]
valkey[("Valkey / Redis")]
neo4j[("Neo4j")]
end
providers["Providers"]
user --> ui
user --> cli
ui -->|REST| api
ui -->|MCP HTTP| mcp
mcp -->|REST| api
api --> pg
api --> valkey
beat -->|enqueue jobs| valkey
valkey -->|dispatch| worker
worker --> pg
worker -->|Attack Paths| neo4j
worker -->|invokes| sdk
cli --> sdk
sdk --> providers
```
<!-- Diagram source: docs/images/products/prowler-app-architecture.mmd — keep this inline block, the docs page getting-started/products/prowler-app.mdx, and the .mmd file in sync. -->
## Prowler CLI
### تشغيل Prowler
يمكن تنفيذ Prowler عبر بيئات متنوعة، مما يوفر مرونة لتلبية احتياجاتك. يمكن تشغيله من:
- محطة العمل الخاصة بك
- Kubernetes Job
- Google Compute Engine
- Azure Virtual Machines (VMs)
- Amazon EC2 instances
- AWS Fargate أو منصات الحاويات الأخرى
- CloudShell
والعديد من البيئات الأخرى.
# 🤖 مهارات الذكاء الاصطناعي للتطوير
يتضمن Prowler مجموعة شاملة من **مهارات الذكاء الاصطناعي** التي تساعد مساعدي البرمجة بالذكاء الاصطناعي على فهم أنماط وأعراف قاعدة شيفرة Prowler.
## ما هي مهارات الذكاء الاصطناعي؟
المهارات هي تعليمات منظمة تمنح مساعدي الذكاء الاصطناعي السياق الذي يحتاجونه لكتابة شيفرة تتبع معايير Prowler. وتشمل:
- **أنماط البرمجة** لكل مكوّن (SDK، API، UI، MCP Server)
- **أعراف الاختبار** (pytest، Playwright)
- **إرشادات البنية المعمارية** (Clean Architecture، أنماط RLS)
- **قواعد خاصة بإطار العمل** (React 19، Next.js 15، Django DRF، Tailwind 4)
## المهارات المتاحة
| الفئة | المهارات |
|----------|--------|
| **عامة** | `typescript`, `react-19`, `nextjs-15`, `tailwind-4`, `playwright`, `pytest`, `django-drf`, `zod-4`, `zustand-5`, `ai-sdk-5` |
| **Prowler** | `prowler`, `prowler-api`, `prowler-ui`, `prowler-mcp`, `prowler-sdk-check`, `prowler-test-ui`, `prowler-test-api`, `prowler-test-sdk`, `prowler-compliance`, `prowler-provider`, `prowler-pr`, `prowler-docs` |
## الإعداد
```bash
./skills/setup.sh
```
يقوم هذا بإعداد المهارات لمساعدي البرمجة بالذكاء الاصطناعي الذين يتبعون معيار [agentskills.io](https://agentskills.io):
| الأداة | الإعداد |
|------|---------------|
| **Claude Code** | `.claude/skills/` (رابط رمزي) |
| **OpenCode** | `.claude/skills/` (رابط رمزي) |
| **Codex (OpenAI)** | `.codex/skills/` (رابط رمزي) |
| **GitHub Copilot** | `.github/skills/` (رابط رمزي) |
| **Gemini CLI** | `.gemini/skills/` (رابط رمزي) |
> **ملاحظة:** أعد تشغيل مساعد البرمجة بالذكاء الاصطناعي بعد تشغيل الإعداد لتحميل المهارات.
> يتطلب Gemini CLI تفعيل `experimental.skills` في الإعدادات.
# 📖 التوثيق
للحصول على تعليمات التثبيت وتفاصيل الاستخدام والدروس التعليمية ودليل المطورين، قم بزيارة https://docs.prowler.com/
# 📃 الترخيص
Prowler مرخّص بموجب Apache License 2.0.
نسخة من الترخيص متاحة على <http://www.apache.org/licenses/LICENSE-2.0>