ドキュメントExperience Cloud KCS

Adobe Experience ManagerでgeneratePdf APIにアクセスする際の401 Unauthorized エラーの解決

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

Adobe Experience Manager（AEM）は、アプリケーションがgeneratePdf APIにアクセスしようとすると、HTTP 401 Unauthorized エラーを返す場合があります。 この問題を解決するには、認証資格情報を検証し、権限を確認し、最近の認証関連の設定変更を確認します。

説明 description

環境

Adobe Experience Manager（AEM）

問題/症状

  • Adobe Experience Managerと統合されたアプリケーションを介してgeneratePdf APIにアクセスしようとすると、HTTP 401 Unauthorized エラーが発生する可能性があります。
  • このエラーにより、ビジネスワークフローに必要なPDF ファイルを開いたり生成したりできなくなります。
  • この問題は、アプリケーションインターフェイスを介してAPIにアクセスする場合に再現できます。
  • リクエストに有効な認証資格情報がないか、提供された資格情報に十分な権限がありません。

解決策 resolution

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

  1. アプリケーションがgeneratePdf APIにアクセスするために使用する資格情報または認証トークンが有効であり、有効期限が切れていないことを確認します。
  2. AEM環境でgeneratePdf APIを呼び出すために必要な権限がユーザーまたはサービスアカウントに付与されていることを確認します。
  3. ID プロバイダー、API キー、OAuth設定の更新など、アクセスに影響を与える可能性のある認証設定に対する最近の変更を確認します。
  4. 環境が最近移行した場合（新しい実稼動環境や長期サポート（LTS）バージョンなど）、必要なすべてのテンプレートとコンテンツパスが同期され、アクセスポリシーが以前の環境と一致していることを確認します。
  5. curlやPostmanなどのツールを使用して、アプリケーション外でのAPI アクセスを直接テストし、問題がアプリケーションまたはバックエンド APIから発生しているかどうかを判断します。
  6. 問題が解決しない場合は、AEMとDispatcherのログを確認して、認証エラーの詳細を確認してください。
  7. これらの手順を完了したら、もう一度generatePdf APIにアクセスして、問題が解決されていることを確認します。
recommendation-more-help
experience-cloud-kcs-help-kbarticles