環境変数

NODE_EXTRA_CA_CERTS

型string

カスタムCA証明書ファイルへのパス

使い方・用途

  • 企業プロキシ環境や制限のあるネットワークで、APIリクエスト時のSSL証明書エラーを回避するために使用します
  • OAuthログインや接続チェックが失敗する場合、ITチームから提供された証明書バンドルを信頼させることで解決できます
  • 証明書の問題による接続失敗時に、適切なネットワーク設定のガイダンスを表示するための基盤となります
英語原文(公式ドキュメントより)

Path to custom CA certificate file

関連ドキュメント

関連する変更履歴

v2.1.273(1件)

Improved
セッション中のSSL証明書やプロキシ接続のエラーが改善され、エラーコードと修正方法が表示されるようになった
英語原文を表示
Improved the in-session SSL certificate and proxy connection errors to name the error code and what to fix, such as NODE_EXTRA_CA_CERTS for an untrusted corporate CA

変更前

エラーメッセージがエラーの発生を示すだけで、原因や対処方法はユーザー自身で調べる必要があった

変更後

セッション内のSSL証明書やプロキシ接続のエラーが、エラーコードと修正方法を表示するようになった

ユーザーへの恩恵

ユーザーはエラーの原因と対処法をすぐに把握でき、証明書やプロキシの設定問題を素早く解決できる

関連ドキュメント

v2.1.199(1件)

Fixed
Permissions
SSL証明書エラー(プロキシ、CA証明書設定、期限切れなど)発生時に、リトライを繰り返さず即座に修正ヒントを表示するよう改善
英語原文を表示
Fixed SSL certificate errors (TLS-inspecting proxies, missing NODE_EXTRA_CA_CERTS, expired certs) burning retries before showing actionable guidance — they now fail immediately with the fix hint

変更前

SSL関連のエラーが発生すると、解決策が示されないまま何度も無駄なリトライが繰り返されていました。

変更後

接続エラーを検知すると、即座に停止して適切な修正ヒントを提示するようになりました。

ユーザーへの恩恵

不毛な待ち時間が減り、環境設定やネットワーク上の問題を即座に特定して解決できます。

関連ドキュメント

v2.1.73(1件)

Added
SSL証明書エラーによるOAuthログインや接続チェックの失敗時に、具体的な解決策を案内する機能を追加
英語原文を表示
Added actionable guidance when OAuth login or connectivity checks fail due to SSL certificate errors (corporate proxies, NODE_EXTRA_CA_CERTS)

変更前

企業プロキシ環境や NODE_EXTRA_CA_CERTS の設定が必要な環境でSSLエラーが発生した際、原因の特定や対処が困難でした。

変更後

証明書の問題で接続に失敗した場合に、ネットワーク設定やプロキシ設定の確認など、状況に応じた具体的なガイダンスが表示されます。

ユーザーへの恩恵

トラブルシューティングの手間が減り、制限のあるネットワーク環境下でもスムーズに導入を開始できるようになります。

関連ドキュメント

v1.0.40(1件)

Fixed
Fixed a bug causing API connection errors with UNABLE_TO_GET_ISSUER_CERT_LOCALLY if NODE_EXTRA_CA_CERTS was set

関連ドキュメント