Skip to main content

Contrast AI SmartFixのトラブルシューティング

問題

現象

対応

無効な認証情報

Contrastから401エラーまたは403エラーが表示される

  • contrast_host、contrast_org_id、contrast_app_id、contrast_authorization_key、contrast_api_keyの値が正しく、GitHubシークレットまたは変数に適切に保存されていることを確認して下さい。

  • contrast_authorization_keyに関連付けられているサービスユーザに必要な権限があることを確認して下さい。

  • For NorthstarNorthstar-only (SAST-only) deployments: contrast_app_id should be omitted from the workflow configuration entirely.

  • For Contrast Assess (IAST) deployments: confirm the contrast_app_id matches the application ID in the repository.

LLMのエラー

LLM API 呼び出しに関連するエラー(APIキーが無効、モデルが見つからない、レート制限など)

  • 使用しているプロバイダーとモデルに対して、agent_modelの文字列が正しいかを確認して下さい(LiteLLMのドキュメントを参照)。

  • LLMプロバイダーのAPIキーが有効であり、GitHubシークレットに正しく保存されていることを確認して下さい。LLMプロバイダーのクォータ(利用制限)またはクレジットが十分にあることを確認して下さい。

  • GitHub ActionsランナーからLLM API エンドポイントへのネットワーク接続を確認して下さい。

プルリクエスト(PR)の作成エラー

GitHub Actionsは実行されるが、PRが作成されないか、PR作成中にエラーが発生

  • github_tokenが正しく指定されていることを確認して下さい。

  • アクションによるPRの作成またはsmartfix/*ブランチからのPR作成を妨げる、ブランチ保護ルールがないことを確認して下さい。

  • base_branchコマンドが存在し、正しく指定されていることを確認して下さい。

修正もPRも生成されない

GihHub Actionsは正常に完了したが、PRや修正は作成されない

  • For NorthstarNorthstar-only (SAST-only) deployments where contrast_app_id is intentionally omitted: confirm CRITICAL, HIGH, or MEDIUM severity SAST findings exist in a REPORTED state in your Contrast organization.

  • For Contrast Assess (IAST) deployments: confirm CRITICAL, HIGH, or MEDIUM severity vulnerabilities exist in a REPORTED state in Contrast for the configured contrast_app_id.

  • ログを確認して、初期ビルド(修正を試みる前のビルドの実行)が失敗していないか確認して下さい。

  • オープン中の既存のSmartFixのPR数が、max_open_prsの上限に達しているかどうかを確認して下さい。PRの数がこの制限を超えると、新しいPRは作成されません。

  • 脆弱性処理中に発生した具体的なエラーについて、アクションログを確認して下さい。

不正確な修正

SmartFixの修正が正しくない

SmartFixで作成されたPRを注意深く確認して下さい。修正が不正確であったり不完全であったりする場合は、却下して下さい。

このセクションの内容: