Failed to fetch - SSL/TLS証明書の原因と解決策

概要

SSL/TLS証明書が無効、期限切れ、自己署名の場合に発生します。ブラウザは証明書の問題があるサーバーへの接続をブロックします。

この原因かどうかの確認方法

1
2
3
4
5
6
# 証明書の詳細確認
openssl s_client -connect api.example.com:443 -servername api.example.com

# 期限確認
echo | openssl s_client -connect api.example.com:443 2>/dev/null | \
  openssl x509 -noout -dates

Consoleに以下のようなメッセージが出る場合、SSL証明書が原因です:

ERR_CERT_DATE_INVALID
ERR_CERT_AUTHORITY_INVALID
ERR_CERT_COMMON_NAME_INVALID

解決策

1. 証明書を更新する

Let’s Encrypt:

1
sudo certbot renew

2. 証明書チェーンを確認する

中間証明書が正しく設定されているか確認してください。

1
2
# 証明書チェーンの確認
openssl s_client -connect api.example.com:443 -showcerts

3. 自己署名証明書の場合（開発環境のみ）

開発環境で自己署名証明書を使用している場合、ブラウザに例外を追加するか、mkcertを使用してローカル認証局を作成してください。

1
2
3
4
5
6
# mkcert をインストール
brew install mkcert  # macOS
mkcert -install

# ローカル証明書を作成
mkcert localhost 127.0.0.1

4. ドメイン名を確認する

証明書のCN（Common Name）またはSAN（Subject Alternative Name）が、アクセスしているドメインと一致しているか確認してください。

よくある間違い

証明書の有効期限を監視していない
ワイルドカード証明書のサブドメイン制限を理解していない
開発環境で自己署名証明書を使用し、本番環境への移行時に問題が発生

まだ解決しない場合

→ 診断ハブに戻る

Failed to fetch - SSL/TLS証明書

概要