Configuration de l’authentification du client

Experience Platform offre une grande flexibilité dans les protocoles d’authentification disponibles pour les partenaires et les clients. Vous pouvez configurer votre destination pour qu’elle prenne en charge l’une des méthodes d’authentification standard du secteur, telles que OAuth2, authentification par jeton porteur, authentification par mot de passe, etc.

Cette page explique comment configurer votre destination à l’aide de votre méthode d’authentification préférée. En fonction de la configuration d’authentification que vous utilisez lors de la création de votre destination, les clients voient différents types de pages d’authentification lors de la connexion à la destination dans l’interface utilisateur de l’Experience Platform.

Pour comprendre où ce composant entre dans une intégration créée avec Destination SDK, reportez-vous au diagramme de la section options de configuration ou consultez les pages de présentation de la configuration de destination suivantes :

Avant que les clients puissent exporter des données de Platform vers votre destination, ils doivent créer une nouvelle connexion entre l’Experience Platform et votre destination, en suivant les étapes décrites dans la section connexion à la destination tutoriel .

When création d’une destination par Destination SDK, la variable customerAuthenticationConfigurations définit ce que voient les clients dans la section écran d'authentification. Selon le type d’authentification de destination, les clients doivent fournir divers détails d’authentification, tels que :

  • Pour les destinations qui utilisent authentification de base, les utilisateurs doivent fournir un nom d’utilisateur et un mot de passe directement dans la page d’authentification de l’interface utilisateur Experience Platform.
  • Pour les destinations qui utilisent authentification du porteur, les utilisateurs doivent fournir un jeton porteur.
  • Pour les destinations qui utilisent Authentification OAuth2, les utilisateurs sont redirigés vers la page de connexion de votre destination, où ils peuvent se connecter à l’aide de leurs informations d’identification.
  • Pour Amazon S3 destinations, les utilisateurs doivent fournir leurs Amazon S3 clé d’accès et clé secrète.
  • Pour Azure Blob destinations, les utilisateurs doivent fournir leurs Azure Blob Chaîne de connexion.

Vous pouvez configurer les détails de l’authentification du client via le /authoring/destinations point de terminaison . Consultez les pages de référence d’API suivantes pour obtenir des exemples d’appels d’API détaillés dans lesquels vous pouvez configurer les composants affichés dans cette page.

Cet article décrit toutes les configurations d’authentification du client prises en charge que vous pouvez utiliser pour votre destination et indique ce que les clients verront dans l’interface utilisateur de l’Experience Platform en fonction de la méthode d’authentification que vous avez configurée pour votre destination.

IMPORTANT

La configuration de l’authentification du client n’exige pas que vous configuriez des paramètres. Vous pouvez copier et coller les fragments de code affichés sur cette page dans vos appels API lors de la création ou mise à jour une configuration de destination, et vos utilisateurs verront l’écran d’authentification correspondant dans l’interface utilisateur de Platform.

IMPORTANT

Tous les noms et valeurs de paramètre pris en charge par Destination SDK sont respect de la casse. Pour éviter les erreurs de respect de la casse, veuillez utiliser les noms et valeurs des paramètres exactement comme indiqué dans la documentation.

Types d’intégration pris en charge

Reportez-vous au tableau ci-dessous pour plus d’informations sur les types d’intégration qui prennent en charge les fonctionnalités décrites sur cette page.

Type d’intégration Fonctionnalité de prise en charge
Intégrations en temps réel (diffusion en continu) Oui
Intégrations basées sur des fichiers (par lots) Oui

Configuration des règles d’authentification

Lors de l’utilisation de l’une des configurations d’authentification du client décrites dans cette page, définissez toujours la variable authenticationRule du paramètre diffusion de destination to "CUSTOMER_AUTHENTICATION", comme illustré ci-dessous.

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

Authentification de base

L’authentification de base est prise en charge pour les intégrations en temps réel (flux) dans Experience Platform.

Lorsque vous configurez le type d’authentification de base, les utilisateurs doivent saisir un nom d’utilisateur et un mot de passe pour se connecter à votre destination.

Rendu de l’interface utilisateur avec authentification de base

Pour configurer l’authentification de base pour votre destination, configurez la variable customerAuthenticationConfigurations via la section /destinations point de terminaison comme illustré ci-dessous :

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

Authentification du porteur

Lorsque vous configurez le type d’authentification du porteur, les utilisateurs doivent saisir le jeton du porteur qu’ils obtiennent de votre destination.

Rendu de l’interface utilisateur avec authentification du porteur

