SSL certificate verify failedの解決方法【2025年最新版】

エラーの概要・症状

“SSL certificate verify failed”というエラーメッセージは、主にHTTPS通信を行う際に、SSL証明書の検証が失敗した場合に表示されます。このエラーは、GitやPythonのリクエストライブラリなど、SSL/TLSを使用する多くのアプリケーションで見られます。具体的には、リモートリポジトリへのアクセスや、外部APIへのリクエスト時に発生することが多く、これによりデータの取得やプッシュができなくなります。

このエラーが発生した場合、ユーザーは以下のような困りごとを抱えることが多いです：

• Gitリポジトリにアクセスできず、コードのプッシュやフェッチができない。
• Pythonスクリプトやアプリケーションが外部APIからデータを取得できない。
• SSL/TLSの設定や証明書の管理に不安を感じる。

このような状況では、迅速な対応が求められます。以下では、このエラーが発生する原因と、具体的な解決方法について詳しく解説します。

このエラーが発生する原因

“SSL certificate verify failed”エラーが発生する主な原因には以下のようなものがあります：

1. 証明書の不一致: リモートサーバーのSSL証明書がローカルの証明書ストアに登録されているルート証明書と一致しない場合、このエラーが発生します。特に、自分で管理しているサーバーや、新しいCA（認証局）の証明書が登録されていない場合が考えられます。

2. 証明書の不正: サーバーのSSL証明書が期限切れ、または無効である場合、クライアントはその証明書を信頼できず、エラーが発生します。

3. ネットワークの設定: プロキシやファイアウォールがSSL通信を妨げたり、SSL証明書の検証を妨害している場合にもこのエラーが発生します。

4. Python環境の問題: Pythonを使用している場合、certifiパッケージが正しくインストールされていない、または古いバージョンのOpenSSLが使用されている可能性があります。

5. Gitの設定: GitがSSL証明書の検証を正しく行っていない設定になっている場合も原因として挙げられます。特に、http.sslVerifyオプションが無効になっている場合などです。

解決方法1（最も効果的）

手順1-1: 証明書の確認と更新

まずは、リモートサーバーのSSL証明書が正しいかどうかを確認します。以下の手順で行います：

1. ブラウザでリモートサーバーのURLを開きます。

2. 鍵のアイコンをクリックし、証明書の詳細を表示します。

3. 証明書が有効であるか、正しいCAによって署名されているかを確認します。

もし証明書が無効な場合は、サーバー側で証明書を更新する必要があります。

手順1-2: Gitの設定変更

Gitの設定を確認し、正しいURLを設定します。以下のコマンドを実行します：

git remote set-url origin https://yourusername@github.com/user/repo.git

次に、以下のコマンドでSSLの検証を有効にします：

git config --global http.sslVerify true

手順1-3: `certifi`のインストール

Pythonを使用している場合は、certifiパッケージをインストールすることをおすすめします。以下のコマンドを実行します：

pip install certifi

これにより、最新の証明書ストアが使用されるようになります。

注意点とトラブルシューティング

• 証明書の確認時に、ブラウザのキャッシュが影響することがあります。正しい証明書が表示されない場合は、キャッシュをクリアして再度確認してください。
• Gitの設定を変更した後、再度プッシュやフェッチを試みて、エラーが解消されたか確認してください。

解決方法2（代替手段）

手順2-1: 環境変数の設定

もし方法1で解決しない場合は、GitのSSL検証を一時的に無効にすることもできます。ただし、これはセキュリティ上のリスクがあるため、最終手段として考えてください。以下のコマンドを実行します：

git config --global http.sslVerify false

これにより、GitはSSL証明書の検証をスキップします。ただし、この設定は全リポジトリに適用されるため、使用後は必ず元に戻してください。

手順2-2: 新しい証明書バンドルのダウンロード

新しい証明書バンドルをダウンロードし、Gitが参照するように設定します。以下のコマンドを実行します：

mkdir ~/certs
curl https://curl.haxx.se/ca/cacert.pem -o ~/certs/cacert.pem

次に、.gitconfigファイルを編集して、以下の設定を追加します：

[http]
sslCAinfo = /home/yourusername/certs/cacert.pem

解決方法3（上級者向け）

手順3-1: Pythonスクリプトの修正

もしPythonを使用してSSL通信を行っている場合、以下の方法でSSL検証を無効にすることもできます。これは特に開発環境で有用ですが、本番環境では避けるべきです。以下のコードを使用します：

import ssl
ssl._create_default_https_context = ssl._create_unverified_context

これにより、全てのSSL通信で証明書の検証がスキップされます。

エラーの予防方法

このエラーを未然に防ぐためには、以下の対策を講じることが重要です：

1. 定期的な証明書の更新: SSL証明書は定期的に更新が必要です。特に自分で管理しているサーバーでは、証明書の有効期限に注意し、期限が切れる前に更新を行います。

2. CA証明書の管理: 新しいCA証明書を使用する場合は、システムやアプリケーションに正しくインストールされているか確認します。特に自社のCAを使用している場合は、しっかりと設定を行うことが重要です。

3. 開発環境の整備: 開発環境では、SSL検証を無効にするのではなく、常に正しい証明書を使用するように心がけます。また、テスト環境でのSSL証明書の管理も怠らないようにします。

関連するエラーと対処法

SSL証明書に関連する他のエラーとしては、以下のようなものがあります：

• **SSL: CERTIFICATE_VERIFY_FAILED**: これは、SSL証明書の検証に失敗したことを示します。上記の方法で解決可能です。
• **SSL: CERTIFICATE_EXPIRED**: 証明書が期限切れの場合、サーバー側で証明書を更新する必要があります。
• **SSL: CERTIFICATE_NOT_YET_VALID**: 証明書がまだ有効化されていない場合、サーバーの設定を確認する必要があります。

まとめ

“SSL certificate verify failed”エラーは、SSL通信を行う上で非常に一般的な問題です。しかし、正しい手順を踏むことで、簡単に解決することが可能です。まずは証明書の確認とGitの設定変更を行い、それでも解決しない場合は他の手段を検討してください。セキュリティを考慮しつつ、適切な方法で対処することが重要です。