קטלוג מדיניויות מובנה

החבילה המותקנת היא מקור האמת לזמינות מדיניויות. הרץ 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-failproofai-commands   block-sudo
block-curl-pipe-sh           block-rm-rf
block-push-master            block-force-push

block-failproofai-commands תמיד פועל. הוא מופיע למעלה למטרות השלמות, אך הוא נרשם בכל הערכה בין אם הוא מופיע בערכה המופעלת שלך או לא, ולא ניתן להשבית אותו או להשהות — הגנה כנגד סוכן המכבה את האכיפה שהסוכן יכול להכבות אינה הגנה. המומלץ הוא בכוונה צר יותר מהכל. מדיניויות תשתית וזרימת עבודה יכולות להפריע לעבודה תקינה ויש להפעילן במאגרים ובמכונות הזקוקות להן.

סודות וסביבה

מדיניות	טריגר	תוצאה
`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`	הסר אסימוני הרשאה של מנשאים.
`protect-env-vars`	`PreToolUse` בכלי מעטפת	חסום פקודות שמשחקות משתני סביבה.
`block-env-files`	`PreToolUse`	חסום קריאה וכתיבה של קבצי `.env`.
`block-read-outside-cwd`	`PreToolUse` בקריאה, glob, grep או כלי מעטפת	שמור קריאות בתוך ספריית העבודה של ההפעלה.
`block-secrets-write`	`PreToolUse` בכלי כתיבה	חסום כתיבות לשמות קבצים וסכמות אישור של מפתחות סודיים נפוצות.

פקודות מסוכנות ותשתית

מדיניות	טריגר	תוצאה
`block-sudo`	`PreToolUse`, `PermissionRequest`	חסום `sudo` אלא אם דפוס הרשאה תואם.
`block-curl-pipe-sh`	`PreToolUse`	חסום סקריפטים שהורדו בצינור ישירות למעטפת.
`block-rm-rf`	`PreToolUse`	חסום דפוסי מחיקה רקורסיבית קטסטרופליים.
`block-failproofai-commands`	`PreToolUse`, `PermissionRequest`	תמיד פועל, לא ניתן להשבית. חסום כל הפעלה של CLI של 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 של זרימת עבודה, הרצה, מיזוג, שחרור, cache וסוד.

בטיחות Git ומסד נתונים

מדיניות	טריגר	תוצאה
`block-push-master`	`PreToolUse`	חסום דחיפות ישירות לענפים מוגנים מוגדרים.
`block-force-push`	`PreToolUse`	חסום דחיפות כוח; `--force-with-lease` נשאר מותר ביישום הנוכחי.
`block-work-on-main`	`PreToolUse`	חסום commits ומיזוגים בענפים מוגנים.
`warn-git-amend`	`PreToolUse`	הזהר לפני כתיבה מחדש של commit עם `--amend`.
`warn-git-stash-drop`	`PreToolUse`	הזהר לפני השלכה קבועה או ניקוי stashes.
`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`	סרב השלמה בעוד commits נשארות מקומיות בלבד.
`require-pr-before-stop`	דרוש בקשת משיכה לענף הנוכחי.
`require-no-conflicts-before-stop`	דרוש מיזוג נקי כנגד ענף בסיס מוגדר.
`require-ci-green-before-stop`	דרוש בדיקות CI של current-HEAD להשלמה בהצלחה.

ייחוס פרמטרים

הגדר פרמטרים תחת אובייקט policyParams של ההיקף שנבחר. סוגים מאומתים על ידי כל מדיניות.

מדיניות	פרמטר	סוג וברירת מחדל
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; ערכים מכילים `regex` ו-`label`
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
חוסמי תשתית	`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 ומסד נתונים

חבילות, התנהגות מערכת וולולים של סוכנים

זרימת עבודה של סיום משימה

ייחוס פרמטרים