はじめに

概要

このページでは、Adobe Experience Platform宛先 SDK を認証し、使用を開始する方法について説明します。 これには、Adobe I/O認証資格情報、サンドボックス名、宛先オーサリングアクセス制御権限の取得方法に関する手順が含まれています。

用語

このガイドでは、IMS 組織やサンドボックスなど、Platform 固有の概念を使用します。 これらの用語と他の用語の定義については、Experience Platformの用語集 を参照してください。

必要な認証資格情報の取得

宛先 SDK は、Adobe I/O ゲートウェイを認証に使用します。 宛先 SDK エンドポイントへの API 呼び出しをおこなうには、API 呼び出しに特定のヘッダーを指定する必要があります。 AdobeExchange チームと協力して、Adobe開発者コンソール への認証を設定します。

宛先 SDK API エンドポイントを正常に呼び出すには、Experience Platform認証に関するチュートリアル に従ってください。 「API キー、IMS 組織 ID、クライアントの秘密鍵を生成する 」手順からチュートリアルを開始します。 Adobe交換チームが前の手順をおこないます。 認証に関するチュートリアルを完了すると、次のように、宛先 SDK API 呼び出しで必要な各ヘッダーの値が提供されます。

  • x-api-key: {API_KEY}(クライアント ID とも呼ばれます)
  • x-gw-ims-org-id: {IMS_ORG}(組織 ID とも呼ばれる)
  • Authorization: Bearer {ACCESS_TOKEN}に対する質問に回答します。アクセストークンの有効期限は 24 時間で、ミリ秒単位で指定するので、更新する必要があります。 アクセストークンを更新するには、認証に関するチュートリアルで説明されている手順を繰り返します。

宛先の所有権とサンドボックス

Experience Platform のすべてのリソースは、特定の仮想サンドボックスに分離されています。宛先 SDK へのリクエストには、操作がおこなわれるサンドボックスの名前を指定するヘッダーが必要です。

  • x-sandbox-name: {SANDBOX_NAME}

Adobe交換チームがサンドボックス名を提供します。この名前は、宛先 SDK API エンドポイントへの呼び出しで使用する必要があります。

ロールベースのアクセス制御 (RBAC)

リファレンスドキュメント で説明されている宛先 SDK API エンドポイントを使用するには、宛先のオーサリング アクセス制御権限が必要です。 Adobe交換チームと協力して、Adobe Admin Console でこの権限を割り当てます。

宛先オーサリング権限

詳細については、次のアクセス制御Experience Platformを参照してください。

その他の考慮事項

  • 宛先の設定に加えた変更は、宛先の設定を作成または編集する場合でも、Adobeによるレビューと承認が必要です。 変更は、レビューが完了した後でのみ、宛先に反映されます。
  • 同じ組織に属し、サンドボックスにアクセスできるユーザーのみが、宛先設定を編集できます。

次の手順

この記事の手順に従って、Adobe I/O、サンドボックス名、宛先オーサリングのアクセス制御権限に対する認証資格情報を取得しました。 次に、宛先 SDK を使用して宛先を設定できます。 宛先 SDK を使用して、次の手順で宛先 を設定します。

このページ