日本語

ローカルスキャナーの接続問題のトラブルシューティング

このガイドでは、企業プロキシ、カスタム SSL インスペクション、または厳しく制限されたネットワークの背後で Aikido Local Scanner を実行する方法を説明します。使用するタイミングと方法についても扱います --enable-proxy と --ca-bundle、ホワイトリストに追加すべきドメイン、および一般的な証明書エラーの修正方法を説明します。

正しく動作するには、Local Scanner が HTTPS（ポート 443）経由で以下のドメインにアクセスできる必要があります：

  • *.aikido.dev
  • *.aikido.io

任意

  • o1405212.ingest.sentry.io エラーレポート用（次のオプションで無効化できます --disable-telemetry)
  • mirror.gcr.io / ghcr.io 依存関係スキャンの脆弱性データベース用
    • 使用する場合は不要 --enable-aikido-hosted-dependencies-db と --enable-aikido-maven-cache
  • api.nuget.org csproj の依存関係解決用
  • raw.githubusercontent.com vcpkg の依存関係解決用

ワイルドカードを使用できない場合:

場所 *.aikido.dev と *.aikido.io は受け付けられません。各ワイルドカードは、小さく固定されたホストのセットに展開されます:

ホスト次の場合
app.aikido.devEUリージョン（デフォルト）
app.us.aikido.devUSリージョン
app.au.aikido.devオーストラリア
app.me.aikido.dev中東
static-cve.aikido.dev次の場合、 --enable-aikido-hosted-dependencies-db
static-maven.aikido.io次の場合、 --enable-aikido-maven-cache

使用する --enable-proxy

スキャナーは ありません デフォルトではシステムプロキシを使用しません。すべての HTTPS トラフィックを企業プロキシ経由で送信するには、次のことを行う必要があります：

  1. プロキシサポートを有効にする で --enable-proxy フラグ。
  2. プロキシ URL を設定する を介して HTTPS_PROXY （または https_proxy）環境変数。

使用する --ca-bundle （カスタムルート CA）

プロキシまたはファイアウォールが SSL インスペクションを行う場合、通常はサーバーの証明書を、以下によって署名された証明書に置き換えます： 社内／企業 CA.

使用 --ca-bundle スキャナーを次のものに向けるには PEM ファイル 企業のルート CA 証明書（必要に応じて中間 CA も）を含むものです。すると、スキャナーはプロキシ経由で接続する際にそれらの CA を信頼します。

  1. 企業の CA 証明書を入手します （例：IT チームから入手するか、マシンの信頼ストアからエクスポートします）。形式は PEM である必要があります。
  2. それをスキャナーに渡します を介して --ca-bundle または AIKIDO_CA_BUNDLE 環境変数。さらに、この値を次のものとして渡す必要がある場合があります： SSL_CERT_FILE と NODE_EXTRA_CA_CERTS 環境変数。