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の代わりにモバイルデータ）でテストします。
    • 問題が1つのネットワークでのみ発生する場合、根本原因はプロキシまたはファイアウォールの設定である可能性が高いです。
  3. 信頼設定を検証します。
    • SDKが実行されているランタイムに、必要なルート証明書と中間証明書がインストールされ、信頼されていることを確認します。
    • 環境がカスタム認証局を使用している場合、それらの証明書が正しく配布されていることを確認します。
  4. プラットフォームのセキュリティ設定を確認します。
    • アプリまたは環境に明示的なトランスポートまたは証明書ルールがある場合、それらの設定がBrazeエンドポイントへのHTTPSリクエストを許可していることを確認します。
  5. ネットワークまたはセキュリティチームと連携します。
    • 完全なエラーとタイムスタンプを共有し、証明書チェーン、TLS検査設定、および許可リストルールを確認してもらいます。
New Stuff!