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 つの認証方法をサポートしています。 統合に一致する方法を選択してください。

メソッド
次に最適
サーバー間
ユーザーインタラクションなしで API を呼び出すバックエンドサービス。 有効期限の短いアクセストークンを返します。
API キー
API を直接呼び出すクライアントサイドまたはブラウザーベースの統合。 許可されたドメインに対してスコープされた、有効期限の長いキーを返します。

サーバー間認証 s2s-auth

  1. API とサービス」、「API」の順に選択します。

    「API とサービス」を示す Developer Console

  2. AEM コンテンツ AI サービス​でフィルタリングし、新規プロジェクトを開始するには「プロジェクトを作成」を選択し、既存のプロジェクトにサービスを追加する場合は「API を追加」を選択します。

    note
    NOTE
    API カードが「ライセンスは必須です」というメッセージと共に無効になっている場合、AEM as a Cloud Service 環境が最新化されていない場合があります。 詳しくは、AEM as a Cloud Service 環境の最新化を参照してください。
  3. API を設定​ダイアログで、サーバー間​認証を選択します。

    サーバー間が選択されている API を設定ダイアログ

    note tip
    TIP
    サーバー間オプションが使用できない場合、統合を設定するユーザーは製品プロファイルに開発者として追加されません。 詳しくは、サーバー間認証を有効にするを参照してください。
  4. 必要に応じて、資格情報を名前変更します。 「次へ」を選択します。

    「次へ」を選択する前に新しいサーバー間資格情報を名前変更する Adobe Developer Console の手順

  5. AEM ユーザー - パブリッシュ - プログラム XXX - 環境 XXXAEM ユーザー - オーサー - プログラム XXX - 環境 XXX の製品プロファイルを選択し、「保存」を選択します。

    ターゲットプログラムと環境の AEM ユーザーのパブリッシュプロファイルとオーサープロファイルを示す製品プロファイルピッカー

  6. API と認証設定を確認します。

    選択した API、認証タイプ、資格情報名を要約する確認画面

    資格情報に割り当てられた製品プロファイルを示す確認画面の詳細

アクセストークンの生成 generate-token

  1. ADC プロジェクトで、資格情報​に移動し、「アクセストークンを生成」を選択します。

    「アクセストークンを生成」ボタンがハイライト表示された資格情報ページ

  2. すべての API リクエストの Authorization ヘッダーにトークンを含めます。

    code language-http
    Authorization: Bearer YOUR_ACCESS_TOKEN
    
    note warning
    WARNING
    トークンは安全に保管してください。 有効期限があり、定期的に再生成する必要があります。

API キー認証 api-key-auth

  1. プロジェクトに AEM Content AI Services API を追加する際は、認証タイプを選択​ダイアログで「API キー」を選択します。

    API キー認証タイプを選択

  2. API キー資格情報を確認します。

    API キー資格情報を追加

  3. キーを使用できるオリジンを制限するには、許可されているドメインを設定します。

    許可されているドメインを設定

  4. API キー(クライアント ID)は、接続済み資格情報​の下に表示されます。 「コピー」を選択します。

    接続済み資格情報から API キーをコピー

  5. すべての API リクエストにキーを含めます。

    code language-http
    x-api-key: YOUR_API_KEY
    

    プロジェクトの準備が整いました。 AEM コンテンツ AI サービスへのすべてのリクエストにこのキーを使用します。

次の手順 next-steps

recommendation-more-help
experience-manager-content-ai-help-content-ai