Skip to content
KitploitKITPLOIT
أدواتالمدونة
Log in
إرسال
أدواتالمدونة
إرسال

أدوات الاختراق واختبار الاختراق والأمن السيبراني لترسانتك الأمنية!

Kitploit هو دليل لأدوات الاختراق والأمن السيبراني واختبار الاختراق. اكتشف آخر تحديثات المشاريع للعثور على الثغرات وتحليل الأنظمة وأتمتة الاختبارات وتعزيز أمنك.

الخلاصاتاتصالالخصوصية© 2026 Kitploit

دليل الأدوات

الفئات

عرض جميع الفئات
Loading categories
allstar — تطبيق GitHub لتعيين وتنفيذ السياسات الأمنية | Kitploit
أدوات/GitHubGitHub/ossf/allstar
أدوات دفاعيةتدقيق التكوينأمن السحابةDevSecOpsأمن سلسلة التوريد
GitHubossf/allstar

allstar

تطبيق GitHub لتعيين وتنفيذ السياسات الأمنية

عرض المستودع
1.4k147100منذ 8 أيامتمت المراجعة من قبل Kitploit
مشاركة
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/ossf/allstar/badge)](https://api.scorecard.dev/projects/github.com/ossf/allstar)

<img align="right" src="https://assets.kitploit.com/production/public/readmes/4605/56f8714eef22fa31a6956e341013b069f09b7dd1b45c374eec1e6987c911ed49.png" width="300" height="400">

# **Allstar**

> [!IMPORTANT]
> **تم إيقاف تطبيق Allstar على GitHub المستضاف من OpenSSF.**
> لا يزال Allstar، وهو مشروع فرعي تابع لـ OpenSSF Scorecard،
> قيد الصيانة — ويجب عليك الآن تشغيله بنفسك، إما
> [كإجراء GitHub](#running-allstar-as-a-github-action) أو
> [كخدمة خلفية (daemon)](#running-allstar-as-a-service-daemon).
>
> راجع [ossf/allstar#881](https://github.com/ossf/allstar/issues/881) لمزيد
> من التفاصيل.
>
> إذا كانت مؤسستك تعتمد على التطبيق المستضاف، فراجع
> [الانتقال بعيدًا عن التطبيق المستضاف](#migrating-off-the-hosted-app).

## نظرة عامة

-  [ما هو Allstar؟](#what-is-allstar)

## الجديد في Allstar

- [whats-new.md](https://github.com/ossf/allstar/blob/main/whats-new.md)

## تعطيل المشكلات غير المرغوب فيها

-  [النجدة! تظهر لديّ مشكلات ينشئها Allstar ولا أريدها!](#disabling-unwanted-issues-1)

## البدء

-  [الخلفية](#background)
-  [خيارات مستوى المؤسسة](#org-level-options)
-  [خيارات التثبيت](#installation-options)
    - [إنشاء تطبيق GitHub الخاص بك](#create-your-github-app)
    - [إنشاء مستودع التحكم `.allstar` الخاص بك](#create-your-allstar-control-repository)
    - [تشغيل Allstar كإجراء GitHub](#running-allstar-as-a-github-action)
    - [تشغيل Allstar كخدمة خلفية (daemon)](#running-allstar-as-a-service-daemon)
-  [الانتقال بعيدًا عن التطبيق المستضاف](#migrating-off-the-hosted-app)

## السياسات والإجراءات
- [الإجراءات](#actions)
- [السياسات](#policies)

## متقدم
- [تعريفات التكوين](#configuration-definitions)
- [أمثلة على التكوينات](#example-config-repository)
- [تشغيل نسختك الخاصة من Allstar](https://github.com/ossf/allstar/blob/main/operator.md)

## المساهمة
- [المساهمة](#contributing)
________
________

## نظرة عامة

### ما هو Allstar؟

Allstar هو تطبيق GitHub يراقب باستمرار مؤسسات GitHub أو
المستودعات للتأكد من التزامها بأفضل ممارسات الأمان. إذا اكتشف Allstar
انتهاكًا لسياسة أمنية، فإنه ينشئ مشكلة (issue) لتنبيه مالك المستودع أو
المؤسسة. وبالنسبة لبعض السياسات الأمنية، يمكن لـ Allstar أيضًا أن يغيّر
تلقائيًا إعداد المشروع الذي تسبب في الانتهاك، معيدًا إياه إلى الحالة
المتوقعة.

هدف Allstar هو منحك تحكمًا دقيقًا في الملفات والإعدادات
التي تؤثر على أمان مشاريعك. يمكنك اختيار السياسات الأمنية التي
تريد مراقبتها على مستوى المؤسسة والمستودع على حد سواء، وكيفية
التعامل مع انتهاكات السياسات. يمكنك أيضًا تطوير سياسات جديدة أو
المساهمة فيها.

يُطوَّر Allstar كجزء من مشروع [OpenSSF Scorecard](https://github.com/ossf/scorecard).

## [الجديد في Allstar](https://github.com/ossf/allstar/blob/main/whats-new.md)

## تعطيل المشكلات غير المرغوب فيها
إذا كانت تظهر لديك مشكلات غير مرغوب فيها ينشئها Allstar، فاتبع [هذه الإرشادات](https://github.com/ossf/allstar/blob/main/opt-out.md) للانسحاب.

## البدء

### الخلفية

Allstar قابل للتكوين بدرجة كبيرة. هناك ثلاثة مستويات رئيسية للتحكم:

- **مستوى المؤسسة**: يمكن لمسؤولي المؤسسة اختيار تمكين Allstar على:
   -  جميع المستودعات في المؤسسة؛
   -  معظم المستودعات، باستثناء بعضها المنسحب منها؛
   -  عدد قليل فقط من المستودعات المشمولة.

تُجرى هذه التكوينات في مستودع `.allstar` الخاص بالمؤسسة.

- **مستوى المستودع:** يمكن لصيانة المستودعات في مؤسسة تستخدم
   Allstar اختيار شمول مستودعهم أو انسحابه من عمليات الإنفاذ على مستوى
   المؤسسة. ملاحظة: لا تعمل عناصر التحكم هذه على مستوى المستودع إلا عندما
   يُسمح بـ "تجاوز المستودع" (repo override) في إعدادات مستوى المؤسسة. تُجرى هذه التكوينات
   في دليل `.allstar` الخاص بالمستودع.

- **مستوى السياسة:** يمكن للمسؤولين أو الصيانة اختيار السياسات
   الممكّنة على مستودعات محددة والإجراءات التي يتخذها Allstar عند انتهاك
   سياسة ما. تُجرى هذه التكوينات في ملف yaml للسياسة في إما
   مستودع `.allstar` الخاص بالمؤسسة (المسؤولون)، أو دليل `.allstar`
   الخاص بالمستودع (الصيانة).

### خيارات مستوى المؤسسة

قبل تثبيت Allstar على مستوى المؤسسة، ينبغي أن تقرر تقريبًا عدد المستودعات
التي تريد أن يعمل عليها Allstar. سيساعدك هذا على الاختيار بين استراتيجيتَي
الاشتراك (Opt-In) والانسحاب (Opt-Out).

-  تتيح لك استراتيجية الاشتراك إضافة المستودعات التي تريد أن يعمل عليها
   Allstar يدويًا. إذا لم تحدد أي مستودعات، فلن يعمل Allstar رغم تثبيته.
   اختر استراتيجية الاشتراك إذا كنت تريد فرض السياسات على عدد صغير فقط من
   إجمالي مستودعاتك، أو تريد تجربة Allstar على مستودع واحد قبل تفعيله على
   المزيد. منذ إصدار v4.3، أصبحت أنماط glob مدعومة لإضافة عدة مستودعات
   ذات اسم مشابه بسهولة.

-  استراتيجية الانسحاب (موصى بها) تفعّل Allstar على جميع المستودعات
   وتتيح لك تحديد المستودعات التي تريد استثناءها يدويًا من تطبيقات
   Allstar. يمكنك أيضًا اختيار استثناء جميع المستودعات العامة، أو جميع
   المستودعات الخاصة. اختر هذا الخيار إذا كنت تريد تشغيل Allstar على جميع
   المستودعات في مؤسسة، أو تريد استثناء عدد صغير فقط من المستودعات أو نوع
   محدد (أي العام مقابل الخاص) من المستودعات.
   منذ إصدار v4.3، أصبحت أنماط glob مدعومة لإضافة عدة مستودعات
   ذات اسم مشابه بسهولة.

<table>
<thead>
<tr>
<th></th>
<th><strong>الانسحاب (موصى به)</strong><br>
<strong>optOutStrategy = true</strong></th>
<th><strong>الاشتراك</strong><br>
<strong>optOutStrategy = false</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>السلوك الافتراضي </td>
<td>جميع المستودعات مفعّلة</td>
<td>لا توجد مستودعات مفعّلة </td>
</tr>
<tr>
<td>إضافة المستودعات يدويًا</td>
<td>إضافة المستودعات يدويًا تعطّل Allstar على تلك المستودعات</td>
<td>إضافة المستودعات يدويًا تفعّل Allstar على تلك المستودعات</td>
</tr>
<tr>
<td>إعدادات إضافية</td>
<td>optOutRepos: سيتم تعطيل Allstar على المستودعات المدرجة<br>
<br>
optOutPrivateRepos: إذا كانت true، سيتم تعطيل Allstar على جميع المستودعات الخاصة
<br>
<br>
optOutPublicRepos: إذا كانت true، سيتم تعطيل Allstar على جميع المستودعات
العامة<br>
<br>
(optInRepos: سيتم تجاهل هذا الإعداد)</td>
<td>optInRepos: سيتم تفعيل Allstar على المستودعات المدرجة <br>
<br>
(optOutRepos: سيتم تجاهل هذا الإعداد)</td>
</tr>
<tr>
<td>تجاوز المستودع </td>
<td>إذا كانت true: يمكن للمستودعات الانسحاب من تطبيقات Allstar الخاصة بمؤسستها
باستخدام الإعدادات في ملف المستودع الخاص بها. يتم تجاهل إعدادات الاشتراك على
مستوى المؤسسة التي تنطبق على ذلك المستودع. <br>
<br>
إذا كانت false: لا يمكن للمستودعات الانسحاب من تطبيقات Allstar كما هي
مُهيّأة على مستوى المؤسسة. </td>
<td>إذا كانت true: يمكن للمستودعات الاشتراك في تطبيقات Allstar الخاصة بمؤسستها حتى
إذا لم تكن مُهيّأة للمستودع على مستوى المؤسسة. يتم تجاهل إعدادات الانسحاب على
مستوى المؤسسة التي تنطبق على ذلك المستودع.<br>
<br>
إذا كانت false: لا يمكن للمستودعات الاشتراك في تطبيقات Allstar إذا لم تكن
مُهيّأة على مستوى المؤسسة. </td>
</tr>
</tbody>
</table>

### خيارات التثبيت

يعمل Allstar على مؤسستك كتطبيق GitHub: فأنت تنشئ التطبيق، وتشغّل العملية
التي تصادق باسمه. لذلك يتكوّن الإعداد من خطوتين مشتركتين بين كل عمليات
النشر — [إنشاء التطبيق](#create-your-github-app) و
[إنشاء مستودع التحكم](#create-your-allstar-control-repository) — ثم
اختيار طريقة تشغيله:

| | [إجراء GitHub](#running-allstar-as-a-github-action) | [خدمة daemon](#running-allstar-as-a-service-daemon) |
|---|---|---|
| **كيف يعمل** | مهمة مجدولة في مستودع `.allstar` الخاص بك | عملية دائمة تستضيفها أنت |
| **ما توفّره** | لا شيء يتجاوز GitHub | خادم أو منسّق حاويات |
| **التواتر** | حسب ما تضبطه في `cron` | مستمر، مع ظهور النتائج خلال 5-10 دقائق |
| **جهد الإعداد** | متوسط | مرتفع |
| **الأنسب عندما** | تريد الخيار الأقل من حيث البنية التحتية | تريد أكبر قدر من التحكم، أو تشغّل خدمات بالفعل |

الإجراء هو الخيار الأقل عبئًا بين الاثنين، وهو ما ينبغي أن تبدأ به معظم
المؤسسات؛ ويمكنك الانتقال إلى daemon لاحقًا دون تغيير أي إعدادات للسياسات.

#### إنشاء تطبيق GitHub الخاص بك

التطبيق هو هوية شبيهة بهوية المستخدم مع مجموعة من الأذونات في مؤسستك.
يحتاج Allstar إلى صلاحية القراءة لمعظم الإعدادات ومحتويات الملفات لاكتشاف
الامتثال، وصلاحية الكتابة على المشكلات (issues) وعمليات الفحص (checks) لإنشاء
المشكلات ودعم إجراء `block`.

اتبع [تعليمات المشغّل - إنشاء تطبيق GitHub
App](https://github.com/ossf/allstar/blob/main/operator.md#create-a-github-app)، وسجّل معرّف التطبيق (App ID) والمفتاح
الخاص (private key). يحتاج كلا وضعي التشغيل إليهما.

#### أنشئ مستودع التحكم `.allstar` الخاص بك

يقرأ Allstar إعداداته من مستودع باسم `.allstar` في مؤسستك.

أسرع طريقة لإنشاء واحد هي من النموذج:

1.  [افتح المستودع النموذجي](https://github.com/ossf/dot-allstar-quickstart)
    وانقر على زر "Use this template"
1.  في حقل اسم المستودع (Repository Name)، اكتب `.allstar`
1.  انقر على "Create repository from template"

يُفعّل هذا جميع [السياسات](#policies) الحالية لـ Allstar على جميع المستودعات
باستخدام استراتيجية إلغاء الاشتراك (Opt Out)، مع إجراء `issue`. يمكنك تغيير أي
جزء من ذلك لاحقًا.

للتحكم الدقيق منذ البداية — باختيار استراتيجية الاشتراك (Opt In) أو إلغاء
الاشتراك (Opt Out) وكتابة ملفات السياسات الفردية بنفسك — اتبع [إرشادات التثبيت
اليدوي](https://github.com/ossf/allstar/blob/main/manual-install.md) بدلاً من ذلك.

#### تشغيل Allstar كإجراء GitHub Action

يشغّل هذا الخيار Allstar كمهمة مجدولة باستخدام GitHub Actions، لذا لا توجد
بنية تحتية لتشغيلها خارج GitHub نفسه.

اتبع [إرشادات تثبيت GitHub
Actions](https://github.com/ossf/allstar/blob/main/github-action-installation.md) لإعداد إجراء (Action) متكرر في مستودع
`.allstar` الخاص بك، وتقويته، ومراقبة نتائجه.

#### تشغيل Allstar كخدمة خفية (daemon)

يشغّل هذا الخيار Allstar كعملية مستمرة، تكتشف الانتهاكات وتحلها باستمرار بدلاً
من الاعتماد على جدول زمني.

راجع [تعليمات المشغّل](https://github.com/ossf/allstar/blob/main/operator.md) لتشغيل العملية، وإدارة الأسرار، وتحديد
الحجم، ومتغيرات البيئة المتاحة.

### الانتقال بعيدًا عن التطبيق المستضاف

إذا كانت مؤسستك تستخدم التطبيق المستضاف من OpenSSF، فإن **إعداداتك تنتقل
كما هي**. يستمر مستودع التحكم `.allstar` و`allstar.yaml` وكل ملف سياسة في
العمل دون تغيير؛ ما تستبدله هو فقط العملية التي تقرأها.

للانتقال:

1. [أنشئ تطبيق GitHub الخاص بك](#create-your-github-app) وثبّته على مؤسستك
   بنفس صلاحية الوصول إلى المستودعات التي كان يتمتع بها التطبيق المستضاف.
1. أبقِ مستودع `.allstar` الحالي لديك كما هو تمامًا.
1. شغّل Allstar [كإجراء](#running-allstar-as-a-github-action) أو
   [كخدمة خفية](#running-allstar-as-a-service-daemon).
1. أزل تثبيت `allstar-app` من مؤسستك، إذا كان لا يزال يظهر ضمن
   Settings -> GitHub Apps.

تبقى المشكلات التي أنشأها التطبيق المستضاف سابقًا في مستودعاتك. يتعرف نسختك
الخاصة على مشكلاته عبر التسمية نفسها `allstar` (أو `issueLabel` الذي قمت
بإعداده)، لذا سيعتمدها ويغلقها عند حل الانتهاكات، بدلاً من إنشاء مشكلات
مكررة.

## السياسات والإجراءات

## **الإجراءات**

يمكن إعداد كل سياسة بإجراء يتخذه Allstar عندما يكتشف أن أحد المستودعات غير
ممتثل.

- `log`: هذا هو الإجراء الافتراضي، ويحدث فعليًا لجميع الإجراءات. تُسجَّل جميع
  نتائج تشغيل السياسات وتفاصيلها. السجلات حاليًا مرئية فقط لمشغّل التطبيق،
  وتجري مناقشة خطط لكشفها.
- `issue`: ينشئ هذا الإجراء مشكلة (issue) على GitHub. تُنشأ مشكلة واحدة فقط لكل
  سياسة، ويصف النص تفاصيل انتهاك السياسة. إذا كانت المشكلة مفتوحة بالفعل،
  يُرسَل إليها تنبيه بتعليق كل 24 ساعة دون تحديثات (غير قابل للإعداد من قبل
  المستخدم حاليًا). إذا تغيّرت نتيجة السياسة، سيُترك تعليق جديد على المشكلة
  ويُربط في نص المشكلة. بمجرد معالجة الانتهاك، ستُغلق Allstar المشكلة تلقائيًا
  خلال 5-10 دقائق.
- `fix`: هذا الإجراء خاص بكل سياسة. ستجري السياسة التغييرات على إعدادات GitHub
  لتصحيح انتهاك السياسة. لن تتمكن جميع السياسات من دعم ذلك (انظر أدناه).

إجراءات مقترحة، لكنها غير منفذة بعد. ستُضاف التعريفات في المستقبل.

- `block`: يمكن لـ Allstar تعيين [GitHub Status
  Check](https://docs.github.com/en/github/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks)
  وحظر دمج أي PR في المستودع إذا فشل الفحص.
- `email`: سيرسل Allstar بريدًا إلكترونيًا إلى مسؤول (مسؤولي) المستودع.
- `rpc`: سيرسل Allstar استدعاء rpc إلى نظام خاص بمنظمة معينة.

### **تكوين الإجراء**

يتوفر إعدادان لتكوين إجراء المشكلة:

- `issueLabel` متاح على مستوى المنظمة والمستودع. سيؤدي تعيينه
  إلى تجاوز التسمية الافتراضية `allstar` التي يستخدمها Allstar لتحديد
  مشكلاته.

- `issueRepo` متاح على مستوى المنظمة. سيؤدي تعيينه إلى إجبار جميع
  المشكلات التي تُنشأ في المنظمة على الإنشاء في المستودع المحدد.

## **السياسات**

على غرار تكوين تمكين تطبيق Allstar، يتم تمكين جميع السياسات
وتكوينها باستخدام ملف yaml إما في مستودع `.allstar` الخاص بالمنظمة،
أو في دليل `.allstar` الخاص بالمستودع. وكما هو الحال مع التطبيق، فإن السياسات
اختيارية افتراضيًا، كما أن إجراء `log` الافتراضي لن ينتج نتائج مرئية. هناك
طريقة بسيطة لتمكين جميع السياسات وهي إنشاء ملف yaml لكل سياسة
بالمحتويات التالية:

```yaml
optConfig:
  optOutStrategy: true
action: issue
```

تفاصيل كيفية عمل إجراء `fix` لكل سياسة موضحة أدناه. إذا لم يُذكر أدناه، فإن إجراء `fix` غير قابل للتطبيق.

### حماية الفروع

ملف إعدادات هذه السياسة يُسمى `branch_protection.yaml`، و[تعريفات الإعدادات موجودة هنا](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/branch#OrgConfig).

تتحقق سياسة حماية الفروع من أن [إعدادات حماية الفروع](https://docs.github.com/en/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches) في GitHub مُهيأة بشكل صحيح وفقًا للإعدادات المحددة. سيصف نص المشكلة أي إعداد غير صحيح. راجع [وثائق GitHub](https://docs.github.com/en/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches) لتصحيح الإعدادات.

سيقوم إجراء `fix` بتغيير إعدادات حماية الفروع لتتوافق مع إعدادات السياسة المحددة.

### الملفات الثنائية

ملف إعدادات هذه السياسة يُسمى `binary_artifacts.yaml`، و[تعريفات الإعدادات موجودة هنا](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/binary#OrgConfig).

تتضمن هذه السياسة [الفحص من scorecard](https://github.com/ossf/scorecard/#scorecard-checks). أزل الملف الثنائي من المستودع لتحقيق الامتثال. نظرًا لأن نتائج scorecard قد تكون مطوّلة، فقد تحتاج إلى تشغيل [scorecard نفسه](https://github.com/ossf/scorecard) لرؤية جميع المعلومات التفصيلية.

### CODEOWNERS

ملف إعدادات هذه السياسة يُسمى `codeowners.yaml`، و[تعريفات الإعدادات موجودة هنا](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/codeowners#OrgConfig).

تتحقق هذه السياسة من وجود [ملف `CODEOWNERS`](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners) في مستودعاتك.

### المتعاونون الخارجيون

ملف إعدادات هذه السياسة يُسمى `outside.yaml`، و[تعريفات الإعدادات موجودة هنا](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/outside#OrgConfig).

تتحقق هذه السياسة مما إذا كان أي من [المتعاونين الخارجيين](https://docs.github.com/en/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization) لديه صلاحية المسؤول (افتراضيًا) أو صلاحية الدفع (اختياريًا) على المستودع. يجب أن يمتلك أعضاء المؤسسة فقط هذه الصلاحية، وإلا فقد يتمكن الأعضاء غير الموثوقين من تغيير الإعدادات على مستوى المسؤول وإيداع تعليمات برمجية ضارة.

### SECURITY.md

ملف إعدادات هذه السياسة يُسمى `security.yaml`، و[تعريفات الإعدادات موجودة هنا](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/security#OrgConfig).

تتحقق هذه السياسة من أن المستودع يحتوي على ملف سياسة أمان في `SECURITY.md` وأنه ليس فارغًا. ستحتوي المشكلة المُنشأة على رابط إلى [علامة تبويب GitHub](https://docs.github.com/en/code-security/getting-started/adding-a-security-policy-to-your-repository) التي تساعدك على إيداع سياسة أمان في مستودعك.

### فحص الأسرار

ملف إعدادات هذه السياسة يُسمى `secret_scanning.yaml`، و[تعريفات الإعدادات موجودة هنا](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/secretscanning#OrgConfig).

تتحقق هذه السياسة من إعداد مستودع GitHub لفحص الأسرار. إذا أبلغ GitHub بأنه معطّل، فإن المشكلة المُنشأة ترتبط مباشرة بإعدادات أمان المستودع. إذا لم تُرجع واجهة API حالة فحص الأسرار، فإن السياسة تسجّل أن الحالة غير متاحة بدلًا من اعتبارها معطّلة.

يُفعّل إجراء `fix` فحص الأسرار في GitHub للمستودعات التي لم يكن لديها مُفعّلًا بالفعل. يحتاج تطبيق Allstar على GitHub إلى صلاحية إدارة المستودع لكي تتمكن واجهة GitHub API من قراءة هذا الإعداد أو تغييره.

### سير العمل الخطير

ملف إعدادات هذه السياسة يُسمى `dangerous_workflow.yaml`، و[تعريفات الإعدادات موجودة هنا](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/workflow#OrgConfig).

ستعمل هذه السياسة على **جميع** الفروع، راجع المبررات [هنا](https://github.com/ossf/allstar/issues/569).

تفحص هذه السياسة ملفات تهيئة سير عمل GitHub Actions
(`.github/workflows`)، بحثًا عن أي أنماط تطابق سلوكًا خطيرًا معروفًا. راجع [وثائق OpenSSF Scorecard](https://github.com/ossf/scorecard/blob/main/docs/checks.md#dangerous-workflow)
لمزيد من المعلومات حول هذا الفحص.

### فحص Scorecard العام

ملف تهيئة هذه السياسة يُسمى `scorecard.yaml`، و[تعريفات التهيئة موجودة هنا](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/scorecard#OrgConfig).

تشغّل هذه السياسة أي فحص Scorecard مُدرج في تهيئة `checks`. يجب أن تحصل جميع الفحوصات التي تُشغَّل على درجة مساوية أو أعلى من إعداد `threshold`. يُرجى مراجعة [وثائق OpenSSF Scorecard](https://github.com/ossf/scorecard/blob/main/docs/checks.md)
لمزيد من المعلومات حول كل فحص.

#### رفع SARIF

يمكن لسياسة Scorecard اختياريًا رفع النتائج بصيغة [SARIF](https://sarifweb.azurewebsites.net/) إلى تبويب **Security > Code Scanning** في كل مستودع. يمنح هذا مسؤولي المؤسسة رؤية لنتائج Scorecard إلى جانب أدوات الأمان الأخرى (CodeQL وDependabot وغيرها) دون الحاجة إلى إعداد سير عمل لكل مستودع.

لتفعيل رفع SARIF، أضف الحقل `upload` إلى ملف `scorecard.yaml` الخاص بك:

```yaml
optConfig:
  optOutStrategy: true
action: issue
checks:
  - Binary-Artifacts
  - Signed-Releases
threshold: 8
upload:
  sarif: true
```

**المتطلبات:**
- يجب أن يمتلك تطبيق Allstar على GitHub إذن المستودع **Code scanning alerts** مضبوطًا على **Read & write** (نطاق API: `security_events`). هذا الإذن ليس ضمن الأذونات التي يحتاجها Allstar عادةً، لذا أضفه إلى تطبيقك قبل تمكين رفع SARIF.
- رفع SARIF غير حاجب: إذا فشل الرفع (مثلًا بسبب أذونات مفقودة)، يستمر فحص السياسة بشكل طبيعي.
- تقارن خاصية اكتشاف التغييرات قيمة SHA لالتزام HEAD في المستودع، وتتخطى الفحص والرفع عندما لا يكون قد تم الدفع إلى المستودع منذ آخر رفع.

يعمل رفع SARIF مع كلتا طريقتي تشغيل Allstar: كـ[خدمة خلفية (daemon)](https://github.com/ossf/allstar/blob/main/operator.md) أو كـ[إجراء GitHub (GitHub Action)](https://github.com/ossf/allstar/blob/main/github-action-installation.md).

### إجراءات GitHub (GitHub Actions)

ملف إعدادات هذه السياسة يُسمى `actions.yaml`، و[تعريفات الإعدادات موجودة هنا](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/action#OrgConfig).

تفحص هذه السياسة ملفات إعدادات سير عمل GitHub Actions (`.github/workflows`) (وتشغيلات سير العمل في بعض الحالات) في كل مستودع للتأكد من توافقها مع القواعد (مثل: require، deny) المحددة في إعدادات مستوى المؤسسة الخاصة بالسياسة.

### مسؤولو المستودعات

ملف إعدادات هذه السياسة يُسمى `admin.yaml`، و[تعريفات الإعدادات موجودة هنا](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/admin#OrgConfig).

تتحقق هذه السياسة من أنه افتراضيًا يجب أن يكون لكل المستودعات مستخدم أو مجموعة مُعيَّنة كمسؤول (Administrator). وتتيح لك اختياريًا ضبط ما إذا كان يُسمح للمستخدمين بأن يكونوا مسؤولين (بدلًا من الفرق).

### السياسات المستقبلية

- التأكد من تمكين dependabot.
- التحقق من أن التبعيات مثبَّتة/مُجمَّدة (pinned/frozen).

## **مستودع إعدادات نموذجي**

راجع [هذا المستودع](https://github.com/GoogleContainerTools/.allstar) كمثال على استخدام إعدادات Allstar. بصفتك مسؤول المؤسسة، فكّر في إضافة ملف README.md يتضمن بعض المعلومات حول كيفية استخدام Allstar في مؤسستك.

## متقدم

### تعريفات الإعدادات

- [إعدادات التمكين على مستوى المؤسسة](https://pkg.go.dev/github.com/ossf/allstar/pkg/config#OrgOptConfig)
- [إعدادات التمكين عبر تجاوز المستودع]( https://pkg.go.dev/github.com/ossf/allstar/pkg/config#RepoOptConfig)

### موقع إعدادات ثانوي على مستوى المؤسسة

افتراضيًا، يُتوقع أن تكون ملفات الإعدادات على مستوى المؤسسة، مثل ملف `allstar.yaml` أعلاه، موجودة في مستودع `.allstar`. إذا لم يكن هذا المستودع موجودًا، فسيُستخدم دليل `allstar` في مستودع `.github` كموقع ثانوي. للتوضيح، بالنسبة لـ `allstar.yaml`:

| الأولوية | المستودع | المسار |
| - | - | - |
| أساسي | `.allstar` | `allstar.yaml` |
| ثانوي | `.github` | `allstar/allstar.yaml` |

ينطبق هذا أيضًا على ملفات الإعدادات على مستوى المؤسسة الخاصة بالسياسات الفردية، كما هو موضح أدناه.

### إعدادات سياسة المستودع في مستودع المؤسسة

سيبحث Allstar أيضًا عن إعدادات السياسة على مستوى المستودع في مستودع `.allstar` الخاص بالمؤسسة، ضمن الدليل الذي يحمل نفس اسم المستودع. تُستخدم هذه الإعدادات بغض النظر عما إذا كان "تجاوز المستودع" (repo override) معطَّلًا أم لا.

على سبيل المثال، سيبحث Allstar عن إعدادات السياسة لمستودع معين `myapp` بالترتيب التالي:

| المستودع | المسار | الشرط |
| - | - | - |
| `myapp` | `.allstar/branch_protection.yaml` | عندما يكون "تجاوز المستودع" مسموحًا. |
| `.allstar` | `myapp/branch_protection.yaml` | في جميع الأوقات. |
| `.allstar` | `branch_protection.yaml` | في جميع الأوقات. |
| `.github` | `allstar/myapp/branch_protection.yaml` | إذا لم يكن مستودع `.allstar` موجودًا. |
| `.github` | `allstar/branch_protection.yaml` | إذا لم يكن مستودع `.allstar` موجودًا. |

### موقع إعدادات الأساس والدمج على مستوى المؤسسة

بالنسبة لملفات إعدادات Allstar والسياسات على مستوى المؤسسة، يمكنك تحديد الحقل `baseConfig` لتحديد مستودع آخر يحتوي على إعدادات Allstar الأساسية. يُوضَّح هذا على أفضل وجه بمثال.

لنفترض أن لديك عدة مؤسسات على GitHub، لكنك تريد الحفاظ على إعدادات Allstar واحدة. مؤسستك الرئيسية هي "acme"، ويحتوي المستودع `acme/.allstar` على `allstar.yaml`:

```yaml
optConfig:
  optOutStrategy: true
issueLabel: allstar-acme
issueFooter: Issue created by Acme security team.
```

لديك أيضًا مؤسسة GitHub تابعة باسم "acme-sat". تريد إعادة استخدام الإعدادات الرئيسية، لكن مع تطبيق بعض التغييرات فوقها عبر تعطيل Allstar على مستودعات معينة. يحتوي المستودع `acme-sat/.allstar` على `allstar.yaml`:

```yaml
baseConfig: acme/.allstar
optConfig:
  optOutRepos:
  - acmesat-one
  - acmesat-two
```

---

[Read more](https://github.com/ossf/allstar)
تنزيل الأداة

الأكثر شعبية

عرض الكل →

اكتشف الأدوات الأكثر استخدامًا من قبل مجتمعنا.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 مجموعة أدوات OSINT المثالية: رسم بياني للتحقيق، وتقييم الثقة، وعائلات الأسماء المستعارة، وخريطة، وخط زمني، وتقارير. 49 وحدة، وأكثر من 400 موقع، دون الحاجة إلى مفاتيح API.

    500
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # تطبيق GhostLock للتنفيذ بنقرة واحدة (CVE-2026-43499)

    466
  • 3

    ARTEX

    baarai/artex

    منصة اختبار اختراق مستقلة متعددة الوكلاء تعتمد على LLM، مع وكلاء تخطيط وتنفيذ، ومخططات للأصول والاستكشاف، وتسجيل حركة مرور MITM، وإعادة اختبار الثغرات.

    339
  • 4

    opencti

    opencti-platform/opencti

    منصة مفتوحة لاستخبارات التهديدات السيبرانية

    317
  • 5

    redforge

    cybersecurity91/redforge

    مجموعة أدوات الفريق الأحمر في المتصفح مع 102 أداة دون اتصال للاستطلاع، وتوليد الحمولات، وهجمات بيانات الاعتماد، والتشفير، والترميز، وإعداد تقارير المهام.

    307
  • 6

    estorides

    grisuno/estorides

    يجمع أكثر من 99 مصدرًا مجانيًا من مصادر OSINT بالتوازي، ويحوّل الكيانات إلى رسم بياني معرفي، ويصدّر بصيغة STIX 2.1 أو MISP أو GraphML مع تحليل بمساعدة LLM.

    294

استكشف جميع الأدوات

تصفح مجموعتنا من الأدوات

عرض جميع الأدوات →