用途:创建和管理 Endor Labs 安全策略,实现自动化安全执行。需命名空间管理员权限。创建或修改策略前必须确认,因为策略变更会影响整个命名空间的执行,例如“阻止严重漏洞”策略可能阻止组织内所有 PR。执行创建、更新、删除前应展示确切的策略过滤器和动作。
策略类型:Finding Policy(定义标记或阻止的安全问题)、Exception Policy(为已接受风险创建例外)、Action Policy(自动化响应,如阻止 PR、通知、创建工单)。
模板:block-critical-reachable(阻止含严重可达漏洞的 PR)、license-compliance(阻止商业项目中的 copyleft 许可证)、no-secrets(阻止提交的密钥)、sast-required(要求合并前通过 SAST 扫描)、sbom-required(要求发布时生成 SBOM)、dependency-age(警告过时依赖)、max-severity(阻止超过严重性阈值的发现)。
工作流:列出策略使用 npx -y endorctl api list --resource FindingPolicy -n $ENDOR_NAMESPACE 2>/dev/null;创建策略使用 npx -y endorctl api create --resource FindingPolicy -n $ENDOR_NAMESPACE 2>/dev/null --data '{...}',其中 data 为 JSON 格式的策略定义,包含 meta 和 spec 字段。创建例外使用 ExceptionPolicy 资源,指定 finding_uuid、expiration 和 justification。自定义策略可参考 /endor-findings 过滤器参考。
结果展示:创建或列出策略后,展示名称、类型、动作、状态、过滤器的人类可读描述及后续步骤(推送测试提交验证、集成流水线、查看所有策略)。数据源策略参考 references/data-sources.md。
错误处理:权限不足联系命名空间管理员;策略已存在可更新或重命名;过滤器无效帮助修复语法;认证错误建议运行 /endor-setup。
限制:需管理员权限;策略影响范围大,操作前需确认;具体收费、价格、平台支持等信息暂未提供。