コンテンツにスキップ

Local Scannerの接続に関するトラブルシューティング

このガイドは、社内プロキシ、カスタムSSLインスペクション、または制限されたネットワークの配下でAikido Local Scannerを実行する際に役立ちます。--enable-proxy--ca-bundleをいつ・どのように使うか、どのドメインを許可リストに追加するか、よくある証明書エラーの解決方法について説明します。

正しく動作するには、Local ScannerがHTTPS(ポート443)経由で次のドメインにアクセスできる必要があります: *.aikido.dev

スキャナーはデフォルトでシステムのプロキシを使用しません。すべてのHTTPSトラフィックを社内プロキシ経由で送信するには、以下が必要です:

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

--ca-bundle(カスタムルートCA)の使用

Section titled “--ca-bundle(カスタムルートCA)の使用”

プロキシやファイアウォールがSSLインスペクションを行う場合、通常、サーバーの証明書は社内/独自CAで署名されたものに置き換えられます。

--ca-bundleを使って、社内のルートCA証明書(および必要に応じて中間CA)を含むPEMファイルをスキャナーに指定します。これにより、プロキシ経由で接続する際にスキャナーがそれらのCAを信頼するようになります。

  1. 社内のCA証明書を取得します(例: ITチームから入手する、またはマシンの信頼ストアからエクスポートする)。PEM形式である必要があります。
  2. --ca-bundleまたはAIKIDO_CA_BUNDLE環境変数でスキャナーに渡します。加えて、この値をSSL_CERT_FILEおよびNODE_EXTRA_CA_CERTS環境変数として渡すことが必要になる場合があります。