OpenAPI ベースのAEM API の設定
AEM as a Cloud Service環境を設定して、OpenAPI ベースのAEM API へのアクセスを有効にする方法について説明します。
AVAILABILITYの高度な設定プロセスには、次の手順が含まれます。
- AEM as a Cloud Service環境の最新化。
- AEM API アクセスを有効にします。
- Adobe Developer Console（ADC）プロジェクトを作成します。
- ADC プロジェクトの設定
- AEM インスタンスを設定して、ADC プロジェクト通信を有効にします。
AEM as a Cloud Serviceの最新化
AEM as a Cloud Service環境の最新化は、次の手順を含む環境アクティビティごとに 1 回行われます。
- AEM リリース 2024.10.18459.20241031T210302Z 以降に更新します。
- リリース 2024.10.18459.20241031T210302Z より前に環境が作成された場合は、新しい製品プロファイルを追加します。
AEM インスタンスの更新
AEM インスタンスを更新するには、「Adobe Cloud Manager」の「環境」セクションで、環境名の横にある 省略記号 アイコンを選択し、「更新」オプションを選択します。
次に、「送信」ボタンをクリックし、推奨 フルスタックパイプラインを実行します。
この場合、フルスタックパイプラインの名前は Dev :: Fullstack-Deploy で、AEM環境の名前は wknd-program-dev です。 名前が異なる場合があります。
新しい製品プロファイルを追加
AEM インスタンスに新しい製品プロファイルを追加するには、Adobe Cloud Manager の「環境」セクションで、環境名の横にある 省略記号 アイコンを選択し、「製品プロファイルを追加」オプションを選択します。
環境名の横にある 省略記号 アイコンをクリックし、アクセスを管理/プロファイルを作成 を選択すると、新しく追加された製品プロファイルを確認できます。
Admin Console ウィンドウに、新しく追加された製品プロファイルが表示されます。
上記の手順で、AEM as a Cloud Service環境の最新化が完了します。
AEM API アクセスの有効化
新しい製品プロファイル が存在すると、Adobe Developer Console（ADC）で OpenAPI ベースのAEM API アクセスが可能になります。 Adobe Developer Console（ADC）は、Adobe API、SDK、リアルタイムイベント、サーバーレス関数などにアクセスするための開発者ハブです。
新しく追加された製品プロファイルは、サービス に関連付けられています。これは、事前定義されたアクセス制御リスト（ACL） _を持つ_AEM ユーザーグループを表します。
サービス は、AEM API へのアクセスレベルを制御するために使用されます。
また、製品プロファイルに関連付けられた サービス を選択または選択解除して、アクセスレベルを増減することもできます。
製品プロファイル名の横にある 詳細を表示 アイコンをクリックして、関連付けを確認します。
デフォルトでは、AEM Assets API Users Service は製品プロファイルに関連付けられていません。 新しく追加された AEM Assets Collaborator Users - author - Program XXX - Environment XXX Product Profile に関連付けましょう。 この関連付けの後、ADC プロジェクトの Asset Author API で目的の認証を設定し、認証アカウントを製品プロファイルに関連付けることができます。
Adobe Developer Console（ADC）プロジェクトの作成
ADC プロジェクトを使用して、目的の API を追加し、その認証を設定して、認証アカウントを製品プロファイルに関連付けます。
ADC プロジェクトを作成するには、次の手順に従います。
-
Adobe IDを使用して 🔗0}Adobe Developer Console} にログインします。
-
「クイックスタート」セクションで、「新規プロジェクトを作成」ボタンをクリックします。
-
これにより、デフォルトの名前で新しいプロジェクトが作成されます。
-
右上隅の プロジェクトを編集 ボタンをクリックして、プロジェクト名を編集します。 意味のある名前を指定し、「保存 をクリックし す。
ADC プロジェクトの設定
ADC プロジェクトを作成したら、目的のAEM API を追加し、その認証を設定して、認証アカウントを製品プロファイルに関連付ける必要があります。
-
AEM API を追加するには、「API を追加」ボタンをクリックします。
-
API を追加 ダイアログで、Experience Cloudでフィルタリングし 目的のAEM API を選択します。 例えば、この場合、「アセットオーサー API が選択されます。
-
次に、API を設定 ダイアログで、目的の認証オプションを選択します。 例えば、この場合、「サーバー間」認証オプションが選択されています。
サーバー間の認証は、ユーザーの操作なしで API へのアクセスが必要なバックエンドサービスに最適です。 Web アプリとシングルページアプリの認証オプションは、ユーザーの代わりに API アクセスを必要とするアプリケーションに適しています。 詳しくは、OAuth サーバー間資格情報と web アプリ間資格情報とシングルページアプリ資格情報の違いを参照してください。
-
必要に応じて、識別しやすくするために API の名前を変更できます。 デモ用に、デフォルト名が使用されます。
-
この場合、認証方法は OAuth サーバー間 なので、認証アカウントを製品プロファイルに関連付ける必要があります。 「AEM Assets Collaborator Users - author - Program XXX - Environment XXX Product Profile」を選択し、「保存」をクリックします。
-
AEM API と認証設定を確認します。
OAuth Web アプリ または OAuth 単一ページアプリ の認証方法を選択した場合、製品プロファイルの関連付けは表示されませんが、アプリケーションリダイレクト URI が必要です。 アプリケーションリダイレクト URI は、認証コードによる認証後にユーザーをアプリケーションにリダイレクトするために使用されます。 関連するユースケースのチュートリアルでは、このような認証固有の設定の概要を説明します。
