VS Codeのプロキシ設定

VS CodeでAikidoへのアウトバウンド通信にプロキシが必要なネットワーク環境では、このガイドを参照してください。

設定

VS CodeのSettingsを開きます（macOSではCmd+,、Windows/LinuxではCtrl+,）。
proxyを検索します。
Http: Proxy Supportをoverrideに設定します（環境がすでに正しくプロキシを処理している場合はon）。Http: Proxy Support
Http: ProxyにプロキシのURLを設定します（例: http://proxy.company.local:8080）。Http: Proxy
可能な限りHttp: Proxy Strict SSLを有効（true）のままにしてください。Http: Proxy Strict SSL
- プロキシ／サーバーの証明書チェーンが信頼されている場合（パブリックCAまたは正しくインストールされた社内CA）はtrueを使用してください。
- 会社がTLSインスペクションやカスタム／自己署名証明書を使用している場合、そのCAをインストールするまではtrueで信頼エラーが発生することがあります。
- 推奨される対処法: aikido.extraCaCerts（またはNODE_EXTRA_CA_CERTS）経由で社内CA証明書（PEM）を追加し、検証を有効なまま維持してください。
- Http: Proxy Strict SSLをfalseに設定するのは、管理された環境での一時的なトラブルシューティング手段としてのみにしてください。証明書の信頼設定が完了したらtrueに戻してください。
VS Codeをリロードします（Developer: Reload Window）。
ファイルを開くか保存して、Aikidoのスキャンをトリガーします。

`settings.json`を使った代替の設定方法

settings.jsonの例

{
  "http.proxySupport": "override",
  "http.proxy": "http://proxy.company.local:8080",
  "http.proxyStrictSSL": true
}

会社が認証付きプロキシを使用している場合

Http: Proxy Authorization

推奨:

{
  "http.proxyAuthorization": "Basic <base64(username:password)>"
}

代替:

{
  "http.proxy": "http://username:[email protected]:8080"
}

会社がTLSインスペクションを使用している場合

Aikido: Extra Ca Certs

プロキシが証明書を再署名する場合は、社内CAバンドルを追加してください。

{
  "aikido.extraCaCerts": "/absolute/path/to/corporate-ca.pem"
}

接続を確認する

プロキシ変更後はVS Codeをリロードしてください。
ファイルを開く/保存してAikidoのスキャンをトリガーします。
ログにプロキシ認証エラーやTLS信頼エラーがないことを確認します。
SCAスキャンを実行し、依存関係のダウンロードが成功することを確認します。

よくある対処法

407 Proxy Authentication Required
- http.proxyAuthorizationの形式（Basic ...）を再確認してください。
- 必要に応じて、プロキシURLの認証情報形式で認証情報を検証してください。
TLSエラー（self-signed、unable to verify、certificate unknown）
- 有効なaikido.extraCaCertsパス（またはNODE_EXTRA_CA_CERTS）を設定してください。
- 可能な限りhttp.proxyStrictSSL: trueを維持してください。
- 証明書変更後はVS Codeをリロードしてください。
プロキシが使用されない
- http.proxySupportがoffになっていないことを確認してください。
- http.proxy、HTTPS_PROXY、https_proxyのいずれかが設定されていることを確認してください。
- 更新後はVS Codeをリロードしてください。