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 コンテンツ AI サービス製品プロファイルに 開発者 として追加されていること。 この役割がない場合、AEM Content AI Services API カードは無効になり、サーバー間認証オプションは非表示になります。
- 選択する製品プロファイルのプログラム番号と環境番号を把握していること(例:
AEM User - publish - Program 12345 - Environment 67890)。 - プログラムの Admin Console で システム管理者 の役割が付与されていること。 この役割では、製品プロファイルを管理し、環境にユーザーを割り当てることができます。
認証方法の選択 choose-auth
AEM コンテンツ AI サービスでは、2 つの認証方法をサポートしています。 統合に一致する方法を選択してください。
サーバー間認証 s2s-auth
-
「API とサービス」、「API」の順に選択します。
-
AEM コンテンツ AI サービスでフィルタリングし、新規プロジェクトを開始するには「プロジェクトを作成」を選択し、既存のプロジェクトにサービスを追加する場合は「API を追加」を選択します。
note NOTE API カードが「ライセンスは必須です」というメッセージと共に無効になっている場合、AEM as a Cloud Service 環境が最新化されていない場合があります。 詳しくは、AEM as a Cloud Service 環境の最新化を参照してください。 -
API を設定ダイアログで、サーバー間認証を選択します。
note tip TIP サーバー間オプションが使用できない場合、統合を設定するユーザーは製品プロファイルに開発者として追加されません。 詳しくは、サーバー間認証を有効にするを参照してください。 -
必要に応じて、資格情報を名前変更します。 「次へ」を選択します。
-
AEM ユーザー - パブリッシュ - プログラム XXX - 環境 XXX や AEM ユーザー - オーサー - プログラム XXX - 環境 XXX の製品プロファイルを選択し、「保存」を選択します。
-
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 キー」を選択します。
-
API キー資格情報を確認します。
-
キーを使用できるオリジンを制限するには、許可されているドメインを設定します。
-
API キー(クライアント ID)は、接続済み資格情報の下に表示されます。 「コピー」を選択します。
-
すべての API リクエストにキーを含めます。
code language-http x-api-key: YOUR_API_KEYプロジェクトの準備が整いました。 AEM コンテンツ AI サービスへのすべてのリクエストにこのキーを使用します。
次の手順 next-steps
- コンテンツソースの制御 - Cloud Manager でコンテンツソースを設定し、取得をトリガーします。
- Content AI API リファレンス - アクセストークンまたは API キーを使用して、インデックス作成済みコンテンツのクエリを実行します。