Builtin policy catalog - Failproof AI

الحزمة المثبتة هي مصدر الحقيقة لتوفر السياسات. قم بتشغيل failproofai policies بعد كل ترقية لأن إدخالات الكتالوج والسلوك قد يتغيران مع إصدار الحزمة.

الأساس الموصى به

يفعّل التحديد الموصى به من الإعداد الموجه حاليًا معقمات الأسرار وحماية البيئة والحماية الذاتية وحماية الأوامر الكارثية وسلامة الفروع المحمية:

sanitize-jwt                 sanitize-api-keys
sanitize-connection-strings sanitize-private-key-content
sanitize-bearer-tokens       protect-env-vars
block-env-files              block-secrets-write
block-self-pause             block-failproofai-commands
block-sudo                   block-curl-pipe-sh
block-rm-rf                  block-push-master
block-force-push

الموصى به أضيق بقصد من Everything. يمكن لسياسات البنية التحتية وسير العمل أن تقاطع العمل الصحيح وينبغي تفعيلها للمستودعات والآلات التي تحتاجها.

الأسرار والبيئة

السياسة	المُحَفِّز	النتيجة
`sanitize-jwt`	`PostToolUse`	تحرير JWTs من مخرجات الأداة قبل أن يراها النموذج.
`sanitize-api-keys`	`PostToolUse`	تحرير مفاتيح OpenAI و Anthropic و GitHub و AWS و Stripe و Google الشائعة.
`sanitize-connection-strings`	`PostToolUse`	تحرير سلاسل اتصال قواعد البيانات التي تحتوي على بيانات الاعتماد.
`sanitize-private-key-content`	`PostToolUse`	تحرير أجسام مفاتيح PEM الخاصة.
`sanitize-bearer-tokens`	`PostToolUse`	تحرير رموز التفويض من نوع bearer.
`protect-env-vars`	`PreToolUse` على أدوات shell	حظر الأوامر التي تفرغ متغيرات البيئة.
`block-env-files`	`PreToolUse`	حظر قراءة وكتابة ملفات `.env`.
`block-read-outside-cwd`	`PreToolUse` على قراءة أو glob أو grep أو أدوات shell	إبقاء القراءات داخل دليل عمل الجلسة.
`block-secrets-write`	`PreToolUse` على أدوات الكتابة	حظر الكتابة إلى أسماء ملفات مفاتيح الأسرار وبيانات الاعتماد الشائعة.

الأوامر الخطرة والبنية التحتية

السياسة	المُحَفِّز	النتيجة
`block-self-pause`	`PreToolUse`, `PermissionRequest`	منع الوكيل من إيقاف إنفاذه الخاص.
`block-sudo`	`PreToolUse`, `PermissionRequest`	حظر `sudo` إلا إذا طابق نمط السماح.
`block-curl-pipe-sh`	`PreToolUse`	حظر البرامج النصية المُحملة الموجهة مباشرة إلى shell.
`block-rm-rf`	`PreToolUse`	حظر أنماط الحذف العودية الكارثية.
`block-failproofai-commands`	`PreToolUse`	منع الوكلاء من تغيير أو إلغاء تثبيت Failproof AI.
`block-kubectl`	`PreToolUse`	التحكم في أوامر Kubernetes.
`block-terraform`	`PreToolUse`	التحكم في أوامر Terraform و OpenTofu.
`block-aws-cli`	`PreToolUse`	التحكم في أوامر AWS CLI.
`block-gcloud`	`PreToolUse`	التحكم في أوامر Google Cloud CLI.
`block-az-cli`	`PreToolUse`	التحكم في أوامر Azure CLI.
`block-helm`	`PreToolUse`	التحكم في أوامر Helm.
`block-gh-pipeline`	`PreToolUse`	التحكم في عمليات GitHub CLI الطفيفة في سير العمل والتشغيل والدمج والإصدار والذاكرة والسر.

سلامة Git وقاعدة البيانات

