JWT 認証を使用したマイクロサービスベースの公開の設定
[Cloud Service]{class="badge informative"}
Adobe Experience Manager ガイド用のマイクロサービスベースの公開as a Cloud Serviceでは、PDF(ネイティブと DITA-OT ベースの両方)、HTML 5、JSON、カスタムの各種類の出力プリセットがサポートされています。
サービスアカウント(JWT)資格情報は非推奨になったので、Adobe IMS OAuth ベースの認証を使用することをお勧めします。 方法を学ぶ oauth 認証を使用したマイクロサービスベースのパブリッシングの設定.
Adobe IMSの JWT ベースの認証で保護された Cloud Publishing サービスの場合、以下の手順に従って環境をAdobeのセキュアトークンベースの認証ワークフローと統合し、新しいクラウドベースのスケーラブルな公開ソリューションの使用を開始する必要があります。
Adobe Developer コンソールでの IMS 設定の作成
集計の作成に必要な役割: システム管理者
Adobe Developer コンソールで IMS 設定を作成するには、次の手順を実行します。
-
Developer Console を開きます。
https://developer.adobe.com/console
. -
切り替え先 プロジェクト タブを上から選択します。
{width="500"}
-
新しい空のプロジェクトを作成するには、を選択します。 空のプロジェクト から 新規プロジェクトを作成 ドロップダウン。
{width="500"}
-
を選択 API から プロジェクトに追加 ドロップダウンで、プロジェクトに IO 管理 API を追加します。
{width="300"} {width="500"}
-
API の追加時に、新しい秘密鍵と公開鍵のペアを作成します。 これにより、秘密鍵がシステムに自動的にダウンロードされます。
{width="500"}
-
設定済みの API を保存します。
{width="600"}
-
に戻る プロジェクト tab キーを押してクリック プロジェクトの概要 左側。
{width="500"}
-
クリック Download 上部のボタンをクリックして、サービス JSON をダウンロードします。
{width="500"}
これで、JWT 認証の詳細が設定され、秘密鍵とサービスの詳細の JSON もダウンロードされました。 次の節では、これらのファイルが必要なので、これら 2 つのファイルを手元に置いてください。
環境への IMS 設定の追加
次の手順を実行して、環境に IMS 設定を追加します。
-
Experience manager を開き、設定する環境が含まれているプログラムを選択します。
-
切り替え先 環境 タブ。
-
設定する環境名をクリックします。 これにより、環境情報ページに移動します。
-
切り替え先 設定 タブ。
-
以下のスクリーンショットに示すように、秘密鍵とプロジェクト JSON をアップロードします。 以下にハイライト表示されているのと同じ名前と設定を使用していることを確認します。
{width="500"}
IMS 設定を環境に追加したら、次の手順を実行して、OSGi を使用してこれらのプロパティをExperience Managerガイドにリンクします。
-
Cloud Manager Git プロジェクトコードで、以下の 2 つのファイルを指定して追加します(ファイルの内容については、 付録)に設定します。
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml
-
新しく追加したファイルがによってカバーされていることを確認します。
filter.xml
. -
Git の変更をコミットし、プッシュします。
-
パイプラインを実行して変更を環境に適用します。
この操作が完了すると、新しい microservice ベースのクラウドパブリッシングを使用できるようになります。
FAQ
- 1 つのキーを複数のクラウド環境で使用できますか?
- はい。1 つの秘密鍵を生成し、すべての環境で使用できますが、すべての環境に環境変数を設定し、同じ鍵を使用する必要があります。
- マイクロサービスを使用する OSGi 設定が有効になっている場合、公開プロセスは同じコードベースを持つローカル AEM サーバーで動作しますか?
- いいえ(フラグの場合)
dxml.use.publish.microservice
はに設定されています。true
次に、マイクロサービスの設定が常に検索されます。 を設定dxml.use.publish.microservice
対象:false
ローカルで公開を機能させるために使用します。
- いいえ(フラグの場合)
- マイクロサービスベースのパブリッシングを使用する場合、DITA プロセスに割り当てられるメモリの量 これは DITA プロファイルの ant パラメータを介して実行されますか。
- マイクロサービスベースのパブリッシングでは、メモリ割り当ては DITA プロファイルの ant パラメーターによって実行されません。 サービスコンテナで使用可能なメモリの合計は 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"
/>