Skip to content

SDK証明書信頼エラーのトラブルシューティング

SDKの初期化がSSLまたはTLS証明書信頼エラーで失敗する場合、通常はデバイス、シミュレーター、ブラウザー、またはサーバーがBrazeエンドポイントの証明書チェーンを検証できないことを意味します。

たとえば、Androidやその他のJVMベースの環境では、次のようなエラーが表示されることがあります。

1

javax.net.ssl.SSLHandshakeException: java.security.cert.CertPathValidatorException: Trust anchor for certification path not found

これは一般的に、SDKの統合バグではなく、環境内のネットワークまたは証明書信頼設定の問題です。

一般的な原因

  • 企業のプロキシ、ファイアウォール、またはトラフィック検査ツールが、ランタイムが信頼していない証明書でHTTPSトラフィックを傍受しています。
  • デバイス、シミュレーター、ブラウザー、またはサーバーのトラストストアに、必要なルート証明書または中間証明書がありません。
  • ローカルのセキュリティ設定により、BrazeエンドポイントへのアウトバウンドHTTPSがブロックされています。
  • アプリレベルの証明書またはトランスポートセキュリティ設定が接続をブロックしています。

トラブルシューティング手順

  1. SDKエンドポイントとネットワークアクセスを確認します。
    • ワークスペースに適したSDKエンドポイントを使用していることを確認します。
    • お使いの環境からそのエンドポイントにHTTPSで到達できることを確認します。
  2. 異なるネットワーク間で動作を比較します。
    • 別のネットワーク（たとえば、企業Wi-Fiの代わりにモバイルデータ通信）でテストします。
    • 問題が特定のネットワークでのみ発生する場合、原因はプロキシまたはファイアウォールの設定である可能性が高いです。
  3. 信頼設定を検証します。
    • SDKが動作しているランタイム環境に、必要なルート証明書および中間証明書がインストールされ、信頼されていることを確認します。
    • お使いの環境でカスタム認証局を使用している場合は、それらの証明書が正しく配布されていることを確認します。
  4. プラットフォームのセキュリティ設定を確認します。
    • アプリや環境にトランスポートまたは証明書に関する明示的なルールがある場合、それらの設定がBrazeエンドポイントへのHTTPSリクエストを許可していることを確認します。
  5. ネットワークチームまたはセキュリティチームと連携します。
    • 完全なエラー内容とタイムスタンプを共有し、証明書チェーン、TLSインスペクション設定、および許可リストのルールを確認してもらいます。
New Stuff!