ドキュメントAEM GuidesAEM Guides ドキュメント

JWT認証によるマイクロサービスベースの公開を設定します

最終更新日： 2026年5月15日

作成対象：

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

[Cloud Service]{class="badge informative"}

NOTE
サービスアカウント（JWT）資格情報は、OAuth サーバー間認証情報に代わって非推奨（廃止予定）になりました。 サービスアカウント（JWT）資格情報を使用しているアプリケーションは、2025年1月1日以降に動作を停止します。 アプリケーションが引き続き機能するようにするには、2025年1月1日までに新しい資格情報に移行する必要があります。 サービスアカウント （JWT）資格情報からOAuth サーバー間資格情報への移行の詳細。

Adobe Experience Manager Guides as a Cloud Service用のマイクロサービスベースのパブリッシングでは、PDF（ネイティブベースとDITA-OT ベースの両方）、HTML5、JSON、およびカスタムタイプの出力プリセットをサポートしています。

サービスアカウント（JWT）資格情報が廃止されたため、Adobe IMSのOAuth ベース認証を使用することをお勧めします。 OAuth認証🔗を使用してマイクロサービスベースの公開を設定する方法について説明します。

Adobe IMS JWT ベースの認証によって保護されるクラウドパブリッシングサービスについては、以下の手順に従って、環境をAdobeのセキュアトークンベースの認証ワークフローと統合し、新しいクラウドベースのスケーラブルなパブリッシングソリューションの使用を開始する必要があります。

Adobe Developer ConsoleでのIMS設定の作成

統合の作成に必要な役割: システム管理者

Adobe Developer ConsoleでIMS設定を作成するには、次の手順を実行します。

  1. Developer Consoleを開きます：https://developer.adobe.com/console。

  2. 上から「プロジェクト」タブに切り替えます。

    「プロジェクト」タブ {width="500"}

  3. 新しい空のプロジェクトを作成するには、「新しいプロジェクトを作成」ドロップダウンから「空のプロジェクト」を選択します。

    新規プロジェクトを作成 {width="500"}

  4. 「プロジェクトに追加」ドロップダウンから「API」を選択して、プロジェクトにIO管理APIを追加します。

    プロジェクトを追加 {width="300"} io管理 {width="500"}

  5. APIの追加時に、新しい秘密鍵と公開鍵のペアを作成します。 これにより、秘密鍵がシステムに自動的にダウンロードされます。

    キーペアを生成 {width="500"}

  6. 設定したAPIを保存します。

    apiを保存 {width="600"}

  7. プロジェクト タブに戻り、左側の​ プロジェクト概要 ​をクリックします。

    プロジェクト概要 {width="500"}

  8. 上部の「ダウンロード」ボタンをクリックして、サービス JSONをダウンロードします。

    jsonをダウンロード {width="500"}

これで、JWT認証の詳細を設定し、秘密鍵とサービスの詳細JSONもダウンロードしました。 次のセクションで必要なファイルなので、これらの2つのファイルを便利に使用できます。

環境へのIMS設定の追加

環境にIMS設定を追加するには、次の手順を実行します。

  1. Experience Managerを開き、設定する環境を含むプログラムを選択します。

  2. 「環境」タブに切り替えます。

  3. 設定する環境名をクリックします。 これにより、環境情報ページに移動します。

  4. 「設定」タブに切り替えます。

  5. 以下のスクリーンショットに示すように、秘密鍵とプロジェクト JSONをアップロードします。 以下に強調表示されているのと同じ名前と設定を使用していることを確認してください。

    ims設定 {width="500"}

NOTE
上記のスクリーンショットに示すように、秘密鍵とサービスの詳細JSON ファイルの内容を開いてコピーし、設定パネルの値列に貼り付ける必要があります。

IMS設定を環境に追加したら、次の手順を実行して、これらのプロパティをOSGiを使用してExperience Manager Guidesにリンクします。

  1. Cloud ManagerのGit プロジェクトコードで、以下の2つのファイルを追加します（ファイルの内容については、付録を参照）。

    • com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
    • com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml

  2. 新しく追加されたファイルがfilter.xmlでカバーされていることを確認します。

  3. Gitの変更をコミットしてプッシュします。

  4. パイプラインを実行して、環境に変更を適用します。

これが完了すると、新しいマイクロサービスベースのクラウドパブリッシングを使用できるようになります。

FAQ

  1. 単一のキーを複数のクラウド環境で使用できますか？
    • はい、1つの秘密鍵を生成してすべての環境に使用できますが、すべての環境に環境変数を設定し、同じキーを使用する必要があります。
  2. マイクロサービスを使用するOSGi設定が有効になっている場合、公開プロセスは同じコードベースを持つローカル AEM サーバーで機能しますか？
    • いいえ。フラグ dxml.use.publish.microserviceがtrueに設定されている場合、常にマイクロサービス設定を探します。 パブリッシングがローカルで機能するように、dxml.use.publish.microserviceをfalseに設定します。
  3. マイクロサービスベースのパブリッシングを使用する場合、DITA プロセスに割り当てられるメモリの量はどれくらいですか？ これはDITA プロファイルのant パラメーターを使用して実行されますか？
    • マイクロサービスベースのパブリッシングでは、メモリ割り当てはDITA プロファイルアントパラメーターを通じて行われません。 サービスコンテナで使用可能な合計メモリは8 GBで、そのうち6 GBがDITA-OT プロセスに割り当てられます。

付録 appendix

ファイル:
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json

コンテンツ:

{
  "service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]",
  "private.key": "$[secret:PRIVATE_KEY]"
}

ファイル: com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml

コンテンツ:

  • dxml.use.publish.microservice: DITA-OTを使用してマイクロサービスベースの公開を有効に切り替えます
  • dxml.use.publish.microservice.native.pdf: マイクロサービスベースのネイティブ PDF パブリッシングを有効にする切り替え
<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
          jcr:primaryType="sling:OsgiConfig"
          dxml.publish.microservice.url="https://adobeioruntime.net/api/v1/web/543112-guidespublisher/default/publishercaller.json"
          dxml.use.publish.microservice="{Boolean}true"
          dxml.use.publish.microservice.native.pdf="{Boolean}true"
/>
recommendation-more-help
experience-manager-guides-help-product-guide