OAuth サーバー間認証

OAuth サーバー間認証を使用すると、ユーザーの操作を必要とせずに、AEM Forms Communications API への安全なトークンベースのアクセスが可能になります。 Adobe Developer Consoleでは、OAuth サーバー間認証がサポートされています。

前提条件

開始する前に、次の前提条件が満たされていることを確認してください。

OAuth サーバー間認証を使用してアクセストークンを生成する方法

次の手順に従って、Adobe Developer コンソールからアクセストークンを生成し、OAuth サーバー間認証を使用して最初の API 呼び出しを行います。

​1. Adobe Developer Console プロジェクトのセットアップ

  1. Adobe Developer Console に移動します

  2. Adobe IDでログイン

  3. 新しいプロジェクトを作成するか、既存のプロジェクトに移動します

新しいプロジェクトを作成するには
  1. クイックスタート」セクションで、「新規プロジェクトを作成」をクリックします

  2. デフォルト名で新しいプロジェクトが作成されます

    ADC プロジェクトの作成

  3. 右上隅の プロジェクトを編集 をクリックします

    プロジェクトを編集

  4. 意味のある名前を指定(例:「formsproject」)

  5. 保存」をクリックします。

    プロジェクト名を編集

既存のプロジェクトに移動するには
  1. Adobe Developer Consoleで すべてのプロジェクト をクリックします

    プロジェクトの検索

  2. プロジェクトを見つけて、クリックして開きます。

    プロジェクトの検索

​2. Forms API を追加する

実行したい内容に基づいてForms API を追加します。

  • AEM Forms Communications API: ドキュメント(PDFおよび関連するフォーマット)を生成、変換、アセンブリ、または保護する必要がある場合に使用します。
  • アダプティブFormsランタイム API – 実行時にアダプティブFormsをレンダリング、送信または処理する必要がある場合に使用します。
AEM Forms Communications API の場合
  1. API を追加」をクリックします。

    API を追加

  2. Forms Communication API を選択

    1. API を追加 ダイアログで、Experience Cloudでフィルタリングします

    2. 「Forms Communication API を選択し す。

      Forms Communication API の追加

    3. 次へ」をクリックします。

    4. OAuth サーバー間 認証方法を選択します

      認証方法の選択

アダプティブ Forms ランタイム API の場合
  1. 「API を追加」をクリック

    API を追加

  2. AEM Forms配信およびランタイム API を選択

    1. API を追加 ダイアログで、Experience Cloudでフィルタリングします

    2. AEM Forms配信およびランタイム API」を選択 ます。
      Forms Communication API の追加

    3. 次へ」をクリックします。

    4. OAuth サーバー間​認証方式を選択します。
      認証方法の選択

また、プロジェクトに追加/API をクリックして、既存のプロジェクトに API と認証方法を追加することもできます
既存のプロジェクトへの API の追加

3.製品プロファイルの追加

製品プロファイルは、AEM リソースにアクセスするための資格情報に対する権限(または認証)を提供します。

  1. お使いのAEM インスタンス URL ()に一致する 製品プロファイル https://Service Type -Environment Type-Program XXX-Environment XXX.adobeaemcloud.com を選択します。

    • サービスタイプ - AEM インスタンスに関連付けられたサービスまたは権限を指定します。

    • 環境タイプ – 環境がオーサーサービス用かパブリッシュサービス用かを指定します

    • プログラム XXX - Cloud Manager プログラム ID を識別します。

    • 環境 XXX - プログラム内の特定の環境 ID を識別します。

    note note
    NOTE
    製品プロファイルは、特定のAEM インスタンス(プログラム +環境)に関連付けられています。 インスタンスの URL に一致するプロファイルを常に選択します。
  2. 設定済み API を保存」をクリックします。API と製品プロファイルがプロジェクトに追加されます

    プロジェクト設定の選択

4.認証情報の生成と保存

  1. Adobe Developer Consoleでプロジェクトに移動します

  2. OAuth サーバー間 資格情報をクリックします

  3. 資格情報の詳細 セクションを表示します

    資格情報の表示

レコード API 資格情報

    API Credentials:
    ================
    Client ID: <your_client_id>
    Client Secret: <your_client_secret>
    Technical Account ID: <tech_account_id>
    Organization ID: <org_id>
    Scopes: AdobeID,openid,read_organizations

​5. アクセストークンの生成

アクセストークンを手動またはプログラムで生成します。

テスト用

Adobe Developer Consoleで手動でアクセストークンを生成します。

  1. プロジェクトへの移動

    1. Adobe Developer Consoleで、プロジェクトを開きます
    2. OAuth サーバー間 をクリックします。
  2. アクセストークンの生成

    1. プロジェクトの「API」セクションで 「アクセストークンを生成」 ボタンをクリックします
    2. 生成されたアクセストークンのコピー

    アクセストークンの生成

    note note
    NOTE
    アクセストークンは 24 時間 のみ有効です
実稼動用

Adobe IMS API を使用してプログラムでトークンを生成します:

必要な資格情報:

  • クライアント ID
  • クライアントの秘密鍵
  • 範囲(通常:openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document

トークン エンドポイント:

code language-none
https://ims-na1.adobelogin.com/ims/token/v3

サンプルリクエスト (curl):

code language-bash
curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials' \
-d 'client_id=<YOUR_CLIENT_ID>' \
-d 'client_secret=<YOUR_CLIENT_SECRET>' \
-d 'scope=AdobeID,openid,read_organizations'

応答:

code language-json
    {
    "access_token": "eyJhbGciOiJSUz...",
    "token_type": "bearer",
    "expires_in": 86399
    }

生成されたアクセストークンを使用して、開発、ステージ、実稼動環境の API 呼び出しを行えるようになりました。

ベストプラクティス:開発、ステージングおよび実稼動用の認証情報の管理

  • 開発、ステージングおよび実稼動用に、常に別々の資格情報を使用します。

  • 正しいAEM環境 URL に各資格情報をマッピングします。

  • 秘密鍵は安全に保存し、ソース管理にコミットしないでください。

  • トークンは 24 時間のみ有効なので、アクセストークンの有効性を追跡します。

次の手順

同期Forms通信 API 用に環境を設定する方法については、AEM Forms as a Cloud Service通信同期処理 ​ を参照してください。

関連記事

同期(オンデマンド)および非同期(バッチ)Forms通信 API の環境を設定する方法について説明します。

同期 API

AEM Forms通信 API – 同期

ドキュメントを即座に生成または処理する、同期(オンデマンド)Forms Communications API の環境を設定する方法を説明します。

詳細情報

非同期 API

AEM Forms通信 API – 非同期(バッチ)

複数のドキュメントをスケジュールに従って生成または処理する、非同期(バッチ)Forms通信 API の環境を設定する方法について説明します。

詳細情報

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab