Korext: AI Code Governance

KOREXT 强制执行操作

在 GitHub 工作流中强制执行 AI 生成代码的合规策略。

72 个策略包。532 条规则。13 种语言。违规项会以 GitHub Code Scanning 注释的形式显示在拉取请求中。

快速开始

将以下内容添加到 .github/workflows/korext.yml：

name: Korext Enforcement
on: [push, pull_request]

permissions:
  contents: read
  security-events: write

jobs:
  enforce:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: Korext/enforce-action@v3
        with:
          api-token: ${{ secrets.KOREXT_API_TOKEN }}

Korext 会在每次推送和 PR 时使用默认的 web 策略包扫描代码。

工作原理

1. 安装：此操作会安装 Korext CLI
2. 扫描：使用所选策略包，对代码库运行 korext enforce
3. 报告：生成 SARIF 文件，并将其上传到 GitHub Code Scanning
4. 阻止：如果发现严重或高危违规项，则工作流失败

借助 GitHub Code Scanning，违规项会以注释的形式直接显示在 PR 差异中。

输入

输入	描述	必填	默认值
directory	要扫描策略违规项的目录	否	.
pack	要强制执行的策略包 ID	否	web
api-token	用于身份验证模式的 Korext API 令牌	否	（匿名）
fail-on-violations	存在严重或高危违规项时使工作流失败	否	true
sarif-upload	将 SARIF 上传到 GitHub Code Scanning	否	true
region	数据处理区域（us、eu、apac）	否	（默认值）
sign-bundles	请求带签名的证明包	否	true

输出

输出	描述
violations	发现的策略违规项总数
sarif-file	生成的 SARIF 结果文件路径
bundle-count	生成的证明包数量
bundles-signed	带签名的证明包数量
bundle-ids	以逗号分隔的证明包 ID 列表

示例

多个策略包

- uses: Korext/enforce-action@v3
  with:
    pack: web,pci-dss-v1,owasp-v1
    api-token: ${{ secrets.KOREXT_API_TOKEN }}

欧盟数据主权

- uses: Korext/enforce-action@v3
  with:
    pack: gdpr-v1
    region: eu
    api-token: ${{ secrets.KOREXT_API_TOKEN }}

扫描指定目录

- uses: Korext/enforce-action@v3
  with:
    directory: src/
    pack: hipaa-v1
    api-token: ${{ secrets.KOREXT_API_TOKEN }}

仅警告（不使工作流失败）

- uses: Korext/enforce-action@v3
  with:
    pack: web
    fail-on-violations: 'false'

身份验证

如需完整访问所有策略包和带签名的证明包，请在 KOREXT 控制面板中创建 API 令牌，并将其添加为 GitHub 密钥：

1. 前往 app.korext.com > Settings > API Tokens
2. 创建新令牌
3. 在代码库的 Settings > Secrets and variables > Actions 中，将其添加为 KOREXT_API_TOKEN

如果没有令牌，此操作将以匿名模式运行（每小时 20 次请求，可用策略包有限）。

链接

• 网站
• 控制面板
• 文档
• npm 上的 CLI
• VS Code 扩展

许可证

专有。请参阅服务条款。