Korext: AI Code Governance

KOREXT Enforce Action

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 は、デフォルトの web ポリシーパックを使用して、プッシュや PR のたびにコードをスキャンします。

仕組み

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 }}

EU データ主権

- 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 として追加します

トークンがない場合、このアクションは匿名モードで実行されます（1 時間あたり 20 リクエスト、利用できるパックは限定されます）。

リンク

• ウェブサイト
• ダッシュボード
• ドキュメント
• npm の CLI
• VS Code 拡張機能

ライセンス

プロプライエタリです。利用規約をご覧ください。