Documentation Index

Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt

Use this file to discover all available pages before exploring further.

ClaudeコードのTLSインスペクション問題の修正

Prev Next

問題

Cato TLSインスペクションが有効になると、Catoは自身のルート/中間証明書をインスペクションされたTLSセッションの発行者として提示し、復号化とセキュリティを可能にします。 ほとんどのエンタープライズアプリケーションは、オペレーティングシステムまたはブラウザの信頼ストアに依存しているため、Catoルート証明書がそこにインストールされると、透過的に動作を継続します。 

しかし、開発者ツール、特にClaudeコードなどは、証明書ピンニングや独自のTLS実装(例えばNode.js/OpenSSL)を使用しており、OS信頼ストアのみに依存するわけではありません。 その結果、オペレーティングシステムがそれを信頼しても、Cato発行の証明書を拒否し、トラフィック検査中にTLSエラー(例: SELF_SIGNED_CERT_IN_CHAIN)が発生する可能性があります。

環境

  • Claudeがバイパスされている場合でもアカウントでTLSインスペクションは有効です。

  • Catoのルート証明書はOS信頼ストアにインストールされており、信頼されています

トラブルシューティング

  • 問題がClaudeコードまたは類似の開発ツールに限定され、一般的なネットワーク問題ではないことを確認します

  • アプリのカスタムCAメカニズムを使用して、Catoのルート証明書を追加します

ソリューション

前提条件

  • Catoルート証明書(PEM形式) - ここから証明書をダウンロードできます - https://clientdownload.catonetworks.com/public/certificates/CatoNetworksTrustedRootCA.cer 

  • 証明書ファイルパス - 証明書が使用中のアプリケーションを実行しているユーザーアカウントにアクセス可能で読み取り可能なローカルファイルシステム上の場所に保存されていることを確認します。

手順

Claudeコードは、環境変数を介してカスタム証明機関をサポートしています。

NODE_EXTRA_CA_CERTS環境変数を使用して、ClaudeコードのNodeベースのTLSスタックをCatoルート証明書ファイルに指示します。 グローバルかつ持続的に設定し、それによってユーザーがClaudeデスクトップ、Claude CLI、またはClaudeコードIDE拡張を使用するたびに機能することを確認します。

確認

  • 環境変数を設定した後、Claudeコードを再起動します

  • 以前失敗したClaudeコード操作を試みます

  • それがTLSエラーなしで成功し、かつTLSインスペクションが有効のままであれば、設定は正しいです

サポートエスカレーション基準

  • NODE_EXTRA_CA_CERTS変数は正しく設定されており、正しいPEMファイルを指していますが、ClaudeコードはTLSハンドシェイクエラーで失敗し続けます。

  • その環境は、標準の環境変数設定を超えた相互TLS(mTLS)とプロキシ認証の組み合わせを必要とします。

  • 組織レベルで複数のユーザーやマシンに環境変数設定を展開または適用するための支援が必要です。