Comment activer le SFTP à partir du cloud / blogs de données Salesforce / Ferfient

C’est un oldie mais un goodie. 🙂

Avec Data Cloud, nous pouvons envoyer des données à de nombreuses sources de données externes comme le marketing Cloud Engagement ou Amazon S3 à travers Cibles d’activation. Mais il y a des moments où nous travaillons avec un système de destination comme Eloqua ou Marketo qui a un soutien solide pour SFTP.

Même avec l’engagement du cloud marketing, vous voudrez peut-être que les données affluent dans Automation Studio au lieu de pousser directement à une extension ou un voyage de données. SFTP permettrait à ce fichier CSV de circuler dans Automation Studio où un script SSJS par exemple pourrait traverser ces lignes et envoyer des messages SMS de masse.

Oui, comme nous le verrons dans cet article de blog, la configuration SFTP via Data Cloud prend en charge à la fois une clé SSH avec une phrase secrète et un mot de passe sur le site SFTP lui-même.

Il y a cinq pièces principales à configurer et à tester cela.

1. Créer une nouvelle clé SSH
2. Configurer le site SFTP dans le marketing Cloud Engagement
3. Testez la connexion SFTP à l’aide d’un outils comme Filezilla
4. Configurer cette cible d’activation SFTP dans le cloud de données
5. Construire un segment et une activation pour tirer parti de cette cible d’activation SFTP

Cela ressemblera à beaucoup de pas, mais cela ne prend vraiment pas autant de temps à faire. Tirant ces objectifs d’activation hors de la boîte comme celui-ci SFTP, va économiser des tonnes de temps à long terme.

Voici un bon article de blog pour vous présenter ce qu’est une clé SSH et comment elle fonctionne. https://www.sectigo.com/resource-library/what-is-an-ssh-key

Voici quelques bons articles sur la façon de générer une clé SSH.

1. https://www.purdue.edu/science/scienceit/ssh-keys-windows.html
2. https://www.ssh.com/academy/ssh/keygen

Note très importante que Marketing Cloud accepte uniquement les clés SSH générées d’une certaine manière… https://help.salesforce.com/s/articleview?id=000380791&type=1

Je suis sur une machine Windows, donc je vais ouvrir une invite de commande et utiliser la commande openSSH.

Une fois dans l’invite de commande Tapez la commande ssh-keygen.

Entrez maintenant votre nom de fichier.

Entrez maintenant votre phrase secrète. Il s’agit essentiellement d’un mot de passe lié à votre clé SSH pour rendre la rupture plus difficile. Ceci est différent de votre mot de passe SFTP qui sera défini du côté de l’engagement du cloud marketing.

Maintenant que votre phrase de passe a été entrée deux fois correctement, la touche SSH est générée.

Lors de l’utilisation de l’invite de commande, les fichiers ont été automatiquement créés dans mon répertoire C: \ Users \ Terry.luschen.

Maintenant, dans l’invite de commande comme indiqué dans le n ° 3 dans la documentation Salesforce ci-dessus, vous devez faire une commande finale.

Changer la clé en format de clé RFC4716 (SSH2)

1. ssh-keygen -e -f originalfilename.pub> newFileName
2. Donc, dans notre exemple ci-dessus, ma commande était
   1. ssh-keygen -e -f mce_ssh_01.pub> mce_ssh_01b
      

Les trois fichiers ressembleront à quelque chose:

1. MCE_SSH_01.pub – Il s’agit du fichier de clé publique à charger dans l’engagement du cloud marketing.
2. MCE_SSH_01 – Il s’agit du fichier de clé privée que nous utiliserons pour charger dans le cloud de données et Filezilla
3. MCE_SSH_01B – Il s’agit d’un autre fichier de clé publique qui peut être utilisé pour se charger dans l’engagement du cloud marketing

J’ai ouvert le fichier .pub et supprimé le commentaire.

J’ai également ajouté une extension de fichier de .txt au fichier MCE_SSH_01B afin qu’il soit maintenant nommé MCE_SSH_01B.txt

Maintenant que nous avons généré nos fichiers SSH, nous pouvons télécharger la clé publique pour marketing l’engagement cloud.

Connectez-vous à l’engagement du cloud marketing

Accédez à Configuration, à l’administration, à la gestion des données, à la gestion clé

Cliquez sur «Créer» sur la page «Key Management»

Remplissez les détails de la «nouvelle clé».

Assurez-vous que SSH est sélectionné.

Sélectionnez le fichier de clé «public» que vous avez créé plus tôt qui a l’extension .pub.

Vérifiez la case «clé publique».

Enregistrer la clé

Accédez maintenant à la configuration, à l’administration, à la gestion des données, aux comptes FTP

Utilisez le bouton «Créer un utilisateur» pour créer un nouvel utilisateur.

Remplissez la nouvelle page utilisateur FTP en entrant une adresse e-mail et un mot de passe. Remarque C’est différent de la phrase de passe créée ci-dessus qui était liée à la touche SSH. Cliquez sur Suivant.

Sélectionnez le bouton radio «clé SSH et mot de passe». Utilisez le sélecteur de fichiers pour sélectionner la clé de cloud marketing que vous venez de créer ci-dessus. Cliquez sur Suivant.

Sélectionnez le type de sécurité dont vous avez besoin. Dans cette photo d’écran, tout est sélectionné, mais vous ne devez généralement sélectionner les cases à cocher qui sont absolument nécessaires. Cliquez sur Suivant.

Si vous essayez de vous limiter à certains IPS, remplissez cet écran. Dans notre exemple, nous n’essayons pas de nous limiter à des IP de cloud de données, par exemple. Cliquez sur Suivant.

