OAuth 認証を使用したマイクロサービスベースの公開の設定

最終更新日： 2025年5月5日

トピック：
AEM Guides の Microservice

作成対象：

管理者

パブリッシングマイクロサービスを使用すると、Experience Manager Guidesas a Cloud Serviceで大規模なパブリッシングワークロードを同時に実行し、業界をリードするAdobe I/O Runtime サーバーレスプラットフォームを活用できます。

公開リクエストごとに、Experience Manager Guidesas a Cloud Serviceは、ユーザーリクエストに応じて水平方向に拡大・縮小される個別のコンテナを実行します。これにより、複数の公開リクエストを実行し、大規模なオンプレミス Adobe Experience Manager サーバーよりも高いパフォーマンスを得ることができます。

メモ

Experience Manager Guidesのマイクロサービスベースの公開では、PDF（ネイティブと DITA-OT ベースの両方）、HTML 5、JSON、カスタムの各種類の出力プリセットがサポートされています。

Cloud Publishing Service はAdobe IMSの OAuth ベースの認証で保護されているので、次の手順を実行して環境をAdobeのセキュアトークンベースの認証ワークフローと統合し、クラウドベースのスケーラブルな公開ソリューションの使用を開始します。

Adobe Developer Consoleでの IMS 設定の作成

設定の作成に必要な役割：システム管理者

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

メモ

AI を利用したスマート提案をオーサリング用に設定する OAuth プロジェクトを既に作成している場合は、次の手順をスキップしてプロジェクトを作成できます。

Developer Console: https://developer.adobe.com/console を開きます。
上部の「プロジェクト」タブに切り替えます。

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

新しい空のプロジェクトを作成します。
プロジェクトに追加 ドロップダウンから「API」を選択して、プロジェクトに IO 管理 API を追加します。

ドロップダウンから API プロジェクトを選択します。

I/O Management API をプロジェクトに追加します。
新しい OAuth 認証情報を作成し、保存します。

API に OAuth 認証情報を設定します。
「プロジェクト」タブに戻り、左側の プロジェクトの概要 を選択します。

新しいプロジェクトの概要
上部の「ダウンロード」ボタンをクリックして、サービス JSON をダウンロードします。

JSON サービスの詳細をダウンロードします。

OAuth 認証の詳細を設定し、JSON サービスの詳細をダウンロードしました。次の節で必要になるので、このファイルは手元に置いておいてください。

環境への IMS 設定の追加

NOTE

スマート提案用の OAuth プロジェクトを既に作成している場合は、同じプロジェクトをマイクロサービスに再利用し、以下の手順をスキップして IMS 設定を環境に追加できます。

既存の設定の更新（JWT）から OAuth shift）

JWT （非推奨）を使用して公開するために、既にマイクロサービスを使用している場合は、次の手順を実行して設定を更新します。

Experience Managerを開き 設定する環境が含まれているプログラムを選択してください。
「環境」タブに切り替えます。
設定する環境の名前を選択します。これにより、環境情報 ページに移動します。
「設定」タブに切り替えます。
SERVICE_ACCOUNT_DETAILS JSON フィールドを、ダウンロードした新しい OAuth JSON ファイルで更新します。
PRIVATE_KEY フィールドを削除します。

既存の JWT 環境設定を更新します。

初回設定

パブリッシングマイクロサービスを初めて使用するには、次の手順に従って設定を更新します。

Experience Managerを開き 設定する環境が含まれているプログラムを選択してください。
「環境」タブに切り替えます。
設定する環境の名前を選択します。これにより、環境情報 ページに移動します。
「設定」タブに切り替えます。
SERVICE_ACCOUNT_DETAILS という名前の新しい設定を作成します。値に、開発者コンソールからダウンロードした OAuth JSON ファイルのコンテンツを追加します。

ims サービスアカウントの設定

初めて環境を設定します。

マイクロサービスベースのパブリッシングを有効化するための初回コード変更

NOTE

マイクロサービスベースの公開を既に使用している場合は、次の手順をスキップしてください。

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

Cloud Manager Git プロジェクトコードで、次の 2 つのファイルを /apps/fmditaCustom/config に追加します（ファイルの内容については、付録を参照）。
- com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
- com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml
新しく追加したファイルが filter.xml でカバーされていることを確認します。
Git の変更をコミットし、プッシュします。
パイプラインを実行して、変更を環境に適用します。

この操作が完了したら、microservice ベースのクラウドパブリッシングを使用できます。

FAQ

マイクロサービスを使用する OSGi 設定が有効になっている場合、公開プロセスは同じコードベースのローカルExperience Managerサーバーで動作しますか？
- いいえ、フラグ dxml.use.publish.microservice が true に設定されている場合は、常にマイクロサービスの設定が検索されます。ローカルサーバーで公開を機能させるには、dxml.use.publish.microservice を false に設定します。
マイクロサービスベースのパブリッシングを使用する場合、DITA プロセスに割り当てられるメモリの量これは DITA プロファイルとパラメータによって駆動されますか？
- マイクロサービスベースのパブリッシングでは、メモリ割り当ては DITA プロファイルとパラメーターによって実行されません。サービスコンテナで使用可能なメモリの合計は 8 GB で、そのうち 6 GB が DITA-OT プロセスに割り当てられます。

付録

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

コンテンツ:

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

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