السياسة	المُحَفِّز	النتيجة
`block-push-master`	`PreToolUse`	حظر الدفع المباشر إلى الفروع المحمية المُعَدَّة.
`block-force-push`	`PreToolUse`	حظر الدفع القسري؛ يبقى `--force-with-lease` مسموحًا بالتنفيذ الحالي.
`block-work-on-main`	`PreToolUse`	حظر الالتزامات والدمجات على الفروع المحمية.
`warn-git-amend`	`PreToolUse`	تحذير قبل إعادة كتابة التزام مع `--amend`.
`warn-git-stash-drop`	`PreToolUse`	تحذير قبل حذف أو مسح المخزن المؤقت بشكل دائم.
`warn-all-files-staged`	`PreToolUse`	تحذير على `git add -A` أو `git add .` أو `git add --all` الواسع.
`warn-destructive-sql`	`PreToolUse`	تحذير على `DROP` و `TRUNCATE` و `DELETE` بدون `WHERE` عبر عملاء قاعدة البيانات المعروفة.
`warn-schema-alteration`	`PreToolUse`	تحذير على عمليات `ALTER TABLE` للعمود وإعادة التسمية المعروفة.

الحزم وسلوك النظام وحلقات الوكيل

السياسة	المُحَفِّز	النتيجة
`warn-package-publish`	`PreToolUse`	تحذير قبل النشر إلى سجلات الحزم.
`warn-global-package-install`	`PreToolUse`	تحذير قبل التثبيت العام للحزم.
`prefer-package-manager`	`PreToolUse`	إرشاد الوكيل لاستخدام مدير حزم مسموح.
`warn-large-file-write`	`PreToolUse` على أدوات الكتابة	تحذير فوق حد حجم الملف المُعَدَّ.
`warn-background-process`	`PreToolUse`	تحذير على أنماط العمليات الخلفية المنفصلة أو طويلة الأمد.
`warn-repeated-tool-calls`	`PreToolUse`	تحذير بعد ثلاث مكالمات أداة متطابقة أو أكثر.

سير عمل نهاية المهمة

تتطلب هذه السياسات جهازًا يصدر حدث Stop متوافقًا.

السياسة	النتيجة
`require-commit-before-stop`	رفض الإكمال بينما يبقى العمل المتتبع غير مرتكب.
`require-push-before-stop`	رفض الإكمال بينما تبقى الالتزامات محلية فقط.
`require-pr-before-stop`	مطلوب طلب دمج للفرع الحالي.
`require-no-conflicts-before-stop`	مطلوب دمج نظيف ضد فرع القاعدة المُعَدَّ.
`require-ci-green-before-stop`	مطلوب إكمال فحوصات CI للرأس الحالي بنجاح.

مرجع المعاملات

قم بتكوين المعاملات ضمن كائن policyParams للنطاق المحدد. يتم التحقق من الأنواع بواسطة كل سياسة.

السياسة	المعامل	النوع والافتراضي
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; تحتوي الإدخالات على `regex` و `label`
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
Infrastructure blockers	`allowPatterns`	`string[]`, `[]`
`block-secrets-write`	`additionalPatterns`	`string[]`, `[]`
`block-push-master`	`protectedBranches`	`string[]`, `["main", "master"]`
`block-work-on-main`	`protectedBranches`	`string[]`, `["main", "master"]`
`prefer-package-manager`	`allowed`, `blocked`	`string[]`, `[]`
`warn-large-file-write`	`thresholdKb`	`number`, `1024`
`require-push-before-stop`	`remote`, `baseBranch`	`string`, `"origin"`; `string`, `"main"`
`require-pr-before-stop`	`baseBranch`	`string`, `"main"`
`require-no-conflicts-before-stop`	`baseBranch`	`string`, `"main"`

{
  "enabledPolicies": ["block-sudo", "block-push-master"],
  "policyParams": {
    "block-sudo": {
      "allowPatterns": ["sudo systemctl status"]
    },
    "block-push-master": {
      "protectedBranches": ["main", "release"]
    }
  }
}

نمط السماح يوسع ما قد يفعله الوكيل. اختبر الترميز الدقيق وأشكال الأوامر على جهاز الهدف قبل نشره عبر الأسطول.

​الأساس الموصى به

​الأسرار والبيئة

​الأوامر الخطرة والبنية التحتية

​سلامة Git وقاعدة البيانات

​الحزم وسلوك النظام وحلقات الوكيل

​سير عمل نهاية المهمة

​مرجع المعاملات

الأساس الموصى به

الأسرار والبيئة

الأوامر الخطرة والبنية التحتية

سلامة Git وقاعدة البيانات

الحزم وسلوك النظام وحلقات الوكيل

سير عمل نهاية المهمة

مرجع المعاملات