ドキュメントExperience Cloud KCS

SSL クライアント証明書の認証ハンドラーが見つからないため、AEM 6.5.1でMSSL レプリケーションが失敗する

最終更新日： 2026年10月12日

この記事では、SSL クライアント証明書の認証ハンドラーバンドルが見つからない場合のAdobe Experience Manager（AEM） 6.5.1でのMSSL レプリケーション エラーの解決方法と、関連するKeyStore初期化エラーに対処する手順について説明します。

説明 description

環境

  • Adobe Experience Manager（AEM） 6.5.1

問題/症状

  • HTTPSとKeyStore/TrustStoreが正しく設定されていても、MSSL （相互SSL）レプリケーションが失敗します。
  • レプリケーションを試みると、401個の不正なエラー​が発生します。
  • システムが基本認証にフォールバックする場合があります。
  • 見つからないハンドラーを解決した後、truststore アクセスのサービスユーザーマッピングが設定されていない場合、KeyStoreNotInitialisedExceptionが発生します。

原因

必要なSSL クライアント証明書認証ハンドラーバンドルがAEM 6.5.1環境にありません。 さらに、truststore アクセスのサービスユーザーマッピングが欠落すると、KeyStore初期化エラーが発生する可能性があります。

解決策 resolution

SSL クライアント証明書認証ハンドラーが見つからないことによるMSSL レプリケーション エラーを修正するには、次の手順に従います。

  1. SSL クライアント証明書の認証ハンドラーバンドルがAEM 6.5.1環境に存在するかどうかを確認します。
  2. バンドルが見つからない場合は、Adobe サポート ​を通じて、お使いのAEM バージョンに適した修正プログラムを入手してインストールしてください。
  3. Adobe サポートが提供する修正プログラムを、AEM 6.5.1環境に手順に従ってデプロイします。
  4. 修正を展開した後、ログを監視して、ハンドラーがX.509個の証明書を検出していることを確認します（jakarta.servlet.request.X509Certificate属性を介して証明書の検出が成功したことを示すログエントリを探します）。
  5. 「未初期化のシステム信頼ストア」などのメッセージが表示されたKeyStoreNotInitialisedExceptionが発生した場合は、org.apache.sling.serviceusermapping.impl.ServiceUserMapperImpl.amendedの OSGi設定 を更新し、com.adobe.granite.auth.cert=truststore-reader-serviceを含めて、truststore アクセス用のサービスユーザーマッピングを追加します。
  6. 必要に応じて、影響を受けるバンドルまたはAEM インスタンスを再起動します。
  7. MSSL レプリケーションをリセットして、クライアント証明書の認証とレプリケーションが期待どおりに機能していることを確認します。
recommendation-more-help
experience-cloud-kcs-help-kbarticles