はじめに

概要 overview

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

用語 terminology

このガイドでは、組織やサンドボックスなど、Experience Platform固有の概念を使用します。 これらの用語の定義については、Experience Platform用語集を参照してください。 この機能に直接関連する用語については、Destination SDK用語集を参照してください。

必要な認証資格情報の取得 obtain-authentication-credentials

Destination SDK では、認証に Adobe I/O ゲートウェイを使用します。 Destination SDK エンドポイントへの API 呼び出しを行うには、API 呼び出しで特定のヘッダーを指定する必要があります。 Adobe Exchange チームと協力して、Adobe デベロッパーコンソールへの認証を設定してください。

Destination SDK API エンドポイントへの呼び出しを成功させるには、 Experience Platform 認証のチュートリアルに従います。「API キー、組織ID、およびクライアントシークレットを生成」ステップからチュートリアルを開始します。 Adobe Exchange チームが、それ以前の手順を代行します。 認証チュートリアルを完了すると、以下に示すような Destination SDK API 呼び出しで必要な各ヘッダーの値が提供されます。

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

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

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

役割ベースのアクセス制御（RBAC） rbac

​ リファレンスドキュメント ​に記載されているDestination SDK API エンドポイントを使用するには、Destination Authoring​のアクセス制御権限が必要です。 Adobe Exchange チームに依頼して、Adobe Admin Console でこの権限を割り当ててもらいます。

詳しくは、次の Experience Platform アクセス制御ドキュメントを参照してください。

その他の留意事項 additional-considerations

次の手順 next-steps

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