顧客認証設定

Experience Platformは、パートナーやお客様が利用できる認証プロトコルを柔軟に提供します。 などの業界標準の認証方法をサポートするように宛先を設定できます。 OAuth2、bearer トークン認証、パスワード認証など。

このページでは、優先認証方式を使用して宛先を設定する方法について説明します。 宛先の作成時に使用する認証設定に基づき、Experience PlatformUI で宛先に接続すると、様々な種類の認証ページが表示されます。

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

お客様が Platform から宛先にデータを書き出す前に、 宛先接続 チュートリアル

条件 宛先の作成 Destination SDK customerAuthenticationConfigurations セクションは、顧客に表示する内容を定義します 認証画面. 宛先の認証タイプに応じて、次のような様々な認証の詳細を指定する必要があります。

  • を使用する宛先の場合 基本認証の場合、ユーザーはユーザー UI 認証ページで直接ユーザー名とパスワードを入力する必要がありますExperience Platform。
  • を使用する宛先の場合 ベアラー認証の場合、ユーザーは bearer トークンを提供する必要があります。
  • を使用する宛先の場合 OAuth2 認証の場合、ユーザーはログインページにリダイレクトされ、自分の資格情報でログインできます。
  • の場合 Amazon S3 宛先、ユーザーは、 Amazon S3 アクセスキーと秘密鍵。
  • の場合 Azure Blob 宛先、ユーザーは、 Azure Blob 接続文字列。

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

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

重要

顧客認証設定では、パラメーターを設定する必要はありません。 このページに表示されるスニペットを API 呼び出しでコピー&ペーストできます。 作成中 または 更新中 宛先設定が作成され、ユーザーに対応する認証画面が Platform UI に表示されます。

重要

Destination SDKでサポートされるすべてのパラメーター名と値は 大文字と小文字を区別. 大文字と小文字の区別に関するエラーを避けるには、ドキュメントに示すように、パラメーターの名前と値を正確に使用してください。

サポートされる統合のタイプ

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

統合タイプ 機能をサポート
リアルタイム（ストリーミング）統合 ○
ファイルベース（バッチ）の統合 ○

認証ルールの設定

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

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

基本認証

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

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

基本認証を使用した UI レンダリング

宛先の基本認証を設定するには、 customerAuthenticationConfigurations セクション ( /destinations エンドポイントに次のように表示されます。

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

ベアラー認証

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

ベアラー認証による UI レンダリング

宛先に bearer タイプの認証を設定するには、 customerAuthenticationConfigurations セクション ( /destinations エンドポイントに次のように表示されます。

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

OAuth 2 認証

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

OAuth 2 認証を使用した UI レンダリング

次の手順でを設定します。 OAuth2 宛先の認証について、 customerAuthenticationConfigurations セクション ( /destinations エンドポイントに次のように表示されます。

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

Amazon S3 認証

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

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

S3 認証を使用した UI レンダリング

次の手順でを設定します。 Amazon S3 宛先の認証について、 customerAuthenticationConfigurations セクション ( /destinations エンドポイントに次のように表示されます。

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

Azure Blob 認証

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

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

Blob 認証を使用した UI レンダリング

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

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

Azure Data Lake Storage 認証

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

次を設定する場合、 Azure Data Lake Storage 認証の種類。ユーザーは、Azure Service Principal の資格情報とそのテナント情報を入力する必要があります。

Azure Data Lake Storage 認証を使用した UI レンダリング

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

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

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

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

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

パスワード認証を使用した SFTP での UI レンダリング

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

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

SSH キー認証を使用した SFTP

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

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

SSH キー認証を使用した SFTP での UI レンダリング

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

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

Google Cloud Storage 認証

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

次を設定する場合、 Google Cloud Storage 認証タイプ、ユーザーは、 Google Cloud Storage アクセスキー ID および 秘密アクセスキー.

Google Cloud Storage 認証を使用した UI レンダリング

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

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

次の手順

この記事を読むと、宛先プラットフォームへのユーザー認証の設定方法をより深く理解できるようになります。

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

このページ