できない.dev

Node.js「self-signed certificate in certificate chain」の原因と直し方

self-signed certificate in certificate chain は、社内 CA を NODE_EXTRA_CA_CERTS で読ませれば直る。
fetch が自己署名 CA を信頼していないと出る。
検証を切る設定は本番で使わない。

公開: 更新:

症状できない
node server.js
HTTPS サーバ起動: https://localhost:8443

2026-09-27 に node:20(Node.js 20.20.2 / npm 10.8.2) で実際に打って取った出力。検証環境の詳細

要約

Node.js 組み込み fetch は、OpenSSL の信頼ストアで TLS チェーンを検証する。
そのため、社内プロキシや MITM 装置で挿入された自己署名 CA を信頼していない環境では、self-signed certificate in certificate chain で接続できない。
NODE_EXTRA_CA_CERTS で追加 CA を読み込ませれば、検証を保ったまま接続できる。
NODE_TLS_REJECT_UNAUTHORIZED=0 は検証を完全に切ってしまうため、本番では使わない。

実行例

環境は node:20(Debian GNU/Linux 12 bookworm / Node.js v20.20.2 / OpenSSL 3.0.19)である。
CA を追加しない素の fetch では、エラーコード SELF_SIGNED_CERT_IN_CHAIN(err.cause.code)が発生した。
これはエラーメッセージ self-signed certificate in certificate chain に対応するコードである。
NODE_EXTRA_CA_CERTS を指定した場合は、HTTP 200 が返った。

$ node -v
v20.20.2
$ openssl version
OpenSSL 3.0.19 27 Jan 2026 (Library: OpenSSL 3.0.19 27 Jan 2026)
$ node server.js
HTTPS サーバ起動: https://localhost:8443
$ node client.js
失敗: SELF_SIGNED_CERT_IN_CHAIN
$ echo $?
0
$ NODE_EXTRA_CA_CERTS=./ca-cert.pem node client.js
status: 200 body: ok
$ echo $?
0
$ NODE_TLS_REJECT_UNAUTHORIZED=0 node client.js
(node:69) Warning: Setting the NODE_TLS_REJECT_UNAUTHORIZED environment variable to '0' makes TLS connections and HTTPS requests insecure by disabling certificate verification.
(Use `node --trace-warnings ...` to show where the warning was created)
status: 200 body: ok
$ echo $?
0

— 2026-09-27 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-09-27 検証(ほか 1 件)
検証日
実行環境
node:20 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 20.20.2
  • npm 10.8.2
  • Python 3.11.2
  • Git 2.39.5

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. CA を環境変数で追加する(推奨)

社内 CA の PEM ファイルを NODE_EXTRA_CA_CERTS で指定すると、Node 内蔵バンドルに 追加 して信頼する(公式ドキュメント(新しいタブで開く))。

export NODE_EXTRA_CA_CERTS=/etc/ssl/private/corp-root-ca.pem
node app.js

複数 CA が必要なら同じ PEM ファイル内に連結する。

2. OS の信頼ストアを使う

Node.js 22.15 以降では --use-system-ca で OS の信頼ストアを参照できる(22.14 では bad option で起動しない)。
社員 PC に CA が配布されている環境ではこちらが楽だ。

node --use-system-ca app.js
# あるいは
NODE_OPTIONS="--use-system-ca" node app.js

3. undici Agent で CA を渡す

特定のリクエストだけ別 CA を使いたい場合は undici の Agent を組み立てて fetch に渡す。

import { Agent, fetch } from "undici";
import { readFileSync } from "node:fs";
 
const agent = new Agent({
  connect: { ca: readFileSync("./corp-ca.pem") },
});
 
const res = await fetch("https://internal.example.com/", { dispatcher: agent });

4. 開発検証時のみ検証を切る

NODE_TLS_REJECT_UNAUTHORIZED=0 node debug.js

このフラグはプロセス全体で TLS 検証を無効化するため、CI / 本番では使わない。
process.env への直接代入も避け、コマンドラインから一時的に渡す。

よくある原因

  1. 社内プロキシや MITM 装置が挿入する自己署名 CA が、Node.js の信頼ストアに入っていない。
  2. サーバが中間 CA を返しておらず、不完全なチェーンになっている。
  3. Node.js は独自の CA バンドルを内蔵しており、OS の信頼ストアを自動では参照しない。
  4. Docker / CI で /etc/ssl/certs をマウントしていないか、ca-certificates が古い。