Adobe Experience Platform Launch has been rebranded as a suite of data collection technologies in Adobe Experience Platform. Several terminology changes have rolled out across the product documentation as a result. Please refer to the following document for a consolidated reference of the terminology changes.
Experience Platform allows you to deliver tag library builds to a secured SFTP server that you host, giving you greater control over how your builds are stored and managed. This guide covers how to set up an SFTP host for a tag property in the Experience Platform UI or Data Collection UI.
You can also opt to use a host that is managed by Adobe instead. See the guide on Adobe-managed hosts for more information.
For information on the benefits and limitations of self-hosting libraries, see the self-hosting guide.
Platform connects to your SFTP site using an encrypted key. There are a few steps to set this up correctly:
You must have a public/private key pair installed on your SFTP server. You can generate these keys on your server or generate them somewhere else and install them on your server. See the GitHub documentation regarding how to generate SSH keys for more information.
The private key is used to encrypt the public key. You will need to provide your private key during the SFTP host creation process. See the section on encrypting values in the Reactor API guide for instructions on encrypting public keys. Use the Production Environment’s GPG key unless you know you need a specific one. Finally, you can encrypt your private key from any machine, so you do not need to install GPG on your server to complete this step.
You may need to approve a set of IP addresses to be used within your company firewall to allow Platform to reach your SFTP server and connect to it. These IP Addresses are:
184.72.239.68
23.20.85.113
54.226.193.184
The structure of tag builds has changed over time. They use symbolic links (symlinks) internally to maintain backward compatibility so that previous embed codes will continue to work with the latest build structure. Your SFTP server must support the usage of symlinks in order to serve as a valid destination for tag builds.
For more detailed information, refer to the following Medium article on how to set up SFTP servers to deliver a build.
Select Hosts in the left navigation, followed by Add Host.
The host creation dialog appears. Provide a name for the host, and under Type, select SFTP.
The dialog expands to include additional configuration options for the SFTP host. These are explained below.
Configuration field | Description |
---|---|
Don’t Use Symlinks | By default, all SFTP hosts use symbolic links (symlinks) to reference library builds that are saved to the server. However, not all servers support the use of symlinks. When this option is selected, the host uses a copy operation to update the build assets directly instead of using symlinks. |
SFTP Server URL | The URL base path for your server. |
Path | The path to append to the base server URL for this host. |
Port | The port must be one of the following:
|
Username | The username to be used when accessing the server. |
Encrypted Private Key | The encrypted private key that you created in a previous step. |
Select Save to create the host with the selected configuration.
When you select Save, the connection and ability to deliver the files to your SFTP server is tested. Platform creates a folder, writes a file within that folder, checks to make sure the file is there, and then cleans up after itself. If the user account on your SFTP server (the one attached to the secure certificate you provided to Platform) does not have the necessary permissions to perform this action, then the host goes into a “Failed” status.
This guide covered how to set up a self-hosted SFTP server for use in tags. Once the host has been established, you can associate it with one or more of your environments for publishing tag libraries. For more information on the high-level process of activating tag functionalities on your web or mobile properties, see the publishing overview.