Adobe Developer Console プロジェクトの設定 configure-adc-project
AEM Content AI Services APIを呼び出すには、Adobe Developer Console(ADC)プロジェクトによって発行された資格情報が必要です。 このページでは、プロジェクトの作成、認証方法の選択、API リクエストごとに含める資格情報の生成について説明します。
開始するには、Adobe Developer Consoleにアクセスしてください。
前提条件 prerequisites
始める前に、次の点を確認してください。
- お客様の組織のAdobe Developer Consoleにアクセスできます。
- Adobe Admin ConsoleのAEM Content AI Services製品プロファイルに 開発者 として追加されました。 このロールがないと、AEM Content AI Services API カードは無効になり、サーバー間認証オプションは非表示になります。
- 選択する製品プロファイルのプログラム番号と環境番号(例:
AEM User - publish - Program 12345 - Environment 67890)を知っています。 - プログラムのAdmin Consoleで システム管理者 の役割を持っています。 この役割では、製品プロファイルを管理し、環境にユーザーを割り当てることができます。
認証方法の選択 choose-auth
AEM Content AI Servicesでは、2つの認証方法をサポートしています。 統合に一致するものを選択してください:
サーバー間認証 s2s-auth
-
APIとサービス、次に API を選択します。
-
AEM Content AI サービスでフィルタリングし、プロジェクトを作成して新しいプロジェクトを開始するか、既存のプロジェクトにサービスを追加する場合は API を追加します。
note NOTE 「ライセンスが必要です」というメッセージが表示されてAPI カードが無効になっている場合、AEM as a Cloud Service環境が最新化されていない可能性があります。 AEM as a Cloud Service環境の最新化を参照してください。 -
Configure API ダイアログで、サーバー間認証を選択します。
note tip TIP サーバー間オプションが使用できない場合、統合を設定するユーザーは開発者として製品プロファイルに追加されません。 サーバー間認証を有効にするを参照してください。 -
必要に応じて、資格情報の名前を変更します。 「次へ」を選択します。
」を選択します
-
AEM User - publish - Program XXX - Environment XXXおよび/またはAEM User - author - Program XXX - Environment XXX Product Profileを選択し、Saveを選択します。
-
APIと認証設定を確認します。
アクセストークンの生成 generate-token
-
ADC プロジェクトで、資格情報に移動し、アクセストークンの生成を選択します。
「アクセストークンを生成」ボタンが強調表示された
-
すべてのAPI リクエストの
Authorizationヘッダーにトークンを含めます。code language-http Authorization: Bearer YOUR_ACCESS_TOKENnote warning WARNING トークンを安全に保管する: 有効期限が切れ、定期的に再生成する必要があります。
API キー認証 api-key-auth
-
AEM Content AI Services APIをプロジェクトに追加する際、認証タイプを選択 ダイアログで「API Key」を選択します。
-
API キー資格情報を確認します。
-
キーを使用できるオリジンを制限するには、許可されたドメインを設定します。
-
API キー(クライアント ID)は、接続済み資格情報の下に表示されます。 「コピー」を選択します。
-
すべてのAPI リクエストにキーを含めます。
code language-http x-api-key: YOUR_API_KEYこれでプロジェクトの準備ができました。 AEM Content AI Servicesへのリクエストのたびにキーを使用します。
次の手順 next-steps
- コンテンツソースの制御 - Cloud Managerとトリガーの取得でコンテンツソースを設定します。
- コンテンツ AI API リファレンス - アクセストークンまたはAPI キーを使用して、インデックス付きコンテンツをクエリします。