正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。
ドキュメントに関する現在のご利用体験についてお聞かせください。アンケートにご協力ください。

悪意のあるソースのスキャン

  • プラン: Ultimate
  • 提供形態: GitLab.com
  • ステータス: 実験的機能

悪意のあるソースのスキャンは、polyfill.ioのサプライチェーン攻撃に関与したCDNなど、リポジトリ内の既知の悪意のある外部ドメインへの参照を検出します。各参照は、SASTの脆弱性として報告されます。

この実験の今後の方向性を決定する際の参考にするため、イシュー634760でフィードバックを共有してください。

悪意のあるソースのスキャンを有効にする

悪意のあるソースのスキャンを有効にするには、.gitlab-ci.ymlファイルに悪意のあるソースのCI/CDコンポーネントを追加します:

yaml
include:
  - component: gitlab.com/security-products/experiments/malicious-sources/malicious-sources@0.2.0

このコンポーネントは、testステージにmalicious-sources-scanジョブを追加します。検出結果は、脆弱性レポートとマージリクエストに表示されます。

検出されるドメイン

悪意のあるソースのスキャンは、重大度がCriticalのこれらのドメインへの参照を検出します:

  • bootcdn.net
  • bootcss.comとcdn.bootcss.com
  • polyfill.com
  • polyfill.ioとcdn.polyfill.io
  • staticfile.netとcdn.staticfile.net
  • staticfile.orgとcdn.staticfile.org
  • unionadjs.com

このアナライザーは、https://、http://、およびプロトコル相対(//)参照を大文字と小文字を区別せずに照合します。

パスを除外する

ファイルとディレクトリをスキップするには、SAST_EXCLUDED_PATHSにgitignore形式のパターンをコンマ区切りのリストとして設定します。.gitディレクトリは常に除外されます。

yaml
variables:
  SAST_EXCLUDED_PATHS: "node_modules, vendor, **/*.min.js"

カスタムルールの追加

他のドメインを検出するには、MALICIOUS_SOURCES_CUSTOM_RULESにルールのYAMLリストを設定します。カスタムルールは、ビルトインルールに追加されます。

yaml
variables:
  MALICIOUS_SOURCES_CUSTOM_RULES: |
    - rule_id: malicious.example.test
      substring: //malicious.example.test
      severity: High
      title: "Malicious CDN: malicious.example.test"
      description: "Known malicious CDN observed in supply chain attacks."
フィールド必須説明
rule_idはい一意のID。ビルトインルールを上書きするには、ルールのドメインをIDとして使用します。
substringはい各行で照合するリテラルテキスト。正規表現はサポートされていません。
severityはいInfo、Low、Medium、High、Criticalのいずれかを指定します。
titleはい検出結果に表示される名前。
descriptionはい脆弱性レポートに表示される説明。
case_insensitiveいいえtrueの場合、大文字と小文字を区別せずに照合します。デフォルトはfalseです。
disabledいいえtrueの場合、ルールが削除されます。デフォルトはfalseです。

ビルトインルールを無効にするには、そのドメインにdisabled: trueを設定します:

yaml
variables:
  MALICIOUS_SOURCES_CUSTOM_RULES: |
    - rule_id: cdn.polyfill.io
      disabled: true

YAMLが無効な場合、スキャンはエラーで失敗します。