En règle générale, vous quitteriez cet écran tel quel. Il permet au dossier racine comme par défaut, puis lorsque vous configurez l’outil qui enverra des données au site SFTP, vous pouvez sélectionner le dossier exact à utiliser. Cliquez sur Enregistrer.

Ouais! Vous avez maintenant configuré notre site SFTP de destination.

Maintenant, nous pouvons tester cela!

1. J’aime tester à l’aide de filezilla, mais vous pouvez utiliser d’autres outils SFTP.
2. Téléchargez le fichierzilla et installez-le sur votre ordinateur.
3. Choisissez Modifier, Paramètres…
   1. Sélectionnez SFTP sous Connexion et choisissez « Ajouter un fichier clé .. ‘
      
   2. Vous pouvez choisir le fichier de clé privé d’origine et Filezilla produira un autre fichier pour vous. Ou vous pouvez utiliser le fichier SSH2 qui a été produit dans l’invite CMD, qui a été nommé MCE_SSH_01B.txt dans notre exemple ci-dessus.
   3. Selon le fichier téléchargé, vous devrez peut-être saisir la phrase de passe.
4. Ouvrez Filezilla et choisissez Fichier, gestionnaire de sites…
5. Cliquez sur «nouveau site» et remplissez les informations à droite. Enregistrez-le en cliquant sur OK.
   
6. Ouvrez votre site et cliquez sur la «connexion» en bas de l’écran.
   1. Vous serez invité à saisir votre phrase secrète qui est connectée à votre clé SSH.
7. Succès! Filezilla vous montre les dossiers du site SFTP de l’engagement Cloud Marketing!
   

1. Maintenant, faisons la même connexion dans le cloud de données
2. Dans la configuration du cloud de données, accédez à Data Cloud, intégrations externes, autres connecteurs
   
3. Choisissez l’onglet «Target» et «Secure File Transfer (SFTP)». Cliquez sur Suivant
   
4. Remplissez les informations de connexion.
   1. Le nom de connexion et le nom de l’API peuvent être tout ce que vous voulez qu’il soit
   2. La «méthode d’authentification» est la «clé privée SSH et mot de passe»
   3. Le nom d’utilisateur et le mot de passe sont les valeurs de l’utilisateur SFTP Cloud marketing.
   4. La clé privée SSH est le premier fichier créé dans l’invite CMC. C’était le fichier MCE_SSH_03 pour nous sans extension de fichier.
   5. La phrase de passe est la phrase de passe entrée dans l’invite CMD lors de la génération de votre clé.
   6. Pas besoin de mettre quoi que ce soit dans le domaine du «cryptage PGP».
   7. Ça devrait ressembler à ça maintenant…
      
   8. Dans la section des détails de la connexion…
      1. Le nom d’hôte et le port proviennent de l’écran SFTP Cloud marketing
         
      2. Ça devrait ressembler à ça maintenant…
         
      3. Vous pouvez «tester» votre connexion avant de l’enregistrer.
5. Vous devez maintenant créer une cible d’activation
   1. Open Data Cloud App
   2. Accédez à l’onglet des cibles d’activation, cliquez sur nouveau
      
   3. Sélectionnez ‘Secure File Transfer (SFTP)’ et cliquez sur ‘Suivant’
      
   4. Remplissez l’écran «New Activation Target».
      1. Sélectionnez le connecteur SFTP que vous avez créé plus tôt dans la liste déroulante «Sélectionner le connecteur SFTP».
         
      2. Cliquez sur Suivant
   5. Remplissez la page finale Sélection de votre format de fichier et d’autres options.
      1. Remarque La taille maximale du fichier est de 500 Mo.
         
      2. Si vous quittez le «type de nom de fichier» comme prédéterminé, vous devez toujours obtenir un nom de fichier unique car il sera annexé avec un «suffixe de date / heure».
         

1. Ouvrez l’application Data Cloud
2. Créez votre segment à partir de l’onglet Segment
3. Accédez à l’onglet Activations et cliquez sur «Nouveau»
   
4. Sélectionnez votre segment et la «cible d’activation» que nous avons créée au-dessus de laquelle dans votre site SFTP. Cliquez sur Continuer.
5. Ajoutez des champs «e-mail» ou «SMS» si nécessaire pour votre activation. Cliquez sur Suivant.
   
6. Remplissez les «Ajouter des attributs et des filtres à votre activation» si nécessaire. Cliquez sur Suivant.
   
7. Donnez un nom à votre activation et finalisez le calendrier et actualisez le type. Cliquez sur Enregistrer.
   
8. Vous devriez maintenant avoir votre nouvelle activation.
   
9. Revenez à votre segment et choisissez «Publier maintenant» si c’est ainsi que vous devez tester votre segment
   

Après avoir publié votre segment, il devrait s’exécuter et votre fichier devrait apparaître sur votre site STFP d’engagement du cloud marketing. Vous pouvez tester cela en ouvrant Filezilla, en vous connectant et en regardant dans le dossier approprié.

C’est ça!

Nous voyons avec Just Clicks et la configuration, nous pouvons envoyer des données de segment créées dans Data Cloud à un site SFTP! Nous utilisons les écrans de configuration standard de «cible d’activation» et «d’activation» dans le cloud de données.

Si vous réfléchissez à des cas d’utilisation pour Agentforce, veuillez lire avec Ce billet de blog De mon collègue Darshan Kukde!

Ici est un autre article de blog où je discute de l’utilisation de données non structurées dans Data Cloud afin que votre agent dans Agentforce puisse aider vos clients de nouvelles manières!

Si vous voulez une démo de cela en action ou si vous souhaitez aller plus loin, veuillez tendre la main et se connecter!