顧客認証設定

Experience Platform は、パートナーおよびお客様が使用できる認証プロトコルに優れた柔軟性を提供します。任意の業界標準の認証方法（OAuth2、ベアラートークン認証、パスワード認証、その他多数）をサポートするように宛先を設定できます。

このページでは、好みの認証方法を使用して宛先を設定する方法について説明します。宛先を作成する際に使用する認証設定に基づいて、Experience Platform UI で宛先に接続する際に、顧客には、様々なタイプの認証ページが表示されます。

このコンポーネントが Destination SDK で作成される統合のどこに適合するかを把握するには、設定オプションドキュメントの図を参照するか、以下の宛先設定の概要ページを参照してください。

顧客は、Platform から宛先にデータを書き出す前に、宛先接続チュートリアルで説明されている手順に従うことで、Experience Platform と宛先の間で新しい接続を作成する必要があります。

Destination SDK で宛先を作成する場合、customerAuthenticationConfigurations セクションが、認証画面で顧客に何が表示されるかを定義します。宛先認証タイプに応じて、顧客は、様々な認証の詳細を指定する必要があります。以下に例を示します。

/authoring/destinations エンドポイントを介して顧客認証の詳細を設定できます。このページに表示されるコンポーネントを設定できる、詳細な API 呼び出しの例については、以下の API リファレンスページを参照してください。

この記事では、宛先に使用できる、サポートされるすべての顧客認証設定を説明し、宛先に設定する認証方法に基づいて、Experience Platform UI で顧客に何が表示されるかを示します。

サポートされる統合タイプ supported-integration-types

このページで説明される機能をサポートする統合のタイプについて詳しくは、以下の表を参照してください。

認証ルール設定 authentication-rule

このページで説明されている任意の顧客認証設定を使用する場合、以下に示すように、常に、宛先配信の authenticationRule パラメーターを "CUSTOMER_AUTHENTICATION" に設定します。

{
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}

基本認証 basic

Experience Platform のリアルタイム（ストリーミング）統合では、基本認証がサポートされます。

基本認証タイプを設定する場合、ユーザーは、宛先に接続するために、ユーザー名およびパスワードを入力する必要があります。

宛先用に基本認証を設定するには、以下に示すように、/destinations エンドポイントを介して customerAuthenticationConfigurations セクションを設定します。

"customerAuthenticationConfigurations":[
   {
      "authType":"BASIC"
   }
]

ベアラー認証 bearer

ベアラー認証タイプを設定する場合、ユーザーは接続先から取得したベアラートークンを入力する必要があります。

宛先用にベアラー認証を設定するには、以下に示すように、/destinations エンドポイントを介して customerAuthenticationConfigurations セクションを設定します。

"customerAuthenticationConfigurations":[
   {
      "authType":"BEARER"
   }
]

OAuth 2 認証 oauth2

ユーザーが「宛先に接続」を選択すると、以下の Twitter カスタムオーディエンスの宛先の例のように、宛先への OAuth 2 認証フローがトリガーされます。宛先エンドポイントへの OAuth 2 認証の設定について詳しくは、専用の Destination SDK OAuth 2 認証ページをお読みください。

宛先用に OAuth2 認証を設定するには、以下に示すように、/destinations エンドポイントを介して customerAuthenticationConfigurations セクションを設定します。

"customerAuthenticationConfigurations":[
   {
      "authType":"OAUTH2"
   }
]

Amazon S3 認証 s3

Experience Platform では、ファイルベースの宛先に対して、Amazon S3 認証がサポートされています。

Amazon S3 認証タイプを設定する際に、ユーザーは S3 資格情報を入力する必要があります。

宛先用に Amazon S3 認証を設定するには、以下に示すように、/destinations エンドポイントを介して customerAuthenticationConfigurations セクションを設定します。

"customerAuthenticationConfigurations":[
   {
      "authType":"S3"
   }
]

Azure Blob 認証 blob

Experience Platform では、ファイルベースの宛先に対して、Azure Blob Storage 認証がサポートされています。

Azure Blob 認証タイプを設定する際に、ユーザーは接続文字列を入力する必要があります。

宛先用に Azure Blob 認証を設定するには、以下に示すように、/destinations エンドポイントで customerAuthenticationConfigurations パラメーターを設定します。

"customerAuthenticationConfigurations":[
   {
      "authType":"AZURE_CONNECTION_STRING"
   }
]

Azure Data Lake Storage 認証 adls

Experience Platform では、ファイルベースの宛先に対して、Azure Data Lake Storage 認証がサポートされています。

Azure Data Lake Storage 認証タイプを設定する際に、ユーザーは、Azure サービスプリンシパル資格情報およびテナント情報を入力する必要があります。

宛先用に Azure Data Lake Storage（ADLS）認証を設定するには、以下に示すように、/destinations エンドポイントの customerAuthenticationConfigurations パラメーターを設定します。

"customerAuthenticationConfigurations":[
   {
      "authType":"AZURE_SERVICE_PRINCIPAL"
   }
]

パスワード認証を使用した SFTP

Experience Platform では、ファイルベースの宛先に対して、パスワードを使用した SFTP 認証がサポートされています。

パスワード認証タイプで SFTP を設定する際に、ユーザーは SFTP のユーザー名とパスワード、SFTP ドメインとポート（デフォルトポートは 22）を入力する必要があります。

パスワードを使用した SFTP 認証を宛先に設定するには、/destinations エンドポイントの customerAuthenticationConfigurations パラメーターを以下のように設定します。

"customerAuthenticationConfigurations":[
   {
      "authType":"SFTP_WITH_PASSWORD"
   }
]

SSH キー認証を使用した SFTP

Experience Platform では、ファイルベースの宛先に対して、SSH キーを使用した SFTP 認証がサポートされています。

SSH キー認証タイプで SFTP を設定する際に、ユーザーは SFTP のユーザー名と SSH キー、および SFTP ドメインとポート（デフォルトポートは 22）を入力する必要があります。

SSH キーを使用した SFTP 認証を宛先に設定するには、/destinations エンドポイントの customerAuthenticationConfigurations パラメーターを以下のように設定します。

"customerAuthenticationConfigurations":[
   {
      "authType":"SFTP_WITH_SSH_KEY"
   }
]

Google Cloud Storage 認証 gcs

Experience Platform では、ファイルベースの宛先に対して、Google Cloud Storage 認証がサポートされています。

Google Cloud Storage 認証タイプを設定する際に、ユーザーは、Google Cloud Storage アクセスキー ID およびシークレットアクセスキーを入力する必要があります。

宛先用に Google Cloud Storage 認証を設定するには、以下に示すように、/destinations エンドポイントで customerAuthenticationConfigurations パラメーターを設定します。

"customerAuthenticationConfigurations":[
   {
      "authType":"GOOGLE_CLOUD_STORAGE"
   }
]

次の手順 next-steps

この記事を読むことで、宛先プラットフォームに対するユーザー認証の設定方法について、理解を深めることができました。

その他の宛先コンポーネントについて詳しくは、以下の記事を参照してください。