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

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

サーバー間認証 s2s-auth

  1. APIとサービス、次に​ API ​を選択します。

    APIとサービスを表示するDeveloper Console

  2. AEM Content AI サービス​でフィルタリングし、プロジェクトを作成​して新しいプロジェクトを開始するか、既存のプロジェクトにサービスを追加する場合は​ API ​を追加します。

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

    ​ サーバー間のAPI ダイアログを選択しました

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

    Adobe Developer Consoleの手順を実行して、新しいサーバー間資格情報の名前を変更してから、「次へ 」を選択します

  5. AEM User - publish - Program XXX - Environment XXX​および/または​AEM User - author - Program XXX - Environment XXX Product Profileを選択し、Save​を選択します。

    対象プログラムと環境の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 Key」を選択します。

    API キー認証タイプを選択

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

    API キー資格情報を追加

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

    許可されたドメインの設定

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

    接続された資格情報からAPI キーをコピー

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

    code language-http
    x-api-key: YOUR_API_KEY
    

    これでプロジェクトの準備ができました。 AEM Content AI Servicesへのリクエストのたびにキーを使用します。

次の手順 next-steps

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