Pour configurer l’authentification par type de porteur pour votre destination, configurez la variable customerAuthenticationConfigurations via la section /destinations point de terminaison comme illustré ci-dessous :

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

Authentification OAuth 2

Les utilisateurs sélectionnent Se connecter à la destination pour déclencher le flux d’authentification OAuth 2 vers votre destination, comme illustré dans l’exemple ci-dessous pour la destination Audiences personnalisées de Twitter. Pour plus d’informations sur la configuration de l’authentification OAuth 2 à votre point d’entrée de destination, consultez la page Authentification OAuth 2 de Destination SDK.

Rendu de l’interface utilisateur avec authentification OAuth 2

Pour configurer OAuth2 l’authentification pour votre destination, configurez la variable customerAuthenticationConfigurations via la section /destinations point de terminaison comme illustré ci-dessous :

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

Authentification Amazon S3

L’authentification Amazon S3 est prise en charge pour les destinations basées sur des fichiers dans Experience Platform.

Lorsque vous configurez le type d’authentification Amazon S3, les utilisateurs doivent saisir leurs informations d’identification S3.

Rendu de l’interface utilisateur avec authentification S3

Pour configurer Amazon S3 l’authentification pour votre destination, configurez la variable customerAuthenticationConfigurations via la section /destinations point de terminaison comme illustré ci-dessous :

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

Authentification Azure Blob

L’authentification Azure Blob Storage est prise en charge pour les destinations basées sur des fichiers dans Experience Platform.

Lorsque vous configurez le type d’authentification Azure Blob, les utilisateurs doivent saisir la chaîne de connexion.

Rendu de l’interface utilisateur avec authentification Blob

Pour configurer l’authentification Azure Blob pour votre destination, configurez le paramètre customerAuthenticationConfigurations du point d’entrée /destinations comme illustré ci-dessous :

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

Authentification Azure Data Lake Storage

L’authentification Azure Data Lake Storage est prise en charge pour les destinations basées sur des fichiers dans Experience Platform.

Lorsque vous configurez la variable Azure Data Lake Storage type d’authentification, les utilisateurs doivent saisir les informations d’identification de l’entité de sécurité Azure Service et leurs informations de client.

Azure Data Lake StorageRendu de l’interface utilisateur avec authentification

Pour configurer l’authentification Azure Data Lake Storage (ADLS) de votre destination, configurez le paramètre customerAuthenticationConfigurations du point d’entrée /destinations comme illustré ci-dessous :

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

SFTP avec authentification par mot de passe

L’authentification SFTP avec mot de passe est prise en charge pour les destinations basées sur des fichiers dans Experience Platform.

Lorsque vous configurez le SFTP avec le type d’authentification par mot de passe, les utilisateurs doivent saisir le nom d’utilisateur et le mot de passe SFTP, ainsi que le domaine et le port SFTP (le port par défaut est 22).

Rendu de l’interface utilisateur avec authentification par mot de passe

Pour configurer l’authentification SFTP avec le mot de passe de votre destination, configurez le paramètre customerAuthenticationConfigurations du point d’entrée /destinations comme illustré ci-dessous :

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

SFTP avec authentification par clé SSH

L’authentification SFTP avec la clé SSH est prise en charge pour les destinations basées sur des fichiers dans Experience Platform.

Lorsque vous configurez le SFTP avec le type d’authentification par clé SSH, les utilisateurs doivent saisir le nom d’utilisateur SFTP et la clé SSH, ainsi que le domaine et le port SFTP (le port par défaut est 22).

Rendu de l’interface utilisateur avec SFTP avec authentification par clé SSH

Pour configurer l’authentification SFTP avec la clé SSH pour votre destination, configurez le paramètre customerAuthenticationConfigurations du point d’entrée /destinations comme illustré ci-dessous :

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

Authentification Google Cloud Storage

L’authentification Google Cloud Storage est prise en charge pour les destinations basées sur des fichiers dans Experience Platform.

Lorsque vous configurez la variable Google Cloud Storage type d’authentification, les utilisateurs doivent saisir leur Google Cloud Storage ID de clé d’accès et clé d'accès secrète.

Rendu de l’interface utilisateur avec l’authentification Google Cloud Storage

Pour configurer l’authentification Google Cloud Storage pour votre destination, configurez le paramètre customerAuthenticationConfigurations du point d’entrée /destinations comme illustré ci-dessous :

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

Étapes suivantes

Après avoir lu cet article, vous devriez mieux comprendre comment configurer l’authentification des utilisateurs sur votre plateforme de destination.

Pour en savoir plus sur les autres composants de destination, consultez les articles suivants :

Sur cette page