DocumentationExperience PlatformBalises

Hôtes SFTP

Last update: Fri Dec 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur

Experience Platform vous permet de diffuser les versions de bibliothèque de balises sur un serveur SFTP sécurisé que vous hébergez, ce qui vous permet de mieux contrôler le stockage et la gestion de vos versions. Ce guide explique comment configurer un hôte SFTP pour une propriété de balise dans l’interface utilisateur d’Experience Platform ou l’interface utilisateur de la collecte de données.

NOTE
Vous pouvez également choisir d’utiliser un hôte géré par Adobe à la place. Pour plus d’informations, consultez le guide sur les hôtes gérés par Adobe.
Pour plus d’informations sur les avantages et les limites des bibliothèques d’auto-hébergement, consultez le ​ guide d’auto-hébergement ​.

Configurer une clé d’accès pour votre serveur access-key

Experience Platform se connecte à votre site SFTP à l’aide d’une clé chiffrée. Pour configurer cette méthode correctement, quelques manipulations sont nécessaires :

Création d’une paire de clés publique/privée

Une paire de clés publique/privée doit être installée sur votre serveur SFTP. Vous pouvez générer ces clés sur votre serveur ou les générer ailleurs et les installer sur votre serveur. Pour plus d’informations, consultez la documentation GitHub concernant la génération de clés SSH.

Chiffrer vos clés

La clé privée est utilisée pour chiffrer la clé publique. Vous devrez fournir votre clé privée pendant le processus de création de l’hôte SFTP. Consultez la section sur le chiffrement des valeurs dans le guide de l’API Reactor pour obtenir des instructions sur le chiffrement des clés publiques. Utilisez la clé GPG de l’environnement de production, sauf si vous savez que vous avez besoin d’une clé spécifique. Enfin, vous pouvez chiffrer votre clé privée depuis n’importe quel ordinateur. Il n’est donc pas nécessaire d’installer GPG sur votre serveur pour réaliser cette manipulation.

Placer sur la liste autorisée des adresses IP Experience Platform

Vous devrez peut-être approuver un ensemble d’adresses IP à utiliser dans le pare-feu de votre société pour permettre à Experience Platform d’accéder à votre serveur SFTP et de s’y connecter. Ces adresses IP sont les suivantes :

  • 34.227.138.75
  • 44.194.43.191
  • 3.215.163.18
NOTE
La structure des versions de balises a changé au fil du temps. Elles utilisent des liens symboliques (symlinks) en interne pour maintenir la rétrocompatibilité afin que les codes intégrés précédents continuent à fonctionner avec la dernière structure de version. Votre serveur SFTP doit prendre en charge l’utilisation des liens symboliques pour servir de destination valide aux versions de balises.

Pour plus d’informations détaillées, reportez-vous à l’article Medium suivant sur la configuration de serveurs SFTP pour la diffusion d’une version.

Création d’un hôte SFTP create

Sélectionnez Hosts dans le volet de navigation de gauche, puis Add Host.

Image illustrant le bouton Ajouter l’hôte sélectionné dans l’interface utilisateur

La boîte de dialogue de création de l’hôte s’affiche. Attribuez un nom à l’hôte et, sous Type, sélectionnez SFTP.

Image illustrant l’option d’hébergement SFTP sélectionnée

Configuration de l’hôte SFTP configure

La boîte de dialogue se développe pour inclure des options de configuration supplémentaires pour l’hôte SFTP. Elles sont expliquées ci-dessous.

Image montrant les détails requis pour une connexion d’hôte SFTP

Champ de configuration
Description
Don’t Use Symlinks
Par défaut, tous les hôtes SFTP utilisent des liens symboliques (symlinks) pour référencer la bibliothèque versions qui sont enregistrés sur le serveur. Cependant, tous les serveurs ne prennent pas en charge l’utilisation de liens symboliques. Lorsque cette option est sélectionnée, l’hôte utilise une opération de copie pour mettre à jour directement les ressources de build au lieu d’utiliser des liens symboliques.
SFTP Server URL
Chemin d’accès de base de l’URL de votre serveur .
Path
Chemin d’accès à ajouter à l’URL du serveur de base pour cet hôte.
Port

Le port doit être l’un des ports suivants :

  • 21
  • 22
  • 201
  • 200
  • 2002
  • 2018
  • 2022
  • 2200
  • 2222
  • 2333
  • 2939
  • 443
  • 4343
  • 80
  • 8080
  • 8888

En règle générale, Adobe limite le nombre de ports pouvant être utilisés pour le trafic sortant. Les ports sélectionnés sont généralement autorisés à passer par les pare-feu d’entreprise et incluent certaines plages pour plus de flexibilité.

Username
Nom d’utilisateur à utiliser lors de l’accès au serveur.
Encrypted Private Key
La clé privée chiffrée que vous avez créée lors d’une étape précédente.

Sélectionnez Save pour créer l’hôte avec la configuration sélectionnée.

Image montrant l’hôte SFTP en cours d’enregistrement

Lorsque vous sélectionnez Save, la connexion et la capacité à envoyer les fichiers sur votre serveur SFTP sont testées. Experience Platform crée un dossier, écrit un fichier dans ce dossier, vérifie que le fichier est bien là, puis supprime le tout. Si le compte utilisateur de votre serveur SFTP (celui associé au certificat sécurisé que vous avez fourni à Experience Platform) ne dispose pas des autorisations nécessaires pour effectuer cette action, l’hôte passe en état « Failed » (Échec).

Étapes suivantes

Ce guide explique comment configurer un serveur SFTP auto-hébergé à utiliser dans les balises. Une fois l’hôte établi, vous pouvez l’associer à un ou plusieurs de vos environnements pour publier des bibliothèques de balises. Pour plus d’informations sur le processus général d’activation des fonctionnalités de balises sur vos propriétés web ou mobiles, consultez la présentation de la publication.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743