AEM as a Cloud Service に対するトークンベースの認証

2025年5月5日
  • 適用対象：
  • Experience Manager as a Cloud Service
  • トピック：
  • API

作成対象：

  • 中級
  • 経験者
  • 開発者

AEM は、GraphQL、AEM コンテンツサービスから Assets HTTP API まで、ヘッドレスな方法で操作できる様々な HTTP エンドポイントを公開します。多くの場合、これらのヘッドレスを使用するお客様は、保護されたコンテンツやアクションにアクセスするために、AEM に対する認証を行う必要があります。これを容易にするために、AEM は、外部のアプリケーション、サービス、システムからの HTTP リクエストのトークンベースの認証をサポートしています。

このチュートリアルでは、外部アプリケーションがアクセストークンを使用して、HTTP 経由で AEM as a Cloud Service に対してプログラムで認証とやり取りを行う方法について詳しく説明します。

前提条件

このチュートリアルを開始する前に、次の情報と環境が整っていることを確認します。

  1. AEM as a Cloud Service 環境（開発環境またはサンドボックスプログラムが望ましい）へのアクセス
  2. AEM as a Cloud Service 環境におけるオーサーサービス AEM 管理者製品プロファイルのメンバーシップ
  3. Adobe IMS 組織管理者のメンバーシップまたはアクセス権（サービス資格情報の初期化を 1 回のみ実行する必要があります）
  4. Cloud Service 環境にデプロイされた最新の WKND サイト

外部アプリケーションの概要

このチュートリアルでは、コマンドラインから実行される単純な Node.js アプリケーションを使用して、Assets HTTP API で AEM as a Cloud Service のアセットメタデータを更新します。

Node.js アプリケーションの実行フローは次のとおりです。

外部アプリケーション

  1. Node.js アプリケーションは、コマンドラインから呼び出されます

  2. コマンドラインパラメーターの定義：

    • 接続先の AEM as a Cloud Service オーサーサービスホスト（aem）
    • アセットが更新される AEM アセットフォルダー（folder）
    • 更新するメタデータのプロパティと値（propertyName と propertyValue）
    • AEM as a Cloud Service へのアクセスに必要な資格情報を提供するファイルへのローカルパス（file）

  3. AEM への認証に使用されるアクセストークンは、コマンドラインパラメーター file で指定された JSON ファイルから取得します

    a. 非ローカル開発用のサービス資格情報が JSON ファイル（file）で提供されている場合、アクセストークンは Adobe IMS API から取得します

  4. アプリケーションはアクセストークンを使用して AEM にアクセスし、コマンドラインパラメーター folder で指定されたフォルダー内のすべてのアセットをリスト表示します

  5. フォルダー内の各アセットのメタデータは、コマンドラインパラメーター propertyName と propertyValue で指定されたプロパティ名と値に基づいてアプリケーションで更新されます

このサンプルアプリケーションは Node.js ですが、これらのやり取りは様々なプログラミング言語で開発し、その他の外部システムから実行できます。