AEM FormsでのPKIXおよびSSL設定の問題の修正

AEM Formsは、証明書が見つからない、キーストア設定が正しくない、またはSSL ポートが正しく設定されていないため、SSL経由での通信に失敗します。 証明書チェーンの検証、JVM トラストストアの更新、JBossまたはWebSphereでのSSL設定の修正により、問題を修正します。

説明 description

環境

  • AEM Forms (JEEおよびOSGi)
  • JBoss
  • WebSphere
  • Adobe Managed Services(AMS)
  • オンプレミス環境

問題/症状

  • javax.net.ssl.SSLHandshakeException: PKIX パスの作成に失敗しました:sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
  • java.sql.SQLRecoverableException: IO Error PKIX パスの作成に失敗しました。
  • SSLが無効または不完全な設定でJBoss EJBの呼び出しに失敗しました:remote.connectionprovider.create.options.org.xnio.Options.SSL_ENABLED=false
  • SSL設定ウィザードがキーストア名とパスワードを要求し、続行できないAEMの起動エラー。

解決策 resolution

この問題を解決するには、次の手順に従います。

  1. standalone/log/server.logまたはSystemOut.logなどのログを確認して、PKIX エラー、SSLHandshakeException、キーストアパスワードの欠落などのSSL エラー署名を特定します。

  2. 証明書の信頼またはキーストアの読み込みの問題を参照するエラーを確認します。

  3. サーバー証明書とそのフルチェーン(サーバー、中間、ルート CA証明書を含む)を抽出し、証明書がログに記録されているホスト名と一致することを確認します。

  4. キーツールを使用して、欠落している証明書をJAVA_HOME/lib/security/cacertsのJVM トラストストアに読み込み、エイリアスを一覧表示してインストールを確認します。 キーストアパスとパスワードが正しく使用されていることを確認します。

    keytool -importcert -alias <alias> -file <certfile.pem> -keystore <JAVA_HOME>/lib/security/cacerts

  5. JBossまたはWebSphereを再起動してトラストストアをリロードし、起動時にSSL エラーが表示されなくなったことを確認します。

  6. データベース接続やHTTPS呼び出しなどの失敗した操作を再実行します。

  7. SSL設定ウィザードがキーストアの入力を要求し、パスワードが不明な場合は、新しいファイル名、キーストアパスワード、およびキーパスワードを指定して、新しいキーストアを作成します。

  8. キーストアファイルが設定ディレクトリに存在することを確認します。

  9. standalone.xmlまたはdomain.xmlでJBoss HTTPS リスナー設定を検証します。

  10. SSLRealmおよびHTTPS リスナーが存在し、エラーなしで正しく読み込まれることを確認します。

  11. データベース関連のSSL エラー、特にencrypt=true;trustServerCertificate=falseを使用するSQL Serverの場合は、データベース証明書をトラストストアにインポートするか、一時的にtrustServerCertificate=trueを設定します。

  12. データソーステストが成功したことを確認します。

  13. エラーがポート 8443に関連する場合は、EJB SSL設定を確認します。

  14. EJB トラフィックに対してSSLが有効で正しく設定されていることを確認し、呼び出しエラーが発生しないことを確認します。

  15. 元の失敗した操作を再テストし、ログにSSLHandshakeExceptionまたは関連するエラーが含まれていないことを確認します。

問題が解決しない場合は、opensslを使用して証明書を比較し、トラストストストアエントリを検証することで、より詳細な検証を実行します。

関連トピックス

recommendation-more-help
experience-cloud-kcs-help-kbarticles