Experience Platformは、パートナーやお客様が利用できる認証プロトコルを柔軟に提供します。 などの業界標準の認証方法をサポートするように宛先を設定できます。 OAuth2、bearer トークン認証、パスワード認証など。
このページでは、優先認証方式を使用して宛先を設定する方法について説明します。 宛先の作成時に使用する認証設定に基づき、Experience PlatformUI で宛先に接続すると、様々な種類の認証ページが表示されます。
Destination SDKを使用して作成された統合で、このコンポーネントがどこに適合するかを把握するには、 設定オプション ドキュメントを参照するか、次の宛先設定の概要ページを参照してください。
お客様が Platform から宛先にデータを書き出す前に、 宛先接続 チュートリアル
条件 宛先の作成 Destination SDK customerAuthenticationConfigurations
セクションは、顧客に表示する内容を定義します 認証画面. 宛先の認証タイプに応じて、次のような様々な認証の詳細を指定する必要があります。
顧客認証の詳細は、 /authoring/destinations
endpoint. このページに示すコンポーネントを設定できる API 呼び出しの詳細な例については、次の API リファレンスページを参照してください。
この記事では、宛先に使用できる、サポートされるすべての顧客認証設定について説明し、宛先に設定した認証方法に基づいて、Experience PlatformUI で顧客に表示される内容を示します。
Destination SDKでサポートされるすべてのパラメーター名と値は 大文字と小文字を区別. 大文字と小文字の区別に関するエラーを避けるには、ドキュメントに示すように、パラメーターの名前と値を正確に使用してください。
このページで説明する機能をサポートする統合のタイプについて詳しくは、次の表を参照してください。
統合タイプ | 機能をサポート |
---|---|
リアルタイム(ストリーミング)統合 | ○ |
ファイルベース(バッチ)の統合 | ○ |
このページで説明するいずれかの顧客認証設定を使用する場合、 authenticationRule
パラメーター 宛先の配信 から "CUSTOMER_AUTHENTICATION"
、以下に示すように。
{
"destinationDelivery":[
{
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"{{destinationServerId}}"
}
]
}
基本認証は、Experience Platformでのリアルタイム(ストリーミング)統合に対してサポートされます。
基本認証タイプを設定する場合、ユーザーは宛先に接続するためのユーザー名とパスワードを入力する必要があります。
宛先の基本認証を設定するには、 customerAuthenticationConfigurations
セクション ( /destinations
エンドポイントに次のように表示されます。
"customerAuthenticationConfigurations":[
{
"authType":"BASIC"
}
]
ベアラー認証タイプを設定する場合、ユーザーは接続先から取得したベアラートークンを入力する必要があります。
宛先に bearer タイプの認証を設定するには、 customerAuthenticationConfigurations
セクション ( /destinations
エンドポイントに次のように表示されます。
"customerAuthenticationConfigurations":[
{
"authType":"BEARER"
}
]
ユーザーが「宛先に接続」を選択すると、以下の Twitter カスタムオーディエンスの宛先の例のように、宛先への OAuth 2 認証フローがトリガーされます。宛先エンドポイントへの OAuth 2 認証の設定について詳しくは、専用の Destination SDK OAuth 2 認証ページをお読みください。
次の手順でを設定します。 OAuth2 宛先の認証について、 customerAuthenticationConfigurations
セクション ( /destinations
エンドポイントに次のように表示されます。
"customerAuthenticationConfigurations":[
{
"authType":"OAUTH2"
}
]
Experience Platform では、Amazon S3 認証がファイルベースの宛先に対してサポートされています。
Amazon S3 認証タイプを設定する場合、ユーザーは S3 資格情報を入力する必要があります。
次の手順でを設定します。 Amazon S3 宛先の認証について、 customerAuthenticationConfigurations
セクション ( /destinations
エンドポイントに次のように表示されます。
"customerAuthenticationConfigurations":[
{
"authType":"S3"
}
]
Experience Platform では、Azure Blob Storage 認証がファイルベースの宛先に対してサポートされています。
Azure Blob 認証タイプを設定する際に、ユーザーは接続文字列を入力する必要があります。
Azure Blob 認証を宛先に設定するには、エンドポイント /destinations
の customerAuthenticationConfigurations
パラメーターを次のように設定します。
"customerAuthenticationConfigurations":[
{
"authType":"AZURE_CONNECTION_STRING"
}
]
Experience Platform では、Azure Data Lake Storage 認証がファイルベースの宛先に対してサポートされています。
次を設定する場合、 Azure Data Lake Storage 認証の種類。ユーザーは、Azure Service Principal の資格情報とそのテナント情報を入力する必要があります。
Azure Data Lake Storage(ADLS)認証を宛先に設定するには、エンドポイント /destinations
の customerAuthenticationConfigurations
パラメーターを次のように設定します。
"customerAuthenticationConfigurations":[
{
"authType":"AZURE_SERVICE_PRINCIPAL"
}
]
Experience Platform では、パスワードを使用した SFTP 認証がファイルベースの宛先に対してサポートされています。
パスワード認証タイプで SFTP を設定する際に、ユーザーは SFTP のユーザー名とパスワード、SFTP ドメインとポート(デフォルトポートは 22)を入力する必要があります。
パスワードを使用した SFTP 認証を宛先に設定するには、エンドポイント /destinations
の customerAuthenticationConfigurations
パラメーターを次のように設定します。
"customerAuthenticationConfigurations":[
{
"authType":"SFTP_WITH_PASSWORD"
}
]
Experience Platform では、SSH キーを使用した SFTP 認証がファイルベースの宛先に対してサポートされています。
SSH キー認証タイプで SFTP を設定する際に、ユーザーは SFTP のユーザー名と SSH キー、および SFTP ドメインとポート(デフォルトポートは 22)を入力する必要があります。
SSH キーを使用した SFTP 認証を宛先に設定するには、エンドポイント /destinations
の customerAuthenticationConfigurations
パラメーターを次のように設定します。
"customerAuthenticationConfigurations":[
{
"authType":"SFTP_WITH_SSH_KEY"
}
]
Experience Platform では、Google Cloud Storage 認証がファイルベースの宛先に対してサポートされています。
次を設定する場合、 Google Cloud Storage 認証タイプ、ユーザーは、 Google Cloud Storage アクセスキー ID および 秘密アクセスキー.
Google Cloud Storage 認証を宛先に設定するには、エンドポイント /destinations
の customerAuthenticationConfigurations
パラメーターを次のように設定します。
"customerAuthenticationConfigurations":[
{
"authType":"GOOGLE_CLOUD_STORAGE"
}
]
この記事を読むと、宛先プラットフォームへのユーザー認証の設定方法をより深く理解できるようになります。
その他の宛先コンポーネントについて詳しくは、次の記事を参照してください。